xml-mapping_extensions 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4fea3e32640619a2a820288fe42d28a8087062dc
+  data.tar.gz: f141e3b7ccc655cc8f2a09141c0e32f266dac8c4
+SHA512:
+  metadata.gz: 6530a2a270d47f95a11d909304b0899080cf315d6f6e7929ff2ac5d6400479130d2dfd7be8a5ea77ebbd9450f5ac1f129d11bb2b1aa1e5c0deac41d9b4305b4c
+  data.tar.gz: 8db7ece8cf07717ddecb34f837f71dd68792f47e4e593bfd36db241061030839d1b1f4982ae184bcd519c6d4110d5bb966e98442b6cc67b0310fc9273d36ccb3

data/.gitignore

@@ -0,0 +1,42 @@
+# Ruby defaults
+
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+
+# Rails engine
+
+.bundle/
+log/*.log
+spec/dummy/db/*.sqlite3
+spec/dummy/db/*.sqlite3-journal
+spec/dummy/log/*.log
+spec/dummy/tmp/
+spec/dummy/.sass-cache
+
+# IntellJ
+
+*.iml
+*.ipr
+*.iws
+.rakeTasks
+.idea
+
+# Emacs
+
+*~
+
+# Mac OS
+
+.DS_Store

data/.rubocop.yml

@@ -0,0 +1,19 @@
+# Disable line-length check; it's too easy for the cure to be worse than the disease
+Metrics/LineLength:
+  Enabled: False
+
+# Disable problematic module documentation check (see https://github.com/bbatsov/rubocop/issues/947)
+Style/Documentation:
+  Enabled: false
+
+# Allow one line around class body (Style/EmptyLines will still disallow two or more)
+Style/EmptyLinesAroundClassBody:
+  Enabled: false
+
+# Allow one line around module body (Style/EmptyLines will still disallow two or more)
+Style/EmptyLinesAroundModuleBody:
+  Enabled: false
+
+# Allow one line around block body (Style/EmptyLines will still disallow two or more)
+Style/EmptyLinesAroundBlockBody:
+  Enabled: false

data/.ruby-version

@@ -0,0 +1 @@
+2.2.2

data/.yardopts

@@ -0,0 +1 @@
+--markup markdown

data/CHANGES.md

@@ -0,0 +1,3 @@
+## 0.1.0 (21 Sep 2015)
+
+- Initial release

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.md

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 The Regents of the University of California
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,26 @@
+# XML::MappingExtensions [![Build Status](https://travis-ci.org/dmolesUC3/xml-mapping_extensions.png?branch=master)](https://travis-ci.org/dmolesUC3/xml-mapping_extensions) [![Code Climate](https://codeclimate.com/github/dmolesUC3/xml-mapping_extensions.png)](https://codeclimate.com/github/dmolesUC3/xml-mapping_extensions) [![Inline docs](http://inch-ci.org/github/dmolesUC3/xml-mapping_extensions.png)](http://inch-ci.org/github/dmolesUC3/xml-mapping_extensions)
+
+
+Additional mapping nodes and other utility classes for working with
+[XML::Mapping](http://multi-io.github.io/xml-mapping/).
+
+## Usage
+
+Require `xml/mapping_extensions` and extend one of the abstract node
+classes, or use one of the provided implementations.
+
+### Abstract nodes
+
+- `NodeBase`: Base class for simple single-attribute nodes that
+   convert XML strings to object values.
+- `EnumNodeBase`: maps XML strings to `Ruby::Enum` values
+
+Note that you must call `::XML::Mapping.add_node_class` for your new node class
+to be registered with the XML mapping engine.
+
+### Provided implementations
+
+- `DateNode`: maps XML Schema dates to `Date` objects
+- `TimeNode`: ISO 8601 strings to `Time` objects
+- `UriNode`: maps URI strings to `URI` objects
+- `MimeTypeNode`: maps MIME type strings to `MIME::Type` objects

data/Rakefile

@@ -0,0 +1,56 @@
+# ------------------------------------------------------------
+# RSpec
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+namespace :spec do
+
+  desc 'Run all unit tests'
+  RSpec::Core::RakeTask.new(:unit) do |task|
+    task.rspec_opts = %w(--color --format documentation --order default)
+    task.pattern = 'unit/**/*_spec.rb'
+  end
+
+  desc 'Run all acceptance tests'
+  RSpec::Core::RakeTask.new(:acceptance) do |task|
+    ENV['COVERAGE'] = nil
+    task.rspec_opts = %w(--color --format documentation --order default)
+    task.pattern = 'acceptance/**/*_spec.rb'
+  end
+
+  task all: [:unit, :acceptance]
+end
+
+desc 'Run all tests'
+task spec: 'spec:all'
+
+# ------------------------------------------------------------
+# Coverage
+
+desc 'Run all unit tests with coverage'
+task :coverage do
+  ENV['COVERAGE'] = 'true'
+  Rake::Task['spec:unit'].execute
+end
+
+# ------------------------------------------------------------
+# RuboCop
+
+require 'rubocop/rake_task'
+RuboCop::RakeTask.new
+
+# ------------------------------------------------------------
+# TODOs
+
+desc 'List TODOs (from spec/todo.rb)'
+RSpec::Core::RakeTask.new(:todo) do |task|
+  task.rspec_opts = %w(--color --format documentation --order default)
+  task.pattern = 'todo.rb'
+end
+
+# ------------------------------------------------------------
+# Defaults
+
+desc 'Run unit tests, check test coverage, run acceptance tests, check code style'
+task default: [:coverage, 'spec:acceptance', :rubocop]

