pixxxer 0.1.0

data/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2011 Guy Royse & Alyssa Diaz
+
+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,52 @@
+Pixxxer
+=======
+
+Installation
+------------
+Installation is super easy.  Gems works like that.
+
+	gem install pixxxer
+
+Usage
+-----
+
+Pixxxer provide a simple DSL for defining fixed with data and then extensions to String and Hash to build and parse
+those records.  It can handle floats, integers, and strings.
+
+Assuming a record like this:
+
+	Title     Author    Qty  Price
+	-----     ------    ---  -----
+    Dune      Herbert   0012001295
+	012345678901234567890123456789
+	          1         2         
+
+You can define the follwing template:
+
+	define_pixxx_template(:book)
+		.add_field(:title).as_string.at_position(0).with_width(10).and
+		.add_field(:author).as_string.at_position(10).with_width(10).and
+		.add_field(:quantity).as_integer.at_position(20).with_width(5).and
+		.add_field(:price).as_float.at_position(25).with_width(5).with_precision(2)
+
+To use the template to parse:
+
+	record = 'Dune      Herbert   0012001295'.pixxxit(:book)
+	record[:title].should == 'Dune      '
+	record[:author].should == 'Herbert    '
+	record[:quantity].should == 120
+	record[:price].should == 12.95
+
+To use the template to build a record:
+
+	s = record.depixxxit(:book)
+	s.should == 'Dune      Herbert   0012001295'
+
+Note:
+- Most things default to zero
+- Fields default to strings
+- at_position is zero-based
+
+Copyright
+---------
+Copyright(c) 2011 Guy Royse & Alyssa Diaz. See LICENSE for further details.

data/lib/pixxxer.rb

@@ -0,0 +1 @@
+require 'pixxxer/pixxxer'

data/lib/pixxxer/field.rb

@@ -0,0 +1,47 @@
+require 'pixxxer/field_pixxxitter'
+require 'pixxxer/field_depixxxitter'
+
+class PixxxerField
+	attr_reader :width, :name, :position, :type, :precision
+	def initialize(field_name, template)
+		@template = template
+		@name = field_name
+		@position = 0
+		@precision = 0
+		@pixxxitter = FieldPixxxitter.new self
+		@depixxxitter = FieldDepixxxitter.new self
+	end
+	def with_width(width)
+		@width = width
+		self
+	end
+	def at_position(position)
+		@position = position
+		self
+	end
+	def as_string
+		self
+	end
+	def as_integer
+		@type = Integer
+		self
+	end
+	def as_float
+		@type = Float
+		self
+	end
+	def with_precision(precision)
+		@precision = precision
+		self
+	end
+	def and
+		@template
+	end
+	def pixxxit(hash, record)
+		@pixxxitter.pixxxit hash, record
+	end
+	def depixxxit(record)
+		@depixxxitter.depixxxit record
+	end
+end
+

data/lib/pixxxer/field_depixxxitter.rb

@@ -0,0 +1,22 @@
+class FieldDepixxxitter
+	def initialize(field)
+		@field = field
+	end
+	def depixxxit(record)
+		field = extract_field record
+		coerce_field field
+	end
+	def extract_field(record)
+		return record[@field.position...record.length] if @field.width.nil?
+		record[@field.position, @field.width]
+	end
+	def coerce_field(field)
+		return field.to_i if @field.type == Integer
+		return adjust_float(field.to_f) if @field.type == Float
+		field
+	end
+	def adjust_float(field)
+		field / 10 ** @field.precision
+	end
+end
+

data/lib/pixxxer/field_pixxxitter.rb

@@ -0,0 +1,45 @@
+class FieldPixxxitter
+	def initialize(field)
+		@field = field
+	end
+	def pixxxit(hash, record)
+		field = fetch_field hash
+		add_to_record record, field
+	end
+	def add_to_record(record, field)
+		record = widen_record record
+		inject_field record, field
+	end
+	def widen_record(record)
+		record.ljust @field.position
+	end
+	def inject_field(record, field)
+		record[@field.position, field.length] = field
+		record
+	end
+	def fetch_field(hash)
+		field = coerce_field hash[@field.name].to_s
+		field = pad_field field
+		shorten_field field
+	end
+	def coerce_field(field)
+		field = (field.to_f * 10 ** @field.precision).to_i if @field.type == Float
+		field.to_s
+	end
+	def shorten_field(field)
+		if @field.type == Integer || @field.type == Float
+			return field[field.length - @field.width, @field.width] unless @field.width.nil?
+		else
+			return field[0, @field.width] unless @field.width.nil?
+		end
+		field
+	end
+	def pad_field(field)
+		if @field.type == Integer || @field.type == Float
+			return field.rjust(@field.width, '0') unless @field.width.nil?
+		else
+			return field.ljust(@field.width, ' ') unless @field.width.nil?
+		end
+		field
+	end
+end

