client_for_poslynx 0.1.1 → 0.2.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    NDk4YjBkNTE0MzhlOGU3MThjNDc1MmYxOTA4MWRmZDM4YmU1ZGM4OQ==
+    NzJjNDczYjYzYzBiMTE1MDI3YTQ4Mjk1M2Y4OGM3ZTM4YTc5NzdhOA==
   data.tar.gz: !binary |-
-    NGNmMTc0ODljNWFlYzE2MmFhMzJkMjhmYmE0NzQ5NWU0NWY0MWUzMg==
+    MzgxZGMxZGE4MWQ2ZTc5Yjc3Mjg1MzIzNzJkNDRiZjRkN2M5OGQzZA==
 SHA512:
   metadata.gz: !binary |-
-    MTA1ODAwOTA4YTRlOWM3ZDdmYzhjM2IyYTJmODY4ZDJkMTBjMGM5YWNiZmQ0
-    YWI3YmIyNjI5MDFmNWY4NTEwYmI3YWY1YWM1Yjc5ZjFiYjg0YTAyM2NmNGNm
-    MDg0NDQ1ZGQyMGFkYmUzOTc2NDE2YWRhYWMzMDIzODEwYjgxMWU=
+    MTMzZTM0OGI5YThhNmI0ODZiNjllN2ZiMjI4OWFlMTM0N2VkYWVlNDRkMTZm
+    NWUzNTMwMjJkNTgyODYxMDBlYzI3YWNmMTk4MjMxYmE4YWM3OTExNzQ5MmI5
+    MTVkZGVlNmYyODZjNjFhOTM3MzAzZDA1ODJhNjZkNWZjNmU0ODE=
   data.tar.gz: !binary |-
-    Mzk4MzMxNWU5ZTFkYmU1NTFmOTZiNjEyMTViZDg0MWY5NTllM2JkNWM5MTI2
-    ZTNkNGM4NWU5Nzg2NzQzMjliMTdhYzIwMTViNjM1YTQ4NTA2NjBhYzRiNTY5
-    MzYyZjU4ZmJlNjVkYjE3NTc3M2EwNmJhYWJiNzJlYmYyNTFkNjM=
+    NTQwZDEyZGI0YWM4MjExNjBiOGU5M2MxNzcwNDY0M2ZhYmVkZjAwYmI2NzYw
+    MjBlZDhmMTM3N2M5ZDA5MDkxZmE3YmNmZDFlZjQwZjNhNmUzN2JmZDc2ZTkx
+    ZDI2MmExMDg0ZmVhYTBmNzdkNjlhM2I2ZTlmN2QxZjViYzkxNWY=

data/CHANGELOG

@@ -6,3 +6,6 @@ Version 0.1.0
 
 Version 0.1.1
 - Add CHANGELOG file
+
+Version 0.2.0
+- Improve API for specifying attribute element mappings.

data/lib/client_for_poslynx/data/abstract_data.rb

@@ -1,6 +1,7 @@
 # coding: utf-8
 
-require 'nokogiri'
+require_relative 'abstract_data/attribute_element_mapping'
+require_relative 'abstract_data/defining_property_mapping'
 
 module ClientForPoslynx
   module Data
@@ -16,22 +17,16 @@ module ClientForPoslynx
         end
 
         def xml_parse(source_xml)
-          doc = XmlDocument.new( source_xml )
-          concrete_data_classes = descendants.
-            reject{ |d| d.name =~ /\bAbstract[A-Z]\w*$/ }.
-            sort_by{ |d| -d.ancestors.length }
-          data_class = concrete_data_classes.detect{ |dc|
-            dc.root_element_name == doc.root_name &&
-            dc.fits_properties?( doc.property_element_contents )
-          }
-          data_class.xml_deserialize(source_xml)
+          doc = XmlDocument.from_xml( source_xml )
+          data_class = concrete_data_class_for_nokogiri_document( doc )
+          data_class.xml_deserialize( source_xml )
         end
 
         def xml_deserialize(xml)
