representable 0.0.1.alpha1

data/test/unit/xml_block_test.rb

@@ -0,0 +1,81 @@
+require_relative './../test_helper'
+
+class ArrayWithBlockShorthand
+  include ROXML
+
+  xml_reader :array, :as => [Integer], :from => 'number'
+end
+
+class ArrayWithBlock
+  include ROXML
+
+  xml_reader :array, :as => [], :from => 'number' do |arr|
+    arr.map(&:to_i).reverse
+  end
+end
+
+class TestXMLBlocks < ActiveSupport::TestCase
+  def test_block_is_applied
+    muffins = Muffins.from_xml(fixture(:muffins))
+
+    assert muffins.count > 0
+    assert_equal 0, muffins.count % 13
+  end
+
+  def test_block_is_applied_to_hash
+    numerology = Numerology.from_xml(fixture(:numerology))
+
+    assert !numerology.predictions.keys.empty?
+    assert numerology.predictions.keys.all? {|k| k.is_a? Integer }
+    assert numerology.predictions.values.all? {|k| k.is_a? String }
+  end
+
+  def test_stacked_blocks_are_applied
+    muffins = MuffinsWithStackedBlocks.from_xml(fixture(:muffins))
+
+    assert muffins.count > 0
+    assert_equal 0, muffins.count % 13
+  end
+
+  def test_block_shorthand_applied_properly_to_array
+    obj = ArrayWithBlockShorthand.from_xml(%{
+      <array_with_block_shorthand>
+        <number>1</number>
+        <number>2</number>
+        <number>3</number>
+      </array_with_block_shorthand>
+    })
+
+    assert_equal [1, 2, 3], obj.array
+  end
+
+  def test_block_applied_properly_to_array
+    obj = ArrayWithBlock.from_xml(%{
+      <array_with_block>
+        <number>1</number>
+        <number>2</number>
+        <number>3</number>
+      </array_with_block>
+    })
+
+    assert_equal [3, 2, 1], obj.array
+  end
+
+  def test_block_shorthand_applied_properly_to_empty_array
+    obj = ArrayWithBlockShorthand.from_xml(%{
+      <array_with_block_shorthand>
+      </array_with_block_shorthand>
+    })
+
+    assert_equal [], obj.array
+  end
+
+  def test_block_applied_properly_to_empty_array
+    obj = ArrayWithBlock.from_xml(%{
+      <array_with_block>
+      </array_with_block>
+    })
+
+    assert_equal [], obj.array
+  end
+end

data/test/unit/xml_bool_test.rb

