rubyexcel 0.1.3 → 0.1.4

data/lib/README.md

@@ -130,9 +130,6 @@ s.column( 'A' ) #=> Column
 s.column( 1 ) #=> Column
 ```
 
-Some Examples
-========
-
 Common Operations
 --------
 
@@ -153,12 +150,25 @@ s.rows(2) { |row| row << x; x+=1 }
 #Filter to specific part numbers
 s.filter!( 'Part', &/Type[1-3]/ )
 
+#Sort by Part Number
+s.sort_by!( 'Part' )
+
 #Add the Number to the Cost in each row.
 s.rows(2) { |row| row.cell_h('Cost').value += row.cell_h('Number').value }
 
 #Split the data into multiple sheets by part number
 wb = s.split( 'Part' )
 
+#Open a sheet in an Excel Workbook
+#Output a sheet as a TSV file
+File.write( 'Output.txt', wb.sheets(1).to_s )
+
+#Output a sheet as an HTML page
+File.write( 'Output.htm', wb.sheets(2).to_html )
+
+#Open a sheet in an Excel Workbook
+wb.sheets( 'Type3' ).to_excel
+
 ```
 
 Workbook
@@ -292,8 +302,9 @@ type_1_and_3, other = s.partition( 'Part', &/Type[13]/ )
 s.reverse_rows!
 s.reverse_columns!
 
-#Sort the rows by a header (ignores header rows)
+#Sort the rows by header(s) (ignores header rows)
 s.sort_by!( 'Part' )
+s.sort_by!( 'Qty', 'Part' )
 
 #Split a Sheet into a Workbook of Sheets by a column (selected by header)
 wb = s.split( 'Part' )

data/lib/rubyexcel/sheet.rb

@@ -36,7 +36,7 @@ module RubyExcel
     def initialize( name, workbook )
       @workbook = workbook
       @name = name
-      @header_rows = nil
+      @header_rows = 1
       @data = Data.new( self, [[]] )
     end
     
@@ -458,23 +458,15 @@ module RubyExcel
     alias each rows
     
     #
-    # Sort the data according to a block (avoiding headers)
+    # Sort the data by a column, selected by header(s)
     #
-    
-    def sort!( &block )
-      data.sort!( &block ); self
-    end
-    
-    #
-    # Sort the data by a column, selected by header
-    #
-    # @param [String] header the header to sort the Sheet by
+    # @param [String, Array<String>] headers the header(s) to sort the Sheet by
     #
     
-    def sort_by!( header )
+    def sort_by!( *headers )
       raise ArgumentError, 'Sheet#sort_by! does not support blocks.' if block_given?
-      idx = data.index_by_header( header ) - 1
-      sort_method = lambda { |array| array[idx] }
+      idx_array = headers.flatten.map { |header| data.index_by_header( header ) - 1 }
+      sort_method = lambda { |array| idx_array.map { |idx| array[idx] } }
       data.sort_by!( &sort_method )
       self
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rubyexcel
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,10 +9,10 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-07 00:00:00.000000000 Z
+date: 2013-05-09 00:00:00.000000000 Z
 dependencies: []
 description: A tabular data structure in Ruby, with header-based helper methods and
-  some of Excel's API style.
+  some of Excel's API style. Designed for Windows + Excel.
 email: VirtuosoJoel@gmail.com
 executables: []
 extensions: []