caxlsx 4.0.0 → 4.4.1

data/lib/axlsx/workbook/workbook.rb

@@ -1,67 +1,67 @@
 # frozen_string_literal: true
 
 module Axlsx
-  require 'axlsx/workbook/worksheet/sheet_calc_pr'
-  require 'axlsx/workbook/worksheet/auto_filter/auto_filter'
-  require 'axlsx/workbook/worksheet/date_time_converter'
-  require 'axlsx/workbook/worksheet/protected_range'
-  require 'axlsx/workbook/worksheet/protected_ranges'
-  require 'axlsx/workbook/worksheet/rich_text_run'
-  require 'axlsx/workbook/worksheet/rich_text'
-  require 'axlsx/workbook/worksheet/cell_serializer'
-  require 'axlsx/workbook/worksheet/cell'
-  require 'axlsx/workbook/worksheet/page_margins'
-  require 'axlsx/workbook/worksheet/page_set_up_pr'
-  require 'axlsx/workbook/worksheet/outline_pr'
-  require 'axlsx/workbook/worksheet/page_setup'
-  require 'axlsx/workbook/worksheet/header_footer'
-  require 'axlsx/workbook/worksheet/print_options'
-  require 'axlsx/workbook/worksheet/cfvo'
-  require 'axlsx/workbook/worksheet/cfvos'
-  require 'axlsx/workbook/worksheet/color_scale'
-  require 'axlsx/workbook/worksheet/data_bar'
-  require 'axlsx/workbook/worksheet/icon_set'
-  require 'axlsx/workbook/worksheet/conditional_formatting'
-  require 'axlsx/workbook/worksheet/conditional_formatting_rule'
-  require 'axlsx/workbook/worksheet/conditional_formattings'
-  require 'axlsx/workbook/worksheet/row'
-  require 'axlsx/workbook/worksheet/col'
-  require 'axlsx/workbook/worksheet/cols'
-  require 'axlsx/workbook/worksheet/comments'
-  require 'axlsx/workbook/worksheet/comment'
-  require 'axlsx/workbook/worksheet/merged_cells'
-  require 'axlsx/workbook/worksheet/sheet_protection'
-  require 'axlsx/workbook/worksheet/sheet_pr'
-  require 'axlsx/workbook/worksheet/dimension'
-  require 'axlsx/workbook/worksheet/sheet_data'
-  require 'axlsx/workbook/worksheet/worksheet_drawing'
-  require 'axlsx/workbook/worksheet/worksheet_comments'
-  require 'axlsx/workbook/worksheet/worksheet_hyperlink'
-  require 'axlsx/workbook/worksheet/worksheet_hyperlinks'
-  require 'axlsx/workbook/worksheet/break'
-  require 'axlsx/workbook/worksheet/row_breaks'
-  require 'axlsx/workbook/worksheet/col_breaks'
-  require 'axlsx/workbook/workbook_view'
-  require 'axlsx/workbook/workbook_views'
-  require 'axlsx/workbook/worksheet/worksheet'
-  require 'axlsx/workbook/shared_strings_table'
-  require 'axlsx/workbook/defined_name'
-  require 'axlsx/workbook/defined_names'
-  require 'axlsx/workbook/worksheet/table_style_info'
-  require 'axlsx/workbook/worksheet/table'
-  require 'axlsx/workbook/worksheet/tables'
-  require 'axlsx/workbook/worksheet/pivot_table_cache_definition'
-  require 'axlsx/workbook/worksheet/pivot_table'
-  require 'axlsx/workbook/worksheet/pivot_tables'
-  require 'axlsx/workbook/worksheet/data_validation'
-  require 'axlsx/workbook/worksheet/data_validations'
-  require 'axlsx/workbook/worksheet/sheet_view'
-  require 'axlsx/workbook/worksheet/sheet_format_pr'
-  require 'axlsx/workbook/worksheet/pane'
-  require 'axlsx/workbook/worksheet/selection'
+  require_relative 'worksheet/sheet_calc_pr'
+  require_relative 'worksheet/auto_filter/auto_filter'
+  require_relative 'worksheet/date_time_converter'
+  require_relative 'worksheet/protected_range'
+  require_relative 'worksheet/protected_ranges'
+  require_relative 'worksheet/rich_text_run'
+  require_relative 'worksheet/rich_text'
+  require_relative 'worksheet/cell_serializer'
+  require_relative 'worksheet/cell'
+  require_relative 'worksheet/page_margins'
+  require_relative 'worksheet/page_set_up_pr'
+  require_relative 'worksheet/outline_pr'
+  require_relative 'worksheet/page_setup'
+  require_relative 'worksheet/header_footer'
+  require_relative 'worksheet/print_options'
+  require_relative 'worksheet/cfvo'
+  require_relative 'worksheet/cfvos'
+  require_relative 'worksheet/color_scale'
+  require_relative 'worksheet/data_bar'
+  require_relative 'worksheet/icon_set'
+  require_relative 'worksheet/conditional_formatting'
+  require_relative 'worksheet/conditional_formatting_rule'
+  require_relative 'worksheet/conditional_formattings'
+  require_relative 'worksheet/row'
+  require_relative 'worksheet/col'
+  require_relative 'worksheet/cols'
+  require_relative 'worksheet/comments'
+  require_relative 'worksheet/comment'
+  require_relative 'worksheet/merged_cells'
+  require_relative 'worksheet/sheet_protection'
+  require_relative 'worksheet/sheet_pr'
+  require_relative 'worksheet/dimension'
+  require_relative 'worksheet/sheet_data'
+  require_relative 'worksheet/worksheet_drawing'
+  require_relative 'worksheet/worksheet_comments'
+  require_relative 'worksheet/worksheet_hyperlink'
+  require_relative 'worksheet/worksheet_hyperlinks'
+  require_relative 'worksheet/break'
+  require_relative 'worksheet/row_breaks'
+  require_relative 'worksheet/col_breaks'
+  require_relative 'workbook_view'
+  require_relative 'workbook_views'
+  require_relative 'worksheet/worksheet'
+  require_relative 'shared_strings_table'
+  require_relative 'defined_name'
+  require_relative 'defined_names'
+  require_relative 'worksheet/table_style_info'
+  require_relative 'worksheet/table'
+  require_relative 'worksheet/tables'
+  require_relative 'worksheet/pivot_table_cache_definition'
+  require_relative 'worksheet/pivot_table'
+  require_relative 'worksheet/pivot_tables'
+  require_relative 'worksheet/data_validation'
+  require_relative 'worksheet/data_validations'
+  require_relative 'worksheet/sheet_view'
+  require_relative 'worksheet/sheet_format_pr'
+  require_relative 'worksheet/pane'
+  require_relative 'worksheet/selection'
 
   # The Workbook class is an xlsx workbook that manages worksheets, charts, drawings and styles.