@@ -0,0 +1,122 @@
+require_relative './../test_helper'
+
+PROC_TRUE = proc {|val| val ? 'TRUE' : 'FALSE'}
+PROC_True = proc {|val| val ? 'True' : 'False'}
+PROC_true = proc {|val| val.to_s}
+PROC_1    = proc {|val| val ? 1 : 0}
+
+class XmlBool
+  include ROXML
+
+  xml_name 'xml_bool'
+  xml_reader :true_from_TRUE?, :to_xml => PROC_TRUE
+  xml_reader :false_from_FALSE?, :from => 'text_for_FALSE', :to_xml => PROC_TRUE
+  xml_reader :true_from_one?, :from => '@attr_for_one', :to_xml => PROC_1
+  xml_reader :false_from_zero?, :from => 'text_for_zero', :in => 'container', :to_xml => PROC_1
+  xml_reader :true_from_True?, :from => '@attr_for_True', :in => 'container', :to_xml => PROC_True
+  xml_reader :false_from_False?, :from => 'false_from_cdata_False', :cdata => true, :to_xml => PROC_True
+  xml_reader :true_from_true?, :to_xml => PROC_true
+  xml_reader :false_from_false?, :to_xml => PROC_true
+  xml_reader :missing?
+end
+
+class XmlBoolRequired
+  include ROXML
+
+  xml_reader :required?, :required => true
+end
+
+class XmlBoolUnexpected
+  include ROXML
+
+  xml_reader :unexpected?
+end
+
+class XmlBoolUnexpectedWithBlock
+  include ROXML
+
+  xml_reader :unexpected? do |val|
+    val
+  end
+end
+
+BOOL_XML = %{
+  <xml_bool attr_for_one="1">
+    <true_from_TRUE>TRUE</true_from_TRUE>
+    <text_for_FALSE>FALSE</text_for_FALSE>
+    <container attr_for_True="True">
+      <text_for_zero>0</text_for_zero>
+    </container>
+    <false_from_cdata_False><![CDATA[False]]></false_from_cdata_False>
+    <true_from_true>true</true_from_true>
+    <false_from_false>false</false_from_false>
+  </xml_bool>
+}
+PRESENT = %{
+  <xml_bool_required>
+    <required>true</required>
+  </xml_bool_required>
+}
+ABSENT = %{
+  <xml_bool_required>
+  </xml_bool_required>
+}
+UNEXPECTED_VALUE_XML = %{
+  <xml_bool_unexpected>
+    <unexpected>Unexpected Value</unexpected>
+  </xml_bool_unexpected>
+}
+
+
+class TestXMLBool < ActiveSupport::TestCase
+  def test_bool_results_for_various_inputs
+    x = XmlBool.from_xml(BOOL_XML)
+    assert_equal true, x.true_from_TRUE?
+    assert_equal false, x.false_from_FALSE?
+    assert_equal true, x.true_from_one?
+    assert_equal false, x.false_from_zero?
+    assert_equal true, x.true_from_True?
+    assert_equal false, x.false_from_False?
+    assert_equal true, x.true_from_true?
+    assert_equal false, x.false_from_false?
+  end
+
+  def test_missing_results_in_nil
+    x = XmlBool.from_xml(BOOL_XML)
+    assert_equal nil, x.missing?
+  end
+
+  def test_unexpected_value_results_in_nil
+    x = XmlBoolUnexpected.from_xml(UNEXPECTED_VALUE_XML)
+    assert_equal nil, x.unexpected?
+  end
+
+  def test_block_recieves_unexpected_value_rather_than_nil
+    x = XmlBoolUnexpectedWithBlock.from_xml(UNEXPECTED_VALUE_XML)
+    assert_equal "Unexpected Value", x.unexpected?
+  end
+
+  def test_required_raises_on_missing
+    assert_nothing_raised do
+      XmlBoolRequired.from_xml(PRESENT)
+    end
+
+    assert_raise ROXML::RequiredElementMissing do
+      XmlBoolRequired.from_xml(ABSENT)
+    end
+  end
+
+  def test_writable_references_properly_handle_punctuation
+    klass = Class.new do
+      include ROXML
+      xml_accessor :punctuation?
+    end
+
+    instance = klass.from_xml("<xml><punctuation>True</punctuation></xml>")
+    assert_equal true, instance.punctuation?
+    instance.punctuation = false
+    assert_equal false, instance.punctuation?
+  end
+
+  to_xml_test XmlBool => BOOL_XML
+end

data/test/unit/xml_convention_test.rb