data/lib/pixxxer/field_pixxxitter.rb~

@@ -0,0 +1,46 @@
+class FieldPixxxitter
+	def initialize(field)
+		@field = field
+	end
+	def pixxxit(hash, record)
+		field = fetch_field hash
+		add_to_record record, field
+	end
+	def add_to_record(record, field)
+		record = widen_record record
+		inject_field record, field
+	end
+	def widen_record(record)
+		record.ljust @field.position
+	end
+	def inject_field(record, field)
+		record[@field.position, field.length] = field
+		record
+	end
+	def fetch_field(hash)
+		field = coerce_field hash[@field.name].to_s
+		field = pad_field field
+		field = shorten_field field
+		field
+	end
+	def coerce_field(field)
+		field = (field.to_f * 10 ** @field.precision).to_i if @field.type == Float
+		field.to_s
+	end
+	def shorten_field(field)
+		if @field.type == Integer || @field.type == Float
+			return field[field.length - @field.width, @field.width] unless @field.width.nil?
+		else
+			return field[0, @field.width] unless @field.width.nil?
+		end
+		field
+	end
+	def pad_field(field)
+		if @field.type == Integer || @field.type == Float
+			return field.rjust(@field.width, '0') unless @field.width.nil?
+		else
+			return field.ljust(@field.width, ' ') unless @field.width.nil?
+		end
+		field
+	end
+end

data/lib/pixxxer/pixxxer.rb

@@ -0,0 +1,19 @@
+require 'pixxxer/template'
+
+$pixxxer_templates = {}
+
+def define_pixxx_template(template_name)
+	$pixxxer_templates[template_name] = PixxxerTemplate.new
+end
+
+class String
+	def depixxxit(template_name)
+		$pixxxer_templates[template_name].depixxxit self
+	end
+end
+
+class Hash
+	def pixxxit(template_name)
+		$pixxxer_templates[template_name].pixxxit self
+	end
+end

data/lib/pixxxer/template.rb

@@ -0,0 +1,26 @@
+require 'pixxxer/field'
+
+class PixxxerTemplate
+	def initialize
+		@fields = {}
+	end
+	def add_field(field_name)
+		@fields[field_name] = PixxxerField.new(field_name, self)
+		@fields[field_name]
+	end
+	def depixxxit(string)
+		record = {}
+		@fields.each do |field_name, field|
+			record[field_name] = field.depixxxit string
+		end
+		record
+	end
+	def pixxxit(hash)
+		string = ''
+		@fields.each do |field_name, field|
+			string = field.pixxxit hash, string
+		end
+		string
+	end
+end
+

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification
+name: pixxxer
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Guy Royse
+- Alyssa Diaz
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-05-12 00:00:00.000000000 -04:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &10736808 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.5.0
+  type: :development
+  prerelease: false
+  version_requirements: *10736808
+- !ruby/object:Gem::Dependency
+  name: rspec-core
+  requirement: &10736532 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.5.1
+  type: :development
+  prerelease: false
+  version_requirements: *10736532
+- !ruby/object:Gem::Dependency
+  name: rspec-expectations
+  requirement: &10736256 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.5.0
+  type: :development
+  prerelease: false
+  version_requirements: *10736256
+description: Simple interface for dealing with the fixed width records that are commong
+  required when working with legacy COBOL systems.
+email:
+- guy@guyroyse.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/pixxxer/field.rb
+- lib/pixxxer/field_depixxxitter.rb
+- lib/pixxxer/field_pixxxitter.rb
+- lib/pixxxer/field_pixxxitter.rb~
+- lib/pixxxer/pixxxer.rb
+- lib/pixxxer/template.rb
+- lib/pixxxer.rb
+- LICENSE
+- README.md
+has_rdoc: true
+homepage: http://github.com/guyroyse/pixxxer
+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: 1.5.2
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.5.2
+signing_key: 
+specification_version: 3
+summary: DSL for building and parsing fixed with records
+test_files: []