-          doc = XmlDocument.new(xml)
-          raise InvalidXmlContentError, "#{root_element_name} root element not found" unless doc.root_name == root_element_name
+          doc = XmlDocument.from_xml( xml )
+          doc.verify_root_element_name root_element_name
           instance = load_from_properties( doc.property_element_contents )
-          instance.source_data = doc.source_xml
+          instance.source_data = xml
           instance
         end
 
@@ -48,22 +43,20 @@ module ClientForPoslynx
           unmatched.empty?
         end
 
-        def defining_element_mappings
-          @defining_element_mappings ||=
-            begin
-              self == AbstractData ?
-                [] :
-                superclass.defining_element_mappings + []
-            end
+        def defining_property_mappings
+          @defining_property_mappings ||= (
+            self == AbstractData ?
+              [] :
+              superclass.defining_property_mappings + []
+          )
         end
 
         def attr_element_mappings
-          @attr_element_mappings ||=
-            begin
-              self == AbstractData ?
-                [] :
-                superclass.attr_element_mappings + []
-            end
+          @attr_element_mappings ||= (
+            self == AbstractData ?
+              [] :
+              superclass.attr_element_mappings + []
+          )
         end
 
         private
@@ -76,72 +69,63 @@ module ClientForPoslynx
           @@descendants ||= []
         end
 
-        def defining_element_value(options)
+        def concrete_data_class_for_nokogiri_document(doc)
+          data_class = concrete_data_classes.detect{ |dc|
+            dc.root_element_name == doc.root_name &&
+            dc.fits_properties?( doc.property_element_contents )
+          }
+        end
+
+        def concrete_data_classes
+          descendants.
+            reject{ |d| d.name =~ /\bAbstract[A-Z]\w*$/ }.
+            sort_by{ |d| -d.ancestors.length }
+        end
+
+        def defining_property_value(options)
           attribute = options.fetch( :attribute )
           element   = options.fetch( :element   )
           value     = options.fetch( :value     )
-          define_singleton_method(attribute) { value }
-          defining_element_mappings << { attribute: attribute, element: element }
+          define_singleton_method( attribute ) { value }
+          define_method( attribute ) { value }
+          defining_property_mappings << DefiningPropertyMapping.new( attribute: attribute, element: element )
         end
 
         def attr_element_mapping(options)
-          type = options[:type]
-          unless type.nil?
-            raise ArgumentError, "The :type option must be a symbol, but a #{type.class} was given." unless Symbol === type
-            raise ArgumentError, "#{type.inspect} is not a valid :type option. Must be :array when given." unless type == :array
-          end
-          attribute = options.fetch( :attribute )
-          element   = options.fetch( :element   )
-          attr_accessor attribute
-          attr_element_mappings << options
+          mapping = AbstractData::AttributeElementMapping.new( options )
+          attr_element_mappings << mapping
+          attr_accessor mapping.attribute_name
         end
 
         def verify_defining_properties(property_contents)
           unmatched = unmatched_defining_properties( property_contents )
           return if unmatched.empty?
