hippo 0.0.6 → 0.0.7

data/CHANGELOG

@@ -1,3 +1,6 @@
+0.0.7 - TBD
+  * Add TransactionSet::Base#find_by_name to allow searching for components
+    by name rather than only by identifier.
 0.0.6 - 2011/11/09
   * Add Separator module for handling segment, field, composite, and
     repetition separators the same.

data/README.md

@@ -1,9 +1,9 @@
 Hippo
 =====
 
-The Hippo library is an attempt at creating a simple DSL to generate and parse HIPAA 
-transaction sets.  HIPAA or the Health Insurance Portability Accountability Act is a 
-series of regulations which place restrictions and requirements on the way transaction 
+The Hippo library is an attempt at creating a simple DSL to generate and parse HIPAA
+transaction sets.  HIPAA or the Health Insurance Portability Accountability Act is a
+series of regulations which place restrictions and requirements on the way transaction
 sets  (ie. Claims, Remittances, Eligibility, Claim Status, etc.) must be formatted.
 
 The HIPAA required transactions sets are created by the X12
@@ -12,7 +12,7 @@ effective 2012/01/01 all organizations must be migrated to using version
 5010.
 
 To obtain copies of the implementation guides you must purchase them from the X12
-organization. The implementation data is also available in tabular format (CSV).  The 
+organization. The implementation data is also available in tabular format (CSV).  The
 transaction sets, loops, and segments in Hippo were created from the X12 CSV Table Data.
 
 More information can be found at the following sites:
@@ -85,7 +85,7 @@ Transaction Sets/Loops and Segments are defined with a very straight forward DSL
     module Hippo::Segments
       class TestSimpleSegment < Hippo::Segments::Base
         segment_identifier 'TSS'
-    
+
         field :name => 'Field1'
         field :name => 'Field2'
         field :name => 'Field3'
@@ -93,32 +93,32 @@ Transaction Sets/Loops and Segments are defined with a very straight forward DSL
         field :name => 'CommonName'
         field :name => 'CommonName'
       end
-    
+
       class TestCompoundSegment < Hippo::Segments::Base
         segment_identifier 'TCS'
-    
+
         composite_field 'CompositeField' do
           field :name => 'Field1'
           field :name => 'Field2'
           field :name => 'Field3'
           field :name => 'CompositeCommonName'
         end
-    
+
         composite_field 'CompositeField' do
           field :name => 'Field4'
           field :name => 'Field5'
           field :name => 'Field6'
           field :name => 'CompositeCommonName'
         end
-    
+
         field :name => 'Field7'
       end
     end
-    
+
     module Hippo::TransactionSets
       module Test
         class Base < Hippo::TransactionSets::Base
-    
+
           segment Hippo::Segments::TestSimpleSegment,
                     :name           => 'Test Simple Segment #1',
                     :minimum        => 1,
@@ -127,7 +127,7 @@ Transaction Sets/Loops and Segments are defined with a very straight forward DSL
                     :defaults => {
                       'TSS01' => 'Blah'
                     }
-    
+
           segment Hippo::Segments::TestCompoundSegment,
                     :name           => 'Test Compound Segment #2',
                     :minimum        => 1,
@@ -136,7 +136,7 @@ Transaction Sets/Loops and Segments are defined with a very straight forward DSL
                     :defaults => {
                       'Field7' => 'Preset Field 7'
                     }
-    
+
           segment Hippo::Segments::TestSimpleSegment,
                     :name           => 'Test Simple Segment #3',
                     :minimum        => 1,
@@ -176,7 +176,7 @@ do not call #build.)
     ts.TSS.build
 ```
 
-The code above produces the following string output (notice how the values from 
+The code above produces the following string output (notice how the values from
 :defaults are prefilled, and the output is automatically sorted based on the order
 that the segments were declared):
 
@@ -196,11 +196,11 @@ on the segment or by passing a block to the segment.
     ts.TCS do |tcs|
       tcs.Field1 = 'Foo'
     end
-    
+
     ts.TSS do |tss|
       tss.Field2 = 'Bar'
     end
-    
+
     # both of the mechanisms above have the same string representation:
     #
     # ts.to_s => 'TSS*Blah*Bar~TCS*Foo**Preset Field 7~'
@@ -220,6 +220,18 @@ TSS_02 instead.
     # ts.to_s => 'TSS*Blah*Bar~TCS*Foo**Preset Field 7~TSS*Last Segment*Baz~'
 ```
 