@@ -0,0 +1,150 @@
+require_relative './../test_helper'
+
+XML_CAMELLOWER = %{
+  <bookCase name="Jonas' Books">
+    <bookCount>12</bookCount>
+    <bigBooks>
+      <bigBook>GED</bigBook>
+      <bigBook>House of Leaves</bigBook>
+    </bigBooks>
+  </bookCase>
+}
+
+XML_CAMELCASE = %{
+  <BookCase Name="Jonas' Books">
+    <BookCount>12</BookCount>
+    <BigBooks>
+      <BigBook>GED</BigBook>
+      <BigBook>House of Leaves</BigBook>
+    </BigBooks>
+  </BookCase>
+}
+
+XML_UNDERSCORE = %{
+  <book_case name="Jonas' Books">
+    <book_count>12</book_count>
+    <big_books>
+      <big_book>GED</big_book>
+      <big_book>House of Leaves</big_book>
+    </big_books>
+  </book_case>
+}
+
+XML_DASHES = %{
+  <book-case name="Jonas' Books">
+    <book-count>12</book-count>
+    <big-books>
+      <big-book>GED</big-book>
+      <big-book>House of Leaves</big-book>
+    </big-books>
+  </book-case>
+}
+
+XML_UPCASE = %{
+  <BOOKCASE NAME="Jonas' Books">
+    <BOOKCOUNT>12</BOOKCOUNT>
+    <BIGBOOKS>
+      <BIGBOOK>GED</BIGBOOK>
+      <BIGBOOK>House of Leaves</BIGBOOK>
+    </BIGBOOKS>
+  </BOOKCASE>
+}
+
+class BookCase
+  include ROXML
+
+  xml_reader :book_count, :as => Integer, :required => true
+  xml_reader :big_books, :as => [], :required => true
+end
+
+class BookCaseCamelCase < BookCase
+  xml_convention :camelcase
+end
+
+class BookCaseUnderScore < BookCase
+  xml_convention :underscore
+end
+
+class BookCaseDashes < BookCase
+  xml_convention &:dasherize
+end
+
+class BookCaseCamelLower < BookCase
+  xml_convention {|val| val.camelcase(:lower) }
+end
+
+class BookCaseUpCase < BookCase
+  xml_convention {|val| val.gsub('_', '').upcase }
+end
+
+class InheritedBookCaseCamelCase < BookCaseCamelCase
+end
+
+class InheritedBookCaseUpCase < BookCaseUpCase
+end
+
+# Same as BookCase.  Needed to keep BookCase clean for other tests
+class ParentBookCaseDefault
+  include ROXML
+
+  xml_reader :book_count, :as => Integer, :required => true
+  xml_reader :big_books, :as => [], :required => true
+end
+
+class InheritedBookCaseDefault < ParentBookCaseDefault
+end
+
+class TestXMLConvention < ActiveSupport::TestCase
+  # TODO: Test convention applies to xml_name as well...
+
+  def test_default_convention_is_underscore
+    bc = BookCase.from_xml(XML_UNDERSCORE)
+    assert_has_book_case_info(bc)
+  end
+
+  [BookCaseUpCase, BookCaseCamelLower, BookCaseDashes, BookCaseUnderScore, BookCaseCamelCase].each do |klass|
+    define_method(:"test_xml_convention_#{klass.to_s.underscore}") do
+      data = :"XML_#{klass.to_s.sub('BookCase', '').upcase}"
+      assert_equal Proc, klass.roxml_naming_convention.class
+
+      bc = klass.from_xml(Object.const_get(data))
+      assert_has_book_case_info(bc)
+    end
+  end
+
+  def test_child_should_inherit_convention_if_it_doesnt_declare_one
+    [InheritedBookCaseUpCase, InheritedBookCaseCamelCase].each do |klass|
+      data = :"XML_#{klass.to_s.sub('InheritedBookCase', '').upcase}"
+      assert_equal Proc, klass.roxml_naming_convention.class
+
+      bc = klass.from_xml(Object.const_get(data))
+      assert_has_book_case_info(bc)
+    end
+  end
+
+  def test_child_should_inherit_convention_even_if_it_is_added_after_child_declaration
+    bc = InheritedBookCaseDefault.from_xml(XML_UNDERSCORE)
+    assert_has_book_case_info(bc)
+
+    ParentBookCaseDefault.class_eval do
+      xml_convention :dasherize
+    end
+
+    bc = InheritedBookCaseDefault.from_xml(XML_DASHES)
+    assert_has_book_case_info(bc)
+    assert_raise ROXML::RequiredElementMissing do
+      InheritedBookCaseDefault.from_xml(XML_UNDERSCORE)
+    end
+  end
+
+  def test_tag_name_should_get_convention_treatment_as_well
+    assert_equal "book-case-dashes", BookCaseDashes.tag_name
+    assert_equal "INHERITEDBOOKCASEUPCASE", InheritedBookCaseUpCase.tag_name
+    assert_equal "InheritedBookCaseCamelCase", InheritedBookCaseCamelCase.tag_name
+  end
+
+  def assert_has_book_case_info(bc)
+    assert_equal 12, bc.book_count
+    assert_equal ['GED', 'House of Leaves'], bc.big_books
+  end
+end

data/test/unit/xml_hash_test.rb

