rubysl-rexml 1.0.0

data/spec/document/node_type_spec.rb

@@ -0,0 +1,7 @@
+require 'rexml/document'
+
+describe "REXML::Document#node_type" do
+  it "returns :document" do
+    REXML::Document.new.node_type.should == :document
+  end
+end

data/spec/document/root_spec.rb

@@ -0,0 +1,11 @@
+require 'rexml/document'
+
+describe "REXML::Document#root" do
+  it "returns document root tag name" do
+    REXML::Document.new("<foo/>").root.name.should == "foo"
+  end
+
+  it "returns nil if there is not root" do
+    REXML::Document.new.root.should == nil
+  end
+end

data/spec/document/stand_alone_spec.rb

@@ -0,0 +1,18 @@
+require 'rexml/document'
+
+describe "REXML::Document#stand_alone?" do
+  it "returns the XMLDecl standalone value" do
+    d = REXML::Document.new
+    decl = REXML::XMLDecl.new("1.0", "UTF-8", "yes")
+    d.add decl
+    d.stand_alone?.should == "yes"
+  end
+
+  # According to the docs this should return the default XMLDecl but that
+  # will carry some more problems when printing the document. Currently, it
+  # returns nil. See http://www.ruby-forum.com/topic/146812#650061
+  it "returns the default value when no XML declaration present" do
+    REXML::Document.new.stand_alone?.should == nil
+  end
+
+end

data/spec/document/version_spec.rb

@@ -0,0 +1,13 @@
+require 'rexml/document'
+
+describe "REXML::Document#version" do
+  it "returns XML version from declaration" do
+    d = REXML::Document.new
+    d.add REXML::XMLDecl.new("1.1")
+    d.version.should == "1.1"
+  end
+
+  it "returns the default version when declaration is not present" do
+    REXML::Document.new.version.should == REXML::XMLDecl::DEFAULT_VERSION
+  end
+end

data/spec/document/write_spec.rb

@@ -0,0 +1,38 @@
+require 'rexml/document'
+require 'rexml/formatters/transitive'
+
+# Maybe this can be cleaned
+describe "REXML::Document#write" do
+  before :each do
+    @d      = REXML::Document.new
+    city    = REXML::Element.new "Springfield"
+    street  = REXML::Element.new "EvergreenTerrace"
+    address = REXML::Element.new "House742"
+    @d << city << street << address
+    @str = ""
+  end
+
+  it "returns document source as string" do
+    @d.write(@str)
+    @str.should == "<Springfield><EvergreenTerrace><House742/></EvergreenTerrace></Springfield>"
+  end
+
+  it "returns document indented" do
+    @d.write(@str, 2)
+    @str.should =~ /\s*<Springfield>\s*<EvergreenTerrace>\s*<House742\/>\s*<\/EvergreenTerrace>\s*<\/Springfield>/
+  end
+
+  # REXML in 1.8 is screwed up:
+  # Document#write uses wrong arity for Formatters::Transitive#initialize
+  ruby_bug "REXMLTracker#162", "1.8" do
+    it "returns document with transitive support" do
+      @d.write(@str, 2, true)
+      @str.should =~ /\s*<Springfield\s*><EvergreenTerrace\s*><House742\s*\/><\/EvergreenTerrace\s*><\/Springfield\s*>/
+    end
+  end
+
+  it "returns document with support for IE" do
+    @d.write(@str, -1, false, true)
+    @str.should ==  "<Springfield><EvergreenTerrace><House742 /></EvergreenTerrace></Springfield>"
+  end
+end

data/spec/document/xml_decl_spec.rb

@@ -0,0 +1,14 @@
+require 'rexml/document'
+
+describe "REXML::Document#xml_decl" do
+  it "returns XML declaration of the document" do
+    d = REXML::Document.new
+    decl = REXML::XMLDecl.new("1.0", "UTF-16", "yes")
+    d.add decl
+    d.xml_decl.should == decl
+  end
+
+  it "returns default XML declaration unless present" do
+    REXML::Document.new.xml_decl.should == REXML::XMLDecl.new
+  end
+end

data/spec/element/add_attribute_spec.rb

@@ -0,0 +1,40 @@
+require 'rexml/document'
+
+describe "REXML::Element#add_attribute" do
+  before :each do
+    @person = REXML::Element.new "person"
+    @person.attributes["name"] = "Bill"
+  end
+
+  it "adds a new attribute" do
+    @person.add_attribute("age", "17")
+    @person.attributes["age"].should == "17"
+  end
+
+  it "overwrites an existing attribute" do
+    @person.add_attribute("name", "Bill")
+    @person.attributes["name"].should == "Bill"
+  end
+
+  it "accepts a pair of strings" do
+    @person.add_attribute("male", "true")
+    @person.attributes["male"].should == "true"
+  end
+
+  it "accepts an Attribute for key" do
+    attr = REXML::Attribute.new("male", "true")
+    @person.add_attribute attr
+    @person.attributes["male"].should == "true"
+  end
+
+  it "ignores value if key is an Attribute" do
+    attr = REXML::Attribute.new("male", "true")
+    @person.add_attribute(attr, "false")
+    @person.attributes["male"].should == "true"
+  end
+
+ it "returns the attribute added" do
+    attr = REXML::Attribute.new("name", "Tony")
+    @person.add_attribute(attr).should == attr
+  end
+end

