X-Git-Url: https://git.openstreetmap.org/rails.git/blobdiff_plain/14ac1babc2517320a2c90fa9b4ac36a5a6e68018..ef7f3d800cbdd49b692df10d312e5fd880e2e938:/test/controllers/relation_controller_test.rb diff --git a/test/controllers/relation_controller_test.rb b/test/controllers/relation_controller_test.rb index ee712f748..2650d706c 100644 --- a/test/controllers/relation_controller_test.rb +++ b/test/controllers/relation_controller_test.rb @@ -68,21 +68,21 @@ class RelationControllerTest < ActionController::TestCase # check that all relations containing a particular node, and no extra # relations, are returned from the relations_for_node call. def test_relations_for_node - check_relations_for_element(:relations_for_node, "node", + check_relations_for_element(:relations_for_node, "node", current_nodes(:node_used_by_relationship).id, - [ :visible_relation, :used_relation ]) + [:visible_relation, :used_relation]) end def test_relations_for_way check_relations_for_element(:relations_for_way, "way", current_ways(:used_way).id, - [ :visible_relation ]) + [:visible_relation]) end def test_relations_for_relation check_relations_for_element(:relations_for_relation, "relation", current_relations(:used_relation).id, - [ :visible_relation ]) + [:visible_relation]) end def check_relations_for_element(method, type, id, expected_relations) @@ -91,7 +91,7 @@ class RelationControllerTest < ActionController::TestCase assert_response :success # count one osm element - assert_select "osm[version=#{API_VERSION}][generator=\"OpenStreetMap server\"]", 1 + assert_select "osm[version='#{API_VERSION}'][generator='OpenStreetMap server']", 1 # we should have only the expected number of relations assert_select "osm>relation", expected_relations.size @@ -99,8 +99,7 @@ class RelationControllerTest < ActionController::TestCase # and each of them should contain the node we originally searched for expected_relations.each do |r| relation_id = current_relations(r).id - assert_select "osm>relation#?", relation_id - assert_select "osm>relation#?>member[type=\"#{type}\"][ref=#{id}]", relation_id + assert_select "osm>relation[id='#{relation_id}']>member[type='#{type}'][ref='#{id}']", 1 end end @@ -110,7 +109,7 @@ class RelationControllerTest < ActionController::TestCase assert_response :success # FIXME check whether this contains the stuff we want! if $VERBOSE - print @response.body + print @response.body end end @@ -130,10 +129,10 @@ class RelationControllerTest < ActionController::TestCase assert_response :success assert_select "osm" do assert_select "relation", :count => 4 - assert_select "relation[id=1][visible=true]", :count => 1 - assert_select "relation[id=2][visible=false]", :count => 1 - assert_select "relation[id=4][visible=true]", :count => 1 - assert_select "relation[id=7][visible=true]", :count => 1 + assert_select "relation[id='1'][visible='true']", :count => 1 + assert_select "relation[id='2'][visible='false']", :count => 1 + assert_select "relation[id='4'][visible='true']", :count => 1 + assert_select "relation[id='7'][visible='true']", :count => 1 end # check error when a non-existent relation is included @@ -147,7 +146,7 @@ class RelationControllerTest < ActionController::TestCase def test_create basic_authorization users(:normal_user).email, "test" - + # put the relation in a dummy fixture changset changeset_id = changesets(:normal_user_first_change).id @@ -155,8 +154,8 @@ class RelationControllerTest < ActionController::TestCase content "" put :create # hope for forbidden, due to user - assert_response :forbidden, - "relation upload should have failed with forbidden" + assert_response :forbidden, + "relation upload should have failed with forbidden" ### # create an relation with a node as member @@ -167,20 +166,19 @@ class RelationControllerTest < ActionController::TestCase "" put :create # hope for forbidden due to user - assert_response :forbidden, - "relation upload did not return forbidden status" - + assert_response :forbidden, + "relation upload did not return forbidden status" + ### - # create an relation with a node as member, this time test that we don't + # create an relation with a node as member, this time test that we don't # need a role attribute to be included nid = current_nodes(:used_node_1).id content "" + - ""+ - "" + "" + "" put :create # hope for forbidden due to user - assert_response :forbidden, - "relation upload did not return forbidden status" + assert_response :forbidden, + "relation upload did not return forbidden status" ### # create an relation with a way and a node as members @@ -192,14 +190,12 @@ class RelationControllerTest < ActionController::TestCase "" put :create # hope for forbidden, due to user - assert_response :forbidden, - "relation upload did not return success status" - - + assert_response :forbidden, + "relation upload did not return success status" ## Now try with the public user basic_authorization users(:public_user).email, "test" - + # put the relation in a dummy fixture changset changeset_id = changesets(:public_user_first_change).id @@ -207,29 +203,28 @@ class RelationControllerTest < ActionController::TestCase content "" put :create # hope for success - assert_response :success, - "relation upload did not return success status" + assert_response :success, + "relation upload did not return success status" # read id of created relation and search for it relationid = @response.body checkrelation = Relation.find(relationid) - assert_not_nil checkrelation, - "uploaded relation not found in data base after upload" + assert_not_nil checkrelation, + "uploaded relation not found in data base after upload" # compare values - assert_equal checkrelation.members.length, 0, - "saved relation contains members but should not" - assert_equal checkrelation.tags.length, 1, - "saved relation does not contain exactly one tag" + assert_equal checkrelation.members.length, 0, + "saved relation contains members but should not" + assert_equal checkrelation.tags.length, 1, + "saved relation does not contain exactly one tag" assert_equal changeset_id, checkrelation.changeset.id, - "saved relation does not belong in the changeset it was assigned to" - assert_equal users(:public_user).id, checkrelation.changeset.user_id, - "saved relation does not belong to user that created it" - assert_equal true, checkrelation.visible, - "saved relation is not visible" + "saved relation does not belong in the changeset it was assigned to" + assert_equal users(:public_user).id, checkrelation.changeset.user_id, + "saved relation does not belong to user that created it" + assert_equal true, checkrelation.visible, + "saved relation is not visible" # ok the relation is there but can we also retrieve it? get :read, :id => relationid assert_response :success - ### # create an relation with a node as member # This time try with a role attribute in the relation @@ -239,59 +234,57 @@ class RelationControllerTest < ActionController::TestCase "" put :create # hope for success - assert_response :success, - "relation upload did not return success status" + assert_response :success, + "relation upload did not return success status" # read id of created relation and search for it relationid = @response.body checkrelation = Relation.find(relationid) - assert_not_nil checkrelation, - "uploaded relation not found in data base after upload" + assert_not_nil checkrelation, + "uploaded relation not found in data base after upload" # compare values - assert_equal checkrelation.members.length, 1, - "saved relation does not contain exactly one member" - assert_equal checkrelation.tags.length, 1, - "saved relation does not contain exactly one tag" + assert_equal checkrelation.members.length, 1, + "saved relation does not contain exactly one member" + assert_equal checkrelation.tags.length, 1, + "saved relation does not contain exactly one tag" assert_equal changeset_id, checkrelation.changeset.id, - "saved relation does not belong in the changeset it was assigned to" - assert_equal users(:public_user).id, checkrelation.changeset.user_id, - "saved relation does not belong to user that created it" - assert_equal true, checkrelation.visible, - "saved relation is not visible" + "saved relation does not belong in the changeset it was assigned to" + assert_equal users(:public_user).id, checkrelation.changeset.user_id, + "saved relation does not belong to user that created it" + assert_equal true, checkrelation.visible, + "saved relation is not visible" # ok the relation is there but can we also retrieve it? - + get :read, :id => relationid assert_response :success - - + ### - # create an relation with a node as member, this time test that we don't + # create an relation with a node as member, this time test that we don't # need a role attribute to be included nid = current_nodes(:used_node_1).id content "" + - ""+ - "" + "" + "" put :create # hope for success - assert_response :success, - "relation upload did not return success status" + assert_response :success, + "relation upload did not return success status" # read id of created relation and search for it relationid = @response.body checkrelation = Relation.find(relationid) - assert_not_nil checkrelation, - "uploaded relation not found in data base after upload" + assert_not_nil checkrelation, + "uploaded relation not found in data base after upload" # compare values - assert_equal checkrelation.members.length, 1, - "saved relation does not contain exactly one member" - assert_equal checkrelation.tags.length, 1, - "saved relation does not contain exactly one tag" + assert_equal checkrelation.members.length, 1, + "saved relation does not contain exactly one member" + assert_equal checkrelation.tags.length, 1, + "saved relation does not contain exactly one tag" assert_equal changeset_id, checkrelation.changeset.id, - "saved relation does not belong in the changeset it was assigned to" - assert_equal users(:public_user).id, checkrelation.changeset.user_id, - "saved relation does not belong to user that created it" - assert_equal true, checkrelation.visible, - "saved relation is not visible" + "saved relation does not belong in the changeset it was assigned to" + assert_equal users(:public_user).id, checkrelation.changeset.user_id, + "saved relation does not belong to user that created it" + assert_equal true, checkrelation.visible, + "saved relation is not visible" # ok the relation is there but can we also retrieve it? - + get :read, :id => relationid assert_response :success @@ -305,28 +298,27 @@ class RelationControllerTest < ActionController::TestCase "" put :create # hope for success - assert_response :success, - "relation upload did not return success status" + assert_response :success, + "relation upload did not return success status" # read id of created relation and search for it relationid = @response.body checkrelation = Relation.find(relationid) - assert_not_nil checkrelation, - "uploaded relation not found in data base after upload" + assert_not_nil checkrelation, + "uploaded relation not found in data base after upload" # compare values - assert_equal checkrelation.members.length, 2, - "saved relation does not have exactly two members" - assert_equal checkrelation.tags.length, 1, - "saved relation does not contain exactly one tag" + assert_equal checkrelation.members.length, 2, + "saved relation does not have exactly two members" + assert_equal checkrelation.tags.length, 1, + "saved relation does not contain exactly one tag" assert_equal changeset_id, checkrelation.changeset.id, - "saved relation does not belong in the changeset it was assigned to" - assert_equal users(:public_user).id, checkrelation.changeset.user_id, - "saved relation does not belong to user that created it" - assert_equal true, checkrelation.visible, - "saved relation is not visible" + "saved relation does not belong in the changeset it was assigned to" + assert_equal users(:public_user).id, checkrelation.changeset.user_id, + "saved relation does not belong to user that created it" + assert_equal true, checkrelation.visible, + "saved relation is not visible" # ok the relation is there but can we also retrieve it? get :read, :id => relationid assert_response :success - end # ------------------------------------ @@ -335,7 +327,7 @@ class RelationControllerTest < ActionController::TestCase ## # test that, when tags are updated on a relation, the correct things - # happen to the correct tables and the API gives sensible results. + # happen to the correct tables and the API gives sensible results. # this is to test a case that gregory marler noticed and posted to # josm-dev. ## FIXME Move this to an integration test @@ -365,8 +357,8 @@ class RelationControllerTest < ActionController::TestCase ## # test that, when tags are updated on a relation when using the diff - # upload function, the correct things happen to the correct tables - # and the API gives sensible results. this is to test a case that + # upload function, the correct things happen to the correct tables + # and the API gives sensible results. this is to test a case that # gregory marler noticed and posted to josm-dev. def test_update_relation_tags_via_upload basic_authorization users(:public_user).email, "test" @@ -408,8 +400,8 @@ class RelationControllerTest < ActionController::TestCase "" put :create # expect failure - assert_response :precondition_failed, - "relation upload with invalid node did not return 'precondition failed'" + assert_response :precondition_failed, + "relation upload with invalid node did not return 'precondition failed'" assert_equal "Precondition failed: Relation with id cannot be saved due to Node with id 0", @response.body end @@ -418,35 +410,33 @@ class RelationControllerTest < ActionController::TestCase # ------------------------------------- def test_create_invalid_xml basic_authorization users(:public_user).email, "test" - + # put the relation in a dummy fixture changeset that works changeset_id = changesets(:public_user_first_change).id - + # create some xml that should return an error content "" + - "" + - "" + "" + + "" put :create # expect failure assert_response :bad_request assert_match(/Cannot parse valid relation from xml string/, @response.body) assert_match(/The type is not allowed only, /, @response.body) end - - + # ------------------------------------- # Test deleting relations. # ------------------------------------- - + def test_delete ## First try to delete relation without auth delete :delete, :id => current_relations(:visible_relation).id assert_response :unauthorized - - + ## Then try with the private user, to make sure that you get a forbidden basic_authorization(users(:normal_user).email, "test") - + # this shouldn't work, as we should need the payload... delete :delete, :id => current_relations(:visible_relation).id assert_response :forbidden @@ -463,7 +453,7 @@ class RelationControllerTest < ActionController::TestCase assert_response :forbidden # try to delete with an invalid (non-existent) changeset - content update_changeset(current_relations(:visible_relation).to_xml,0) + content update_changeset(current_relations(:visible_relation).to_xml, 0) delete :delete, :id => current_relations(:visible_relation).id assert_response :forbidden @@ -482,7 +472,7 @@ class RelationControllerTest < ActionController::TestCase delete :delete, :id => current_relations(:invisible_relation).id assert_response :forbidden - # this works now because the relation which was using this one + # this works now because the relation which was using this one # has been deleted. content(relations(:used_relation).to_xml) delete :delete, :id => current_relations(:used_relation).id @@ -492,10 +482,8 @@ class RelationControllerTest < ActionController::TestCase delete :delete, :id => 0 assert_response :forbidden - - ## now set auth for the public user - basic_authorization(users(:public_user).email, "test"); + basic_authorization(users(:public_user).email, "test") # this shouldn't work, as we should need the payload... delete :delete, :id => current_relations(:visible_relation).id @@ -514,27 +502,27 @@ class RelationControllerTest < ActionController::TestCase assert_response :conflict # try to delete with an invalid (non-existent) changeset - content update_changeset(current_relations(:visible_relation).to_xml,0) + content update_changeset(current_relations(:visible_relation).to_xml, 0) delete :delete, :id => current_relations(:visible_relation).id assert_response :conflict # this won't work because the relation is in a changeset owned by someone else content(relations(:used_relation).to_xml) delete :delete, :id => current_relations(:used_relation).id - assert_response :conflict, - "shouldn't be able to delete a relation in a changeset owned by someone else (#{@response.body})" + assert_response :conflict, + "shouldn't be able to delete a relation in a changeset owned by someone else (#{@response.body})" # this won't work because the relation in the payload is different to that passed content(relations(:public_used_relation).to_xml) delete :delete, :id => current_relations(:used_relation).id assert_not_equal relations(:public_used_relation).id, current_relations(:used_relation).id assert_response :bad_request, "shouldn't be able to delete a relation when payload is different to the url" - + # this won't work because the relation is in-use by another relation content(relations(:public_used_relation).to_xml) delete :delete, :id => current_relations(:public_used_relation).id - assert_response :precondition_failed, - "shouldn't be able to delete a relation used in a relation (#{@response.body})" + assert_response :precondition_failed, + "shouldn't be able to delete a relation used in a relation (#{@response.body})" assert_equal "Precondition failed: The relation 5 is used in relation 6.", @response.body # this should work when we provide the appropriate payload... @@ -545,24 +533,24 @@ class RelationControllerTest < ActionController::TestCase # valid delete should return the new version number, which should # be greater than the old version number assert @response.body.to_i > current_relations(:visible_relation).version, - "delete request should return a new version number for relation" + "delete request should return a new version number for relation" # this won't work since the relation is already deleted content(relations(:invisible_relation).to_xml) delete :delete, :id => current_relations(:invisible_relation).id assert_response :gone - + # Public visible relation needs to be deleted content(relations(:public_visible_relation).to_xml) delete :delete, :id => current_relations(:public_visible_relation).id assert_response :success - # this works now because the relation which was using this one + # this works now because the relation which was using this one # has been deleted. content(relations(:public_used_relation).to_xml) delete :delete, :id => current_relations(:public_used_relation).id - assert_response :success, - "should be able to delete a relation used in an old relation (#{@response.body})" + assert_response :success, + "should be able to delete a relation used in an old relation (#{@response.body})" # this won't work since the relation never existed delete :delete, :id => 0 @@ -575,7 +563,7 @@ class RelationControllerTest < ActionController::TestCase def test_tag_modify_bounding_box # in current fixtures, relation 5 contains nodes 3 and 5 (node 3 # indirectly via way 3), so the bbox should be [3,3,5,5]. - check_changeset_modify(BoundingBox.new(3,3,5,5)) do |changeset_id| + check_changeset_modify(BoundingBox.new(3, 3, 5, 5)) do |changeset_id| # add a tag to an existing relation relation_xml = current_relations(:visible_relation).to_xml relation_element = relation_xml.find("//osm/relation").first @@ -583,10 +571,10 @@ class RelationControllerTest < ActionController::TestCase new_tag['k'] = "some_new_tag" new_tag['v'] = "some_new_value" relation_element << new_tag - + # update changeset ID to point to new changeset update_changeset(relation_xml, changeset_id) - + # upload the change content relation_xml put :update, :id => current_relations(:visible_relation).id @@ -604,7 +592,7 @@ class RelationControllerTest < ActionController::TestCase current_nodes(:used_node_2), current_ways(:used_way), current_ways(:way_with_versions) - ].each_with_index do |element, version| + ].each_with_index do |element, _version| bbox = element.bbox.to_unscaled check_changeset_modify(bbox) do |changeset_id| relation_xml = Relation.find(relation_id).to_xml @@ -614,49 +602,49 @@ class RelationControllerTest < ActionController::TestCase new_member['type'] = element.class.to_s.downcase new_member['role'] = "some_role" relation_element << new_member - + # update changeset ID to point to new changeset update_changeset(relation_xml, changeset_id) - + # upload the change content relation_xml put :update, :id => current_relations(:visible_relation).id assert_response :success, "can't update relation for add #{element.class}/bbox test: #{@response.body}" - # get it back and check the ordering + # get it back and check the ordering get :read, :id => relation_id assert_response :success, "can't read back the relation: #{@response.body}" check_ordering(relation_xml, @response.body) end end end - + ## - # remove a member from a relation and check the bounding box is + # remove a member from a relation and check the bounding box is # only that element. def test_remove_member_bounding_box - check_changeset_modify(BoundingBox.new(5,5,5,5)) do |changeset_id| + check_changeset_modify(BoundingBox.new(5, 5, 5, 5)) do |changeset_id| # remove node 5 (5,5) from an existing relation relation_xml = current_relations(:visible_relation).to_xml - relation_xml. - find("//osm/relation/member[@type='node'][@ref='5']"). - first.remove! - + relation_xml + .find("//osm/relation/member[@type='node'][@ref='5']") + .first.remove! + # update changeset ID to point to new changeset update_changeset(relation_xml, changeset_id) - + # upload the change content relation_xml put :update, :id => current_relations(:visible_relation).id assert_response :success, "can't update relation for remove node/bbox test" end end - + ## # check that relations are ordered def test_relation_member_ordering basic_authorization(users(:public_user).email, "test") - + doc_str = < @@ -708,7 +696,7 @@ OSM end end - ## + ## # check that relations can contain duplicate members def test_relation_member_duplicates doc_str = < OSM doc = XML::Parser.string(doc_str).parse - basic_authorization(users(:public_user).email, "test"); + basic_authorization(users(:public_user).email, "test") content doc put :create @@ -781,28 +769,28 @@ OSM ## # remove all the members from a relation. the result is pretty useless, but # still technically valid. - def test_remove_all_members - check_changeset_modify(BoundingBox.new(3,3,5,5)) do |changeset_id| + def test_remove_all_members + check_changeset_modify(BoundingBox.new(3, 3, 5, 5)) do |changeset_id| relation_xml = current_relations(:visible_relation).to_xml - relation_xml. - find("//osm/relation/member"). - each {|m| m.remove!} - + relation_xml + .find("//osm/relation/member") + .each(&:remove!) + # update changeset ID to point to new changeset update_changeset(relation_xml, changeset_id) - + # upload the change content relation_xml put :update, :id => current_relations(:visible_relation).id assert_response :success, "can't update relation for remove all members test" checkrelation = Relation.find(current_relations(:visible_relation).id) - assert_not_nil(checkrelation, + assert_not_nil(checkrelation, "uploaded relation not found in database after upload") assert_equal(0, checkrelation.members.length, "relation contains members but they should have all been deleted") end end - + # ============================================================ # utility functions # ============================================================ @@ -831,7 +819,7 @@ OSM # that the changeset bounding box is +bbox+. def check_changeset_modify(bbox) ## First test with the private user to check that you get a forbidden - basic_authorization(users(:normal_user).email, "test"); + basic_authorization(users(:normal_user).email, "test") # create a new changeset for this operation, so we are assured # that the bounding box will be newly-generated. @@ -841,10 +829,9 @@ OSM assert_response :forbidden, "shouldn't be able to create changeset for modify test, as should get forbidden" end - ## Now do the whole thing with the public user basic_authorization(users(:public_user).email, "test") - + # create a new changeset for this operation, so we are assured # that the bounding box will be newly-generated. changeset_id = with_controller(ChangesetController.new) do @@ -859,14 +846,14 @@ OSM # now download the changeset to check its bounding box with_controller(ChangesetController.new) do - get :read, :id => changeset_id, :format => :xml # TODO why it doesn't use defaults? + get :read, :id => changeset_id assert_response :success, "can't re-read changeset for modify test" assert_select "osm>changeset", 1, "Changeset element doesn't exist in #{@response.body}" - assert_select "osm>changeset[id=#{changeset_id}]", 1, "Changeset id=#{changeset_id} doesn't exist in #{@response.body}" - assert_select "osm>changeset[min_lon=#{bbox.min_lon}]", 1, "Changeset min_lon wrong in #{@response.body}" - assert_select "osm>changeset[min_lat=#{bbox.min_lat}]", 1, "Changeset min_lat wrong in #{@response.body}" - assert_select "osm>changeset[max_lon=#{bbox.max_lon}]", 1, "Changeset max_lon wrong in #{@response.body}" - assert_select "osm>changeset[max_lat=#{bbox.max_lat}]", 1, "Changeset max_lat wrong in #{@response.body}" + assert_select "osm>changeset[id='#{changeset_id}']", 1, "Changeset id=#{changeset_id} doesn't exist in #{@response.body}" + assert_select "osm>changeset[min_lon='#{bbox.min_lon}']", 1, "Changeset min_lon wrong in #{@response.body}" + assert_select "osm>changeset[min_lat='#{bbox.min_lat}']", 1, "Changeset min_lat wrong in #{@response.body}" + assert_select "osm>changeset[max_lon='#{bbox.max_lon}']", 1, "Changeset max_lon wrong in #{@response.body}" + assert_select "osm>changeset[max_lat='#{bbox.max_lat}']", 1, "Changeset max_lat wrong in #{@response.body}" end end @@ -887,8 +874,8 @@ OSM end ## - # updates the relation (XML) +rel+ and - # yields the new version of that relation into the block. + # updates the relation (XML) +rel+ and + # yields the new version of that relation into the block. # the parsed XML doc is retured. def with_update(rel) rel_id = rel.find("//osm/relation").first["id"].to_i @@ -904,12 +891,12 @@ OSM yield new_rel - return version + version end ## # updates the relation (XML) +rel+ via the diff-upload API and - # yields the new version of that relation into the block. + # yields the new version of that relation into the block. # the parsed XML doc is retured. def with_update_diff(rel) rel_id = rel.find("//osm/relation").first["id"].to_i @@ -928,29 +915,29 @@ OSM post :upload, :id => cs_id assert_response :success, "can't upload diff relation: #{@response.body}" version = xml_parse(@response.body).find("//diffResult/relation").first["new_version"].to_i - end - + end + # now get the new version get :read, :id => rel_id assert_response :success new_rel = xml_parse(@response.body) - + yield new_rel - - return version + + version end ## # returns a k->v hash of tags from an xml doc - def get_tags_as_hash(a) - a.find("//osm/relation/tag").sort_by { |v| v['k'] }.inject({}) do |h,v| + def get_tags_as_hash(a) + a.find("//osm/relation/tag").sort_by { |v| v['k'] }.inject({}) do |h, v| h[v['k']] = v['v'] h end end - + ## - # assert that all tags on relation documents +a+ and +b+ + # assert that all tags on relation documents +a+ and +b+ # are equal def assert_tags_equal(a, b) # turn the XML doc into tags hashes @@ -959,9 +946,9 @@ OSM assert_equal a_tags.keys, b_tags.keys, "Tag keys should be identical." a_tags.each do |k, v| - assert_equal v, b_tags[k], - "Tags which were not altered should be the same. " + - "#{a_tags.inspect} != #{b_tags.inspect}" + assert_equal v, b_tags[k], + "Tags which were not altered should be the same. " + + "#{a_tags.inspect} != #{b_tags.inspect}" end end @@ -975,7 +962,7 @@ OSM # update an attribute in the node element def xml_attr_rewrite(xml, name, value) xml.find("//osm/relation").first[name] = value.to_s - return xml + xml end ##