file-formatter 0.2.1

data/LICENSE

@@ -0,0 +1,27 @@
+File-Formatter for Ruby
+-----------------------
+Homepage:  http://rubyforge.org/projects/file-formatter/
+Copyright: Copyright � 2007 Daniel Mantilla.
+Summary:   MIT-style
+
+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 names of its contributors may not be used to endorse or promote
+  products derived from this software without specific prior written
+  permission.
+
+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

@@ -0,0 +1,17 @@
+File Formatter for Ruby
+-----------------------
+This library provides the ability to transform delimited or fixed length files
+into another delimited file. It's completely flexible on the names used and 
+full Ruby expressions can be used when generating the output.
+Please refer to the documentation ("manual.doc") for further explanation.
+
+Homepage::  http://rubyforge.org/projects/file-formatter/
+Copyright:: 2007, Daniel Mantilla
+
+LICENSE NOTES
+-------------
+Please read the file LICENSE for licensing restrictions on this library.
+
+Requirements
+------------
+File-Formatter requires Ruby 1.8.2 or better, it uses CSV to parse delimited files.

data/gemspec.rb

@@ -0,0 +1,13 @@
+require 'rubygems'
+SPEC = Gem::Specification.new do |s|
+  s.name = "file-formatter"
+  s.version = "0.2.1"
+  s.author = "Daniel Mantilla"
+  s.email = "dmantilla@yahoo.com"
+  s.homepage = "http://appcabinet.com"
+  s.platform = Gem::Platform::RUBY
+  s.summary = "Transforms a fixed/delimited file into another delimited file"
+  s.files = Dir["./*"] + Dir["*/**"]
+  s.has_rdoc = true
+  s.require_path = "lib"
+end

data/lib/file_formatter.rb

@@ -0,0 +1,19 @@
+require 'file_formatter_input'
+require 'file_formatter_input_data'
+require 'file_formatter_output'
+require 'file_formatter_output_data'
+
+class FileFormatter
+
+	# CONSTANTS
+	
+	DATA_FORMATS = [:delimited, :fixed]
+	DATA_DELIMITERS = {
+		:colon => ':',
+		:semicolon => ';',
+		:pipe => '|',
+		:space => ' ',
+		:comma => ',',
+		:dot => '.'
+	}
+end

data/lib/file_formatter_input.rb

@@ -0,0 +1,52 @@
+class FileFormatterInput
+	
+	include Reloadable if defined? Reloadable
+	
+	attr_accessor :__yaml__, :file_path, :file_name
+	
+	def initialize(yaml_def)
+		raise 'No definition was provided' if yaml_def.size.zero?
+		
+		@__yaml__ = yaml_def.dup
+		
+		@data = FileFormatterInputData.new
+
+		# Load Yaml into a hash
+		input_def = YAML::load(yaml_def)
+		raise 'Hash was not provided.' unless input_def.is_a?  Hash
+		raise 'No entries exist in the Hash' if input_def.length.zero?
+
+		input_def.each {|k,v| instance_eval("self.#{k}=v")}
+	end
+	
+	def data; @data; end
+	def data=(value); @data.data = value; end
+	
+	def file_full_name; File.join(file_path, file_name); end
+
+	def parse(max_lines=nil)
+		input = File.open(file_full_name)
+		
+		i = 0
+		
+		while !input.eof?
+			@data.__set_content__(input.readline)
+			
+			yield @data
+			
+			break if (i += 1) == max_lines
+		end
+		
+		input.close
+		input = nil
+	end
+	
+	def method_missing(sym, *args)
+		if sym.to_s == @data.__name__
+			@data
+		else
+			super(sym, *args)
+		end
+	end
+end
+

data/lib/file_formatter_input_data.rb