-  # The following parts of the Office Open XML spreadsheet specification are not implimented in this version.
+  # The following parts of the Office Open XML spreadsheet specification are not implemented in this version.
   #
   #   bookViews
   #   calcPr
@@ -184,6 +184,12 @@ module Axlsx
       @styles
     end
 
+    # The theme associated with this workbook
+    # @return [Theme]
+    def theme
+      @theme ||= Theme.new
+    end
+
     # An array that holds all cells with styles
     # @return Set
     def styled_cells
@@ -217,7 +223,7 @@ module Axlsx
     # Indicates if the epoc date for serialization should be 1904. If false, 1900 is used.
     @@date1904 = false
 
-    # A quick helper to retrive a worksheet by name
+    # A quick helper to retrieve a worksheet by name
     # @param [String] name The name of the sheet you are looking for
     # @return [Worksheet] The sheet found, or nil
     def sheet_by_name(name)
@@ -249,18 +255,28 @@ module Axlsx
 
     # Instance level access to the class variable 1904
     # @return [Boolean]
-    def date1904() @@date1904; end
+    def date1904
+      @@date1904
+    end
 
     # see @date1904
-    def date1904=(v) Axlsx.validate_boolean v; @@date1904 = v; end
+    def date1904=(v)
+      Axlsx.validate_boolean v
+      @@date1904 = v
+    end
 
     # Sets the date1904 attribute to the provided boolean
     # @return [Boolean]