data/lib/xml/mapping_extensions/date_node.rb

@@ -0,0 +1,26 @@
+require_relative 'node_base'
+
+require 'time'
+
+module XML
+  module MappingExtensions
+    # XML mapping for XML Schema dates.
+    # Known limitation: loses time zone info
+    class DateNode < NodeBase
+
+      # param xml_text [String] an XML Schema date
+      # @return [Date] the value as a `Date`
+      def to_value(xml_text)
+        Date.xmlschema(xml_text)
+      end
+
+      # @param value [Date] the value as a `Date`
+      # @return [String] the value as an XML Schema date string, without
+      #   time zone information
+      def to_xml_text(value)
+        value.xmlschema
+      end
+    end
+    ::XML::Mapping.add_node_class DateNode
+  end
+end

data/lib/xml/mapping_extensions/enum_node_base.rb

@@ -0,0 +1,24 @@
+require_relative 'node_base'
+
+require 'ruby-enum'
+
+module XML
+  module MappingExtensions
+
+    # Base class for single-attribute nodes with `Ruby::Enum` values
+    #
+    # Usage:
+    #   - extend this class
+    #   - add an `ENUM_CLASS` constant whose value is the `Ruby::Enum` class
+    #     to be mapped
+    #   - call `::XML::Mapping.add_node_class` to add your new node class
+    class EnumNodeBase < NodeBase
+
+      def to_value(xml_text)
+        enum_class = self.class::ENUM_CLASS
+        enum_class.parse(xml_text)
+      end
+
+    end
+  end
+end

data/lib/xml/mapping_extensions/mime_type_node.rb

@@ -0,0 +1,26 @@
+require_relative 'node_base'
+
+require 'mime-types'
+
+module XML
+  module MappingExtensions
+
+    # Converts MIME type strings to `MIME::Type` objects
+    class MimeTypeNode < NodeBase
+
+      # Converts a MIME type string to a `MIME::Type` object,
+      # either the first corresponding value in the `MIME::Types`
+      # registry, or a newly created value.
+      # @param xml_text the MIME type string
+      # @return [MIME::Type] the corresponding `MIME::Type`
+      def to_value(xml_text)
+        if (mt = MIME::Types[xml_text].first)
+          mt
+        else
+          MIME::Type.new(xml_text)
+        end
+      end
+    end
+    ::XML::Mapping.add_node_class MimeTypeNode
+  end
+end

data/lib/xml/mapping_extensions/node_base.rb