data/spec/element/add_attributes_spec.rb

@@ -0,0 +1,21 @@
+require 'rexml/document'
+
+describe "REXML::Element#add_attribute" do
+  before :each do
+    @person = REXML::Element.new "person"
+    @person.attributes["name"] = "Bill"
+  end
+
+  it "adds multiple attributes from a hash" do
+    @person.add_attributes({"name" => "Joe", "age" => "27"})
+    @person.attributes["name"].should == "Joe"
+    @person.attributes["age"].should == "27"
+  end
+
+  it "adds multiple attributes from an array" do
+    attrs =  { "name" => "Joe", "age" => "27"}
+    @person.add_attributes attrs.to_a
+    @person.attributes["name"].should == "Joe"
+    @person.attributes["age"].should == "27"
+  end
+end

data/spec/element/add_element_spec.rb

@@ -0,0 +1,38 @@
+require 'rexml/document'
+
+
+describe "REXML::Element#add_element" do
+  before :each do
+    @root = REXML::Element.new("root")
+  end
+
+  it "adds a child without attributes" do
+    name = REXML::Element.new("name")
+    @root.add_element name
+    @root.elements["name"].name.should == name.name
+    @root.elements["name"].attributes.should == name.attributes
+    @root.elements["name"].context.should == name.context
+  end
+
+  it "adds a child with attributes" do
+    person = REXML::Element.new("person")
+    @root.add_element(person, {"name" => "Madonna"})
+    @root.elements["person"].name.should == person.name
+    @root.elements["person"].attributes.should == person.attributes
+    @root.elements["person"].context.should == person.context
+  end
+
+  it "adds a child with name" do
+    @root.add_element "name"
+    @root.elements["name"].name.should == "name"
+    @root.elements["name"].attributes.should == {}
+    @root.elements["name"].context.should == nil
+  end
+
+  it "returns the added child" do
+    name = @root.add_element "name"
+    @root.elements["name"].name.should == name.name
+    @root.elements["name"].attributes.should == name.attributes
+    @root.elements["name"].context.should == name.context
+  end
+end

data/spec/element/add_namespace_spec.rb

@@ -0,0 +1,23 @@
+require 'rexml/document'
+
+describe "REXML::Element#add_namespace" do
+  before :each do
+    @elem = REXML::Element.new("person")
+  end
+
+  it "adds a namespace to element" do
+    @elem.add_namespace("foo", "bar")
+    @elem.namespace("foo").should == "bar"
+  end
+
+  it "accepts a prefix string as prefix" do
+    @elem.add_namespace("xmlns:foo", "bar")
+    @elem.namespace("foo").should == "bar"
+  end
+
+  it "uses prefix as URI if uri is nil" do
+    @elem.add_namespace("some_uri", nil)
+    @elem.namespace.should == "some_uri"
+  end
+end
+

data/spec/element/add_text_spec.rb

@@ -0,0 +1,23 @@
+require 'rexml/document'
+
+describe "REXML::Element#add_namespace" do
+  before :each do
+    @name = REXML::Element.new "Name"
+  end
+
+  it "adds text to an element" do
+    @name.add_text "Ringo"
+    @name.to_s.should == "<Name>Ringo</Name>"
+  end
+
+  it "accepts a Text" do
+    @name.add_text(REXML::Text.new("Ringo"))
+    @name.to_s.should == "<Name>Ringo</Name>"
+  end
+
+  it "joins the new text with the old one" do
+    @name.add_text "Ringo"
+    @name.add_text " Starr"
+    @name.to_s.should == "<Name>Ringo Starr</Name>"
+  end
+end

data/spec/element/attribute_spec.rb

@@ -0,0 +1,16 @@
+require 'rexml/document'
+
+describe "REXML::Element#attribute" do
+  it "returns an attribute by name" do
+    person = REXML::Element.new "Person"
+    attribute = REXML::Attribute.new("drink", "coffee")
+    person.add_attribute(attribute)
+    person.attribute("drink").should == attribute
+  end
+
+  it "supports attributes inside namespaces" do
+    e = REXML::Element.new("element")
+    e.add_attributes({"xmlns:ns" => "http://some_uri"})
+    e.attribute("ns", "ns").to_s.should == "http://some_uri"
+  end
+end

data/spec/element/attributes_spec.rb

@@ -0,0 +1,18 @@
+require 'rexml/document'
+
+describe "REXML::Element#attributes" do
+  it "returns element's Attributes" do
+    p = REXML::Element.new "Person"
+
+    name = REXML::Attribute.new("name", "John")
+    attrs = REXML::Attributes.new(p)
+    attrs.add name
+
+    p.add_attribute name
+    p.attributes.should == attrs
+  end
+
+  it "returns an empty hash if element has no attributes" do
+    REXML::Element.new("Person").attributes.should == {}
+  end
+end