-    def self.date1904=(v) Axlsx.validate_boolean v; @@date1904 = v; end
+    def self.date1904=(v)
+      Axlsx.validate_boolean v
+      @@date1904 = v
+    end
 
     # retrieves the date1904 attribute
     # @return [Boolean]
-    def self.date1904() @@date1904; end
+    def self.date1904
+      @@date1904
+    end
 
     # Whether to treat values starting with an equals sign as formulas or as literal strings.
     # Allowing user-generated data to be interpreted as formulas is a security risk.
@@ -280,10 +296,13 @@ module Axlsx
     #     calculation. Thus the performance benefits of turning this off are
     #     marginal unless you are creating a very large sheet.
     # @return [Boolean]
-    def use_autowidth() @use_autowidth; end
+    attr_reader :use_autowidth
 
     # see @use_autowidth
-    def use_autowidth=(v = true) Axlsx.validate_boolean v; @use_autowidth = v; end
+    def use_autowidth=(v = true)
+      Axlsx.validate_boolean v
+      @use_autowidth = v
+    end
 
     # Font size of bold fonts is multiplied with this
     # Used for automatic calculation of cell widths with bold text
@@ -360,6 +379,7 @@ module Axlsx
         r << Relationship.new(pivot_table.cache_definition, PIVOT_TABLE_CACHE_DEFINITION_R, format(PIVOT_TABLE_CACHE_DEFINITION_PN, index + 1))
       end
       r << Relationship.new(self, STYLES_R, STYLES_PN)
+      r << Relationship.new(self, THEME_R, THEME_PN)
       if use_shared_strings
         r << Relationship.new(self, SHARED_STRINGS_R, SHARED_STRINGS_PN)
       end
@@ -373,7 +393,7 @@ module Axlsx
     end
 
     # The xml:space attribute for the worksheet.
-    # This determines how whitespace is handled withing the document.
+    # This determines how whitespace is handled within the document.
     # The most relevant part being whitespace in the cell text.
     # allowed values are :preserve and :default. Axlsx uses :preserve unless
     # you explicily set this to :default.

data/lib/axlsx/workbook/workbook_view.rb

@@ -38,7 +38,7 @@ module Axlsx
     # @option [Boolean] show_horizontal_scroll Specifies a boolean value that indicates whether to display the horizontal scroll bar in the user interface.
     # @option [Boolean] show_vertical_scroll Specifies a boolean value that indicates whether to display the vertical scroll bar.
     # @option [Boolean] show_sheet_tabs Specifies a boolean value that indicates whether to display the sheet tabs in the user interface.
-    # @option [Integer] tab_ratio Specifies ratio between the workbook tabs bar and the horizontal scroll bar.
+    # @option [Integer] tab_ratio Specifies the ratio between the workbook tabs bar and the horizontal scroll bar (from 0 to 1000, higher values mean more space for tabs). May only be supported on some clients.
     # @option [Integer] first_sheet Specifies the index to the first sheet in this book view.
     # @option [Integer] active_tab Specifies an unsignedInt that contains the index to the active sheet in this book view.
     # @option [Integer] x_window Specifies the X coordinate for the upper left corner of the workbook window. The unit of measurement for this value is twips.

data/lib/axlsx/workbook/workbook_views.rb

@@ -5,7 +5,7 @@ module Axlsx
   class WorkbookViews < SimpleTypedList
     # creates the book views object
     def initialize
-      super WorkbookView
+      super(WorkbookView)
     end
 
     # Serialize to xml

data/lib/axlsx/workbook/worksheet/auto_filter/auto_filter.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
-require 'axlsx/workbook/worksheet/auto_filter/filter_column'
-require 'axlsx/workbook/worksheet/auto_filter/filters'
-require 'axlsx/workbook/worksheet/auto_filter/sort_state'
+require_relative 'filter_column'
+require_relative 'filters'
+require_relative 'sort_state'
 
 module Axlsx
   # This class represents an auto filter range in a worksheet
