nebulous 0.0.4 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 15734d97663b72356a0c85a85a07e5bddc191a0f
-  data.tar.gz: a2fdc1e48d2835bc8a6e509733cbbb5a09ed9bdd
+  metadata.gz: bf7777af004a3e807166622d2e9cc01beb8b6d04
+  data.tar.gz: 59ad738d6c9b7ff3a81e9f476d1727f187dd9537
 SHA512:
-  metadata.gz: d98c33418a5c0c497027d57491e8e3698357bd35762b9c11efe67e8d97dce7458693b4129d52516d155e498ff3023b825c6c04e224e679e5f681fa17886dfd3f
-  data.tar.gz: 43845b83b364c806fa803affe6b5c8981af2286a68e0ca157d321c63328b0c27ddfb4e7d4f451ba82e5bb5dff7ba617513282c1ef8aa1258f9b106c2bd885862
+  metadata.gz: d9bc42df4140f2965205a2f8ae8379df12e9e18465b80a4264b74952d2ba7b262b4b50d78695bda7dc4a2889bcb4e18c4ef9e3268db7524cfd1cdf2b5ddd8d7a
+  data.tar.gz: 3bc3793318ea8bc82e0d839c0044a210c6906fe2ac5fe2652b214f9df7532e62d0ff2ccfce34add2ffbf61601219581c5b38a4593952f1db586cf32a70f12c82

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    nebulous (0.0.3)
+    nebulous (0.0.4)
       activesupport
       cocaine (~> 0.5)
 

data/README.md

@@ -18,6 +18,48 @@ Or install it yourself as:
 
 ## Usage
 
+Nebulous is a bit easier going than other CSV libraries for Ruby. It will parse
+data that would otherwise fail with Ruby's CSV and supports the common problems
+that are present in real-world CSV files. Nebulous will also try to intelligently
+determine the column delimiters and line terminators before parsing so you don't
+have to. Which makes handling CSV file uploads a breeze when you have no idea
+what you might get. Let's cover some examples.
+
+    Nebulous.process "path/to/file.csv"
+    => [{:first_name=>"Meghan", :last_name=>"Koch"},
+        {:first_name=>"Genoveva", :last_name=>"Dare"}, ...]
+
+Or process within a block in chunks of 10
+
+    Nebulous.process "path/to/file.csv", chunk: 10 do |chunk|
+      p chunk
+    end
+    => [{:first_name=>"Meghan", :last_name=>"Koch"},
+        {:first_name=>"Genoveva", :last_name=>"Dare"}, ...]
+    => [{:first_name=>"Chad", :last_name=>"Anderson"},
+        {:first_name=>"Arnold", :last_name=>"Yundt"}, ...]
+
+
+Or provide your own header mapping to normalize columns:
+
+    map = {first_name: :col1, last_name: :col2 }
+    Nebulous.process "path/to/file.csv", mapping: map
+    => [{:col1=>"どーもありがとう", :col2=>"ミスター·ロボット"},
+        {:col1=>"Meghan", :col2=>"Koch"}, 
+        {:col1=>"Genoveva", :col2=>"Dare"}]
+
+
+If you know your CSV file does not contain headers it will return simple Arrays.
+
+    Nebulous.process "path/to/file.csv", headers: false
+    => [["どーもありがとう", "ミスター·ロボット"],
+        ["Meghan", "Koch"], 
+        ["Genoveva", "Dare"]]
+
+Or provide a limit:
+
+    Nebulous.process "path/to/file.csv", limit: 1
+    => [{:first_name=>"どーもありがとう", :last_name=>"ミスター·ロボット"}]
 
 
 ## Contributing

data/lib/nebulous/input/parsing.rb

@@ -24,7 +24,7 @@ module Nebulous
 
       def yield_chunk(chunk, &_block)
         if chunk.full? || file.eof?
-          yield chunk.map(&:to_a)
+          yield chunk
           @chunk = nil
         end
       end

data/lib/nebulous/version.rb

@@ -1,3 +1,3 @@
 module Nebulous
-  VERSION = '0.0.4'.freeze
+  VERSION = '0.0.5'.freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nebulous
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors:
 - Zach Graves