merge_excel 0.2.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8b4b332e7aeffcf25e4d60ba3da613d352671400
-  data.tar.gz: 342ce48decad71444ff3a7c62f80d61e9d58d335
+  metadata.gz: e7d9194cae8de5e57f5b2c828ed06b84a8bcd64d
+  data.tar.gz: c23be5c9b741ad107636391285f2b90013040c38
 SHA512:
-  metadata.gz: 55554b291704b54902b1f6302397f07d3657199335d802e9083d152dd0dda171be852401454bdc3184805bdaa65ff3aa79e11b4f1d09a88baf6a0985e67fb9e6
-  data.tar.gz: 9463f8e58c96a1ca822a90f4f5265e1664b89bbe6d4c4608d3eec1dbf86f32c13ddb7e7fc798be0deb540fe6c30aa9ac5ece567647c8c1e4ea004237a85f2120
+  metadata.gz: 411b29d822d1dea25e569bfa1672f3c788e97562cb67c86a4d08b53635dd13c8a4e8eea954bd136b9a45ea70c26522e0395a5703e5bb89a445bc874c228ee1ac
+  data.tar.gz: 38d08dc4376f337ebf92276229b280c57803650a82379751bd771ff39e3188c61696fa1250fb81f9e8abe6bd8b7ba468526365ba5c4eea43f392924cc3ea080b

data/.gitignore

@@ -10,3 +10,5 @@
 /spec/results/
 /palestra.rb
 .byebug_history
+
+*.gem

data/README.md

@@ -22,6 +22,46 @@ Or install it yourself as:
 
 ## Usage
 
+Given `excel_files_dir` the directory where the Excel files you want to merge are placed and `merged_file_path` the path or filename of the destination Excel file.
+
+
+```ruby
+require 'merge_excel'
+
+me = MergeExcel::Excel.new(excel_files_dir)
+me.merge merged_file_path
+```
+By default the command will merge:
+- all worksheets
+- the header line (first row)
+- all rows until an empty one
+- all columns
+
+### Options
+
+Options allows you to control what to merge.
+
+```ruby
+options = {
+  selector_pattern: "*.xls",
+  sheets_idxs:      [1],
+  data_rows: {
+    1 => {
+      header_row: 0, # or :missing
+      data_starting_row: 1,
+      data_first_column: 0,
+      data_last_column: 5 # omit or :last to get all columns
+    }
+  }
+}
+
+me = MergeExcel::Excel.new(excel_files_dir, options)
+me.merge merged_file_path
+```
+
+In this example will be merged only '.xls' files, of which only the columns from 0 to 5 of the second sheet.
+
+
 
 
 ## Development

data/lib/merge_excel/excel.rb

@@ -2,18 +2,18 @@ module MergeExcel
   class Excel
     attr_reader :files
 
-    def initialize(hash, selector_pattern="*.{xls,xlsx}")
-      @settings = Settings::Parser.new(hash)
-      @files   = Dir.glob(File.join(@settings.input_dir, selector_pattern))
+    def initialize(input_dir, options={})
+      @settings = Settings::Parser.new(options)
+      @files    = Dir.glob(File.join(input_dir, @settings.selector_pattern))
     end
 
-    def merge
+    def merge(output_file_path)
       wbook = WBook.new(@settings)
       @files.each do |i_xls_filepath|
         puts i_xls_filepath
         wbook.import_data(i_xls_filepath)
       end
-      wbook.export @settings.output_file_path
+      wbook.export output_file_path
     end
   end
 end

data/lib/merge_excel/settings/parser.rb

@@ -1,10 +1,9 @@
 module MergeExcel
   module Settings
     class Parser
-      attr_reader :input_dir, :output_file_path, :sheets_idxs, :data_rows, :extra_data_rows
+      attr_reader :selector_pattern, :sheets_idxs, :data_rows, :extra_data_rows
       def initialize(hash)
-        @input_dir         = hash.fetch(:input_dir)
-        @output_file_path  = hash.fetch(:output_file_path)
+        @selector_pattern  = hash.fetch(:selector_pattern){ "*.{xls,xlsx}" }
         read_sheets_index    hash.fetch(:sheets_idxs){ :all }
         read_data_rows       hash.fetch(:data_rows){ {any: DataRow::DEFAULT_DATA_ROW_CONFIG } }
         read_extra_data_rows hash.fetch(:extra_data_rows){   {any: ExtraDataRow::DEFAULT_EXTRA_DATA_ROW_CONFIG } }

data/lib/merge_excel/version.rb

@@ -1,3 +1,3 @@
 module MergeExcel
-  VERSION = "0.2.1"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: merge_excel
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Iwan Buetti
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-03-06 00:00:00.000000000 Z
+date: 2018-03-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler