test/controllers/api/old_ways_controller_test.rb

   1 require "test_helper"
   2
   3 module Api
   4   class OldWaysControllerTest < ActionDispatch::IntegrationTest
   5     ##
   6     # test all routes which lead to this controller
   7     def test_routes
   8       assert_routing(
   9         { :path => "/api/0.6/way/1/history", :method => :get },
  10         { :controller => "api/old_ways", :action => "index", :way_id => "1" }
  11       )
  12       assert_routing(
  13         { :path => "/api/0.6/way/1/history.json", :method => :get },
  14         { :controller => "api/old_ways", :action => "index", :way_id => "1", :format => "json" }
  15       )
  16       assert_routing(
  17         { :path => "/api/0.6/way/1/2", :method => :get },
  18         { :controller => "api/old_ways", :action => "show", :way_id => "1", :version => "2" }
  19       )
  20       assert_routing(
  21         { :path => "/api/0.6/way/1/2.json", :method => :get },
  22         { :controller => "api/old_ways", :action => "show", :way_id => "1", :version => "2", :format => "json" }
  23       )
  24       assert_routing(
  25         { :path => "/api/0.6/way/1/2/redact", :method => :post },
  26         { :controller => "api/old_ways", :action => "redact", :way_id => "1", :version => "2" }
  27       )
  28     end
  29
  30     ##
  31     # check that a visible way is returned properly
  32     def test_index
  33       way = create(:way, :with_history, :version => 2)
  34
  35       get api_way_versions_path(way)
  36
  37       assert_response :success
  38       assert_dom "osm:root", 1 do
  39         assert_dom "> way", 2 do |dom_ways|
  40           assert_dom dom_ways[0], "> @id", way.id.to_s
  41           assert_dom dom_ways[0], "> @version", "1"
  42
  43           assert_dom dom_ways[1], "> @id", way.id.to_s
  44           assert_dom dom_ways[1], "> @version", "2"
  45         end
  46       end
  47     end
  48
  49     ##
  50     # check that an invisible way's history is returned properly
  51     def test_index_invisible
  52       get api_way_versions_path(create(:way, :with_history, :deleted))
  53       assert_response :success
  54     end
  55
  56     ##
  57     # check chat a non-existent way is not returned
  58     def test_index_invalid
  59       get api_way_versions_path(0)
  60       assert_response :not_found
  61     end
  62
  63     ##
  64     # test that redacted ways aren't visible in the history
  65     def test_index_redacted_unauthorised
  66       way = create(:way, :with_history, :version => 2)
  67       way.old_ways.find_by(:version => 1).redact!(create(:redaction))
  68
  69       get api_way_versions_path(way)
  70
  71       assert_response :success, "Redaction shouldn't have stopped history working."
  72       assert_dom "osm way[id='#{way.id}'][version='1']", 0,
  73                  "redacted way #{way.id} version 1 shouldn't be present in the history."
  74
  75       get api_way_versions_path(way, :show_redactions => "true")
  76
  77       assert_response :success, "Redaction shouldn't have stopped history working."
  78       assert_dom "osm way[id='#{way.id}'][version='1']", 0,
  79                  "redacted way #{way.id} version 1 shouldn't be present in the history when passing flag."
  80     end
  81
  82     def test_index_redacted_normal_user
  83       way = create(:way, :with_history, :version => 2)
  84       way.old_ways.find_by(:version => 1).redact!(create(:redaction))
  85
  86       get api_way_versions_path(way), :headers => bearer_authorization_header
  87
  88       assert_response :success, "Redaction shouldn't have stopped history working."
  89       assert_dom "osm way[id='#{way.id}'][version='1']", 0,
  90                  "redacted node #{way.id} version 1 shouldn't be present in the history, even when logged in."
  91
  92       get api_way_versions_path(way, :show_redactions => "true"), :headers => bearer_authorization_header
  93
  94       assert_response :success, "Redaction shouldn't have stopped history working."
  95       assert_dom "osm way[id='#{way.id}'][version='1']", 0,
  96                  "redacted node #{way.id} version 1 shouldn't be present in the history, even when logged in and passing flag."
  97     end
  98
  99     def test_index_redacted_moderator
 100       way = create(:way, :with_history, :version => 2)
 101       way.old_ways.find_by(:version => 1).redact!(create(:redaction))
 102       auth_header = bearer_authorization_header create(:moderator_user)
 103
 104       get api_way_versions_path(way), :headers => auth_header
 105
 106       assert_response :success, "Redaction shouldn't have stopped history working."
 107       assert_dom "osm way[id='#{way.id}'][version='1']", 0,
 108                  "way #{way.id} version 1 should not be present in the history for moderators when not passing flag."
 109
 110       get api_way_versions_path(way, :show_redactions => "true"), :headers => auth_header
 111
 112       assert_response :success, "Redaction shouldn't have stopped history working."
 113       assert_dom "osm way[id='#{way.id}'][version='1']", 1,
 114                  "way #{way.id} version 1 should still be present in the history for moderators when passing flag."
 115     end
 116
 117     def test_show
 118       way = create(:way, :with_history, :version => 2)
 119
 120       get api_way_version_path(way, 1)
 121
 122       assert_response :success
 123       assert_dom "osm:root", 1 do
 124         assert_dom "> way", 1 do
 125           assert_dom "> @id", way.id.to_s
 126           assert_dom "> @version", "1"
 127         end
 128       end
 129
 130       get api_way_version_path(way, 2)
 131
 132       assert_response :success
 133       assert_dom "osm:root", 1 do
 134         assert_dom "> way", 1 do
 135           assert_dom "> @id", way.id.to_s
 136           assert_dom "> @version", "2"
 137         end
 138       end
 139     end
 140
 141     ##
 142     # test that redacted ways aren't visible, regardless of
 143     # authorisation except as moderator...
 144     def test_show_redacted_unauthorised
 145       way = create(:way, :with_history, :version => 2)
 146       way.old_ways.find_by(:version => 1).redact!(create(:redaction))
 147
 148       get api_way_version_path(way, 1)
 149
 150       assert_response :forbidden, "Redacted way shouldn't be visible via the version API."
 151
 152       get api_way_version_path(way, 1, :show_redactions => "true")
 153
 154       assert_response :forbidden, "Redacted way shouldn't be visible via the version API when passing flag."
 155     end
 156
 157     def test_show_redacted_normal_user
 158       way = create(:way, :with_history, :version => 2)
 159       way.old_ways.find_by(:version => 1).redact!(create(:redaction))
 160
 161       get api_way_version_path(way, 1), :headers => bearer_authorization_header
 162
 163       assert_response :forbidden, "Redacted way shouldn't be visible via the version API, even when logged in."
 164
 165       get api_way_version_path(way, 1, :show_redactions => "true"), :headers => bearer_authorization_header
 166
 167       assert_response :forbidden, "Redacted way shouldn't be visible via the version API, even when logged in and passing flag."
 168     end
 169
 170     ##
 171     # check that returned history is the same as getting all
 172     # versions of a way from the api.
 173     def test_history_equals_versions
 174       way = create(:way, :with_history)
 175       used_way = create(:way, :with_history)
 176       create(:relation_member, :member => used_way)
 177       way_with_versions = create(:way, :with_history, :version => 4)
 178
 179       check_history_equals_versions(way.id)
 180       check_history_equals_versions(used_way.id)
 181       check_history_equals_versions(way_with_versions.id)
 182     end
 183
 184     ##
 185     # test the redaction of an old version of a way, while not being
 186     # authorised.
 187     def test_redact_way_unauthorised
 188       way = create(:way, :with_history, :version => 4)
 189       way_v3 = way.old_ways.find_by(:version => 3)
 190
 191       do_redact_way(way_v3, create(:redaction))
 192       assert_response :unauthorized, "should need to be authenticated to redact."
 193     end
 194
 195     ##
 196     # test the redaction of an old version of a way, while being
 197     # authorised as a normal user.
 198     def test_redact_way_normal_user
 199       auth_header = bearer_authorization_header
 200       way = create(:way, :with_history, :version => 4)
 201       way_v3 = way.old_ways.find_by(:version => 3)
 202
 203       do_redact_way(way_v3, create(:redaction), auth_header)
 204       assert_response :forbidden, "should need to be moderator to redact."
 205     end
 206
 207     ##
 208     # test that, even as moderator, the current version of a way
 209     # can't be redacted.
 210     def test_redact_way_current_version
 211       auth_header = bearer_authorization_header create(:moderator_user)
 212       way = create(:way, :with_history, :version => 4)
 213       way_latest = way.old_ways.last
 214
 215       do_redact_way(way_latest, create(:redaction), auth_header)
 216       assert_response :bad_request, "shouldn't be OK to redact current version as moderator."
 217     end
 218
 219     def test_redact_way_by_regular_without_write_redactions_scope
 220       auth_header = bearer_authorization_header(create(:user), :scopes => %w[read_prefs write_api])
 221       do_redact_redactable_way(auth_header)
 222       assert_response :forbidden, "should need to be moderator to redact."
 223     end
 224
 225     def test_redact_way_by_regular_with_write_redactions_scope
 226       auth_header = bearer_authorization_header(create(:user), :scopes => %w[write_redactions])
 227       do_redact_redactable_way(auth_header)
 228       assert_response :forbidden, "should need to be moderator to redact."
 229     end
 230
 231     def test_redact_way_by_moderator_without_write_redactions_scope
 232       auth_header = bearer_authorization_header(create(:moderator_user), :scopes => %w[read_prefs write_api])
 233       do_redact_redactable_way(auth_header)
 234       assert_response :forbidden, "should need to have write_redactions scope to redact."
 235     end
 236
 237     def test_redact_way_by_moderator_with_write_redactions_scope
 238       auth_header = bearer_authorization_header(create(:moderator_user), :scopes => %w[write_redactions])
 239       do_redact_redactable_way(auth_header)
 240       assert_response :success, "should be OK to redact old version as moderator with write_redactions scope."
 241     end
 242
 243     ##
 244     # test the redaction of an old version of a way, while being
 245     # authorised as a moderator.
 246     def test_redact_way_moderator
 247       way = create(:way, :with_history, :version => 4)
 248       way_v3 = way.old_ways.find_by(:version => 3)
 249       auth_header = bearer_authorization_header create(:moderator_user)
 250
 251       do_redact_way(way_v3, create(:redaction), auth_header)
 252
 253       assert_response :success, "should be OK to redact old version as moderator."
 254       assert_predicate way_v3.reload, :redacted?
 255
 256       # check moderator can still see the redacted data, when passing
 257       # the appropriate flag
 258       get api_way_version_path(way_v3.way_id, way_v3.version), :headers => auth_header
 259       assert_response :forbidden, "After redaction, node should be gone for moderator, when flag not passed."
 260       get api_way_version_path(way_v3.way_id, way_v3.version, :show_redactions => "true"), :headers => auth_header
 261       assert_response :success, "After redaction, node should not be gone for moderator, when flag passed."
 262     end
 263
 264     # testing that if the moderator drops auth, he can't see the
 265     # redacted stuff any more.
 266     def test_redact_way_is_redacted
 267       way = create(:way, :with_history, :version => 4)
 268       way_v3 = way.old_ways.find_by(:version => 3)
 269       auth_header = bearer_authorization_header create(:moderator_user)
 270
 271       do_redact_way(way_v3, create(:redaction), auth_header)
 272       assert_response :success, "should be OK to redact old version as moderator."
 273
 274       # re-auth as non-moderator
 275       auth_header = bearer_authorization_header
 276
 277       # check can't see the redacted data
 278       get api_way_version_path(way_v3.way_id, way_v3.version), :headers => auth_header
 279       assert_response :forbidden, "Redacted node shouldn't be visible via the version API."
 280     end
 281
 282     ##
 283     # test the unredaction of an old version of a way, while not being
 284     # authorised.
 285     def test_unredact_way_unauthorised
 286       way = create(:way, :with_history, :version => 2)
 287       way_v1 = way.old_ways.find_by(:version => 1)
 288       way_v1.redact!(create(:redaction))
 289
 290       post way_version_redact_path(way_v1.way_id, way_v1.version)
 291       assert_response :unauthorized, "should need to be authenticated to unredact."
 292     end
 293
 294     ##
 295     # test the unredaction of an old version of a way, while being
 296     # authorised as a normal user.
 297     def test_unredact_way_normal_user
 298       way = create(:way, :with_history, :version => 2)
 299       way_v1 = way.old_ways.find_by(:version => 1)
 300       way_v1.redact!(create(:redaction))
 301
 302       auth_header = bearer_authorization_header
 303
 304       post way_version_redact_path(way_v1.way_id, way_v1.version), :headers => auth_header
 305       assert_response :forbidden, "should need to be moderator to unredact."
 306     end
 307
 308     ##
 309     # test the unredaction of an old version of a way, while being
 310     # authorised as a moderator.
 311     def test_unredact_way_moderator
 312       moderator_user = create(:moderator_user)
 313       way = create(:way, :with_history, :version => 2)
 314       way_v1 = way.old_ways.find_by(:version => 1)
 315       way_v1.redact!(create(:redaction))
 316
 317       auth_header = bearer_authorization_header moderator_user
 318
 319       post way_version_redact_path(way_v1.way_id, way_v1.version), :headers => auth_header
 320       assert_response :success, "should be OK to unredact old version as moderator."
 321
 322       # check moderator can still see the unredacted data, without passing
 323       # the appropriate flag
 324       get api_way_version_path(way_v1.way_id, way_v1.version), :headers => auth_header
 325       assert_response :success, "After unredaction, node should not be gone for moderator."
 326
 327       # and when accessed via history
 328       get api_way_versions_path(way), :headers => auth_header
 329       assert_response :success, "Unredaction shouldn't have stopped history working."
 330       assert_select "osm way[id='#{way_v1.way_id}'][version='#{way_v1.version}']", 1,
 331                     "way #{way_v1.way_id} version #{way_v1.version} should still be present in the history for moderators."
 332
 333       auth_header = bearer_authorization_header
 334
 335       # check normal user can now see the unredacted data
 336       get api_way_version_path(way_v1.way_id, way_v1.version), :headers => auth_header
 337       assert_response :success, "After redaction, node should not be gone for moderator, when flag passed."
 338
 339       # and when accessed via history
 340       get api_way_versions_path(way), :headers => auth_header
 341       assert_response :success, "Redaction shouldn't have stopped history working."
 342       assert_select "osm way[id='#{way_v1.way_id}'][version='#{way_v1.version}']", 1,
 343                     "way #{way_v1.way_id} version #{way_v1.version} should still be present in the history for normal users."
 344     end
 345
 346     private
 347
 348     ##
 349     # look at all the versions of the way in the history and get each version from
 350     # the versions call. check that they're the same.
 351     def check_history_equals_versions(way_id)
 352       get api_way_versions_path(way_id)
 353       assert_response :success, "can't get way #{way_id} from API"
 354       history_doc = XML::Parser.string(@response.body).parse
 355       assert_not_nil history_doc, "parsing way #{way_id} history failed"
 356
 357       history_doc.find("//osm/way").each do |way_doc|
 358         history_way = Way.from_xml_node(way_doc)
 359         assert_not_nil history_way, "parsing way #{way_id} version failed"
 360
 361         get api_way_version_path(way_id, history_way.version)
 362         assert_response :success, "couldn't get way #{way_id}, v#{history_way.version}"
 363         version_way = Way.from_xml(@response.body)
 364         assert_not_nil version_way, "failed to parse #{way_id}, v#{history_way.version}"
 365
 366         assert_ways_are_equal history_way, version_way
 367       end
 368     end
 369
 370     def do_redact_redactable_way(headers = {})
 371       way = create(:way, :with_history, :version => 4)
 372       way_v3 = way.old_ways.find_by(:version => 3)
 373       do_redact_way(way_v3, create(:redaction), headers)
 374     end
 375
 376     def do_redact_way(way, redaction, headers = {})
 377       get api_way_version_path(way.way_id, way.version)
 378       assert_response :success, "should be able to get version #{way.version} of way #{way.way_id}."
 379
 380       # now redact it
 381       post way_version_redact_path(way.way_id, way.version), :params => { :redaction => redaction.id }, :headers => headers
 382     end
 383   end
 384 end