@@ -0,0 +1,56 @@
+require 'xml/mapping'
+
+module XML
+  module MappingExtensions
+
+    # Base class for simple single-attribute nodes that convert
+    # XML strings to object values.
+    #
+    # Usage:
+    #   - extend this class
+    #   - override `to_value` (and, optionally, `to_xml_text`) to do your conversion
+    #   - call `::XML::Mapping.add_node_class` to add your new node class
+    class NodeBase < ::XML::Mapping::SingleAttributeNode
+
+      # See `::XML::Mapping::SingleAttributeNode#initialize`
+      def initialize(*args)
+        path, *args = super(*args)
+        @path = ::XML::XXPath.new(path)
+        args
+      end
+
+      # Implements `::XML::Mapping::SingleAttributeNode#extract_attr_value`.
+      # @param xml [Element] The XML element to extract the value from
+      # @return [Object, nil] the mapped value, or nil if
+      def extract_attr_value(xml)
+        xml_text = default_when_xpath_err { @path.first(xml).text }
+        to_value(xml_text) if xml_text
+      end
+
+      # Implements `::XML::Mapping::SingleAttributeNode#set_attr_value`.
+      # The object value is passed to `to_xml_text` for string conversion.
+      # @param xml [Element] The XML element to write to
+      # @param value [Object] The value to write
+      def set_attr_value(xml, value)
+        text = to_xml_text(value)
+        @path.first(xml, ensure_created: true).text = text
+      end
+
+      # Override this method to convert XML text to an object value
+      # @param _xml_text [String] The XML string to parse
+      # @return [Object] The object value
+      def to_value(_xml_text)
+        fail NoMethodError, "#{self.class} should override #to_value to convert an XML string to an object value"
+      end
+
+      # Override this method to convert object values to XML text.
+      # The default implementation simply calls `to_s`.
+      # @param value [Object] The object value to convert
+      # @return [String] The XML string to write
+      def to_xml_text(value)
+        value.to_s
+      end
+
+    end
+  end
+end

data/lib/xml/mapping_extensions/time_node.rb

@@ -0,0 +1,24 @@
+require_relative 'node_base'
+
+module XML
+  module MappingExtensions
+
+    # Maps `Time` objects to ISO 8601 strings.
+    class TimeNode < NodeBase
+
+      # param xml_text [String] an ISO 8601 datetime value
+      # @return [Time] the value as a UTC `Time`
+      def to_value(xml_text)
+        Time.iso8601(xml_text).utc
+      end
+
+      # @param value [Time] the value as a `Time`
+      # @return the value as an ISO 8601 string
+      def to_xml_text(value)
+        value.utc.iso8601
+      end
+    end
+    ::XML::Mapping.add_node_class TimeNode
+
+  end
+end

data/lib/xml/mapping_extensions/uri_node.rb

@@ -0,0 +1,18 @@
+require_relative 'node_base'
+
+require 'uri'
+
+module XML
+  module MappingExtensions
+    # Coverts URI strings to `URI` objects.
+    class UriNode < NodeBase
+      # @param xml_text [String] the URI string to convert
+      # @return [URI] the URI
+      # @raise [URI::InvalidURIError] if `xml_text` is not a valid URI.
+      def to_value(xml_text)
+        URI(xml_text.strip)
+      end
+    end
+    ::XML::Mapping.add_node_class UriNode
+  end
+end

data/lib/xml/mapping_extensions/version.rb

@@ -0,0 +1,6 @@
+module XML
+  module MappingExtensions
+    # The version of this gem
+    VERSION = '0.1.0'
+  end
+end

data/lib/xml/mapping_extensions.rb

@@ -0,0 +1,7 @@
+module XML
+  # Additional mapping nodes and other utility classes for working with
+  # [XML::Mapping](http://multi-io.github.io/xml-mapping/)
+  module MappingExtensions
+    Dir.glob(File.expand_path('../mapping_extensions/*.rb', __FILE__), &method(:require))
+  end
+end

data/spec/rspec_custom_matchers.rb

