rubysl-rexml 1.0.0

data/spec/attributes/element_set_spec.rb

@@ -0,0 +1,25 @@
+require 'rexml/document'
+
+describe "REXML::Attributes#[]=" do
+  before :each do
+    @e = REXML::Element.new("song")
+    @name = REXML::Attribute.new("name", "Holy Smoke!")
+    @e.attributes << @name
+  end
+
+  it "sets an attribute" do
+    @e.attributes["author"] = "_why's foxes"
+    @e.attributes["author"].should == "_why's foxes"
+  end
+
+  it "overwrites an existing attribute" do
+    @e.attributes["name"] = "Chunky Bacon"
+    @e.attributes["name"].should == "Chunky Bacon"
+  end
+
+  it "deletes an attribute is value is nil" do
+    @e.attributes["name"] = nil
+    @e.attributes.length.should == 0
+  end
+end
+

data/spec/attributes/get_attribute_ns_spec.rb

@@ -0,0 +1,13 @@
+require 'rexml/document'
+
+describe "REXML::Attributes#get_attribute_ns" do
+  it "returns an attribute by name and namespace" do
+    e = REXML::Element.new("root")
+    attr = REXML::Attribute.new("xmlns:ns", "http://some_url")
+    e.attributes << attr
+    attr.prefix.should == "xmlns"
+    # This might be a bug in Attribute, commenting until those specs
+    # are ready
+    # e.attributes.get_attribute_ns(attr.prefix, "name").should == "http://some_url"
+  end
+end

data/spec/attributes/get_attribute_spec.rb

@@ -0,0 +1,28 @@
+require 'rexml/document'
+
+describe "REXML::Attributes#get_attribute" do
+  before :each do
+    @e = REXML::Element.new("root")
+    @name = REXML::Attribute.new("name", "Dave")
+    @e.attributes << @name
+  end
+
+  it "fetches an attributes" do
+    @e.attributes.get_attribute("name").should == @name
+  end
+
+  it "fetches an namespaced attribute" do
+    ns_name = REXML::Attribute.new("im:name", "Murray")
+    @e.attributes << ns_name
+    @e.attributes.get_attribute("name").should == @name
+    @e.attributes.get_attribute("im:name").should == ns_name
+  end
+
+  it "returns an Attribute" do
+    @e.attributes.get_attribute("name").should be_kind_of(REXML::Attribute)
+  end
+
+  it "returns nil if it attribute does not exist" do
+    @e.attributes.get_attribute("fake").should be_nil
+  end
+end

data/spec/attributes/initialize_spec.rb

@@ -0,0 +1,18 @@
+require 'rexml/document'
+
+describe "REXML::Attributes#initialize" do
+  it "is auto initialized by Element" do
+    e = REXML::Element.new "root"
+    e.attributes.should be_kind_of(REXML::Attributes)
+
+    e.attributes << REXML::Attribute.new("name", "Paul")
+    e.attributes["name"].should == "Paul"
+  end
+
+  it "receives a parent node" do
+    e = REXML::Element.new "root"
+    a = REXML::Attributes.new(e)
+    e.attributes << REXML::Attribute.new("name", "Vic")
+    e.attributes["name"].should == "Vic"
+  end
+end

data/spec/attributes/length_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path('../shared/length', __FILE__)
+require 'rexml/document'
+
+describe "REXML::Attributes#length" do
+ it_behaves_like :rexml_attribute_length, :length
+end

data/spec/attributes/namespaces_spec.rb

@@ -0,0 +1,5 @@
+require 'rexml/document'
+
+describe "REXML::Attributes#namespaces" do
+  it "needs to be reviewed for spec completeness"
+end

data/spec/attributes/prefixes_spec.rb

