spreadsheet_architect 3.0.0 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9373288a5139e4300488dc26c66aa5783ddca415a5a01c9b509b7e19a4716055
-  data.tar.gz: c8c58c68932e5fc5e36c3f73c3b5d106e90261a64bdbf046fa133e940c2fbb94
+  metadata.gz: c8e7dd80b1f4347e578f1a4ab5a8224ee78f03d8f5c6cfac34882099fb6307f3
+  data.tar.gz: 90a5a75b3efe90265123b140373080fe7b780e51b7f6cbf9d6afc30adf9f656d
 SHA512:
-  metadata.gz: ef1f1ac7cd4187c9dae74efcc001099cc190a39a11f7f15341c0649dfac21c13347f8f537274a664e6365229d31a32b58dc60786ea3f7127fdfd18828ba91175
-  data.tar.gz: 84b8abd050f5924b25ba15012dde4cd5500ad85de2fa16149c0d0eda0e3fa85ef49370a7d3d5f6a2f3c7ede3f176c6ca23fae02e811bf18711b3b6c3e2fbc09f
+  metadata.gz: 519fc04923d74447c67d4f6717f2314da4ac248a2f3d03ab324894d8f273a82dacee97a8acef8c3d39006d70aca1c638c6fce461cb694fe1ca82c602291dbb68
+  data.tar.gz: f86599479cc858dbde7161a27d922967ce87f93936993137398905b4711784253b59ceff7f5cf6d2c8490e3bb7c9199c09243afa284b2b0b7116495b1c490cf2

data/CHANGELOG.md

@@ -1,6 +1,13 @@
 CHANGELOG
 ---------
 