-          message = unmatched.map{ |mapping|
-            attribute, el_name = mapping.values_at(:attribute, :element)
-            defining_value = public_send(attribute)
-            "#{el_name} child element with \"#{defining_value}\" value not found."
+          message = unmatched.map{ |property_mapping|
+            defining_mapping = public_send( property_mapping.attribute_name )
+            "#{property_mapping.element_name} child element with \"#{defining_mapping}\" value not found."
           }.join( ' ' )
           raise InvalidXmlContentError, message
         end
 
         def unmatched_defining_properties(property_contents)
           unmatched = []
-          defining_element_mappings.each do |mapping|
-            attribute, el_name = mapping.values_at(:attribute, :element)
-            defining_value = public_send(attribute)
-            unmatched << mapping unless property_contents[el_name] == defining_value
+          defining_property_mappings.each do |property_mapping|
+            defining_value = public_send( property_mapping.attribute_name )
+            unmatched << property_mapping unless property_contents[property_mapping.element_name] == defining_value
           end
           unmatched
         end
 
         def select_variable_property_contents(property_contents)
-          defining_element_names = defining_element_mappings.map{ |mapping| mapping[:element] }
+          defining_element_names = defining_property_mappings.map(&:element_name)
           property_contents.reject{ |name, content| defining_element_names.include?(name) }
         end
 
         def populate_instance_from_properties instance, variable_property_contents
           variable_property_contents.each do |name, content|
-            mapping = attr_element_mappings.detect{ |mapping| mapping[:element] == name }
+            mapping = attr_element_mappings.detect{ |mapping| mapping.element_name == name }
             next unless mapping
-            value = if mapping[:numbered_lines]
-              template = mapping[:numbered_lines]
-              [].tap{ |lines|
-                line_num = 1
-                while ( content.has_key?(key = template % line_num) )
-                  lines << content[key]
-                  line_num += 1
-                end
-              }
-            elsif mapping[:type] == :array
-              content.split('|')
-            else
-              content
-            end
-            attribute = mapping[:attribute]
-            instance.public_send "#{attribute}=", value
+            instance.public_send "#{mapping.attribute_name}=", mapping.value_from_element_content( content)
           end
         end
 
@@ -150,50 +134,28 @@ module ClientForPoslynx
       attr_accessor :source_data
 
       def xml_serialize
-        doc = Nokogiri::XML::Document.new
-        root = doc.create_element(self.class.root_element_name)
-        self.class.defining_element_mappings.each do |mapping|
-          content = self.class.public_send( mapping[:attribute] )
-          next unless content
-          element = doc.create_element( mapping[:element], nil, nil, content )
-          root.add_child element
-        end
-        self.class.attr_element_mappings.each do |mapping|
-          content = public_send( mapping[:attribute] )
-          next unless content
-          element = if mapping[:numbered_lines]
-            build_numbered_lines_xml_node( doc, mapping[:element], mapping[:numbered_lines], content )
-          elsif mapping[:type] == :array
-            build_vertical_bar_separated_list_node( doc, mapping[:element], content )
-          else
-            build_text_element_node( doc, mapping[:element], content )
-          end
-          root.add_child element
-        end
-        doc.root = root
-        doc.serialize(:save_with => Nokogiri::XML::Node::SaveOptions::AS_XML | Nokogiri::XML::Node::SaveOptions::NO_DECLARATION)
+        doc = Data::XmlDocument.with_root_element_name( self.class.root_element_name )
+        add_properties_to_xml_document doc
+        doc.serialize
       end
 
       private
 
-      def build_numbered_lines_xml_node(doc, element_name, line_template, content)
-        element = doc.create_element( element_name )
-        [content].flatten.each_with_index do |line_text, idx|
-          line_num = idx + 1
-          element_name = line_template % line_num
-          line_el = doc.create_element( element_name, nil, nil, line_text )
-          element.add_child line_el
+      def add_properties_to_xml_document(doc)
+        all_mappings.each do |mapping|
+          content = property_attribute_value( mapping )
+          next unless content
+          doc_content = mapping.xml_doc_content_from_client_content( content )
+          doc.add_property_content mapping.element_name, doc_content
         end
-        element
       end
 
-      def build_vertical_bar_separated_list_node(doc, element_name, content)
-        text = [content].flatten * '|'
-        doc.create_element( element_name, nil, nil, text )
+      def all_mappings
+        self.class.defining_property_mappings + self.class.attr_element_mappings
       end
 
-      def build_text_element_node(doc, element_name, content)
-        doc.create_element( element_name, nil, nil, "#{content}" )
+      def property_attribute_value( property )
+        public_send( property.attribute_name )
       end
 
     end

data/lib/client_for_poslynx/data/abstract_data/attribute_element_mapping.rb

@@ -0,0 +1,141 @@
+# coding: utf-8
+
+require 'nokogiri'
+
+module ClientForPoslynx
+  module Data
+    class AbstractData
+
+      module AttributeElementMapping
+
+        class Abstract ; end
+        class Text          < AttributeElementMapping::Abstract ; end
+        class MultiText     < AttributeElementMapping::Abstract ; end
+        class NumberedLines < AttributeElementMapping::Abstract ; end
+
+        def self.new(options)
+          klass = case
+            when options[:multi_text]     ; AttributeElementMapping::MultiText
+            when options[:numbered_lines] ; AttributeElementMapping::NumberedLines
+            else                          ; AttributeElementMapping::Text
+          end
+          klass.new( options )
+        end
+
+        class Abstract
+          attr_reader :attribute_name, :element_name, :numbered_line_template
+
+          def numbered_lines? ; @numbered_lines ; end
+          def multi_text?     ; @multi_text     ; end
+
+          def initialize(options)
+            options = options.reject { |k,v| v.nil? }
+            @attribute_name = options.fetch( :attribute ) { raise ArgumentError, ':attribute option value must be provided' }
+            @element_name   = options.fetch( :element   ) { raise ArgumentError, ':element option value must be provided' }
+            options.delete :attribute ; options.delete :element
+            additional_init options
+            verify_no_unexpected_unused_options options
+          end
+
+          def text_mapping?           ; false ; end
+          def multi_text_mapping?     ; false ; end
+          def numbered_lines_mapping? ; false ; end
+
+          def value_from_element_content(content)
+            raise NotImplementedError
+            [].tap{ |lines|
+              line_num = 1
+              while ( content.has_key?(key =  numbered_line_template % line_num) )
+                lines << content[key]
+                line_num += 1
+              end
+            }
+          end
+
+          def xml_doc_content_from_client_content(client_content)
+            raise NotImplementedError
+          end
+
+          private
+
+          def verify_no_unexpected_unused_options(unused_options)
+            unless unused_options.empty?
+              key_list = unused_options.keys.map(&:inspect)
+              raise ArgumentError, "Unexpected option(s) #{key_list} supplied"
+            end
+          end
+
+          def additional_init(options)
+            # Do nothing by default.
+          end
+        end
+
+        class Text < AttributeElementMapping::Abstract
+          def text_mapping? ; true ; end
+
+          def value_from_element_content(content)
+            content
+          end
+
+          def xml_doc_content_from_client_content(client_content)
+            client_content.to_s
+          end
+        end
+
+        class MultiText < AttributeElementMapping::Abstract
+          def multi_text_mapping? ; true ; end
+
+          def value_from_element_content(content)
+            content.split('|')
+          end
+
+          def xml_doc_content_from_client_content(client_content)
+            client_content = [client_content].flatten
+            client_content * '|'
+          end
+
+          private
+
+          def additional_init(options)
+            @multi_text = !!options.delete( :multi_text )
+          end
+        end
+
+        class NumberedLines < AttributeElementMapping::Abstract
+          def numbered_lines_mapping? ; true ; end
+
+          def value_from_element_content(content)
+            [].tap{ |lines|
+              line_num = 1
+              while ( content.has_key?(key =  numbered_line_template % line_num) )
+                lines << content[key]
+                line_num += 1
+              end
+            }
+          end
+
+          def xml_doc_content_from_client_content(client_content)
+            client_content = [client_content].flatten
+            Hash[
+              client_content.each_with_index.map { |line_text, idx|
+                line_num = idx + 1
+                line_element_name = numbered_line_template % line_num
+                [ line_element_name, line_text ]
+              }
+            ]
+          end
+
+          private
+
+          def additional_init(options)
+            numbered_line_name_template = options.delete( :numbered_lines )
+            @numbered_lines = !!numbered_line_name_template
+            @numbered_line_template = numbered_line_name_template
+          end
+        end
+
+      end
+
+    end
+  end
+end

data/lib/client_for_poslynx/data/abstract_data/defining_property_mapping.rb

@@ -0,0 +1,22 @@
+# coding: utf-8
+
+module ClientForPoslynx
+  module Data
+    class AbstractData
+
+      class DefiningPropertyMapping
+        attr_reader :attribute_name, :element_name
+
+        def initialize(options)
+          @attribute_name = options.fetch(:attribute)
+          @element_name = options.fetch(:element)
+        end
+
+        def xml_doc_content_from_client_content(client_content)
+          client_content
+        end
+      end
+
+    end
+  end
+end

data/lib/client_for_poslynx/data/requests/credit_card_sale.rb

@@ -8,7 +8,7 @@ module ClientForPoslynx
 
       class CreditCardSale < AbstractRequest
 
-        defining_element_value attribute: :command, element: 'Command', value: 'CCSALE'
+        defining_property_value attribute: :command, element: 'Command', value: 'CCSALE'
 
         attr_element_mapping attribute: :merchant_supplied_id, element: 'Id'
         attr_element_mapping attribute: :client_id,            element: 'ClientId'

data/lib/client_for_poslynx/data/requests/debit_card_sale.rb

@@ -8,7 +8,7 @@ module ClientForPoslynx
 
       class DebitCardSale < AbstractRequest
 
-        defining_element_value attribute: :command, element: 'Command', value: 'DCSALE'
+        defining_property_value attribute: :command, element: 'Command', value: 'DCSALE'
 
         attr_element_mapping attribute: :merchant_supplied_id, element: 'Id'
         attr_element_mapping attribute: :client_id,            element: 'ClientId'

data/lib/client_for_poslynx/data/requests/pin_pad_display_message.rb

@@ -8,10 +8,10 @@ module ClientForPoslynx
 
       class PinPadDisplayMessage < AbstractRequest
 
-        defining_element_value attribute: :command, element: 'Command', value: 'PPDISPLAY'
+        defining_property_value attribute: :command, element: 'Command', value: 'PPDISPLAY'
         attr_element_mapping attribute: :line_count,    element: 'Lines'
-        attr_element_mapping attribute: :text_lines,    element: 'Text',    type: :array
-        attr_element_mapping attribute: :button_labels, element: 'Buttons', type: :array
+        attr_element_mapping attribute: :text_lines,    element: 'Text',    multi_text: true
+        attr_element_mapping attribute: :button_labels, element: 'Buttons', multi_text: true
 
       end
 

data/lib/client_for_poslynx/data/requests/pin_pad_display_specified_form.rb

@@ -8,11 +8,11 @@ module ClientForPoslynx
 
       class PinPadDisplaySpecifiedForm < AbstractRequest
 
-        defining_element_value attribute: :command,   element: 'Command',  value: 'PPSPECIFIEDFORM'
+        defining_property_value attribute: :command,   element: 'Command',  value: 'PPSPECIFIEDFORM'
 
         attr_element_mapping attribute: :form_name,     element: 'FormName'
-        attr_element_mapping attribute: :text_values,   element: 'Text',     type: :array
-        attr_element_mapping attribute: :button_labels, element: 'Buttons',  type: :array
+        attr_element_mapping attribute: :text_values,   element: 'Text',     multi_text: true
+        attr_element_mapping attribute: :button_labels, element: 'Buttons',  multi_text: true
 
       end
 

data/lib/client_for_poslynx/data/requests/pin_pad_initialize.rb

@@ -8,7 +8,7 @@ module ClientForPoslynx
 
       class PinPadInitialize < AbstractRequest
 
-        defining_element_value attribute: :command, element: 'Command', value: 'PPINIT'
+        defining_property_value attribute: :command, element: 'Command', value: 'PPINIT'
         attr_element_mapping attribute: :idle_prompt, element: 'IdlePrompt'
 
       end

data/lib/client_for_poslynx/data/responses/credit_card_sale.rb

@@ -8,7 +8,7 @@ module ClientForPoslynx
 
       class CreditCardSale < AbstractResponse
 
-        defining_element_value attribute: :command, element: 'Command', value: 'CCSALE'
+        defining_property_value attribute: :command, element: 'Command', value: 'CCSALE'
 
         attr_element_mapping attribute: :processor_authorization,  element: 'Authorization'
         attr_element_mapping attribute: :record_number,            element: 'RecNum'

data/lib/client_for_poslynx/data/responses/debit_card_sale.rb

@@ -8,7 +8,7 @@ module ClientForPoslynx
 
       class DebitCardSale < AbstractResponse
 
-        defining_element_value attribute: :command, element: 'Command', value: 'DCSALE'
+        defining_property_value attribute: :command, element: 'Command', value: 'DCSALE'
 
         attr_element_mapping attribute: :processor_authorization,  element: 'Authorization'
         attr_element_mapping attribute: :record_number,            element: 'RecNum'

data/lib/client_for_poslynx/data/responses/pin_pad_display_message.rb

@@ -8,7 +8,7 @@ module ClientForPoslynx
 
       class PinPadDisplayMessage < AbstractResponse
 
-        defining_element_value attribute: :command, element: 'Command', value: 'PPDISPLAY'
+        defining_property_value attribute: :command, element: 'Command', value: 'PPDISPLAY'
         attr_element_mapping attribute: :button_response,  element: 'Response'
 
       end

data/lib/client_for_poslynx/data/responses/pin_pad_display_specified_form.rb

@@ -8,7 +8,7 @@ module ClientForPoslynx
 
       class PinPadDisplaySpecifiedForm < AbstractResponse
 
-        defining_element_value attribute: :command, element: 'Command', value: 'PPSPECIFIEDFORM'
+        defining_property_value attribute: :command, element: 'Command', value: 'PPSPECIFIEDFORM'
         attr_element_mapping attribute: :button_response,  element: 'Response'
         attr_element_mapping attribute: :signature_data,  element: 'Signature'
 

data/lib/client_for_poslynx/data/responses/pin_pad_initialize.rb

@@ -8,7 +8,7 @@ module ClientForPoslynx
 
       class PinPadInitialize < AbstractResponse
 
-        defining_element_value attribute: :command, element: 'Command', value: 'PPINIT'
+        defining_property_value attribute: :command, element: 'Command', value: 'PPINIT'
 
       end
 

data/lib/client_for_poslynx/data/xml_document.rb

@@ -7,18 +7,42 @@ module ClientForPoslynx
 
     class XmlDocument
 
-      attr_reader :source_xml
-
-      def initialize( source_xml )
-        @source_xml = source_xml
-        @nokogiri_doc = Nokogiri::XML::Document.parse(
-          source_xml,
-          nil, nil,
-          Nokogiri::XML::ParseOptions::DEFAULT_XML & ~Nokogiri::XML::ParseOptions::RECOVER
+      class << self
+        private :new
+
+        def with_root_element_name(name)
+          nokogiri_doc = Nokogiri::XML::Document.new
+          nokogiri_doc.root = nokogiri_doc.create_element( name )
+          new(nokogiri_doc)
+        end
+
+        def from_xml(source_xml)
+          nokogiri_doc = Nokogiri::XML::Document.parse(
+            source_xml,
+            nil, nil,
+            Nokogiri::XML::ParseOptions::DEFAULT_XML & ~Nokogiri::XML::ParseOptions::RECOVER
+          )
+          new(nokogiri_doc)
+        rescue Nokogiri::XML::SyntaxError => e
+          raise InvalidXmlError
+        end
+
+      end
+
+      def initialize(nokogiri_doc)
+        @nokogiri_doc = nokogiri_doc
+      end
+
+      def verify_root_element_name(expected_name)
+        unless root_name == expected_name
+          raise InvalidXmlContentError, "#{expected_name} root element not found"
+        end
+      end
+
+      def serialize
+        nokogiri_doc.serialize(
+          :save_with => Nokogiri::XML::Node::SaveOptions::AS_XML | Nokogiri::XML::Node::SaveOptions::NO_DECLARATION
         )
-      rescue Nokogiri::XML::SyntaxError => e
-        p e
-        raise InvalidXmlError
       end
 
       def root_name
@@ -29,6 +53,19 @@ module ClientForPoslynx
         @property_element_contents ||= hash_from_element( root )
       end
 
+      def add_property_content(element_name, content)
+        element = nokogiri_doc.create_element( element_name )
+        if Hash === content
+          content.each do |element_name, text|
+            child_element = nokogiri_doc.create_element( element_name, nil, nil, text )
+            element.add_child child_element
+          end
+        else
+          element.content = content.to_s
+        end
+        root.add_child element
+      end
+
       private
 
       attr_reader :nokogiri_doc

data/lib/client_for_poslynx/version.rb

@@ -1,5 +1,5 @@
 # coding: utf-8
 
 module ClientForPoslynx
-  VERSION = '0.1.1'
+  VERSION = '0.2.0'
 end

data/spec/client_for_poslynx/data/abstract_data/attribute_element_mapping_spec.rb

@@ -0,0 +1,52 @@
+# coding: utf-8
+
+require 'spec_helper'
+
+describe ClientForPoslynx::Data::AbstractData::AttributeElementMapping do
+
+  it "Fails creation without :attribute option" do
+    expect{
+      described_class.new element: 'Foo'
+    }.to raise_exception( ArgumentError )
+  end
+
+  it "Fails creation without :element option" do
+    expect{
+      described_class.new attribute: :foo
+    }.to raise_exception( ArgumentError )
+  end
+
+  it "Creates a text mapping instance with minimum attriubtes" do
+    actual = described_class.new(
+      attribute: :foo, element: 'Foo'
+    )
+    expect( actual ).to be_text_mapping
+  end
+
+  it "Creates a multi-text mapping instance with multi_text attribute" do
+    actual = described_class.new(
+      attribute: :foo, element: 'Foo', multi_text: true
+    )
+    expect( actual ).to be_multi_text_mapping
+  end
+
+  it "Creates a numbered_lines mapping instance with numbered_lines attribute" do
+    actual = described_class.new(
+      attribute: :foo, element: 'Foo', numbered_lines: 'the-template'
+    )
+    expect( actual ).to be_numbered_lines_mapping
+  end
+
+  it "Fails creation with unexpected attribute" do
+    expect{
+      described_class.new attribute: :foo, element: 'Foo', bar: true
+    }.to raise_exception( ArgumentError )
+  end
+
+  it "fails creation with both nulti-text and numbered-lines options" do
+    expect{
+      described_class.new attribute: :foo, element: 'Foo', multi_text: true, numbered_lines: 'x'
+    }.to raise_exception( ArgumentError )
+  end
+
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: client_for_poslynx
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Steve Jorgensen
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-08-31 00:00:00.000000000 Z
+date: 2014-09-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -89,6 +89,8 @@ files:
 - lib/client_for_poslynx.rb
 - lib/client_for_poslynx/data.rb
 - lib/client_for_poslynx/data/abstract_data.rb
+- lib/client_for_poslynx/data/abstract_data/attribute_element_mapping.rb
+- lib/client_for_poslynx/data/abstract_data/defining_property_mapping.rb
 - lib/client_for_poslynx/data/properties_xml_parser.rb
 - lib/client_for_poslynx/data/requests.rb
 - lib/client_for_poslynx/data/requests/abstract_request.rb
@@ -127,6 +129,7 @@ files:
 - lib/client_for_poslynx/message_handling/stream_data_writer.rb
 - lib/client_for_poslynx/message_handling/xml_extractor.rb
 - lib/client_for_poslynx/version.rb
+- spec/client_for_poslynx/data/abstract_data/attribute_element_mapping_spec.rb
 - spec/client_for_poslynx/data/abstract_data_spec.rb
 - spec/client_for_poslynx/data/requests/abstract_request_spec.rb
 - spec/client_for_poslynx/data/requests/can_visit_spec.rb
@@ -172,6 +175,7 @@ signing_key:
 specification_version: 4
 summary: A TCP client for Precidia's POSLynx™ devices
 test_files:
+- spec/client_for_poslynx/data/abstract_data/attribute_element_mapping_spec.rb
 - spec/client_for_poslynx/data/abstract_data_spec.rb
 - spec/client_for_poslynx/data/requests/abstract_request_spec.rb
 - spec/client_for_poslynx/data/requests/can_visit_spec.rb