@@ -0,0 +1,23 @@
+require 'rexml/document'
+
+describe "REXML::Attributes#prefixes" do
+  before :each do
+    @e = REXML::Element.new("root")
+    a1 = REXML::Attribute.new("xmlns:a", "bar")
+    a2 = REXML::Attribute.new("xmlns:b", "bla")
+    a3 = REXML::Attribute.new("xmlns:c", "baz")
+    @e.attributes << a1
+    @e.attributes << a2
+    @e.attributes << a3
+
+    @e.attributes << REXML::Attribute.new("xmlns", "foo")
+  end
+
+  it "returns an array with the prefixes of each attribute" do
+    @e.attributes.prefixes.sort.should == ["a", "b", "c"]
+  end
+
+  it "does not include the default namespace" do
+    @e.attributes.prefixes.include?("xmlns").should == false
+  end
+end

data/spec/attributes/shared/add.rb

@@ -0,0 +1,17 @@
+describe :rexml_attribute_add, :shared => true do
+  before :each do
+    @e = REXML::Element.new("root")
+    @attr = REXML::Attributes.new(@e)
+    @name = REXML::Attribute.new("name", "Joe")
+  end
+
+  it "adds an attribute" do
+    @attr.send(@method, @name)
+    @attr["name"].should == "Joe"
+  end
+
+  it "replaces an existing attribute" do
+    @attr.send(@method, REXML::Attribute.new("name", "Bruce"))
+    @attr["name"].should == "Bruce"
+  end
+end

data/spec/attributes/shared/length.rb

@@ -0,0 +1,12 @@
+require 'rexml/document'
+
+describe :rexml_attribute_length, :shared => true do
+  it "returns the number of attributes" do
+    e = REXML::Element.new("root")
+    e.attributes.send(@method).should == 0
+
+    e.attributes << REXML::Attribute.new("name", "John")
+    e.attributes << REXML::Attribute.new("another_name", "Leo")
+    e.attributes.send(@method).should == 2
+  end
+end

data/spec/attributes/size_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path('../shared/length', __FILE__)
+require 'rexml/document'
+
+describe "REXML::Attributes#size" do
+ it_behaves_like :rexml_attribute_length, :size
+end

data/spec/attributes/to_a_spec.rb

@@ -0,0 +1,20 @@
+require 'rexml/document'
+
+describe "REXML::Attributes#to_a" do
+  it "returns an array with the attributes" do
+    e = REXML::Element.new("root")
+    name = REXML::Attribute.new("name", "Dave")
+    last = REXML::Attribute.new("last_name", "Murray")
+
+    e.attributes << name
+    e.attributes << last
+
+    result = e.attributes.to_a.sort { |a, b| a.to_s <=> b.to_s }
+    result.should == [name, last]
+  end
+
+  it "returns an empty array if it has no attributes" do
+    REXML::Element.new("root").attributes.to_a.should == []
+  end
+end
+

data/spec/cdata/clone_spec.rb

@@ -0,0 +1,9 @@
+require 'rexml/document'
+
+describe "REXML::CData#clone" do
+  it "makes a copy of itself" do
+    c = REXML::CData.new("some text")
+    c.clone.to_s.should == c.to_s
+    c.clone.should == c
+  end
+end

data/spec/cdata/initialize_spec.rb

@@ -0,0 +1,24 @@
+require 'rexml/document'
+
+describe "REXML::CData#initialize" do
+  it "creates a new CData object" do
+    c = REXML::CData.new("some    text")
+    c = REXML::CData.new("some    text")
+    c.should be_kind_of(REXML::CData)
+    c.should be_kind_of(REXML::Text)
+  end
+
+  it "respects whitespace if whitespace is true" do
+    c = REXML::CData.new("whitespace     test", true)
+    c1 = REXML::CData.new("whitespace     test", false)
+
+    c.to_s.should == "whitespace     test"
+    c1.to_s.should == "whitespace test"
+  end
+
+  it "receives parent as third argument" do
+    e = REXML::Element.new("root")
+    c = REXML::CData.new("test", true, e)
+    e.to_s.should == "<root><![CDATA[test]]></root>"
+  end
+end