+- **3.1.0** - UNRELEASED
+  - Add new option `:conditional_row_styles` to `to_xlsx`.
+  - Add ability to pass an alternative method name as a Symbol/String to the `:spreadsheet_columns` option.
+  - Replace all usage of the legacy method `instance_eval` with the proper method `send`.
+  - [#23](https://github.com/westonganger/spreadsheet_architect/issues/23#issuecomment-412803761) - Fix bug where custom `columns_widths` in xlsx spreadsheets might not get set correctly.
+  - All exceptions now inherit from the appropriate ruby core exception classes
+  - `SpreadsheetArchitect::Exceptions::InvalidOptionError` renamed to `SpreadsheetArchitect::Exceptions::OptionTypeError`
 - **3.0.0** - July 6, 2018
   - [#16](https://github.com/westonganger/spreadsheet_architect/issues/16) - Add ability to pass :instances option to SpreadsheetArchitect class methods
   - [#16](https://github.com/westonganger/spreadsheet_architect/issues/16) - Remove Plain Ruby syntax `Post.to_xlsx(instances: posts_array)` in favor of `SpreadsheetArchitect.to_xlsx(instance: posts_array)`. However, it may still work at this time if configured correctly.

data/README.md

@@ -90,9 +90,17 @@ class Post
       ['Category/Tags', "#{category.name} - #{tags.collect(&:name).join(', ')}"]
     ]
 end
+
+Post.to_xlsx(instances: posts)
+```
+
+If you want to use a different method name then `spreadsheet_columns` you can pass a method name as a Symbol or String to the `spreadsheet_columns` option. Feel free to utilize the model-wide/project-wide defaults features if desired necessary.
+
+```ruby
+Post.to_xlsx(instances: posts, spreadsheet_columns: :my_special_columns)
 ```
 
-Alternatively, if `spreadsheet_columns` is passed as an option, this instance method does not need to be defined on the class. If defined on the class then naturally this will override it.
+Alternatively, you can pass a Proc/lambda to the `spreadsheet_columns` option. For those purists that really dont want to define any extra `spreadsheet_columns` instance method on your model, this option can help you work with that methodology.
 
 ```ruby
 Post.to_xlsx(instances: posts, spreadsheet_columns: Proc.new{|instance|
@@ -220,20 +228,21 @@ See this file for more details: https://github.com/westonganger/spreadsheet_arch
 |---|---|---|
 |**data**<br>*2D Array*| |Cannot be used with the `:instances` option.<br><br>Tabular data for the non-header row cells.  |
 |**instances**<br>*Array*| |Cannot be used with the `:data` option.<br><br>Array of class/model instances to be used as row data. Cannot be used with :data option|
-|**spreadsheet_columns**<br>*Array*| If using the instances option or on a ActiveRecord relation, this defaults to the classes custom `spreadsheet_columns` method or any custom defaults defined.<br>If none of those then falls back to `self.column_names` for ActiveRecord models. | Cannot be used with the `:data` option.<br><br>Use this option to override or define the spreadsheet columns. |
+|**spreadsheet_columns**<br>*Proc/Symbol/String*| Use this option to override or define the spreadsheet columns. Normally, if this option is not specified and are using the instances option/ActiveRecord relation, it uses the classes custom `spreadsheet_columns` method or any custom defaults defined.<br>If neither of those and is an ActiveRecord model, then it will falls back to the models `self.column_names` | Cannot be used with the `:data` option.<br><br>If a Proc value is passed it will be evaluated on the instance object.<br><br>If a Symbol or String value is passed then it will search the instance for a method name that matches and call it. |
 |**headers**<br>*Array / 2D Array*| |Data for the header row cells. If using on a class/relation, this defaults to the ones provided via `spreadsheet_columns`. Pass `false` to skip the header row. |
 |**sheet_name**<br>*String*|`Sheet1`||
 |**header_style**<br>*Hash*|`{background_color: "AAAAAA", color: "FFFFFF", align: :center, font_name: 'Arial', font_size: 10, bold: false, italic: false, underline: false}`|See all available style options [here](https://github.com/westonganger/spreadsheet_architect/blob/master/docs/axlsx_styles_reference.md)|
 |**row_style**<br>*Hash*|`{background_color: nil, color: "000000", align: :left, font_name: 'Arial', font_size: 10, bold: false, italic: false, underline: false, format_code: nil}`|Styles for non-header rows. See all available style options [here](https://github.com/westonganger/spreadsheet_architect/blob/master/docs/axlsx_styles_reference.md)|
-|**column_styles**<br>*Array*||[See this example for usage](https://github.com/westonganger/spreadsheet_architect/blob/master/test/spreadsheet_architect/kitchen_sink_test.rb)|
-|**range_styles**<br>*Array*||[See this example for usage](https://github.com/westonganger/spreadsheet_architect/blob/master/test/spreadsheet_architect/kitchen_sink_test.rb)|
-|**merges**<br>*Array*||Merge cells. [See this example for usage](https://github.com/westonganger/spreadsheet_architect/blob/master/test/spreadsheet_architect/kitchen_sink_test.rb). Warning merges cannot overlap eachother, if you attempt to do so Excel will claim your spreadsheet is corrupt and refuse to open your spreadsheet.|
-|**borders**<br>*Array*||[See this example for usage](https://github.com/westonganger/spreadsheet_architect/blob/master/test/spreadsheet_architect/kitchen_sink_test.rb)|
+|**column_styles**<br>*Array*||[See this example for usage](https://github.com/westonganger/spreadsheet_architect/blob/master/test/unit/kitchen_sink_test.rb)|
+|**range_styles**<br>*Array*||[See this example for usage](https://github.com/westonganger/spreadsheet_architect/blob/master/test/unit/kitchen_sink_test.rb)|
+|**conditional_row_styles**<br>*Array*||[See this example for usage](https://github.com/westonganger/spreadsheet_architect/blob/master/test/unit/kitchen_sink_test.rb). The if/unless proc will called with the following args: `row_index`, `row_data`|
+|**merges**<br>*Array*||Merge cells. [See this example for usage](https://github.com/westonganger/spreadsheet_architect/blob/master/test/unit/kitchen_sink_test.rb). Warning merges cannot overlap eachother, if you attempt to do so Excel will claim your spreadsheet is corrupt and refuse to open your spreadsheet.|
+|**borders**<br>*Array*||[See this example for usage](https://github.com/westonganger/spreadsheet_architect/blob/master/test/unit/kitchen_sink_test.rb)|
 |**column_types**<br>*Array*||Valid types for XLSX are :string, :integer, :float, :boolean, nil = auto determine.|
 |**column_widths**<br>*Array*||Sometimes you may want explicit column widths. Use nil if you want a column to autofit again.|
 
 ## `to_axlsx_spreadsheet(options={}, axlsx_package_to_join=nil)`
-Same options as `to_xlsx`. For more details
+Same options as `to_xlsx`
 
 ## `to_ods(options={})`
 
@@ -241,7 +250,7 @@ Same options as `to_xlsx`. For more details
 |---|---|---|
 |**data**<br>*2D Array*| |Cannot be used with the `:instances` option.<br><br>Tabular data for the non-header row cells.  |
 |**instances**<br>*Array*| |Cannot be used with the `:data` option.<br><br>Array of class/model instances to be used as row data. Cannot be used with :data option|
-|**spreadsheet_columns**<br>*Array*| If using the instances option or on a ActiveRecord relation, this defaults to the classes custom `spreadsheet_columns` method or any custom defaults defined.<br>If none of those then falls back to `self.column_names` for ActiveRecord models. | Cannot be used with the `:data` option.<br><br>Use this option to override or define the spreadsheet columns. |
+|**spreadsheet_columns**<br>*Proc/Symbol/String*| Use this option to override or define the spreadsheet columns. Normally, if this option is not specified and are using the instances option/ActiveRecord relation, it uses the classes custom `spreadsheet_columns` method or any custom defaults defined.<br>If neither of those and is an ActiveRecord model, then it will falls back to the models `self.column_names` | Cannot be used with the `:data` option.<br><br>If a Proc value is passed it will be evaluated on the instance object.<br><br>If a Symbol or String value is passed then it will search the instance for a method name that matches and call it. |
 |**headers**<br>*Array / 2D Array*| |Data for the header row cells. If using on a class/relation, this defaults to the ones provided via `spreadsheet_columns`. Pass `false` to skip the header row. |
 |**sheet_name**<br>*String*|`Sheet1`||
 |**header_style**<br>*Hash*|`{background_color: "AAAAAA", color: "FFFFFF", align: :center, font_size: 10, bold: true}`|Note: Currently ODS only supports these options|
@@ -257,7 +266,7 @@ Same options as `to_ods`
 |---|---|---|
 |**data**<br>*2D Array*| |Cannot be used with the `:instances` option.<br><br>Tabular data for the non-header row cells.  |
 |**instances**<br>*Array*| |Cannot be used with the `:data` option.<br><br>Array of class/model instances to be used as row data. Cannot be used with :data option|
-|**spreadsheet_columns**<br>*Array*| If using the instances option or on a ActiveRecord relation, this defaults to the classes custom `spreadsheet_columns` method or any custom defaults defined.<br>If none of those then falls back to `self.column_names` for ActiveRecord models. | Cannot be used with the `:data` option.<br><br>Use this option to override or define the spreadsheet columns. |
+|**spreadsheet_columns**<br>*Proc/Symbol/String*| Use this option to override or define the spreadsheet columns. Normally, if this option is not specified and are using the instances option/ActiveRecord relation, it uses the classes custom `spreadsheet_columns` method or any custom defaults defined.<br>If neither of those and is an ActiveRecord model, then it will falls back to the models `self.column_names` | Cannot be used with the `:data` option.<br><br>If a Proc value is passed it will be evaluated on the instance object.<br><br>If a Symbol or String value is passed then it will search the instance for a method name that matches and call it. |
 |**headers**<br>*Array / 2D Array*| |Data for the header row cells. If using on a class/relation, this defaults to the ones provided via `spreadsheet_columns`. Pass `false` to skip the header row. |
 
 
@@ -265,8 +274,6 @@ Same options as `to_ods`
 
 ```ruby
 class Post
-  include SpreadsheetArchitect
-
   def spreadsheet_columns
     [:name, :content]
   end
@@ -276,11 +283,13 @@ class Post
       ['My Post Report'],
       self.column_names.map{|x| x.titleize}
     ],
+     spreadsheet_columns: :spreadsheet_columns,
     header_style: {background_color: 'AAAAAA', color: 'FFFFFF', align: :center, font_name: 'Arial', font_size: 10, bold: false, italic: false, underline: false},
     row_style: {background_color: nil, color: '000000', align: :left, font_name: 'Arial', font_size: 10, bold: false, italic: false, underline: false},
     sheet_name: self.name,
     column_styles: [],
     range_styles: [],
+    conditional_row_styles: [],
     merges: [],
     borders: [],
     column_types: [],
@@ -295,11 +304,13 @@ end
 
 SpreadsheetArchitect.default_options = {
   headers: true,
+  spreadsheet_columns: :spreadsheet_columns,
   header_style: {background_color: 'AAAAAA', color: 'FFFFFF', align: :center, font_name: 'Arial', font_size: 10, bold: false, italic: false, underline: false},
   row_style: {background_color: nil, color: '000000', align: :left, font_name: 'Arial', font_size: 10, bold: false, italic: false, underline: false},
   sheet_name: 'My Project Export',
   column_styles: [],
   range_styles: [],
+  conditional_row_styles: [],
   merges: [],
   borders: [],
   column_types: [],
@@ -307,7 +318,7 @@ SpreadsheetArchitect.default_options = {
 ```
 
 # Kitchen Sink Examples with Styling for XLSX and ODS
-See this example: https://github.com/westonganger/spreadsheet_architect/blob/master/test/spreadsheet_architect/kitchen_sink_test.rb
+See this example: https://github.com/westonganger/spreadsheet_architect/blob/master/test/unit/kitchen_sink_test.rb
 
 # Axlsx Style Reference
 
@@ -324,6 +335,8 @@ We use the `appraisal` gem for testing multiple versions of `axlsx`. Please use
 1. `bundle exec appraisal install`
 2. `bundle exec appraisal rake test`
 
+At this time the spreadsheets generated by the test suite are manually inspected. After running the tests, the test output can be viewed at `test/dummy_app/tmp/#{alxsx_version}/*`
+
 # Credits
 
 Created & Maintained by [Weston Ganger](https://westonganger.com) - [@westonganger](https://github.com/westonganger)

data/lib/spreadsheet_architect.rb

@@ -26,7 +26,7 @@ module SpreadsheetArchitect
     if val.is_a?(Hash)
       @default_options = val
     else
-      raise SpreadsheetArchitect::Exceptions::InvalidTypeError.new("SpreadsheetArchitect.default_options")
+      raise SpreadsheetArchitect::Exceptions::OptionTypeError.new("SpreadsheetArchitect.default_options")
     end
   end
 

data/lib/spreadsheet_architect/class_methods/xlsx.rb

@@ -20,6 +20,8 @@ module SpreadsheetArchitect
         package = Axlsx::Package.new
       end
 
+      row_index = -1
+
       package.workbook.add_worksheet(name: options[:sheet_name]) do |sheet|
         max_row_length = options[:data].empty? ? 0 : options[:data].max_by{|x| x.length}.length
 
@@ -27,6 +29,8 @@ module SpreadsheetArchitect
           header_style_index = package.workbook.styles.add_style(header_style)
 
           options[:headers].each do |header_row|
+            row_index += 1
+
             missing = max_row_length - header_row.count
             if missing > 0
               missing.times do
@@ -35,6 +39,17 @@ module SpreadsheetArchitect
             end
 
             sheet.add_row header_row, style: header_style_index
+
+            if options[:conditional_row_styles]
+              conditional_styles_for_row = SpreadsheetArchitect::Utils::XLSX.conditional_styles_for_row(options[:conditional_row_styles], row_index, header_row)
+              
+              unless conditional_styles_for_row.empty?
+                sheet.add_style(
+                  "#{SpreadsheetArchitect::Utils::XLSX::COL_NAMES.first}#{row_index+1}:#{SpreadsheetArchitect::Utils::XLSX::COL_NAMES[max_row_length-1]}#{row_index+1}", 
+                  SpreadsheetArchitect::Utils::XLSX.convert_styles_to_axlsx(conditional_styles_for_row)
+                )
+              end
+            end
           end
         end
 
@@ -45,6 +60,8 @@ module SpreadsheetArchitect
         row_style_index = package.workbook.styles.add_style(row_style)
 
         options[:data].each do |row_data|
+          row_index += 1
+
           missing = max_row_length - row_data.count
           if missing > 0
             missing.times do
@@ -66,6 +83,17 @@ module SpreadsheetArchitect
           end
 
           sheet.add_row row_data, style: row_style_index, types: types
+
+          if options[:conditional_row_styles]
+            conditional_styles_for_row = SpreadsheetArchitect::Utils::XLSX.conditional_styles_for_row(options[:conditional_row_styles], row_index, row_data)
+            
+            unless conditional_styles_for_row.empty?
+              sheet.add_style(
+                "#{SpreadsheetArchitect::Utils::XLSX::COL_NAMES.first}#{row_index+1}:#{SpreadsheetArchitect::Utils::XLSX::COL_NAMES[max_row_length-1]}#{row_index+1}", 
+                SpreadsheetArchitect::Utils::XLSX.convert_styles_to_axlsx(conditional_styles_for_row)
+              )
+            end
+          end
         end
 
         options[:data].first.each_with_index do |x,i|

data/lib/spreadsheet_architect/exceptions.rb

@@ -1,7 +1,19 @@
 module SpreadsheetArchitect
   module Exceptions
 
-    class InvalidRangeError < StandardError
+    class OptionTypeError < TypeError
+      def initialize(which)
+        super("Invalid data type for the #{which} option")
+      end
+    end
+
+    class ArgumentError < ::ArgumentError
+      def initialize(msg)
+        super(msg)
+      end
+    end
+
+    class InvalidRangeError < ArgumentError
       def initialize(type, range)
         case type
         when :columns, :rows
@@ -16,39 +28,33 @@ module SpreadsheetArchitect
       end
     end
 
-    class InvalidTypeError < StandardError
-      def initialize(which)
-        super("Invalid data type for the #{which}")
-      end
-    end
-
-    class InvalidColumnError < StandardError
+    class InvalidColumnError < ArgumentError
       def initialize(col)
         super("Invalid Column `#{col}` given for column_types options")
       end
     end
 
-    class InvalidRangeStylesOptionError < StandardError
+    class InvalidRangeStylesOptionError < ArgumentError
       def initialize(type, opt)
         super("Invalid or missing :#{type} option for `#{opt}`. :#{type} can be an integer, range, or :all")
       end
     end
 
-    class NoDataError < StandardError
+    class NoDataError < ArgumentError
       def initialize
         super("Missing :data or :instances option")
       end
     end
 
-    class MultipleDataSourcesError < StandardError
+    class MultipleDataSourcesError < ArgumentError
       def initialize
         super("Both :data and :instances options cannot be combined, please choose one.")
       end
     end
     
-    class SpreadsheetColumnsNotDefinedError < StandardError
-      def initialize(klass)
-        super("The instance method `spreadsheet_columns` is not defined on #{klass}")
+    class SpreadsheetColumnsNotDefinedError < ArgumentError
+      def initialize(klass, method_name='spreadsheet_columns')
+        super("The instance method `#{method_name}` is not defined on #{klass}")
       end
     end
   end

data/lib/spreadsheet_architect/monkey_patches/axlsx_column_width.rb

@@ -15,6 +15,9 @@ if RUBY_VERSION.to_f >= 2
           @custom_width = true
           @best_fit = true
           @width = v + 5
+        else
+          @custom_width = true
+          @width = v
         end
       end
     end

data/lib/spreadsheet_architect/utils.rb

@@ -32,43 +32,57 @@ module SpreadsheetArchitect
           end
         end
 
-        if !options[:spreadsheet_columns] && klass != SpreadsheetArchitect && !klass.instance_methods.include?(:spreadsheet_columns)
-          if is_ar_model?(klass)
-            the_column_names = klass.column_names
-            headers = the_column_names.map{|x| str_titleize(x)} if needs_headers
-            columns = the_column_names.map{|x| x.to_sym}
-          else
-            raise SpreadsheetArchitect::Exceptions::SpreadsheetColumnsNotDefinedError.new(klass)
+        if options[:spreadsheet_columns]
+          if [String, Symbol].any?{|x| options[:spreadsheet_columns].is_a?(x)}
+            cols_method_name = options[:spreadsheet_columns]
+
+            if klass != SpreadsheetArchitect && !klass.instance_methods.include?(cols_method_name)
+              raise SpreadsheetArchitect::Exceptions::SpreadsheetColumnsNotDefinedError.new(klass, cols_method_name)
+            end
+          end
+        else
+          if klass != SpreadsheetArchitect && !klass.instance_methods.include?(:spreadsheet_columns)
+            if is_ar_model?(klass)
+              the_column_names = klass.column_names
+              headers = the_column_names.map{|x| str_titleize(x)} if needs_headers
+              columns = the_column_names.map{|x| x.to_sym}
+            else
+              raise SpreadsheetArchitect::Exceptions::SpreadsheetColumnsNotDefinedError.new(klass)
+            end
           end
         end
 
         data = []
         options[:instances].each do |instance|
           if columns
-            data.push columns.map{|col| col.is_a?(Symbol) ? instance.instance_eval(col.to_s) : col}
+            data.push columns.map{|col| col.is_a?(Symbol) ? instance.send(col) : col}
           else
             row_data = []
 
-            if !options[:spreadsheet_columns]
+            if options[:spreadsheet_columns]
+              if cols_method_name
+                instance_cols = instance.send(cols_method_name)
+              else
+                instance_cols = options[:spreadsheet_columns].call(instance)
+              end
+            else
               if klass == SpreadsheetArchitect && !instance.respond_to?(:spreadsheet_columns)
                 raise SpreadsheetArchitect::Exceptions::SpreadsheetColumnsNotDefinedError.new(instance.class)
               else
                 instance_cols = instance.spreadsheet_columns
               end
-            else
-              instance_cols = options[:spreadsheet_columns].call(instance)
             end
 
             instance_cols.each_with_index do |x,i|
               if x.is_a?(Array)
                 headers.push(x[0].to_s) if needs_headers
-                row_data.push(x[1].is_a?(Symbol) ? instance.instance_eval(x[1].to_s) : x[1])
+                row_data.push(x[1].is_a?(Symbol) ? instance.send(x[1]) : x[1])
                 if needs_column_types
                   column_types[i] = x[2]
                 end
               else
                 headers.push(str_titleize(x.to_s)) if needs_headers
-                row_data.push(x.is_a?(Symbol) ? instance.instance_eval(x.to_s) : x)
+                row_data.push(x.is_a?(Symbol) ? instance.send(x) : x)
               end
             end
 
@@ -101,7 +115,7 @@ module SpreadsheetArchitect
             klass::SPREADSHEET_OPTIONS.merge(options)
           )
         else
-          raise SpreadsheetArchitect::Exceptions::InvalidTypeError.new("#{klass}::SPREADSHEET_OPTIONS constant")
+          raise SpreadsheetArchitect::Exceptions::OptionTypeError.new("#{klass}::SPREADSHEET_OPTIONS constant")
         end
       else
         options = SpreadsheetArchitect.default_options.merge(options)
@@ -188,13 +202,13 @@ module SpreadsheetArchitect
         end
 
         if invalid
-          raise SpreadsheetArchitect::Exceptions::InvalidTypeError.new(":#{option_name} option")
+          raise SpreadsheetArchitect::Exceptions::OptionTypeError.new(":#{option_name} option")
         end
       end
     end
 
     def self.verify_option_types(options)
-      check_option_type(options, :spreadsheet_columns, Proc)
+      check_option_type(options, :spreadsheet_columns, [Proc, Symbol, String])
       check_option_type(options, :data, Array)
       check_option_type(options, :instances, Array)
       check_option_type(options, :headers, [TrueClass, Array])
@@ -202,6 +216,7 @@ module SpreadsheetArchitect
       check_option_type(options, :row_style, Hash)
       check_option_type(options, :column_styles, Array)
       check_option_type(options, :range_styles, Array)
+      check_option_type(options, :conditional_row_styles, Array)
       check_option_type(options, :merges, Array)
       check_option_type(options, :borders, Array)
       check_option_type(options, :column_widths, Array)

data/lib/spreadsheet_architect/utils/xlsx.rb

@@ -148,6 +148,32 @@ module SpreadsheetArchitect
         end
       end
 
+      def self.conditional_styles_for_row(conditional_row_styles, row_index, row_data)
+        merged_conditional_styles = {}
+
+        conditional_row_styles.each do |x|
+          if x[:if] && x[:unless]
+            raise SpreadsheetArchitect::Exceptions::ArgumentError.new('Cannot pass both :if and :unless within the same :conditonal_row_styles entry')
+          elsif !x[:if] && !x[:unless]
+            raise SpreadsheetArchitect::Exceptions::ArgumentError.new('Must pass either :if or :unless within the each :conditonal_row_styles entry')
+          elsif !x[:styles]
+            raise SpreadsheetArchitect::Exceptions::ArgumentError.new('Must pass the :styles option within a :conditonal_row_styles entry')
+          end
+
+          conditions_met = (x[:if] || x[:unless]).call(row_data, row_index)
+
+          if x[:unless]
+            conditions_met = !conditions_met
+          end
+
+          if conditions_met
+            merged_conditional_styles.merge!(x[:styles])
+          end
+        end
+
+        return merged_conditional_styles
+      end
+
       private
 
       def self.symbolize_keys(hash={})

data/lib/spreadsheet_architect/version.rb

@@ -1,3 +1,3 @@
 module SpreadsheetArchitect
-  VERSION = "3.0.0"
+  VERSION = "3.1.0"
 end

data/test/dummy_app/app/models/custom_columns_method_post.rb

@@ -0,0 +1,29 @@
+class CustomColumnsMethodPost < ActiveRecord::Base
+  self.table_name = :posts
+
+  include SpreadsheetArchitect
+
+  def my_custom_spreadsheet_columns
+    [
+      :name,
+      ['The Content', :content],
+      :created_at, 
+      ['Created At Date', created_at.to_date],
+      [:asd, 'tadaaa']
+    ]
+  end
+
+  SPREADSHEET_OPTIONS = {
+    headers: true,
+    spreadsheet_columns: :my_custom_spreadsheet_columns,
+    header_style: {background_color: 'AAAAAA', color: 'FFFFFF', align: :center, font_name: 'Arial', font_size: 10, bold: false, italic: false, underline: false},
+    row_style: {background_color: nil, color: '000000', align: :left, font_name: 'Arial', font_size: 10, bold: false, italic: false, underline: false},
+    sheet_name: 'My Project Export',
+    column_styles: [],
+    range_styles: [],
+    merges: [],
+    borders: [],
+    column_types: []
+  }
+
+end