@@ -80,7 +80,7 @@ module Axlsx
                            condition.order == :asc ? index1 <=> index2 : index2 <=> index1
                          end
 
-            break unless comparison.zero?
+            break unless comparison == 0
           end
 
           comparison

data/lib/axlsx/workbook/worksheet/auto_filter/filter_column.rb

@@ -10,7 +10,7 @@ module Axlsx
     include Axlsx::SerializedAttributes
 
     # Creates a new FilterColumn object
-    # @note This class yeilds its filter object as that is where the vast majority of processing will be done
+    # @note This class yields its filter object as that is where the vast majority of processing will be done
     # @param [Integer|Cell] col_id The zero based index for the column to which this filter will be applied
     # @param [Symbol] filter_type The symbolized class name of the filter to apply to this column.
     # @param [Hash] options options for this object and the filter
@@ -43,7 +43,9 @@ module Axlsx
     # the filter button can be hidden, and not drawn.
     # @return [Boolean]
     def show_button
-      @show_button ||= true
+      return @show_button if defined?(@show_button)
+
+      true
     end
 
     # Flag indicating whether the AutoFilter button for this column is hidden.
@@ -83,7 +85,7 @@ module Axlsx
     # @return [Boolean]
     def show_button=(show)
       Axlsx.validate_boolean show
-      @show_botton = show
+      @show_button = show
     end
 
     # Serialize the object to xml

data/lib/axlsx/workbook/worksheet/auto_filter/filters.rb

@@ -13,7 +13,7 @@ module Axlsx
     # @option [Boolean] blank @see blank
     # @option [String] calendar_type @see calendar_type
     # @option [Array] filter_items An array of values that will be used to create filter objects.
-    # @option [Array] date_group_items An array of hases defining date group item filters to apply.
+    # @option [Array] date_group_items An array of hashes defining date group item filters to apply.
     # @note The recommended way to interact with filter objects is via AutoFilter#add_column
     # @example
     #   ws.auto_filter.add_column(0, :filters, :blank => true, :calendar_type => 'japan', :filter_items => [100, 'a'])
@@ -36,12 +36,12 @@ module Axlsx
     # even when those dates are not using the same calendar system / date formatting.
     attr_reader :calendar_type
 
-    # Tells us if the row of the cell provided should be filterd as it
+    # Tells us if the row of the cell provided should be filtered as it
     # does not meet any of the specified filter_items or
     # date_group_items restrictions.
     # @param [Cell] cell The cell to test against items
     # TODO implement this for date filters as well!
-    def apply(cell)
+    def apply(cell) # rubocop:disable Naming/PredicateMethod
       return false unless cell
 
       filter_items.each do |filter|
@@ -138,7 +138,7 @@ module Axlsx
 
       # Creates a new DateGroupItem
       # @param [Hash] options A hash of options to use when
-      # instanciating the object
+      # instantiating the object
       # @option [String] date_time_grouping the part of the date this
       # filter should apply for grouping
       # @option [Integer|String] year @see year

data/lib/axlsx/workbook/worksheet/auto_filter/sort_condition.rb

@@ -6,7 +6,7 @@ module Axlsx
     # Creates a new SortCondition object
     # @param [Integer] column_index Zero-based index indicating the AutoFilter column to which the sorting should be applied to
     # @param [Symbol] order The order the column should be sorted on, can only be :asc or :desc
-    # @param [Array] custom_list An array containg a custom sorting list in order.
+    # @param [Array] custom_list An array containing a custom sorting list in order.
     def initialize(column_index:, order:, custom_list:)
       Axlsx.validate_int column_index
       @column_index = column_index

data/lib/axlsx/workbook/worksheet/auto_filter/sort_state.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require 'axlsx/workbook/worksheet/auto_filter/sort_condition'
+require_relative 'sort_condition'
 
 module Axlsx
   # This class performs sorting on a range in a worksheet