@@ -0,0 +1,47 @@
+require 'rspec/expectations'
+require 'mime/types'
+
+RSpec::Matchers.define :be_time do |expected|
+
+  def to_string(time)
+    time.is_a?(Time) ? time.utc.round(2).iso8601(2) : time.to_s
+  end
+
+  match do |actual|
+    if expected
+      fail "Expected value #{expected} is not a Time" unless expected.is_a?(Time)
+      actual.is_a?(Time) && (to_string(expected) == to_string(actual))
+    else
+      return actual.nil?
+    end
+  end
+
+  failure_message do |actual|
+    expected_str = to_string(expected)
+    actual_str = to_string(actual)
+    "expected time:\n#{expected_str}\n\nbut was:\n#{actual_str}"
+  end
+end
+
+def to_mime_type(mime_type)
+  return nil unless mime_type
+  return mime_type if mime_type.is_a?(MIME::Type)
+
+  mt = MIME::Types[mime_type].first
+  return mt if mt
+
+  MIME::Type.new(mime_type)
+end
+
+RSpec::Matchers.define :be_mime_type do |expected|
+
+  expected_mime_type = to_mime_type(expected)
+
+  match do |actual|
+    actual == expected_mime_type
+  end
+
+  failure_message do |actual|
+    "expected MIME type:\n#{expected_mime_type}\nbut was:\n#{actual}"
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,36 @@
+# ------------------------------------------------------------
+# SimpleCov/CodeClimate setup
+
+if ENV['COVERAGE']
+  if ENV['CODECLIMATE_REPO_TOKEN']
+    require 'codeclimate-test-reporter'
+    CodeClimate::TestReporter.start
+  end
+
+  require 'simplecov'
+  require 'simplecov-console'
+
+  SimpleCov.minimum_coverage 100
+  SimpleCov.start do
+    add_filter '/spec/'
+    SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+        SimpleCov::Formatter::HTMLFormatter,
+        SimpleCov::Formatter::Console,
+    ]
+  end
+end
+
+# ------------------------------------------------------------
+# Rspec configuration
+
+RSpec.configure do |config|
+  config.raise_errors_for_deprecations!
+  config.mock_with :rspec
+end
+
+require 'rspec_custom_matchers'
+
+# ------------------------------------------------------------
+# XML::MappingExtensions
+
+require 'xml/mapping_extensions'

data/spec/unit/xml/mapping_extensions/date_node_spec.rb

@@ -0,0 +1,54 @@
+require 'spec_helper'
+
+module XML
+  module MappingExtensions
+    class DateNodeSpecElem
+      include ::XML::Mapping
+      date_node :date, '@date', default_value: nil
+
+      def self.from_str(date_str)
+        xml_string = "<elem date='#{date_str}'/>"
+        doc = REXML::Document.new(xml_string)
+        load_from_xml(doc.root)
+      end
+    end
+    describe DateNode do
+
+      def to_date(str)
+        DateNodeSpecElem.from_str(str).date
+      end
+
+      def to_text(date)
+        elem = DateNodeSpecElem.new
+        elem.date = date
+        xml = elem.save_to_xml
+        xml.attributes['date']
+      end
+
+      it 'parses a date' do
+        actual = to_date('2002-09-24')
+        expected = Date.new(2002, 9, 24)
+        expect(actual).to eq(expected)
+      end
+
+      it 'parses a UTC "zulu" date (time zone designator "Z")' do
+        actual = to_date('2002-09-24Z')
+        expected = Date.new(2002, 9, 24)
+        expect(actual).to eq(expected)
+      end
+
+      it 'parses a date with a numeric timezone offset' do
+        actual = to_date('2002-09-24-06:00')
+        expected = Date.new(2002, 9, 24)
+        expect(actual).to eq(expected)
+      end
+
+      it 'outputs a date' do
+        expected = '2002-09-24'
+        actual = to_text(Date.new(2002, 9, 24))
+        expect(actual).to eq(expected)
+      end
+
+    end
+  end
+end

data/spec/unit/xml/mapping_extensions/enum_node_base_spec.rb