@@ -0,0 +1,131 @@
+class FileFormatterInputData
+
+	include Reloadable if defined? Reloadable
+	
+	attr_accessor :data, :__name__, :__format__, :__delimiter__
+	
+	def initialize
+		@__format__ = :delimited
+		@__delimiter__ = :comma
+		# A hash is used to speed things up a bit 
+		@children = []
+	end
+	
+	def __set_content__(text_line)
+		if __format__ == :delimited
+			# Parse the line (space separator has a different behaviour)
+			if __delimiter__ == :space
+				@content = text_line.split(FileFormatter::DATA_DELIMITERS[__delimiter__])
+			else
+				@content = CSV::parse_line(text_line, FileFormatter::DATA_DELIMITERS[__delimiter__])
+			end
+		else
+			# Fixed format
+			@content = []
+			i = 0
+			@data.keys.sort.each do |k|
+				# There may be situations where indexed are skipped, as a result
+				# some nil values may be stored in the array
+				if @data[k]
+					#puts @data[k].to_yaml
+					@content << text_line[i, @data[k][1]]
+					i += @data[k][1]
+				end
+			end
+		end
+		# Check if there are any other objects embedded
+		@children.each {|item| item[1].__set_content__(@content[item[0]])}
+	end
+	
+	def __format__=(value)
+		symbol_value = value.is_a?(Symbol) ? value : value.downcase.intern
+
+		if FileFormatter::DATA_FORMATS.include? symbol_value
+			@__format__ = symbol_value
+		else
+			raise "Invalid format '#{value}'"
+		end
+	end
+	
+	def __delimiter__=(value)
+		symbol_value = value.is_a?(Symbol) ? value : value.downcase.intern
+		
+		if FileFormatter::DATA_DELIMITERS.include? symbol_value
+			@__delimiter__ = symbol_value
+		else
+			raise "Invalid delimiter '#{value}'"
+		end
+	end
+	
+	def data=(hash_value)
+		@data = {}
+		
+		# Make sure the file format is set first if specified
+		self.__format__ = hash_value['format'] if hash_value['format']
+		
+		hash_value.each do |k,v|
+			# Only string keys are stored as properties and removed from hash
+			if k.is_a? String
+				instance_eval("self.__#{k}__ = v")
+				hash_value.delete(k)
+			elsif k.is_a? Fixnum
+				# If the value has a hash
+				if v.is_a? Hash
+					# And the hash is a data element, create a new instance of the class
+					if v.include? 'data'
+						input_data = FileFormatterInputData.new
+						input_data.data = v['data']
+						@data[k] = [input_data]
+						@children << [k,input_data]
+					end
+				else
+					# Not a hash? the value is stored as an array always
+					# If it's a fixed format file, make sure there are two values
+					# the first is the field name and the second the length
+					if __format__ == :fixed
+						field_name, field_length = v.split(',')
+						# If the length was not specified, throw error
+						if field_length.to_i.zero?
+							raise "Field #{field_name} has not length associated."
+						else
+							@data[k] = [field_name, field_length.to_i]
+						end
+					else
+						@data[k] = [v]
+					end
+				end
+			end
+		end
+	end
+
+	def method_missing(sym, *args)
+		element_name = sym.to_s
+		# We look for the element name in the hash
+		# i.e. {1=>'name', 2=>'address'} 
+		# if a "name" method is requested search in the values and return the key 
+		if entry = @data.find {|k,v| v[0] == element_name}
+			# if there is content (!nil) return the requested element from the array 
+			@content ? @content[entry[0]].to_s : '[error no input provided]'
+			
+		elsif !@children.size.zero?
+			# Check if any of the values that contain instances of FileFormatterInputData matches the symbol
+			inner_data = nil
+			@data.each do |k,v|
+				if v[0].is_a? FileFormatterInputData
+					if v[0].__name__ == element_name
+						inner_data = v[0]
+						break
+					end
+				end
+			end
+			
+			if inner_data
+				inner_data
+			else
+				super(sym, *args)
+			end
+		else
+			super(sym, *args)
+		end
+	end
+end

data/lib/file_formatter_output.rb