data/spec/cdata/shared/to_s.rb

@@ -0,0 +1,11 @@
+describe :rexml_cdata_to_s, :shared => true do
+  it "returns the contents of the CData" do
+    c = REXML::CData.new("some text")
+    c.send(@method).should == "some text"
+  end
+
+  it "does not escape text" do
+    c1 = REXML::CData.new("some& text\n")
+    c1.send(@method).should == "some& text\n"
+  end
+end

data/spec/cdata/to_s_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path('../shared/to_s', __FILE__)
+require 'rexml/document'
+
+describe "REXML::CData#to_s" do
+  it_behaves_like :rexml_cdata_to_s, :to_s
+end

data/spec/cdata/value_spec.rb

@@ -0,0 +1,6 @@
+require File.expand_path('../shared/to_s', __FILE__)
+require 'rexml/document'
+
+describe "REXML::CData#value" do
+  it_behaves_like :rexml_cdata_to_s, :value
+end

data/spec/document/add_element_spec.rb

@@ -0,0 +1,30 @@
+require 'rexml/document'
+
+describe "REXML::Document#add_element" do
+  it "adds arg1 with attributes arg2 as root node" do
+    d = REXML::Document.new
+    e = REXML::Element.new("root")
+    d.add_element e
+    d.root.should == e
+  end
+
+  it "sets arg2 as arg1's attributes" do
+    d = REXML::Document.new
+    e = REXML::Element.new("root")
+    attr = {"foo" => "bar"}
+    d.add_element(e,attr)
+    d.root.attributes["foo"].should == attr["foo"]
+  end
+
+  it "accepts a node name as arg1 and adds it as root" do
+    d = REXML::Document.new
+    d.add_element "foo"
+    d.root.name.should == "foo"
+  end
+
+  it "sets arg1's context to the root's context" do
+    d = REXML::Document.new("", {"foo" => "bar"})
+    d.add_element "foo"
+    d.root.context.should == d.context
+  end
+end

data/spec/document/add_spec.rb

@@ -0,0 +1,60 @@
+require 'rexml/document'
+
+# This spec defines Document#add and Document#<<
+
+describe :rexml_document_add, :shared => true do
+  before :each do
+    @doc  = REXML::Document.new("<root/>")
+    @decl = REXML::XMLDecl.new("1.0")
+  end
+
+  it "sets document's XML declaration" do
+    @doc.send(@method, @decl)
+    @doc.xml_decl.should == @decl
+  end
+
+  it "inserts XML declaration as first node" do
+    @doc.send(@method, @decl)
+    @doc.children[0].version.should == "1.0"
+  end
+
+  it "overwrites existing XML declaration" do
+    @doc.send(@method, @decl)
+    @doc.send(@method, REXML::XMLDecl.new("2.0"))
+    @doc.xml_decl.version.should == "2.0"
+  end
+
+  it "sets document DocType" do
+    @doc.send(@method, REXML::DocType.new("transitional"))
+    @doc.doctype.name.should == "transitional"
+  end
+
+  ruby_bug "#19058", "1.8" do
+    # MRI 1.8.x and 1.9 bug. A patch has been submitted.
+    # http://rubyforge.org/tracker/index.php?func=detail&aid=19058&group_id=426&atid=1698
+    it "overwrites existing DocType" do
+      @doc.send(@method, REXML::DocType.new("transitional"))
+      @doc.send(@method, REXML::DocType.new("strict"))
+      @doc.doctype.name.should == "strict"
+    end
+  end
+
+  it "adds root node unless it exists" do
+    d = REXML::Document.new("")
+    elem = REXML::Element.new "root"
+    d.send(@method, elem)
+    d.root.should == elem
+  end
+
+  it "refuses to add second root" do
+    lambda { @doc.send(@method, REXML::Element.new("foo")) }.should raise_error(RuntimeError)
+  end
+end
+
+describe "REXML::Document#add" do
+  it_behaves_like(:rexml_document_add, :add)
+end
+
+describe "REXML::Document#<<" do
+  it_behaves_like(:rexml_document_add, :<<)
+end

