hflr 1.4.1 → 1.5.1

data/History.txt

@@ -29,3 +29,7 @@
 
    * conditionally use force_encoding, if method available
 
+
+== 1.5.1
+
+  * Add set_random() and get_random_record(record_number) for random access mode. See examples.rb in test directory for example code.

data/hflr.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{hflr}
-  s.version = "1.4.1"
+  s.version = "1.5.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Colin Davis", "Wade Stebbings"]
@@ -25,7 +25,7 @@ See the tests and examples bundled with this gem.}
   #s.rdoc_options = ["--main", "README.txt"]
   s.require_paths = ["lib"]
 
-  s.rubygems_version = %q{1.4.1}
+  s.rubygems_version = %q{1.5.1}
   s.summary = %q{HFLR -- Hierarchical Fixed Length Records  Allows you to read and write files of fixed width records when the file contains one or more than one type of record}
   s.test_files = ["test/test_hflr.rb", "test/test_helper.rb"]
 end

data/lib/hflr/fl_record_file.rb

@@ -24,20 +24,44 @@ class FLRFile
     end        
   end
   
-  def set_fast
-  @fast = !@record_type_labels.is_a?(Hash)                    
-  unless @fast    
-  raise "Cannot set fast mode with more than one record type."
+  def set_random
+    if @fast
+      raise "Cannot set random access mode with fast mode already set."
+    end
+    
+    @random = !@record_type_labels.is_a?(Hash)                    
+    @random or raise "Cannot set random mode with more than one record type."
+    @width = get_record_width_from_file
+  end
+  
+  def get_random_record(record_number)
+    return record_number if record_number.nil?
+    offset = record_number * @width
+    begin
+      @file.pos = offset
+      line = @file.read(@width)
+    rescue Exception=>msg
+      return nil
+    end
+    build_record(line)          
   end
-      if @fast
+  
+  
+  def set_fast
+    if @random 
+      raise "Already set random access mode"
+    end
+    
+    @fast = !@record_type_labels.is_a?(Hash)                    
+    unless @fast    
+        raise "Cannot set fast mode with more than one record type."
+    end
+        if @fast
        @width = get_record_width_from_file
 
-
        records_to_take =  100000000 / @width
-
        @buffer_size = @width * records_to_take       
        
-
        @position=0
        @current_buffer=nil
       end        
@@ -214,6 +238,7 @@ def offsets_to_read(ranges, width)
 end
 
 def get_record_width_from_file  
+  @file.rewind
   width = @file.gets.size 
   @file.rewind
   width

data/test/examples.rb

@@ -23,7 +23,24 @@ end
 def show(record)
   print record.members.map{|m| m.to_s + ": " + record[m].to_s}.join(", ") + "\n" 
   end
+  
+  
+  # You can read the file in random order:
+  customer_file.set_random
+  record = customer_file.get_random_record(2)
+puts "Record 2 randomly accessed:   #{record.name} #{record.zip} "
+record = customer_file.get_random_record(0)
+puts "Record 0 randomly accessed:   #{record.name} #{record.zip} "
+record = customer_file.get_random_record(1)
+puts "Record 1 randomly accessed:   #{record.name} #{record.zip} "
+
+record = customer_file.get_random_record(11)
+puts "Returns a nil if record is off the end of the file: #{record.to_s}"
 
+  
+  
+  
+# You can read through a file with more than one record type:
 # metadata for customer_orders file
 layouts = {:customer=>[
   Column.new("name",1,25),

metadata

@@ -1,21 +1,21 @@
 --- !ruby/object:Gem::Specification
 name: hflr
 version: !ruby/object:Gem::Version
-  version: 1.4.1
-  prerelease: 
+  version: 1.5.1
+  prerelease:
 platform: ruby
 authors:
 - Colin Davis
 - Wade Stebbings
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
 date: 2013-03-08 00:00:00.000000000 Z
 dependencies: []
-description: ! "HFLR -- Hierarchical Fixed Length Records\n\nAllows you to read and
-  write files of fixed width records when the file contains one or more\nthan one
-  type of record.  \n\nInstall with 'gem install hflr'\n\nSee the tests and examples
-  bundled with this gem."
+description: "HFLR -- Hierarchical Fixed Length Records\n\nAllows you to read and\
+  \ write files of fixed width records when the file contains one or more\nthan one\
+  \ type of record.  \n\nInstall with 'gem install hflr'\n\nSee the tests and examples\
+  \ bundled with this gem."
 email: colin.c.davis@gmail.com
 executables: []
 extensions: []
@@ -42,31 +42,32 @@ files:
 - test/sample_out.dat
 - test/test_helper.rb
 - test/test_hflr.rb
-homepage: 
+homepage:
 licenses: []
-post_install_message: 
+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
+      version: !binary |-
+        MA==
   none: false
+required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: !binary |-
+        MA==
+  none: false
 requirements: []
-rubyforge_project: 
+rubyforge_project:
 rubygems_version: 1.8.24
-signing_key: 
+signing_key:
 specification_version: 3
-summary: HFLR -- Hierarchical Fixed Length Records  Allows you to read and write files
-  of fixed width records when the file contains one or more than one type of record
+summary: HFLR -- Hierarchical Fixed Length Records  Allows you to read and write files of fixed width records when the file contains one or more than one type of record
 test_files:
 - test/test_hflr.rb
 - test/test_helper.rb