+Obviously, this could get somewhat tedious when operating on a TransactionSet with many segments
+with the same identifier.  As an alternative you can also access a particular segment/loop based
+on the name provided in the TransactionSet definition.
+
+```ruby
+    ts.find\_by\_name('Test Simple Segment #1') do |tss|
+      tss.Field2 = 'Baz'
+    end
+
+    # ts.to_s => 'TSS*Blah*Baz~'
+```
+
 The same technique can be used to reference fields within a segment that have the same name.
 
 ```ruby

data/lib/hippo/transaction_sets/base.rb

@@ -129,9 +129,26 @@ module Hippo::TransactionSets
       end[sequence]
     end
 
+    def get_component_by_name(name, sequence = nil)
+      sequence =  if sequence.nil?
+                    0
+                  else
+                    sequence.to_i - 1
+                  end
+
+      self.class.components.select do |c|
+        puts c.options.inspect
+        c.options[:name] == name
+      end[sequence]
+    end
+
     def method_missing(method_name, *args)
-      component_name, component_sequence = method_name.to_s.split('_')
-      component = get_component(component_name, component_sequence)
+      component = if method_name == :find_by_name
+                    get_component_by_name(args[0], args[1])
+                  else
+                    component_name, component_sequence = method_name.to_s.split('_')
+                    get_component(component_name, component_sequence)
+                  end
 
       if component.nil?
         raise Hippo::Exceptions::InvalidSegment.new "Invalid segment specified: '#{method_name.to_s}'."

data/lib/hippo/version.rb

@@ -1,3 +1,3 @@
 module Hippo
-  VERSION = "0.0.6"
+  VERSION = "0.0.7"
 end

data/test/test_transaction_sets_base.rb

@@ -31,7 +31,7 @@ class TestTransactionSetBase < MiniTest::Unit::TestCase
     assert_equal 'TSS*Foo~', ts.to_s
   end
 
-  def test_accessing_sements_with_same_segment_id
+  def test_accessing_segments_with_same_segment_id
     ts = Hippo::TransactionSets::Test::Base.new
     ts.TSS.Field2 = 'Bar'
     ts.TCS.Field1 = 'Foo'
@@ -40,6 +40,15 @@ class TestTransactionSetBase < MiniTest::Unit::TestCase
     assert_equal 'TSS*Blah*Bar~TCS*Foo**Preset Field 7~TSS*Last Standalone Segment*Baz~', ts.to_s
   end
 
+  def test_accessing_segments_by_name
+    ts = Hippo::TransactionSets::Test::Base.new
+    ts.find_by_name('Test Simple Segment #1') do |tss|
+      tss.Field2 = 'Baz'
+    end
+
+    assert_equal 'TSS*Blah*Baz~', ts.to_s
+  end
+
   def test_assigning_segment_values_with_block_syntax
     ts = Hippo::TransactionSets::Test::Base.new
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hippo
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
   prerelease: 
 platform: ruby
 authors:
@@ -10,11 +10,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-09 00:00:00.000000000 Z
+date: 2011-11-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
-  requirement: &70266547233860 !ruby/object:Gem::Requirement
+  requirement: &70305083942840 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -22,10 +22,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70266547233860
+  version_requirements: *70305083942840
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70266547233360 !ruby/object:Gem::Requirement
+  requirement: &70305083942340 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -33,7 +33,7 @@ dependencies:
         version: 0.9.2
   type: :development
   prerelease: false
-  version_requirements: *70266547233360
+  version_requirements: *70305083942340
 description: HIPAA Transaction Set Generator/Parser
 email:
 - robertj@promedicalinc.com
@@ -265,7 +265,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: hippo
-rubygems_version: 1.8.10
+rubygems_version: 1.8.11
 signing_key: 
 specification_version: 3
 summary: HIPAA Transaction Set Generator/Parser