act_as_importable 0.0.6 → 0.0.7

data/README.md

@@ -1,6 +1,6 @@
 # ActAsImportable
 
-Helps you easily import records from a CSV file.
+Helps you easily import records from a CSV file or an array of hashes.
 
 ## Installation
 
@@ -22,7 +22,38 @@ Or install it yourself as:
 class User < ActiveRecord::Base
   act_as_importable
 end
+
+User.import_csv_file('/path/to/file.csv')
+# or
+User.import_csv_text(csv_text)
+# or
+User.import_data(array_of_hashes)
+```
+
+## CSV File Format
+
+The importer will automatically map the column headers to the attributes of the model.
+
+###Example:
+```
+first_name,last_name,email
+John,Smith,j.smith@gmail.com
+```
+
+This will create a new User called John Smith with the email address j.smith@gmail.com.
+
+## Updating existing records
+
+You can specify a unique field that will be used to find existing records.
+
+###Example:
 ```
+User.import_csv_file('/path/to/file.csv', :uid => :email)
+```
+
+This will find an existing record with a matching email address and update their name.
+If no record exists it will create a new one.
+
 
 ## Test
 

data/lib/act_as_importable/base.rb

@@ -8,7 +8,7 @@ module ActAsImportable
     module ClassMethods
 
       def import_csv_file(file, options = {})
-        import_csv_text(File.read(file), options)
+        import_csv_text(read_file(file, options), options)
       end
 
       def import_csv_text(text, options = {})
@@ -18,6 +18,12 @@ module ActAsImportable
         end
       end
 
+      def import_data(data, options = {})
+        data.map do |row|
+          import_record(row, options)
+        end
+      end
+
       # Creates or updates a model record
       # Existing records are found by the column(s) specified by the :uid option (default 'id').
       # If the values for the uid columns are not provided the row will be ignored.
@@ -31,7 +37,9 @@ module ActAsImportable
         record = find_or_create_by_uids(uid_values(row, options))
         remove_uid_values_from_row(row, options)
         record.update_attributes(row)
-        record.save
+        unless record.save
+          Rails.logger.error(record.errors.full_messages)
+        end
         record
       end
 
@@ -87,6 +95,14 @@ module ActAsImportable
         end
       end
 
+      def read_file(file, options = {})
+        if options[:encoding]
+          File.read(file, :encoding => options[:encoding])
+        else
+          File.read(file)
+        end
+      end
+
     end
   end
 end

data/lib/act_as_importable/version.rb

@@ -1,3 +1,3 @@
 module ActAsImportable
-  VERSION = "0.0.6"
+  VERSION = "0.0.7"
 end

data/spec/act_as_importable/act_as_importable_spec.rb

@@ -74,7 +74,22 @@ describe "an act_as_importable model" do
     it "should return an array of imported records" do
       Item.import_csv_text(text).should == Item.all.to_a
     end
+  end
+
+  describe "import data" do
+    let(:beer) { { :name => 'Beer', :price => 2.5 } }
+    let(:apple) { {:name => 'Apple', :price => 0.5} }
+    let(:data) { [beer, apple] }
 
+    it 'should call import_record with row hashes' do
+      Item.should_receive(:import_record).with(beer, {}).once
+      Item.should_receive(:import_record).with(apple, {}).once
+      Item.import_data(data)
+    end
+
+    it "should return an array of imported records" do
+      Item.import_data(data).should == Item.all.to_a
+    end
   end
 
   describe "import record" do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: act_as_importable
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-03-09 00:00:00.000000000 Z
+date: 2013-03-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport