fixed_width-multibyte 0.2.2 → 0.2.3

data/README.markdown

@@ -1,149 +1,158 @@
-DESCRIPTION:
-============
-
-A simple, clean DSL for describing, writing, and parsing fixed-width text files.
-
-FEATURES:
-=========
-
-* Easy DSL syntax
-* Can parse and format fixed width files
-* Templated sections for reuse
-
-SYNOPSIS:
-=========
-
-##Creating a definition (Quick 'n Dirty)
-
-Hopefully this will cover 90% of use cases.
-
-    # Create a FixedWidth::Defintion to describe a file format
-    FixedWidth.define :simple do |d|
-      # This is a template section that can be reused in other sections
-      d.template :boundary do |t|
-        t.column :record_type, 4
-        t.column :company_id, 12
-      end
-    
-      # Create a section named :header
-      d.header(:align => :left) do |header|
-        # The trap tells FixedWidth which lines should fall into this section
-        header.trap { |line| line[0,4] == 'HEAD' }
-        # Use the boundary template for the columns
-        header.template :boundary
-      end
-    
-      d.body do |body|
-        body.trap { |line| line[0,4] =~ /[^(HEAD|FOOT)]/ }
-        body.column :id, 10, :parser => :to_i
-        body.column :first, 10, :align => :left, :group => :name
-        body.column :last,  10, :align => :left, :group => :name
-        body.spacer 3
-        body.column :city, 20  , :group => :address
-        body.column :state, 2  , :group => :address
-        body.column :country, 3, :group => :address
-      end
-    
-      d.footer do |footer|
-        footer.trap { |line| line[0,4] == 'FOOT' }
-        footer.template :boundary
-        footer.column :record_count, 10, :parser => :to_i
-      end
-    end
-
-This definition would output a parsed file something like this:
-
-    {
-        :body => [
-          { :id => 12,
-            :name => { :first => "Ryan", :last => "Wood" },
-            :address => { :city => "Foo", :state => 'SC', :country => "USA" }
-          },
-          { :id => 13,
-            :name => { :first => "Jo", :last => "Schmo" },
-            :address => { :city => "Bar", :state => "CA", :country => "USA" }
-          }
-        ],
-        :header => [{ :record_type => 'HEAD', :company_id => 'ABC'  }],
-        :footer => [{ :record_type => 'FOOT', :company_id => 'ABC', :record_count => 2  }]
-    }
-
-##Sections
-###Declaring a section
-
-Sections can have any name, however duplicates are not allowed. (A `DuplicateSectionNameError` will be thrown.) We use the standard `method_missing` trick. So if you see any unusual behavior, that's probably the first spot to look.
-
-    FixedWidth.define :simple do |d|
-        d.a_section_name do |s|
-            ...
-        end
-        d.another_section_name do |s|
-            ...
-        end
-    end
-
-### Section options:
-
-* `:singular` (default `false`) indicates that the section will only have a single record, and that it should not be returned nested in an array.
-
-* `:optional` (default `false`) indicates that the section is optional. (An otherwise-specified section will raise a `RequiredSectionNotFoundError` if the trap block doesn't match the row after the last one of the previous section.)
-
-##Columns
-###Declaring a column
-
-Columns can have any name, except for `:spacer` which is reserved. Also, duplicate column names within groupings are not allowed, and a column cannot share the same name as a group. (A `DuplicateColumnNameError` will be thrown for a duplicate column name within a grouping. A `DuplicateGroupNameError` will be thrown if you try to declare a column with the same name as an existing group or vice versa.) Again, basic `method_missing` trickery here, so be warned. You can declare columns either with the `method_missing` thing or by calling `Section#column`.
-
-    FixedWidth.define :simple do |d|
-        d.a_section_name do |s|
-            s.a_column_name 12
-            s.column :another_column_name, 14
-        end
-    end
-
-###Column Options:
-
-* `:align` can be set to `:left` or `:right`, to indicate which side the values should be/are justified to. By default, all columns are aligned `:right`.
-
-* `:group` can be set to a `Symbol` indicating the name of the nested hash which the value should be parsed to when reading/the name of the nested hash the value should be extracted from when writing.
-
-* `:parser` and `:formatter` options are symbols (to be proc-ified) or procs. By default, parsing and formatting assume that we're expecting/writing right-aligned strings, padded with spaces.
-
-* `:nil_blank` set to true will cause whitespace-only fields to be parsed to nil, regardless of `:parser`.
-
-* `:padding` can be set to a single character that will be used to pad formatted values, when writing fixed-width files.
-
-* `:truncate` can be set to true to truncate any value that exceeds the `length` property of a column. If unset or set to `false`, a `FixedWidth::FormattedStringExceedsLengthError` exception will be thrown.
-
-##Writing out fixed-width records
-
-Then either feed it a nested struct with data values to create the file in the defined format:
-
-    test_data = {
-        :body => [
-          { :id => 12,
-            :name => { :first => "Ryan", :last => "Wood" },
-            :address => { :city => "Foo", :state => 'SC', :country => "USA" }
-          },
-          { :id => 13,
-            :name => { :first => "Jo", :last => "Schmo" },
-            :address => { :city => "Bar", :state => "CA", :country => "USA" }
-          }
-        ],
-        :header => [{ :record_type => 'HEAD', :company_id => 'ABC'  }],
-        :footer => [{ :record_type => 'FOOT', :company_id => 'ABC', :record_count => 2  }]
-    }
-
-    # Generates the file as a string
-    puts FixedWidth.generate(:simple, test_data)
-
-    # Writes the file
-    FixedWidth.write(file_instance, :simple, test_data)
-
-Or parse files already in that format into a nested hash:
-
-    parsed_data = FixedWidth.parse(file_instance, :test).inspect
-
-INSTALL:
-========
-
+SPECIAL NOTE
+============
+
+Gem name: fixed_width-multibyte (as opposed to fixed_width)
+
+Forked from https://github.com/timonk/fixed_width to provide multibyte support. Uses ActiveSupport::Multibyte::Chars instead of String#unpack. Tested in Ruby 1.8.7 and 1.9.2.
+
+Per https://github.com/timonk/fixed_width/pull/1, this fork will not be reintegrated into the fixed_width because it adds the ActiveSupport dependency.
+
+DESCRIPTION:
+============
+
+A simple, clean DSL for describing, writing, and parsing fixed-width text files.
+
+FEATURES:
+=========
+
+* Easy DSL syntax
+* Can parse and format fixed width files
+* Templated sections for reuse
+
+SYNOPSIS:
+=========
+
+##Creating a definition (Quick 'n Dirty)
+
+Hopefully this will cover 90% of use cases.
+
+    # Create a FixedWidth::Defintion to describe a file format
+    FixedWidth.define :simple do |d|
+      # This is a template section that can be reused in other sections
+      d.template :boundary do |t|
+        t.column :record_type, 4
+        t.column :company_id, 12
+      end
+    
+      # Create a section named :header
+      d.header(:align => :left) do |header|
+        # The trap tells FixedWidth which lines should fall into this section
+        header.trap { |line| line[0,4] == 'HEAD' }
+        # Use the boundary template for the columns
+        header.template :boundary
+      end
+    
+      d.body do |body|
+        body.trap { |line| line[0,4] =~ /[^(HEAD|FOOT)]/ }
+        body.column :id, 10, :parser => :to_i
+        body.column :first, 10, :align => :left, :group => :name
+        body.column :last,  10, :align => :left, :group => :name
+        body.spacer 3
+        body.column :city, 20  , :group => :address
+        body.column :state, 2  , :group => :address
+        body.column :country, 3, :group => :address
+      end
+    
+      d.footer do |footer|
+        footer.trap { |line| line[0,4] == 'FOOT' }
+        footer.template :boundary
+        footer.column :record_count, 10, :parser => :to_i
+      end
+    end
+
+This definition would output a parsed file something like this:
+
+    {
+        :body => [
+          { :id => 12,
+            :name => { :first => "Ryan", :last => "Wood" },
+            :address => { :city => "Foo", :state => 'SC', :country => "USA" }
+          },
+          { :id => 13,
+            :name => { :first => "Jo", :last => "Schmo" },
+            :address => { :city => "Bar", :state => "CA", :country => "USA" }
+          }
+        ],
+        :header => [{ :record_type => 'HEAD', :company_id => 'ABC'  }],
+        :footer => [{ :record_type => 'FOOT', :company_id => 'ABC', :record_count => 2  }]
+    }
+
+##Sections
+###Declaring a section
+
+Sections can have any name, however duplicates are not allowed. (A `DuplicateSectionNameError` will be thrown.) We use the standard `method_missing` trick. So if you see any unusual behavior, that's probably the first spot to look.
+
+    FixedWidth.define :simple do |d|
+        d.a_section_name do |s|
+            ...
+        end
+        d.another_section_name do |s|
+            ...
+        end
+    end
+
+### Section options:
+
+* `:singular` (default `false`) indicates that the section will only have a single record, and that it should not be returned nested in an array.
+
+* `:optional` (default `false`) indicates that the section is optional. (An otherwise-specified section will raise a `RequiredSectionNotFoundError` if the trap block doesn't match the row after the last one of the previous section.)
+
+##Columns
+###Declaring a column
+
+Columns can have any name, except for `:spacer` which is reserved. Also, duplicate column names within groupings are not allowed, and a column cannot share the same name as a group. (A `DuplicateColumnNameError` will be thrown for a duplicate column name within a grouping. A `DuplicateGroupNameError` will be thrown if you try to declare a column with the same name as an existing group or vice versa.) Again, basic `method_missing` trickery here, so be warned. You can declare columns either with the `method_missing` thing or by calling `Section#column`.
+
+    FixedWidth.define :simple do |d|
+        d.a_section_name do |s|
+            s.a_column_name 12
+            s.column :another_column_name, 14
+        end
+    end
+
+###Column Options:
+
+* `:align` can be set to `:left` or `:right`, to indicate which side the values should be/are justified to. By default, all columns are aligned `:right`.
+
+* `:group` can be set to a `Symbol` indicating the name of the nested hash which the value should be parsed to when reading/the name of the nested hash the value should be extracted from when writing.
+
+* `:parser` and `:formatter` options are symbols (to be proc-ified) or procs. By default, parsing and formatting assume that we're expecting/writing right-aligned strings, padded with spaces.
+
+* `:nil_blank` set to true will cause whitespace-only fields to be parsed to nil, regardless of `:parser`.
+
+* `:padding` can be set to a single character that will be used to pad formatted values, when writing fixed-width files.
+
+* `:truncate` can be set to true to truncate any value that exceeds the `length` property of a column. If unset or set to `false`, a `FixedWidth::FormattedStringExceedsLengthError` exception will be thrown.
+
+##Writing out fixed-width records
+
+Then either feed it a nested struct with data values to create the file in the defined format:
+
+    test_data = {
+        :body => [
+          { :id => 12,
+            :name => { :first => "Ryan", :last => "Wood" },
+            :address => { :city => "Foo", :state => 'SC', :country => "USA" }
+          },
+          { :id => 13,
+            :name => { :first => "Jo", :last => "Schmo" },
+            :address => { :city => "Bar", :state => "CA", :country => "USA" }
+          }
+        ],
+        :header => [{ :record_type => 'HEAD', :company_id => 'ABC'  }],
+        :footer => [{ :record_type => 'FOOT', :company_id => 'ABC', :record_count => 2  }]
+    }
+
+    # Generates the file as a string
+    puts FixedWidth.generate(:simple, test_data)
+
+    # Writes the file
+    FixedWidth.write(file_instance, :simple, test_data)
+
+Or parse files already in that format into a nested hash:
+
+    parsed_data = FixedWidth.parse(file_instance, :test).inspect
+
+INSTALL:
+========
+
     sudo gem install fixed_width

data/VERSION

@@ -1 +1 @@
-0.2.2
+0.2.3

data/fixed_width-multibyte.gemspec

@@ -4,21 +4,14 @@
 # -*- encoding: utf-8 -*-
 
 Gem::Specification.new do |s|
-  s.name = %q{fixed_width-multibyte}
-  s.version = "0.2.2"
+  s.name = "fixed_width-multibyte"
+  s.version = "0.2.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Timon Karnezos"]
-  s.date = %q{2011-05-21}
-  s.description = %q{A gem that provides a DSL for parsing and writing files of fixed-width records.
-
-Multibyte support added while Timon is on vacation.
-
-Shamelessly forked from ryanwood/slither [http://github.com/ryanwood/slither].
-
-Renamed the gem to be a little clearer as to its purpose. Hate that 'nokogiri' nonsense.
-}
-  s.email = %q{timon.karnezos@gmail.com}
+  s.date = "2012-01-27"
+  s.description = "A gem that provides a DSL for parsing and writing files of fixed-width records.\n\nMultibyte support added while Timon is on vacation.\n\nShamelessly forked from ryanwood/slither [http://github.com/ryanwood/slither].\n\nRenamed the gem to be a little clearer as to its purpose. Hate that 'nokogiri' nonsense.\n"
+  s.email = "timon.karnezos@gmail.com"
   s.extra_rdoc_files = [
     "README.markdown",
     "TODO"
@@ -32,7 +25,7 @@ Renamed the gem to be a little clearer as to its purpose. Hate that 'nokogiri' n
     "VERSION",
     "examples/readme_example.rb",
     "fixed_width-multibyte.gemspec",
-    "fixed_width.gemspec",
+    "lib/fixed_width-multibyte.rb",
     "lib/fixed_width.rb",
     "lib/fixed_width/column.rb",
     "lib/fixed_width/core_ext/symbol.rb",
@@ -49,10 +42,10 @@ Renamed the gem to be a little clearer as to its purpose. Hate that 'nokogiri' n
     "spec/section_spec.rb",
     "spec/spec_helper.rb"
   ]
-  s.homepage = %q{http://github.com/timonk/fixed_width}
+  s.homepage = "http://github.com/timonk/fixed_width"
   s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.6.2}
-  s.summary = %q{A gem that provides a DSL for parsing and writing files of fixed-width records.}
+  s.rubygems_version = "1.8.10"
+  s.summary = "A gem that provides a DSL for parsing and writing files of fixed-width records."
 
   if s.respond_to? :specification_version then
     s.specification_version = 3

data/lib/fixed_width-multibyte.rb

@@ -0,0 +1 @@
+require File.expand_path('../fixed_width', __FILE__)

data/lib/fixed_width.rb

@@ -1,4 +1,3 @@
-$: << File.dirname(__FILE__)
 require 'ostruct'
 
 require 'active_support'

metadata

@@ -1,47 +1,48 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: fixed_width-multibyte
-version: !ruby/object:Gem::Version 
+version: !ruby/object:Gem::Version
+  version: 0.2.3
   prerelease: 
-  version: 0.2.2
 platform: ruby
-authors: 
+authors:
 - Timon Karnezos
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-05-21 00:00:00 -05:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2012-01-27 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: activesupport
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: &2177839880 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
-  version_requirements: *id001
-description: |
-  A gem that provides a DSL for parsing and writing files of fixed-width records.
-  
+  prerelease: false
+  version_requirements: *2177839880
+description: ! 'A gem that provides a DSL for parsing and writing files of fixed-width
+  records.
+
+
   Multibyte support added while Timon is on vacation.
-  
+
+
   Shamelessly forked from ryanwood/slither [http://github.com/ryanwood/slither].
-  
-  Renamed the gem to be a little clearer as to its purpose. Hate that 'nokogiri' nonsense.
 
+
+  Renamed the gem to be a little clearer as to its purpose. Hate that ''nokogiri''
+  nonsense.
+
+'
 email: timon.karnezos@gmail.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - README.markdown
 - TODO
-files: 
+files:
 - COPYING
 - HISTORY
 - README.markdown
@@ -50,7 +51,7 @@ files:
 - VERSION
 - examples/readme_example.rb
 - fixed_width-multibyte.gemspec
-- fixed_width.gemspec
+- lib/fixed_width-multibyte.rb
 - lib/fixed_width.rb
 - lib/fixed_width/column.rb
 - lib/fixed_width/core_ext/symbol.rb
@@ -66,33 +67,29 @@ files:
 - spec/parser_spec.rb
 - spec/section_spec.rb
 - spec/spec_helper.rb
-has_rdoc: true
 homepage: http://github.com/timonk/fixed_width
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.6.2
+rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
 summary: A gem that provides a DSL for parsing and writing files of fixed-width records.
 test_files: []
-
+has_rdoc: 

data/fixed_width.gemspec

@@ -1,76 +0,0 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
-# -*- encoding: utf-8 -*-
-
-Gem::Specification.new do |s|
-  s.name = %q{fixed_width}
-  s.version = "0.2.1"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Timon Karnezos"]
-  s.date = %q{2010-05-31}
-  s.description = %q{A gem that provides a DSL for parsing and writing files of fixed-width records.
-
-Shamelessly forked from ryanwood/slither [http://github.com/ryanwood/slither].
-
-Renamed the gem to be a little clearer as to its purpose. Hate that 'nokogiri' nonsense.
-}
-  s.email = %q{timon.karnezos@gmail.com}
-  s.extra_rdoc_files = [
-    "README.markdown",
-     "TODO"
-  ]
-  s.files = [
-    ".gitignore",
-     "COPYING",
-     "HISTORY",
-     "README.markdown",
-     "Rakefile",
-     "TODO",
-     "VERSION",
-     "examples/readme_example.rb",
-     "fixed_width.gemspec",
-     "lib/fixed_width.rb",
-     "lib/fixed_width/column.rb",
-     "lib/fixed_width/core_ext/symbol.rb",
-     "lib/fixed_width/definition.rb",
-     "lib/fixed_width/fixed_width.rb",
-     "lib/fixed_width/generator.rb",
-     "lib/fixed_width/parser.rb",
-     "lib/fixed_width/section.rb",
-     "spec/column_spec.rb",
-     "spec/definition_spec.rb",
-     "spec/fixed_width_spec.rb",
-     "spec/generator_spec.rb",
-     "spec/parser_spec.rb",
-     "spec/section_spec.rb",
-     "spec/spec_helper.rb"
-  ]
-  s.homepage = %q{http://github.com/timonk/fixed_width}
-  s.rdoc_options = ["--charset=UTF-8"]
-  s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.6}
-  s.summary = %q{A gem that provides a DSL for parsing and writing files of fixed-width records.}
-  s.test_files = [
-    "spec/column_spec.rb",
-     "spec/definition_spec.rb",
-     "spec/fixed_width_spec.rb",
-     "spec/generator_spec.rb",
-     "spec/parser_spec.rb",
-     "spec/section_spec.rb",
-     "spec/spec_helper.rb",
-     "examples/readme_example.rb"
-  ]
-
-  if s.respond_to? :specification_version then
-    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
-    s.specification_version = 3
-
-    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
-    else
-    end
-  else
-  end
-end
-