@@ -0,0 +1,54 @@
+class FileFormatterOutput
+	
+	include Reloadable if defined? Reloadable
+	
+	attr_accessor :__yaml__, :file_path, :file_name
+	
+	def initialize(yaml_def, formatter_input)
+		raise 'No definition was provided' if yaml_def.size.zero?
+		
+		@__yaml__ = yaml_def.dup
+
+		@data = FileFormatterOutputData.new(formatter_input)
+		
+		# Load Yaml into a hash
+		output_def = YAML::load(yaml_def)
+		raise 'Hash was not provided.' unless output_def.is_a?  Hash
+		raise 'No entries exist in the Hash' if output_def.length.zero?
+		
+		output_def.each {|k,v| instance_eval("self.#{k}=v")}
+	end
+	
+	def data; @data; end
+	def data=(value); @data.data = value; end
+	
+	def file_full_name; File.join(file_path, file_name); end
+
+	def generate(max_lines=nil)
+		input = File.open(@data.__formatter_input__.file_full_name)
+		output = File.open(file_full_name, 'w')
+		
+		i = 0
+		
+		while !input.eof?
+			@data.__formatter_input__.data.__set_content__(input.readline)
+			output_line = @data.__generate_line__
+			
+			yield output_line if block_given?
+			
+			output.puts output_line
+			
+			break if (i += 1) == max_lines
+		end
+		
+		output.close
+		output = nil
+		
+		input.close
+		input = nil
+		
+		return i
+	end
+
+end
+

data/lib/file_formatter_output_data.rb

@@ -0,0 +1,53 @@
+class FileFormatterOutputData
+
+	include Reloadable if defined? Reloadable
+	
+	attr_accessor :data, :__formatter_input__, :__name__, :__format__, :__delimiter__
+	
+	def initialize(formatter_input)
+		@__formatter_input__ = formatter_input
+		
+		@__format__ = :delimited
+		@__delimiter__ = :comma
+	end
+	
+	def data=(hash_value)
+		@data = {}
+		hash_value.each do |k,v|
+			# Only string keys are stored as properties and removed from hash
+			if k.is_a? String
+				instance_eval("self.__#{k}__ = v")
+				hash_value.delete(k)
+			elsif k.is_a? Fixnum
+				@data[k] = v
+			end
+		end
+	end
+
+	def __raw_value__(index); @data.fetch(index, ''); end
+	
+	def __value__(index) 
+		value = __raw_value__(index).to_s
+		instance_eval(value) rescue value
+	end
+	
+	def __generate_line__
+		array_out = []
+		@data.each do |k,v|
+			array_out[k] = __value__(k) if k.is_a?(Fixnum)
+		end
+		
+		CSV.generate_line(array_out, FileFormatter::DATA_DELIMITERS[__delimiter__])
+	end
+
+	def method_missing(sym, *args)
+		# If the requested method matches the name of the formatter_input
+		# it is returned, i.e. 'presort_run'
+		if @__formatter_input__ and (sym.to_s == @__formatter_input__.data.__name__)
+			@__formatter_input__.data
+		else
+			super(sym, *args)
+		end
+	end
+	
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.2
+specification_version: 1
+name: file-formatter
+version: !ruby/object:Gem::Version 
+  version: 0.2.1
+date: 2007-05-07 00:00:00 -04:00
+summary: Transforms a fixed/delimited file into another delimited file
+require_paths: 
+- lib
+email: dmantilla@yahoo.com
+homepage: http://appcabinet.com
+rubyforge_project: 
+description: 
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Daniel Mantilla
+files: 
+- ./gemspec.rb
+- ./lib
+- ./LICENSE
+- ./manual.doc
+- ./README
+- lib/file_formatter.rb
+- lib/file_formatter_input.rb
+- lib/file_formatter_input_data.rb
+- lib/file_formatter_output.rb
+- lib/file_formatter_output_data.rb
+test_files: []
+
+rdoc_options: []
+
+extra_rdoc_files: []
+
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: []
+