@@ -21,7 +21,7 @@ module Axlsx
     # It requires a column_index for the sorting, descending and the custom order are optional.
     # @param [Integer] column_index Zero-based index indicating the AutoFilter column to which the sorting should be applied to
     # @param [Symbol] order The order the column should be sorted on, can only be :asc or :desc
-    # @param [Array] custom_list An array containg a custom sorting list in order.
+    # @param [Array] custom_list An array containing a custom sorting list in order.
     # @return [SortCondition]
     def add_sort_condition(column_index:, order: :asc, custom_list: [])
       sort_conditions << SortCondition.new(column_index: column_index, order: order, custom_list: custom_list)

data/lib/axlsx/workbook/worksheet/border_creator.rb

@@ -63,19 +63,19 @@ module Axlsx
     end
 
     def first_row
-      @first_row ||= first_cell.scan(/\d+/).first
+      @first_row ||= first_cell[/\d+/]
     end
 
     def first_col
-      @first_col ||= first_cell.scan(/\D+/).first
+      @first_col ||= first_cell[/\D+/]
     end
 
     def last_row
-      @last_row ||= last_cell.scan(/\d+/).first
+      @last_row ||= last_cell[/\d+/]
     end
 
     def last_col
-      @last_col ||= last_cell.scan(/\D+/).first
+      @last_col ||= last_cell[/\D+/]
     end
   end
 end

data/lib/axlsx/workbook/worksheet/cell.rb

@@ -2,7 +2,7 @@
 
 module Axlsx
   # A cell in a worksheet.
-  # Cell stores inforamation requried to serialize a single worksheet cell to xml. You must provde the Row that the cell belongs to and the cells value. The data type will automatically be determed if you do not specify the :type option. The default style will be applied if you do not supply the :style option. Changing the cell's type will recast the value to the type specified. Altering the cell's value via the property accessor will also automatically cast the provided value to the cell's type.
+  # Cell stores information required to serialize a single worksheet cell to xml. You must provide the Row that the cell belongs to and the cells value. The data type will automatically be determed if you do not specify the :type option. The default style will be applied if you do not supply the :style option. Changing the cell's type will recast the value to the type specified. Altering the cell's value via the property accessor will also automatically cast the provided value to the cell's type.
   # @note The recommended way to generate cells is via Worksheet#add_row
   #
   # @see Worksheet#add_row
@@ -41,7 +41,7 @@ module Axlsx
       self.type = type unless type == :string
 
       val = options.delete(:style)
-      self.style = val unless val.nil? || val.zero?
+      self.style = val unless val.nil? || val == 0
       val = options.delete(:formula_value)
       self.formula_value = val unless val.nil?
       val = options.delete(:escape_formulas)
@@ -57,11 +57,11 @@ module Axlsx
     # you need to set this.
     attr_accessor :formula_value
 
-    # An array of available inline styes.
+    # An array of available inline styles.
     # TODO change this to a hash where each key defines attr name and validator (and any info the validator requires)
-    # then move it out to a module so we can re-use in in other classes.
+    # then move it out to a module so we can reuse in in other classes.
     # needs to define bla=(v) and bla methods on the class that hook into a