data/spec/element/cdatas_spec.rb

@@ -0,0 +1,23 @@
+require 'rexml/document'
+
+describe "REXML::Element#cdatas" do
+  before :each do
+    @e = REXML::Element.new("Root")
+  end
+
+  it "returns the array of children cdatas" do
+    c = REXML::CData.new("Primary")
+    d = REXML::CData.new("Secondary")
+    @e << c
+    @e << d
+    @e.cdatas.should == [c, d]
+  end
+
+  it "freezes the returned array" do
+    @e.cdatas.frozen?.should == true
+  end
+
+  it "returns an empty array if element has no cdata" do
+    @e.cdatas.should == []
+  end
+end

data/spec/element/clone_spec.rb

@@ -0,0 +1,28 @@
+require 'rexml/document'
+
+describe "REXML::Element#clone" do
+  before :each do
+    @e = REXML::Element.new "a"
+  end
+  it "creates a copy of element" do
+    @e.clone.to_s.should == @e.to_s
+  end
+
+  it "copies the attributes" do
+    @e.add_attribute("foo", "bar")
+    @e.clone.to_s.should == @e.to_s
+  end
+
+  it "does not copy the text" do
+    @e.add_text "some text..."
+    @e.clone.to_s.should_not == @e
+    @e.clone.to_s.should == "<a/>"
+  end
+
+  it "does not copy the child elements" do
+    b = REXML::Element.new "b"
+    @e << b
+    @e.clone.should_not == @e
+    @e.clone.to_s.should == "<a/>"
+  end
+end

data/spec/element/comments_spec.rb

@@ -0,0 +1,20 @@
+require 'rexml/document'
+
+describe "REXML::Element#comments" do
+  before :each do
+    @e = REXML::Element.new "root"
+    @c1 = REXML::Comment.new "this is a comment"
+    @c2 = REXML::Comment.new "this is another comment"
+    @e << @c1
+    @e << @c2
+  end
+
+  it "returns the array of comments" do
+    @e.comments.should == [@c1, @c2]
+  end
+
+  it "returns a frozen object" do
+    comment = REXML::Comment.new "The insertion should fail"
+    @e.comments.frozen?.should == true
+  end
+end

data/spec/element/delete_attribute_spec.rb

@@ -0,0 +1,38 @@
+require 'rexml/document'
+
+describe "REXML::Element#delete_attribute" do
+  before :each do
+    @e = REXML::Element.new("Person")
+    @attr = REXML::Attribute.new("name", "Sean")
+    @e.add_attribute(@attr)
+  end
+
+  it "deletes an attribute from the element" do
+    @e.delete_attribute("name")
+    @e.attributes["name"].should be_nil
+  end
+
+#  Bug was filled with a patch in Ruby's tracker #20298
+  quarantine! do
+    it "receives an Attribute" do
+      @e.add_attribute(@attr)
+      @e.delete_attribute(@attr)
+      @e.attributes["name"].should be_nil
+    end
+  end
+
+  # Docs say that it returns the removed attribute but then examples
+  # show it returns the element with the attribute removed.
+  # Also fixed in #20298
+  it "returns the element with the attribute removed" do
+    elem = @e.delete_attribute("name")
+    elem.attributes.should be_empty
+    elem.to_s.should eql("<Person/>")
+  end
+
+  it "returns nil if the attribute does not exist" do
+    @e.delete_attribute("name")
+    at = @e.delete_attribute("name")
+    at.should be_nil
+  end
+end

data/spec/element/delete_element_spec.rb

@@ -0,0 +1,50 @@
+require 'rexml/document'
+
+describe "REXML::Element#delete_element" do
+  before :each do
+    @root = REXML::Element.new("root")
+  end
+
+  it "deletes the child element" do
+    node = REXML::Element.new("some_node")
+    @root.add_element node
+    @root.delete_element node
+    @root.elements.size.should == 0
+  end
+
+  it "deletes a child via XPath" do
+    @root.add_element "some_node"
+    @root.delete_element "some_node"
+    @root.elements.size.should == 0
+  end
+
+  it "deletes the child at index" do
+    @root.add_element "some_node"
+    @root.delete_element 1
+    @root.elements.size.should == 0
+  end
+
+  # According to the docs this should return the deleted element
+  # but it won't if it's an Element.
+  ruby_bug "REXMLTracker#161", "1.8" do
+    it "deletes Element and returns it" do
+      node = REXML::Element.new("some_node")
+      @root.add_element node
+      del_node = @root.delete_element node
+      del_node.should == node
+    end
+  end
+
+  # Note how passing the string will return the removed element
+  # but passing the Element as above won't.
+  it "deletes an element and returns it" do
+    node = REXML::Element.new("some_node")
+    @root.add_element node
+    del_node = @root.delete_element "some_node"
+    del_node.should == node
+  end
+
+  it "returns nil unless element exists" do
+    @root.delete_element("something").should == nil
+  end
+end