fixy 0.0.1

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+/.idea
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+/pmip

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+## v0.0.1
+
+* Initial release

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in fixy.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Omar Skalli
+
+MIT License
+
+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,175 @@
+## fixy
+
+Library for generating fixed width flat file documents. 
+
+## Installation
+
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'fixy'
+```
+
+And then execute:
+
+```bash
+bundle
+```
+
+Or install it yourself as:
+
+```bash
+gem install fixy
+```
+
+Then proceed to creating your records, and documents as described in the paragraphs below.
+
+## Overview
+
+A fixed-width document (`Fixy::Document`) is composed of multiple single-line records (`Fixy::Record`).
+
+## Record definition
+
+Every record is defined through a specific format, which defines the following aspects:
+
+* Record length (how many characters in the line)
+* Required formatters (e.g. Alphanumeric, Rate, Amount)
+* Field declaration:
+	* Field human readable name
+	* Field size (how many characters for the field)
+	* Field range (start/end column for the field)
+	* Field format (e.g. Alphanumeric, Rate, Amount)
+* Field definition
+
+Below is an example of a record for defining a person's first and last name:
+
+```ruby
+class PersonRecord < Fixy::Record
+
+	# Include formatters
+	
+  include Fixy::Formatter::Alphanumeric
+
+	# Define record length
+	
+  set_record_length 20
+
+  # Fields Declaration:
+  # -----------------------------------------------------------
+  #       name          size      Range             Format        
+  # ------------------------------------------------------------
+
+  field :first_name,     10,     '1-10' ,      :alphanumeric
+  field :last_name ,     10,     '11-20',      :alphanumeric
+
+	# Any required data for the record can be 
+	# provided through the initializer
+			
+	def initialize(first_name, last_name)
+	  @first_name = first_name
+	  @last_name  = last_name
+	end
+	
+	# Fields Definition:
+	# 1) Using a Proc 
+	
+  field_value :first_name, -> { @first_name }
+
+	# 2) Using a method definition. 
+	#    This is most interesting when complex logic is involved.
+  
+  def last_name
+    @last_name
+  end
+end
+```
+
+Given a record definition, you can generate a single line (e.g. for testing purposes):
+
+```ruby
+PersonRecord.new('Sarah', 'Kerrigan').generate
+	
+# This will output the following 20 characters long record
+#
+#  "Sarah     Kerrigan  \n"
+#
+```
+
+Most of the time however, you will not have to call `generate` directly, as the document will take care of that part.
+
+## Document definition
+
+A document is composed of a multitude of records (instances of a `Fixy::Record`). Because some document specification require earlier records to contain a count of upcoming records, both appending and prepending records is supported during a document definition. Below is an example of a document, based on the record defined in the previous section.
+
+```ruby
+class PeopleDocument < Fixy::Document
+  def build
+    append_record  PersonRecord.new('Sarah', 'Kerrigan')
+    append_record  PersonRecordnew('Jim', 'Raynor')
+    prepend_record PersonRecord.new('Arcturus', 'Mengsk')
+  end
+end
+```
+
+## Generating a document
+
+With records and documents defined, generating documents is a breeze:
+
+** Generating to string **
+
+```ruby
+
+PeopleDocument.new.generate
+```
+
+The output would be: "Arcturus  Mengsk    \nSarah     Kerrigan  \nJim       Raynor   "
+
+** Generating to file **
+
+```ruby
+
+PeopleDocument.new.generate_to_file("output.txt")
+```
+
+** Generating HTML Debug version **
+
+This is most useful when getting an error such as: `Unexpected character at line 20, column 95`. The HTML output makes it really easy to make sense out of any fixed width document, and quickly identify issues.
+
+```ruby
+
+PeopleDocument.new.generate_to_file("output.html", true)
+```
+
+
+## Creating custom formatters
+
+Currently, there aren't many formatters included in this release, and you will most likely have to write your own. To create a new formatter of type `type` (e.g. amount), you simply need a method called `format_<type>(input, length)`. The argument `input` is the value being formatted, and `length` is the number of characters to fill. It is important to make sure `length` characters are returned by the formatter!
+
+An example for formatter definition: 
+```ruby
+
+module Fixy
+	module Formatter
+		module Numeric
+    		def format_numeric(input, length)
+      			input = input.to_s
+      			raise ArgumentError, "Invalid Input (only digits are accepted)" unless input =~ /^\d+$/
+      			raise ArgumentError, "Not enough length (input: #{input}, length: #{length})" if input.length > length
+      			input.rjust(length, '0')
+           end
+  		end
+	end
+end
+```
+
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+

data/Rakefile

@@ -0,0 +1,11 @@
+# encoding: utf-8
+require 'rake/clean'
+require 'rake'
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+task :default => :spec

data/fixy.gemspec

@@ -0,0 +1,25 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'fixy/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'fixy'
+  spec.version       = Fixy::VERSION
+  spec.authors       = ['Omar Skalli']
+  spec.email         = ['omar@zenpayroll.com']
+  spec.description   = %q{Library for generating fixed width flat files.}
+  spec.summary       = %q{Provides a DSL for defining, generating, and debugging fixed width documents.}
+  spec.homepage      = 'https://github.com/chetane/fixy'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split($/)
+  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_development_dependency 'bundler'
+  spec.add_development_dependency 'rspec'
+
+  spec.add_runtime_dependency 'rake'
+  spec.add_runtime_dependency 'activesupport'
+end

data/lib/fixy.rb

@@ -0,0 +1,6 @@
+require 'fixy/decorator/debug'
+require 'fixy/decorator/default'
+require 'fixy/document'
+require 'fixy/formatter/alphanumeric'
+require 'fixy/record'
+require 'fixy/version'

data/lib/fixy/decorator/debug.rb

@@ -0,0 +1,65 @@
+module Fixy
+  module Decorator
+    class Debug
+      class << self
+        def document(document)
+          '<html>
+            <head>
+              <script src="http://code.jquery.com/jquery-1.11.0.min.js"></script>
+              <script src="http://netdna.bootstrapcdn.com/bootstrap/3.1.1/js/bootstrap.min.js"></script>
+              <style>
+                body  { margin: 0; padding: 0; background-color: #CDCDCD; }
+                pre   { margin: 0; }
+                .even { background-color: #ABABAB; }
+                .odd  { background-color: #CDCDCD; }
+                b     { font-size: 15px; }
+                .line { width: 50px; text-align: right; margin-right: 10px; color: #7f8284; display: inline-block; background-color: #272822; padding-right: 5px;}
+                span:hover { background-color: yellow; }
+                span.line:hover { background-color: #3e3d32; }
+                .tooltip        { min-width: 250px; position: absolute; z-index: 1030; display: block; font-size: 12px; line-height: 1.4; visibility: visible; filter: alpha(opacity=0); opacity: 0; }
+                .tooltip.in     { filter: alpha(opacity=90); opacity: .9; }
+                .tooltip.bottom { padding: 5px 0; margin-top: 3px; }
+                .tooltip-inner  {  max-width: 200px; padding: 3px 8px;  color: #fff; text-align: center;  text-decoration: none; background-color: #000; border-radius: 4px; }
+                .tooltip-arrow  { position: absolute; width: 0; height: 0; border-color: transparent; border-style: solid; }
+                .tooltip.bottom .tooltip-arrow { top: 0; left: 50%; margin-left: -5px; border-width: 0 5px 5px; border-bottom-color: #000; }
+              </style>
+              <script type="text/javascript">
+                $(document).ready(function() {
+                    $("div").each(function(i, div) {
+                        $div = $(div);
+                        $spans = $div.find("span");
+                        $spans.each(function(j, span) {
+                            element = $(span);
+                            method = element.data("method");
+                            size = element.data("size");
+                            format = element.data("format");
+                            column = element.data("column");
+                            line = i + 1;
+
+                            $(element).tooltip({
+                                title: ("<b>" + method + "</b><br/>Line: " + line + "<br/>Column: " + column + "<br/>Length: " + size + "<br/>Formatter: " + format),
+                                placement: "bottom",
+                                container: "body",
+                                html: true
+                            });
+                        });
+                        $div.find("pre").prepend("<span class=\'line\'>" + (i + 1) + "</span>");
+                    });
+                });
+              </script>
+            </head>
+            <body>' + document + '</body>
+          </html>'
+        end
+
+        def field(value, record_number, position, method, length, type)
+          "<span class='#{(record_number.even?? 'even' : 'odd')}' data-column='#{position}' data-method='#{method}' data-size='#{length}' data-format='#{type}'>#{value}</span>"
+        end
+
+        def record(record)
+          "<div><pre>#{record}</pre></div>"
+        end
+      end
+    end
+  end
+end

data/lib/fixy/decorator/default.rb

@@ -0,0 +1,19 @@
+module Fixy
+  module Decorator
+    class Default
+      class << self
+        def document(document)
+          document
+        end
+
+        def field(value, record_number, position, method, length, type)
+          value
+        end
+
+        def record(record)
+          record
+        end
+      end
+    end
+  end
+end

data/lib/fixy/document.rb

@@ -0,0 +1,40 @@
+module Fixy
+  class Document
+
+    attr_accessor :content, :debug_mode
+
+    def generate_to_file(path, debug = false)
+      File.open(path, 'w') do |file|
+        file.write(generate(debug))
+      end
+    end
+
+    def generate(debug = false)
+      @debug_mode = debug
+      @content = ''
+
+      # Generate document based on user logic.
+      build
+
+      decorator.document(@content)
+    end
+
+    private
+
+    def build
+      raise NotImplementedError
+    end
+
+    def decorator
+      debug_mode ? Fixy::Decorator::Debug : Fixy::Decorator::Default
+    end
+
+    def prepend_record(record)
+      @content = record.generate(debug_mode) << @content
+    end
+
+    def append_record(record)
+      @content << record.generate(debug_mode)
+    end
+  end
+end

data/lib/fixy/formatter/alphanumeric.rb

@@ -0,0 +1,24 @@
+module Fixy
+  module Formatter
+    module Alphanumeric
+
+      #
+      # Alphanumeric Formatter
+      #
+      # Only contains printable characters and is
+      # left-justified and filled with spaces.
+      #
+
+      def format_alphanumeric(input, bytes)
+        input_string = String.new(input.to_s)
+        truncated_bytesize = [input_string.bytesize, bytes].min
+        if truncated_bytesize < bytes
+          input_string << " " * (bytes - truncated_bytesize)
+          input_string
+        else
+          input_string.byteslice(0..(truncated_bytesize - 1))
+        end
+      end
+    end
+  end
+end

data/lib/fixy/record.rb

@@ -0,0 +1,107 @@
+module Fixy
+  class Record
+    require 'active_support/core_ext/proc'
+
+    class << self
+      def set_record_length(count)
+        define_singleton_method('record_length') { count }
+      end
+
+      def field(name, size, range, type)
+        @record_fields ||= {}
+        range_matches = range.match /^(\d+)(?:-(\d+))?$/
+
+        # Make sure inputs are valid, we rather fail early than behave unexpectedly later.
+        raise ArgumentError, "Name '#{name}' is not a symbol"  unless name.is_a? Symbol
+        raise ArgumentError, "Size '#{size}' is not a numeric" unless size.is_a?(Numeric) && size > 0
+        raise ArgumentError, "Range '#{range}' is invalid"     unless range_matches
+        raise ArgumentError, "Unknown type '#{type}'"          unless (private_instance_methods + instance_methods).include? "format_#{type}".to_sym
+
+        # Validate the range is consistent with size
+        range_from  = Integer(range_matches[1])
+        range_to    = Integer(range_matches[2].nil? ? range_matches[1] : range_matches[2])
+        valid_range = (range_from + (size - 1) == range_to)
+
+        raise ArgumentError, "Invalid Range (size: #{size}, range: #{range})" unless valid_range
+        raise ArgumentError, "Invalid Range (> #{record_length})"             unless range_to <= record_length
+
+        # Ensure range is not already covered by another definition
+        (1..range_to).each do |column|
+          if @record_fields[column] && @record_fields[column][:to] >= range_from
+            raise ArgumentError, "Column #{column} has already been allocated"
+          end
+        end
+
+        # We're good to go :)
+        @record_fields[range_from] = { name: name, from: range_from, to: range_to, size: size, type: type}
+      end
+
+      # Convenience method for creating field methods
+      def field_value(name, value)
+
+        # Make sure we're not overriding an existing method
+        if (private_instance_methods + instance_methods).include?(name)
+          raise ArgumentError, "Method '#{name}' is already defined, watch out for conflicts."
+        end
+
+        if value.is_a? Proc
+          define_method(name) { value.bind(self).call }
+        else
+          define_method(name) { value }
+        end
+      end
+
+      def record_fields
+        @record_fields
+      end
+    end
+
+    attr_accessor :debug_mode
+
+    # Generate the entry based on the record structure
+    def generate(debug = false)
+      @debug_mode = debug
+      output = ''
+      current_position = 1
+      current_record = 1
+
+      while current_position <= self.class.record_length do
+
+        field = record_fields[current_position]
+        raise StandardError, "Undefined field for position #{current_position}" unless field
+
+        # We will first retrieve the value, then format it
+        method          = field[:name]
+        value           = send(method)
+        formatted_value = format_value(value, field[:size], field[:type])
+        formatted_value = decorator.field(formatted_value, current_record, current_position, method, field[:size], field[:type])
+
+        output << formatted_value
+        current_position = field[:to] + 1
+        current_record += 1
+      end
+
+      # Documentation mandates that every record ends with new line.
+      output << "\n"
+
+      # All ready. In the words of Mr. Peters: "Take it and go!"
+      decorator.record(output)
+    end
+
+    private
+
+    # Format value with user defined formatters.
+    def format_value(value, size, type)
+      send("format_#{type}".to_sym, value, size)
+    end
+
+    # Retrieves the list of record fields that were set through the class methods.
+    def record_fields
+      self.class.record_fields
+    end
+
+    def decorator
+      debug_mode ? Fixy::Decorator::Debug : Fixy::Decorator::Default
+    end
+  end
+end

data/lib/fixy/version.rb

@@ -0,0 +1,3 @@
+module Fixy
+  VERSION = "0.0.1"
+end

data/spec/fixtures/debug_document.txt

@@ -0,0 +1,50 @@
+<html>
+            <head>
+              <script src="http://code.jquery.com/jquery-1.11.0.min.js"></script>
+              <script src="http://netdna.bootstrapcdn.com/bootstrap/3.1.1/js/bootstrap.min.js"></script>
+              <style>
+                body  { margin: 0; padding: 0; background-color: #CDCDCD; }
+                pre   { margin: 0; }
+                .even { background-color: #ABABAB; }
+                .odd  { background-color: #CDCDCD; }
+                b     { font-size: 15px; }
+                .line { width: 50px; text-align: right; margin-right: 10px; color: #7f8284; display: inline-block; background-color: #272822; padding-right: 5px;}
+                span:hover { background-color: yellow; }
+                span.line:hover { background-color: #3e3d32; }
+                .tooltip        { min-width: 250px; position: absolute; z-index: 1030; display: block; font-size: 12px; line-height: 1.4; visibility: visible; filter: alpha(opacity=0); opacity: 0; }
+                .tooltip.in     { filter: alpha(opacity=90); opacity: .9; }
+                .tooltip.bottom { padding: 5px 0; margin-top: 3px; }
+                .tooltip-inner  {  max-width: 200px; padding: 3px 8px;  color: #fff; text-align: center;  text-decoration: none; background-color: #000; border-radius: 4px; }
+                .tooltip-arrow  { position: absolute; width: 0; height: 0; border-color: transparent; border-style: solid; }
+                .tooltip.bottom .tooltip-arrow { top: 0; left: 50%; margin-left: -5px; border-width: 0 5px 5px; border-bottom-color: #000; }
+              </style>
+              <script type="text/javascript">
+                $(document).ready(function() {
+                    $("div").each(function(i, div) {
+                        $div = $(div);
+                        $spans = $div.find("span");
+                        $spans.each(function(j, span) {
+                            element = $(span);
+                            method = element.data("method");
+                            size = element.data("size");
+                            format = element.data("format");
+                            column = element.data("column");
+                            line = i + 1;
+
+                            $(element).tooltip({
+                                title: ("<b>" + method + "</b><br/>Line: " + line + "<br/>Column: " + column + "<br/>Length: " + size + "<br/>Formatter: " + format),
+                                placement: "bottom",
+                                container: "body",
+                                html: true
+                            });
+                        });
+                        $div.find("pre").prepend("<span class='line'>" + (i + 1) + "</span>");
+                    });
+                });
+              </script>
+            </head>
+            <body><div><pre><span class='odd' data-column='1' data-method='first_name' data-size='10' data-format='alphanumeric'>Arcturus  </span><span class='even' data-column='11' data-method='last_name' data-size='10' data-format='alphanumeric'>Mengsk    </span>
+</pre></div><div><pre><span class='odd' data-column='1' data-method='first_name' data-size='10' data-format='alphanumeric'>Sarah     </span><span class='even' data-column='11' data-method='last_name' data-size='10' data-format='alphanumeric'>Kerrigan  </span>
+</pre></div><div><pre><span class='odd' data-column='1' data-method='first_name' data-size='10' data-format='alphanumeric'>Jim       </span><span class='even' data-column='11' data-method='last_name' data-size='10' data-format='alphanumeric'>Raynor    </span>
+</pre></div></body>
+          </html>

data/spec/fixtures/debug_record.txt

@@ -0,0 +1,2 @@
+<div><pre><span class='odd' data-column='1' data-method='first_name' data-size='10' data-format='alphanumeric'>Sarah     </span><span class='even' data-column='11' data-method='last_name' data-size='10' data-format='alphanumeric'>Kerrigan  </span>
+</pre></div>

data/spec/fixy/document_spec.rb

@@ -0,0 +1,42 @@
+require 'spec_helper'
+
+describe 'Defining a Document' do
+  context 'when a build action is not defined' do
+    it 'should raise an exception' do
+      expect {
+        Fixy::Document.new.generate
+      }.to raise_error(NotImplementedError)
+    end
+  end
+
+  context 'when a build action is defined' do
+    it 'should generate fixed width document' do
+
+      class IdentityRecord < Fixy::Record
+        set_record_length 20
+        include Fixy::Formatter::Alphanumeric
+        field :first_name, 10, '1-10' , :alphanumeric
+        field :last_name , 10, '11-20', :alphanumeric
+
+        def initialize(first_name, last_name)
+          @first_name = first_name
+          @last_name  = last_name
+        end
+
+        field_value :first_name, -> { @first_name }
+        field_value :last_name , -> { @last_name  }
+      end
+
+      class PeopleDocument < Fixy::Document
+        def build
+          append_record  IdentityRecord.new('Sarah', 'Kerrigan')
+          append_record  IdentityRecord.new('Jim', 'Raynor')
+          prepend_record IdentityRecord.new('Arcturus', 'Mengsk')
+        end
+      end
+
+      PeopleDocument.new.generate "Arcturus  Mengsk    \nSarah     Kerrigan  \nJim       Raynor   "
+      PeopleDocument.new.generate(true).should eq File.read('spec/fixtures/debug_document.txt')
+    end
+  end
+end

data/spec/fixy/record_spec.rb

@@ -0,0 +1,96 @@
+require 'spec_helper'
+
+describe 'Defining a Record' do
+  context 'when the definition is correct' do
+    it 'should not raise any exception' do
+      expect {
+        class PersonRecord < Fixy::Record
+          include Fixy::Formatter::Alphanumeric
+
+          set_record_length 20
+
+          field :first_name, 10, '1-10' , :alphanumeric
+          field :last_name , 10, '11-20', :alphanumeric
+        end
+      }.not_to raise_error
+    end
+  end
+
+  context 'when the definition is incorrect' do
+    it 'should raise appropriate exception' do
+      expect {
+        class PersonRecordA < Fixy::Record
+          set_record_length 20
+          field :first_name, 10, '1-10', :alphanumeric
+        end
+      }.to raise_error(ArgumentError, "Unknown type 'alphanumeric'")
+
+      expect {
+        class PersonRecordB < Fixy::Record
+          include Fixy::Formatter::Alphanumeric
+          set_record_length 20
+          field :first_name, 2, '1-10', :alphanumeric
+        end
+      }.to raise_error(ArgumentError, "Invalid Range (size: 2, range: 1-10)")
+
+      expect {
+        class PersonRecordC < Fixy::Record
+          include Fixy::Formatter::Alphanumeric
+          set_record_length 20
+          field :first_name, 10, '1-10', :alphanumeric
+          field :last_name , 10, '10-19', :alphanumeric
+        end
+      }.to raise_error(ArgumentError, "Column 1 has already been allocated")
+
+      expect {
+        class PersonRecordD < Fixy::Record
+          include Fixy::Formatter::Alphanumeric
+          set_record_length 10
+          field :first_name, 10, '1-10', :alphanumeric
+          field :last_name , 10, '11-20', :alphanumeric
+        end
+      }.to raise_error(ArgumentError, "Invalid Range (> 10)")
+    end
+  end
+end
+
+describe 'Generating a Record' do
+  context 'when properly defined' do
+    it 'should generate fixed width record' do
+      class PersonRecordE < Fixy::Record
+        include Fixy::Formatter::Alphanumeric
+
+        set_record_length 20
+
+        field :first_name, 10, '1-10' , :alphanumeric
+        field :last_name , 10, '11-20', :alphanumeric
+
+        field_value :first_name, -> { 'Sarah' }
+
+        def last_name
+          'Kerrigan'
+        end
+      end
+
+      PersonRecordE.new.generate.should eq "Sarah     Kerrigan  \n"
+      PersonRecordE.new.generate(true).should eq File.read('spec/fixtures/debug_record.txt')
+    end
+  end
+
+  context 'when definition is incomplete (e.g. undefined columns)' do
+    it 'should raise an error' do
+      class PersonRecordF < Fixy::Record
+        include Fixy::Formatter::Alphanumeric
+        set_record_length 20
+        field :first_name, 10, '1-10' , :alphanumeric
+        field :last_name , 8,  '11-18', :alphanumeric
+        field_value :first_name, -> { 'Sarah' }
+        field_value :last_name,  -> { 'Kerrigan' }
+      end
+
+      expect {
+        PersonRecordF.new.generate
+      }.to raise_error(StandardError, "Undefined field for position 19")
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+require 'rspec'
+require 'fixy'

metadata

@@ -0,0 +1,134 @@
+--- !ruby/object:Gem::Specification
+name: fixy
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Omar Skalli
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Library for generating fixed width flat files.
+email:
+- omar@zenpayroll.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- fixy.gemspec
+- lib/fixy.rb
+- lib/fixy/decorator/debug.rb
+- lib/fixy/decorator/default.rb
+- lib/fixy/document.rb
+- lib/fixy/formatter/alphanumeric.rb
+- lib/fixy/record.rb
+- lib/fixy/version.rb
+- spec/fixtures/debug_document.txt
+- spec/fixtures/debug_record.txt
+- spec/fixy/document_spec.rb
+- spec/fixy/record_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/chetane/fixy
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Provides a DSL for defining, generating, and debugging fixed width documents.
+test_files:
+- spec/fixtures/debug_document.txt
+- spec/fixtures/debug_record.txt
+- spec/fixy/document_spec.rb
+- spec/fixy/record_spec.rb
+- spec/spec_helper.rb