data/spec/document/clone_spec.rb

@@ -0,0 +1,19 @@
+require 'rexml/document'
+
+# According to the MRI documentation (http://www.ruby-doc.org/stdlib/libdoc/rexml/rdoc/index.html),
+# clone's behavior "should be obvious". Apparently "obvious" means cloning
+# only the attributes and the context of the document, not its children.
+describe "REXML::Document#clone" do
+  it "clones document attributes" do
+    d = REXML::Document.new("foo")
+    d.attributes["foo"] = "bar"
+    e = d.clone
+    e.attributes.should == d.attributes
+  end
+
+  it "clones document context" do
+    d = REXML::Document.new("foo", {"foo" => "bar"})
+    e = d.clone
+    e.context.should == d.context
+  end
+end

data/spec/document/doctype_spec.rb

@@ -0,0 +1,14 @@
+require 'rexml/document'
+
+describe "REXML::Document#doctype" do
+  it "returns the doctype" do
+    d = REXML::Document.new
+    dt = REXML::DocType.new("foo")
+    d.add dt
+    d.doctype.should == dt
+  end
+
+  it "returns nil if there's no doctype" do
+    REXML::Document.new.doctype.should == nil
+  end
+end

data/spec/document/encoding_spec.rb

@@ -0,0 +1,21 @@
+require 'rexml/document'
+
+describe "REXML::Document#encoding" do
+  before :each do
+    @doc = REXML::Document.new
+  end
+
+  it "returns encoding from XML declaration" do
+    @doc.add REXML::XMLDecl.new(nil, "UTF-16", nil)
+    @doc.encoding.should == "UTF-16"
+  end
+
+  it "returns encoding from XML declaration (for UTF-16 as well)" do
+    @doc.add REXML::XMLDecl.new("1.0", "UTF-8", nil)
+    @doc.encoding.should == "UTF-8"
+  end
+
+  it "uses UTF-8 as default encoding" do
+    @doc.encoding.should == "UTF-8"
+  end
+end

data/spec/document/expanded_name_spec.rb

@@ -0,0 +1,15 @@
+require 'rexml/document'
+
+describe :document_expanded_name, :shared => true do
+  it "returns an empty string for root" do # root nodes have no expanded name
+    REXML::Document.new.send(@method).should == ""
+  end
+end
+
+describe "REXML::Document#expanded_name" do
+  it_behaves_like(:document_expanded_name, :expanded_name)
+end
+
+describe "REXML::Document#name" do
+  it_behaves_like(:document_expanded_name, :name)
+end

data/spec/document/new_spec.rb

@@ -0,0 +1,37 @@
+require 'rexml/document'
+
+describe "REXML::Document#new" do
+
+  it "initializes context of {} unless specified" do
+    d = REXML::Document.new("<foo />")
+    d.context.should == {}
+  end
+
+  it "has empty attributes if source is nil" do
+    d = REXML::Document.new(nil)
+    d.elements.should be_empty
+  end
+
+  it "can use other document context" do
+    s = REXML::Document.new("")
+    d = REXML::Document.new(s)
+    d.context.should == s.context
+  end
+
+  it "clones source attributes" do
+    s = REXML::Document.new("<root />")
+    s.attributes["some_attr"] = "some_val"
+    d = REXML::Document.new(s)
+    d.attributes.should == s.attributes
+  end
+
+  ruby_bug "#", "1.8.6.111" do
+    it "raises an error if source is not a Document, String or IO" do
+      lambda {s = REXML::Document.new(3)}.should raise_error(RuntimeError)
+    end
+  end
+
+  it "does not perform XML validation" do
+    REXML::Document.new("Invalid document").should be_kind_of(REXML::Document)
+  end
+end