@@ -0,0 +1,115 @@
+require_relative './../test_helper'
+
+class BookWithContributorHash
+  include ROXML
+
+  xml_reader :contributors, :as => {:key => '@role',
+                             :value => 'name'}
+end
+
+class TestXMLHash < ActiveSupport::TestCase
+  def setup
+    @contents = {'quaquaversally' => 'adjective: (of a geological formation) sloping downward from the center in all directions.',
+                 'tergiversate' => 'To use evasions or ambiguities; equivocate.'}
+  end
+
+  def test_hash_preserves_data
+    b = BookWithContributorHash.from_xml(%{
+      <book isbn="0974514055">
+        <contributor role="author"><name>David Thomas</name></contributor>
+        <contributor role="supporting author"><name>Andrew Hunt</name></contributor>
+        <contributor role="supporting author"><name>Chad Fowler</name></contributor>
+      </book>
+    })
+    assert_equal({'author' => 'David Thomas', 'supporting author' => ['Andrew Hunt', 'Chad Fowler']},
+      b.contributors)
+  end
+
+  def test_hash_with_object_key_fails
+    assert_raise ArgumentError do
+      Class.new do
+        include ROXML
+
+        xml_reader :object_key_to_text, :as => {:key => BookWithContributorHash,
+                                         :value => 'text_node'}
+      end
+    end
+  end
+
+  def test_hash_with_object_value_fails
+    assert_raise ArgumentError do
+      Class.new do
+        include ROXML
+
+        xml_reader :key_to_object_value, :as => {:key => '@text_node',
+                                          :value => BookWithContributorHash}
+      end
+    end
+  end
+
+  def test_attrs_hash
+    dict = DictionaryOfAttrs.from_xml(fixture(:dictionary_of_attrs))
+    assert_equal Hash, dict.definitions.class
+    assert_equal @contents, dict.definitions
+  end
+
+  def test_text_hash
+    dict = DictionaryOfTexts.from_xml(fixture(:dictionary_of_texts))
+    assert_equal Hash, dict.definitions.class
+    assert_equal @contents, dict.definitions
+  end
+
+  def test_mixed_content_hash
+    dict = DictionaryOfMixeds.from_xml(fixture(:dictionary_of_mixeds))
+    assert_equal Hash, dict.definitions.class
+    assert_equal @contents, dict.definitions
+  end
+
+  def test_name_hash
+    dict = DictionaryOfNames.from_xml(fixture(:dictionary_of_names))
+    assert_equal Hash, dict.definitions.class
+    assert_equal @contents, dict.definitions
+  end
+
+  def test_guarded_name_hash
+    dict = DictionaryOfGuardedNames.from_xml(fixture(:dictionary_of_guarded_names))
+    assert_equal Hash, dict.definitions.class
+    assert_equal @contents, dict.definitions
+  end
+
+  def test_text_name_clashes
+    dict = DictionaryOfNameClashes.from_xml(fixture(:dictionary_of_name_clashes))
+    assert_equal Hash, dict.definitions.class
+    assert_equal @contents, dict.definitions
+  end
+
+  def test_attr_name_clashes
+    dict = DictionaryOfAttrNameClashes.from_xml(fixture(:dictionary_of_attr_name_clashes))
+    assert_equal Hash, dict.definitions.class
+    assert_equal @contents, dict.definitions
+  end
+
+  def test_it_should_gracefully_handle_empty_hash
+    dict = Class.new do
+      include ROXML
+
+      xml_reader :missing_hash, :as => {:key => :name, :value => :content}, :in => 'EmptyDictionary'
+    end
+
+    assert_equal({}, dict.from_xml(%{
+      <dict>
+        <EmptyDictionary>
+        </EmptyDictionary>
+      </dict>
+    }).missing_hash)
+  end
+
+  def test_as_hash_of_as_type_not_deprecated
+    assert_not_deprecated do
+      opts = ROXML::Definition.new(:name, :as => {:key => :name, :value => {:from => 'value', :as => OctalInteger}})
+      assert opts.hash?
+      assert_equal OctalInteger, opts.hash.value.sought_type
+      assert_equal 'value', opts.hash.value.name
+    end
+  end
+end