-    # set_attr method that kicks the suplied validator and updates the instance_variable
+    # set_attr method that kicks the supplied validator and updates the instance_variable
     # for the key
     INLINE_STYLES = [:value, :type, :font_name, :charset,
                      :family, :b, :i, :strike, :outline,
@@ -166,7 +166,7 @@ module Axlsx
 
     # Indicates that the cell has one or more of the custom cell styles applied.
     # @return [Boolean]
-    def is_text_run? # rubocop:disable Naming/PredicateName
+    def is_text_run? # rubocop:disable Naming/PredicatePrefix
       defined?(@is_text_run) && @is_text_run && !contains_rich_text?
     end
 
@@ -189,7 +189,9 @@ module Axlsx
     attr_reader :font_name
 
     # @see font_name
-    def font_name=(v) set_run_style :validate_string, :font_name, v; end
+    def font_name=(v)
+      set_run_style :validate_string, :font_name, v
+    end
 
     # The inline charset property for the cell
     # As far as I can tell, this is pretty much ignored. However, based on the spec it should be one of the following:
@@ -216,7 +218,9 @@ module Axlsx
     attr_reader :charset
 
     # @see charset
-    def charset=(v) set_run_style :validate_unsigned_int, :charset, v; end
+    def charset=(v)
+      set_run_style :validate_unsigned_int, :charset, v
+    end
 
     # The inline family property for the cell
     # @return [Integer]
@@ -237,49 +241,63 @@ module Axlsx
     attr_reader :b
 
     # @see b
-    def b=(v) set_run_style :validate_boolean, :b, v; end
+    def b=(v)
+      set_run_style :validate_boolean, :b, v
+    end
 
     # The inline italic property for the cell
     # @return [Boolean]
     attr_reader :i
 
     # @see i
-    def i=(v) set_run_style :validate_boolean, :i, v; end
+    def i=(v)
+      set_run_style :validate_boolean, :i, v
+    end
 
     # The inline strike property for the cell
     # @return [Boolean]
     attr_reader :strike
 
     # @see strike
-    def strike=(v) set_run_style :validate_boolean, :strike, v; end
+    def strike=(v)
+      set_run_style :validate_boolean, :strike, v
+    end
 
     # The inline outline property for the cell
     # @return [Boolean]
     attr_reader :outline
 
     # @see outline
-    def outline=(v) set_run_style :validate_boolean, :outline, v; end
+    def outline=(v)
+      set_run_style :validate_boolean, :outline, v
+    end
 
     # The inline shadow property for the cell
     # @return [Boolean]
     attr_reader :shadow
 
     # @see shadow
-    def shadow=(v) set_run_style :validate_boolean, :shadow, v; end
+    def shadow=(v)
+      set_run_style :validate_boolean, :shadow, v
+    end
 
     # The inline condense property for the cell
     # @return [Boolean]
     attr_reader :condense
 
     # @see condense
-    def condense=(v) set_run_style :validate_boolean, :condense, v; end
+    def condense=(v)
+      set_run_style :validate_boolean, :condense, v
+    end
 
     # The inline extend property for the cell
     # @return [Boolean]
     attr_reader :extend
 
     # @see extend
-    def extend=(v) set_run_style :validate_boolean, :extend, v; end
+    def extend=(v)
+      set_run_style :validate_boolean, :extend, v
+    end
 
     # The inline underline property for the cell.
     # It must be one of :none, :single, :double, :singleAccounting, :doubleAccounting
@@ -307,7 +325,9 @@ module Axlsx
     attr_reader :sz
 
     # @see sz
-    def sz=(v) set_run_style :validate_unsigned_int, :sz, v; end
+    def sz=(v)
+      set_run_style :validate_unsigned_int, :sz, v
+    end
 
     # The inline vertical alignment property for the cell
     # this must be one of [:baseline, :subscript, :superscript]
@@ -390,13 +410,13 @@ module Axlsx
       CellSerializer.to_xml_string r_index, c_index, self, str
     end
 
-    def is_formula? # rubocop:disable Naming/PredicateName
+    def is_formula? # rubocop:disable Naming/PredicatePrefix
       return false if escape_formulas
 
       type == :string && @value.to_s.start_with?(FORMULA_PREFIX)
     end
 
-    def is_array_formula? # rubocop:disable Naming/PredicateName
+    def is_array_formula? # rubocop:disable Naming/PredicatePrefix
       return false if escape_formulas
 
       type == :string &&
@@ -529,14 +549,14 @@ module Axlsx
 
       case type
       when :date
-        self.style = STYLE_DATE if style.zero?
+        self.style = STYLE_DATE if style == 0
         if !v.is_a?(Date) && v.respond_to?(:to_date)
           v.to_date
         else
           v
         end
       when :time
-        self.style = STYLE_DATE if style.zero?
+        self.style = STYLE_DATE if style == 0
         if !v.is_a?(Time) && v.respond_to?(:to_time)
           v.to_time
         else

data/lib/axlsx/workbook/worksheet/cell_serializer.rb

@@ -7,7 +7,7 @@ module Axlsx
       # Calls the proper serialization method based on type.
       # @param [Integer] row_index The index of the cell's row
       # @param [Integer] column_index The index of the cell's column
-      # @param [String] str The string to apend serialization to.
+      # @param [String] str The string to append serialization to.
       # @return [String]
       def to_xml_string(row_index, column_index, cell, str = +'')
         str << '<c r="'

data/lib/axlsx/workbook/worksheet/cfvo.rb

@@ -40,10 +40,16 @@ module Axlsx
     attr_reader :val
 
     # @see type
-    def type=(v); Axlsx.validate_conditional_formatting_value_object_type(v); @type = v end
+    def type=(v)
+      Axlsx.validate_conditional_formatting_value_object_type(v)
+      @type = v
+    end
 
     # @see gte
-    def gte=(v); Axlsx.validate_boolean(v); @gte = v end
+    def gte=(v)
+      Axlsx.validate_boolean(v)
+      @gte = v
+    end
 
     # @see val
     def val=(v)

data/lib/axlsx/workbook/worksheet/col.rb

@@ -9,6 +9,7 @@ module Axlsx
 
     include Axlsx::OptionsParser
     include Axlsx::SerializedAttributes
+
     # Create a new Col objects
     # @param min First column affected by this 'column info' record.
     # @param max Last column affected by this 'column info' record.
@@ -110,7 +111,7 @@ module Axlsx
     def width=(v)
       # Removing this validation make a 10% difference in performance
       # as it is called EVERY TIME A CELL IS ADDED - the proper solution
-      # is to only set this if a calculated value is greated than the
+      # is to only set this if a calculated value is greater than the
       # current @width value.
       # TODO!!!
       # Axlsx.validate_unsigned_numeric(v) unless v == nil
@@ -121,17 +122,30 @@ module Axlsx
     # updates the width for this col based on the cells autowidth and
     # an optionally specified fixed width
     # @param [Cell] cell The cell to use in updating this col's width
-    # @param [Integer] fixed_width If this is specified the width is set
-    # to this value and the cell's attributes are ignored.
+    # @param [Numeric, :auto, :ignore, nil] fixed_width Decides how the width
+    # of the cell should be updated. If this is specified as as Numeric the
+    # width is set to this value and the cell's attributes are ignored. If set
+    # to `nil` or `:auto` and `use_autowidth` is true, it uses the autowidth of
+    # the cell. If set to `:ignore`, the cell's width is not changed. In any
+    # case the col's width is set to the new value only if the current width is
+    # smaller than the new one, so that the largest width of all cells in this
+    # column is used.
     # @param [Boolean] use_autowidth If this is false, the cell's
     # autowidth value will be ignored.
     def update_width(cell, fixed_width = nil, use_autowidth = true)
-      if fixed_width.is_a? Numeric
-        self.width = fixed_width
-      elsif use_autowidth
-        cell_width = cell.autowidth
-        self.width = cell_width unless (width || 0) > (cell_width || 0)
-      end
+      cell_width =
+        case fixed_width
+        when Numeric
+          fixed_width
+        when nil, :auto
+          cell.autowidth if use_autowidth
+        when :ignore
+          nil
+        else
+          raise ArgumentError, "fixed_with must be a Numeric, :auto, :ignore or nil, but is '#{fixed_width.inspect}'"
+        end
+
+      self.width = cell_width unless (width || 0) > (cell_width || 0)
     end
 
     # Serialize this columns data to an xml string

data/lib/axlsx/workbook/worksheet/col_breaks.rb

@@ -7,7 +7,7 @@ module Axlsx
   class ColBreaks < SimpleTypedList
     # Instantiates a new list restricted to Break types
     def initialize
-      super Break
+      super(Break)
     end
 
     # A column break specific helper for adding a break.

data/lib/axlsx/workbook/worksheet/cols.rb

@@ -7,7 +7,7 @@ module Axlsx
     def initialize(worksheet)
       raise ArgumentError, "you must provide a worksheet" unless worksheet.is_a?(Worksheet)
 
-      super Col
+      super(Col)
       @worksheet = worksheet
     end