@@ -0,0 +1,58 @@
+require 'spec_helper'
+
+module XML
+  module MappingExtensions
+
+    class MyEnum
+      include Ruby::Enum
+
+      define :FOO, 'foo'
+      define :BAR, 'bar'
+    end
+
+    class MyEnumNode < EnumNodeBase
+      ENUM_CLASS = MyEnum
+    end
+    ::XML::Mapping.add_node_class(MyEnumNode)
+
+    class EnumNodeBaseSpecElem
+      include ::XML::Mapping
+      my_enum_node :my_enum, '@my_enum', default_value: nil
+
+      def self.from_str(enum_str)
+        xml_string = enum_str ? "<elem my_enum='#{enum_str}'/>" : '<elem/>'
+        doc = REXML::Document.new(xml_string)
+        load_from_xml(doc.root)
+      end
+    end
+    describe EnumNodeBase do
+
+      def to_my_enum(str)
+        EnumNodeBaseSpecElem.from_str(str).my_enum
+      end
+
+      def to_text(enum)
+        elem = EnumNodeBaseSpecElem.new
+        elem.my_enum = enum
+        xml = elem.save_to_xml
+        xml.attributes['my_enum']
+      end
+
+      it 'parses an enum value' do
+        expect(to_my_enum('foo')).to eq(MyEnum::FOO)
+      end
+
+      it 'transforms an enum to a string' do
+        expect(to_text(MyEnum::BAR)).to eq('bar')
+      end
+
+      it 'parses a missing value as nil' do
+        expect(to_my_enum(nil)).to be_nil
+      end
+
+      it 'doesn\'t set an attribute for a nil value' do
+        expect(to_text(nil)).to be_nil
+      end
+    end
+  end
+end

data/spec/unit/xml/mapping_extensions/mime_type_node_spec.rb

@@ -0,0 +1,52 @@
+require 'spec_helper'
+
+module XML
+  module MappingExtensions
+
+    class MimeTypeSpecElem
+      include XML::Mapping
+      mime_type_node :mime_type, '@mime_type', default_value: nil
+
+      def self.from_str(mt_string)
+        xml_string = mt_string ? "<elem mime_type='#{mt_string}'/>" : '<elem/>'
+        doc = REXML::Document.new(xml_string)
+        load_from_xml(doc.root)
+      end
+    end
+
+    describe MimeTypeNode do
+      def to_mime_type(str)
+        MimeTypeSpecElem.from_str(str).mime_type
+      end
+
+      def to_text(mime_type)
+        elem = MimeTypeSpecElem.new
+        elem.mime_type = mime_type
+        xml = elem.save_to_xml
+        xml.attributes['mime_type']
+      end
+
+      it 'accepts a standard MIME type' do
+        mt_str = 'text/plain'
+        mt = MIME::Types[mt_str].first
+        expect(to_mime_type(mt_str)).to eq(mt)
+      end
+
+      it 'accepts a non-standard MIME type' do
+        mt_str = 'elvis/presley'
+        mt = MIME::Type.new(mt_str)
+        expect(to_mime_type(mt_str)).to eq(mt)
+      end
+
+      it 'doesn\'t set an attribute for a nil value' do
+        expect(to_text(nil)).to be_nil
+      end
+
+      it 'fails if mime_type isn\'t a MIME type' do
+        mt_str = 'I am not a mime type'
+        expect { to_mime_type(mt_str) }.to raise_error(MIME::Type::InvalidContentType)
+      end
+
+    end
+  end
+end

data/spec/unit/xml/mapping_extensions/node_base_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+module XML
+  module MappingExtensions
+
+    class SomeMappingClass
+      include ::XML::Mapping
+    end
+
+    describe NodeBase do
+      before :each do
+        @node = NodeBase.new(SomeMappingClass, :attr_name, 'attr_name')
+      end
+
+      describe '#extract_attr_value' do
+        it 'forwards to #to_value'
+      end
+
+      describe '#set_attr_value' do
+        it 'forwards to #to_xml_text'
+      end
+
+      describe '#xml_text' do
+        it 'should be abstract' do
+          expect { @node.to_value('some text') }.to raise_error(NoMethodError)
+        end
+      end
+
+      describe '#to_xml_text' do
+        it 'should call to_s by default' do
+          values = ['elvis', 123, Object.new]
+          values.each do |v|
+            expect(@node.to_xml_text(v)).to eq(v.to_s)
+          end
+        end
+      end
+    end
+  end
+end

data/spec/unit/xml/mapping_extensions/time_node_spec.rb

