smarter_csv 1.0.0.pre1 → 1.0.0

data/README.md

@@ -23,7 +23,7 @@ As the existing CSV libraries didn't fit my needs, I was writing my own CSV proc
 #### Example 1: Reading a CSV-File in one Chunk, returning one Array of Hashes:
 
     filename = '/tmp/input_file.txt' # TAB delimited file, each row ending with Control-M
-    recordsA = SmarterCSV.process_csv(filename, {:col_sep => "\t", :row_sep => "\cM"}
+    recordsA = SmarterCSV.process(filename, {:col_sep => "\t", :row_sep => "\cM"}
 
     => returns an array of hashes
 
@@ -31,7 +31,7 @@ As the existing CSV libraries didn't fit my needs, I was writing my own CSV proc
 
     # without using chunks:
     filename = '/tmp/some.csv'
-    n = SmarterCSV.process_csv(filename, {:key_mapping => {:unwanted_row => nil, :old_row_name => :new_name}}) do |array|
+    n = SmarterCSV.process(filename, {:key_mapping => {:unwanted_row => nil, :old_row_name => :new_name}}) do |array|
           # we're passing a block in, to process each resulting hash / =row (the block takes array of hashes)
           # when chunking is not enabled, there is only one hash in each array
           MyModel.create( array.first )
@@ -44,7 +44,7 @@ As the existing CSV libraries didn't fit my needs, I was writing my own CSV proc
 
     # using chunks:
     filename = '/tmp/some.csv'
-    n = SmarterCSV.process_csv(filename, {:key_mapping => {:unwanted_row => nil, :old_row_name => :new_name}, :chunk_size => 100}) do |array|
+    n = SmarterCSV.process(filename, {:key_mapping => {:unwanted_row => nil, :old_row_name => :new_name}, :chunk_size => 100}) do |array|
           # we're passing a block in, to process each resulting hash / row (block takes array of hashes)
           # when chunking is enabled, there are up to :chunk_size hashes in each array
           MyModel.collection.insert( array )   # insert up to 100 records at a time
@@ -56,13 +56,19 @@ As the existing CSV libraries didn't fit my needs, I was writing my own CSV proc
 #### Example 4: Reading a CSV-like File, and Processing it with Resque:
 
     filename = '/tmp/strange_db_dump'   # a file with CRTL-A as col_separator, and with CTRL-B\n as record_separator (hello iTunes)
-    n = SmarterCSV.process_csv(filename, {:col_sep => "\cA", :row_sep => "\cB\n", :comment_regexp => /^#/,
+    n = SmarterCSV.process(filename, {:col_sep => "\cA", :row_sep => "\cB\n", :comment_regexp => /^#/,
             :chunk_size => '5' , :key_mapping => {:export_date => nil, :name => :genre}}) do |x|
         puts   "Resque.enque( ResqueWorkerClass, #{x.size}, #{x.inspect} )"   # simulate processing each chunk
     end
     => returns number of chunks
 
 
+## See also:
+
+  http://www.unixgods.org/~tilo/Ruby/process_csv_as_hashes.html
+
+
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -89,10 +95,3 @@ TODO: Write usage instructions here
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create new Pull Request
 
-
-## See also:
-
-  http://www.unixgods.org/~tilo/Ruby/process_csv_as_hashes.html
-
-  https://gist.github.com/3101950
-

data/lib/smarter_csv/smarter_csv.rb

@@ -29,7 +29,7 @@ module SmarterCSV
   #    This can be very useful when passing chunked data to a post-processing step, e.g. through Resque
   #
 
-  def SmarterCSV.process_csv(filename, options={}, &block)
+  def SmarterCSV.process(filename, options={}, &block)
     default_options = {:col_sep => ',' , :row_sep => $/ , :quote_char => '"', :remove_empty_fields => true,
       :comment_regexp => /^#/, :chunk_size => nil , :key_mapping_hash => nil
     }
@@ -107,5 +107,9 @@ module SmarterCSV
     end
   end
 
+  def SmarterCSV.process_csv(*args)
+    warn "[DEPRECATION] `process_csv` is deprecated.  Please use `process` instead."
+    SmarterCSV.process(*args)
+  end
 end
 

data/lib/smarter_csv/version.rb

@@ -1,3 +1,3 @@
 module SmarterCSV
-  VERSION = "1.0.0.pre1"
+  VERSION = "1.0.0"
 end

metadata

@@ -1,8 +1,8 @@
 --- !ruby/object:Gem::Specification
 name: smarter_csv
 version: !ruby/object:Gem::Version
-  version: 1.0.0.pre1
-  prerelease: 6
+  version: 1.0.0
+  prerelease: 
 platform: ruby
 authors:
 - ! 'Tilo Sloboda
@@ -50,9 +50,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
-  - - ! '>'
+  - - ! '>='
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.15