from_excel 1.0.0 → 1.0.1

data/README.rdoc

@@ -1,6 +1,7 @@
 == Overview
 
 Import excel spreadsheet rows to ruby objects.
+
 For how to use it, see examples below or see unit tests
 
 == Install
@@ -10,9 +11,13 @@ For how to use it, see examples below or see unit tests
 == Dependencies
 
 gem 'nokogiri'
+
 gem 'roo'
+
 gem 'rubyzip'
+
 gem 'spreadsheet'
+
 gem 'google-spreadsheet-ruby'
 
 (also require 'active_support/inflector')
@@ -30,18 +35,17 @@ spreadsheet_file : File object as spreadsheet (ie :File.new ("path_to_spreadshee
 options :
  :mapping => hash mapping attribute <=> <column name or column index>
  :title => true|false . Pass false to indicate that columns have no title. True by default.
+ :offset_from_title. First row offset from title 
  :limits => :start => [first_row, first_column], :end => [last_row, last_column]
- :rules => Procs rules to convert data in cell sheet to desired data for object attribute.
- For example, transform a string to association id (see example below)
+ :rules => Procs rules to convert data in cell sheet to desired data for object attribute.For example, transform a string to association id (see example below)
  
 
-<b>Note: If columns have title, by default the row of columns titles is supposed to be the first row before the first row
-of data which will be convert to ruby object.</b>
+<b>Note</b>: If columns have title, by default the row of columns titles is supposed to be the first row before the first row of data which will be converted to ruby object.To change it, pass :offset_from_title => <offset>
  
 == Basic spreadsheet 
 
 Suppose you have this kind of Excel sheet:
-      A           B         C
+      A               B         C
    1 First name	Last name	 Age
    2 Albert	    Einstein	 131
    3 Leonard	  De Vinci	 558
@@ -61,16 +65,20 @@ You get theses users :
     User.new(:first_name => 'Martin', :last_name =>	'Heidegger', :age => 121)]
    
 By default, attributes model are retrieved from columns title with the following simple rule :
+
 o spaces are converted to "_"
+
 o words are downcased
    
-   First Name => :first_name
-   Last Name => :last_name
+First Name => :first_name
+
+Last Name => :last_name
       
 
 == Mapping attribute - column names
   
-If a column name can't be simply mapped to attribute model, you can pass a map to.    
+If a column name can't be simply mapped to attribute model, you can pass a map to.   
+ 
 If, with the last spreadsheet example, "First name" column had "Prenom" instead as title and you want this column
 to map :first_name attribute of User model, do like this :
 
@@ -79,7 +87,9 @@ to map :first_name attribute of User model, do like this :
 == Spreadsheet whithout columns title
 
 Suppose your spreadsheet has no columns title.
+
 You can then map columns <=> model attribute via index of column.
+
 You can also pass the starting cell of data (the first cell of data (excluded title when there is one))
 
    users = User.from_excel sheet,  :mapping => {:first_name => 1, :last_name => 2, :age => 3}, :limits => {:start => [2, 1]}
@@ -97,9 +107,9 @@ If not, you must pass a mapping with :attribute => column_index
 
 Suppose user has one adress of class Adress(:street, :town, :zip_code)
 And you have this spreadsheet :
-        A            B            C      D                  E     F
-  1  First name	Last name	     Age	    Street	          Town	   Zip Code
-  2  Albert	     Einstein	     131	    17 rue de Brest	  Quimper	 29000
+        A               B                 C                D                  E                 F
+  1  First name	     Last name	          Age	        Street	             Town	       Zip Code
+  2  Albert	     Einstein	         131	        17 rue de Brest	     Quimper	       29000
 So, you want user with user.adress = Adress.new(:stret => ..., :town => ... , :zip_code => ....)
 Just pass the following mapping :
 
@@ -127,9 +137,9 @@ You have roles predifined in your database :
 
   Sheet :
 
-    First name	Last name	Rôle
-    Bobby	      Lapointe	Admin
-    Gaston	     Lagaffe	Reader
+    First name	       Last name	    Rôle
+    Bobby	        Lapointe	  Admin
+    Gaston	        Lagaffe	          Reader
 
   
 'Admin' value must be retrieved as a Role with id 1 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: from_excel
 version: !ruby/object:Gem::Version 
-  hash: 23
-  prerelease: false
+  hash: 21
+  prerelease: 
   segments: 
   - 1
   - 0
-  - 0
-  version: 1.0.0
+  - 1
+  version: 1.0.1
 platform: ruby
 authors: 
 - Philippe Cantin
@@ -15,11 +15,23 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-11-08 00:00:00 +01:00
-default_executable: 
-dependencies: []
-
-description: Import Excel spreadsheet rows to ruby objects
+date: 2012-01-25 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: roo
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: Import Excel spreadsheet to ruby objects
 email: 
 executables: []
 
@@ -38,7 +50,6 @@ files:
 - test/test_bounds.rb
 - test/test_from_excel.rb
 - test/test_mapping.rb
-has_rdoc: true
 homepage: http://github.com/anoiaque/from_excel
 licenses: []
 
@@ -68,10 +79,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.7
+rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
-summary: Import Excel spreadsheet rows to ruby objects
+summary: Import Excel spreadsheet to ruby objects
 test_files: 
 - test/helper.rb
 - test/model/adress.rb