@@ -0,0 +1,72 @@
+require 'spec_helper'
+
+module XML
+  module MappingExtensions
+    class TimeNodeSpecElem
+      include ::XML::Mapping
+      time_node :time, '@time', default_value: nil
+
+      def self.from_str(time_str)
+        xml_string = "<elem time='#{time_str}'/>"
+        doc = REXML::Document.new(xml_string)
+        load_from_xml(doc.root)
+      end
+    end
+    describe TimeNode do
+
+      def to_time(str)
+        TimeNodeSpecElem.from_str(str).time
+      end
+
+      def to_text(time)
+        elem = TimeNodeSpecElem.new
+        elem.time = time
+        xml = elem.save_to_xml
+        xml.attributes['time']
+      end
+
+      it 'parses a date with hours, minutes, and seconds' do
+        actual = to_time('1997-07-16T19:20:30')
+        expected = Time.new(1997, 7, 16, 19, 20, 30)
+        expect(actual).to be_time(expected)
+      end
+
+      it 'parses a date with hours, minutes, seconds, and fractional seconds' do
+        actual = to_time('1997-07-16T19:20:30.45')
+        expected = Time.new(1997, 7, 16, 19, 20, 30.45)
+        expect(actual).to be_time(expected)
+      end
+
+      it 'parses a UTC "zulu" time (time zone designator "Z")' do
+        actual = to_time('1997-07-16T19:20:30.45Z')
+        expected = Time.new(1997, 7, 16, 19, 20, 30.45, '+00:00')
+        expect(actual).to be_time(expected)
+      end
+
+      it 'parses a time with a numeric timezone offset' do
+        actual = to_time('1997-07-16T19:20:30.45+01:30')
+        expected = Time.new(1997, 7, 16, 19, 20, 30.45, '+01:30')
+        expect(actual).to be_time(expected)
+      end
+
+      it 'outputs a date with hours, minutes, and seconds' do
+        expected = '1997-07-16T19:20:30Z'
+        actual = to_text(Time.utc(1997, 7, 16, 19, 20, 30))
+        expect(actual).to eq(expected)
+      end
+
+      it 'truncates fractional seconds' do
+        expected = '1997-07-16T19:20:30Z'
+        actual = to_text(Time.utc(1997, 7, 16, 19, 20, 30))
+        expect(actual).to eq(expected)
+      end
+
+      it 'outputs a time with a numeric timezone offset as UTC' do
+        expected = '1997-07-16T17:50:30Z'
+        actual = to_text(Time.new(1997, 7, 16, 19, 20, 30, '+01:30'))
+        expect(actual).to eq(expected)
+      end
+
+    end
+  end
+end

data/spec/unit/xml/mapping_extensions/uri_node_spec.rb

@@ -0,0 +1,57 @@
+require 'spec_helper'
+
+module XML
+  module MappingExtensions
+
+    class UriNodeSpecElem
+      include XML::Mapping
+      uri_node :uri, '@uri', default_value: nil
+
+      def self.from_str(uri_str)
+        xml_string = uri_str ? "<elem uri='#{uri_str}'/>" : '<elem/>'
+        doc = REXML::Document.new(xml_string)
+        load_from_xml(doc.root)
+      end
+    end
+
+    describe UriNode do
+
+      def to_uri(str)
+        UriNodeSpecElem.from_str(str).uri
+      end
+
+      def to_text(uri)
+        elem = UriNodeSpecElem.new
+        elem.uri = uri
+        xml = elem.save_to_xml
+        xml.attributes['uri']
+      end
+
+      it 'parses a URI' do
+        uri_str = 'http://example.org/'
+        expect(to_uri(uri_str)).to eq(URI(uri_str))
+      end
+
+      it 'strips whitespace' do
+        uri_str = 'http://example.org/'
+        expect(to_uri(" #{uri_str} ")).to eq(URI(uri_str))
+      end
+
+      it 'fails on a malformed URI' do
+        bad_uri = 'I am not a URI'
+        expect { to_uri(" #{bad_uri} ") }.to raise_error(URI::InvalidURIError)
+      end
+
+      it 'transforms a URI to a string' do
+        uri_str = 'http://example.org/'
+        expect(to_text(URI(uri_str))).to eq(uri_str)
+      end
+
+      it 'doesn\'t set an attribute for a nil value' do
+        expect(to_text(nil)).to be_nil
+      end
+
+    end
+
+  end
+end

data/xml-mapping_extensions.gemspec

@@ -0,0 +1,36 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'uri'
+require 'xml/mapping_extensions/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'xml-mapping_extensions'
+  spec.version = XML::MappingExtensions::VERSION
+  spec.authors = ['David Moles']
+  spec.email = ['david.moles@ucop.edu']
+  spec.summary = 'Some extensions for for XML::Mapping'
+  spec.description = 'Mapping nodes and other utility classes extending XML::Mapping'
+  spec.license = 'MIT'
+
+  origin_uri = URI(`git config --get remote.origin.url`.chomp)
+  spec.homepage = URI::HTTP.build(host: origin_uri.host, path: origin_uri.path.chomp('.git')).to_s
+
+  spec.files = `git ls-files -z`.split("\x0")
+  spec.executables = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'mime-types', '~> 2.5'
+  spec.add_dependency 'ruby-enum', '~> 0.4'
+  spec.add_dependency 'xml-mapping', '~> 0.10'
+
+  spec.add_development_dependency 'rake', '~> 10.4'
+  spec.add_development_dependency 'rspec', '~> 3.2'
+  spec.add_development_dependency 'rubocop', '~> 0.32.1'
+  spec.add_development_dependency 'simplecov', '~> 0.9.2'
+  spec.add_development_dependency 'simplecov-console', '~> 0.2.0'
+  spec.add_development_dependency 'yard', '~> 0.8'
+  spec.add_development_dependency 'codeclimate-test-reporter'
+end

metadata

@@ -0,0 +1,219 @@
+--- !ruby/object:Gem::Specification
+name: xml-mapping_extensions
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- David Moles
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-09-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mime-types
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: ruby-enum
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: xml-mapping
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.32.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.32.1
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+- !ruby/object:Gem::Dependency
+  name: simplecov-console
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: codeclimate-test-reporter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Mapping nodes and other utility classes extending XML::Mapping
+email:
+- david.moles@ucop.edu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- ".ruby-version"
+- ".yardopts"
+- CHANGES.md
+- Gemfile
+- LICENSE.md
+- README.md
+- Rakefile
+- lib/xml/mapping_extensions.rb
+- lib/xml/mapping_extensions/date_node.rb
+- lib/xml/mapping_extensions/enum_node_base.rb
+- lib/xml/mapping_extensions/mime_type_node.rb
+- lib/xml/mapping_extensions/node_base.rb
+- lib/xml/mapping_extensions/time_node.rb
+- lib/xml/mapping_extensions/uri_node.rb
+- lib/xml/mapping_extensions/version.rb
+- spec/rspec_custom_matchers.rb
+- spec/spec_helper.rb
+- spec/unit/xml/mapping_extensions/date_node_spec.rb
+- spec/unit/xml/mapping_extensions/enum_node_base_spec.rb
+- spec/unit/xml/mapping_extensions/mime_type_node_spec.rb
+- spec/unit/xml/mapping_extensions/node_base_spec.rb
+- spec/unit/xml/mapping_extensions/time_node_spec.rb
+- spec/unit/xml/mapping_extensions/uri_node_spec.rb
+- xml-mapping_extensions.gemspec
+homepage: http://github.com/dmolesUC3/xml-mapping_extensions
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.6
+signing_key: 
+specification_version: 4
+summary: Some extensions for for XML::Mapping
+test_files:
+- spec/rspec_custom_matchers.rb
+- spec/spec_helper.rb
+- spec/unit/xml/mapping_extensions/date_node_spec.rb
+- spec/unit/xml/mapping_extensions/enum_node_base_spec.rb
+- spec/unit/xml/mapping_extensions/mime_type_node_spec.rb
+- spec/unit/xml/mapping_extensions/node_base_spec.rb
+- spec/unit/xml/mapping_extensions/time_node_spec.rb
+- spec/unit/xml/mapping_extensions/uri_node_spec.rb
+has_rdoc: