rubyXL 3.4.12 → 3.4.25

data/lib/rubyXL/objects/worksheet.rb

@@ -15,7 +15,6 @@ require 'rubyXL/objects/query_table'
 require 'rubyXL/worksheet'
 
 module RubyXL
-
   # Eventually, the entire code for Worksheet will be moved here. One small step at a time!
 
   # http://www.datypic.com/sc/ooxml/e-ssml_outlinePr-1.html
@@ -58,7 +57,7 @@ module RubyXL
   end
 
   class WorksheetFormatProperties < OOXMLObject
-    define_attribute(:baseColWidth,     :int,    :default => 8)
+    define_attribute(:baseColWidth,     :int, :default => 8)
     define_attribute(:defaultColWidth,  :double)
     define_attribute(:defaultRowHeight, :double, :required => true)
     define_attribute(:customHeight,     :bool,   :default => false)
@@ -83,12 +82,12 @@ module RubyXL
     define_attribute(:blackAndWhite,      :bool,   :default => false)
     define_attribute(:draft,              :bool,   :default => false)
     define_attribute(:cellComments,       RubyXL::ST_CellComments, :default => 'none')
-    define_attribute(:useFirstPageNumber, :bool,   :default => false)
+    define_attribute(:useFirstPageNumber, :bool, :default => false)
     define_attribute(:errors,             RubyXL::ST_PrintError, :default => 'displayed')
     define_attribute(:horizontalDpi,      :int,    :default => 600)
     define_attribute(:verticalDpi,        :int,    :default => 600)
     define_attribute(:copies,             :int,    :default => 1)
-    define_attribute(:'r:id',             :string)
+    define_relationship
     define_element_name 'pageSetup'
   end
 
@@ -166,7 +165,7 @@ module RubyXL
   class ConditionalFormatValue < OOXMLObject
     define_attribute(:type, RubyXL::ST_CfvoType, :required => true)
     define_attribute(:val,  :string)
-    define_attribute(:gte,  :bool,   :default => true)
+    define_attribute(:gte,  :bool, :default => true)
     define_child_node(RubyXL::ExtensionStorageArea)
     define_element_name 'cfvo'
   end
@@ -212,7 +211,7 @@ module RubyXL
     define_attribute(:timePeriod,   RubyXL::ST_TimePeriod)
     define_attribute(:rank,         :int)
     define_attribute(:stdDev,       :int)
-    define_attribute(:equalAverage, :bool,   :default  => false)
+    define_attribute(:equalAverage, :bool, :default => false)
     define_child_node(RubyXL::Formula, :collection => true, :node_name => :formula, :accessor => :formulas)
     define_child_node(RubyXL::ColorScale)
     define_child_node(RubyXL::DataBar)
@@ -301,8 +300,8 @@ module RubyXL
 
   # http://www.datypic.com/sc/ooxml/e-ssml_hyperlink-1.html
   class Hyperlink < OOXMLObject
-    define_attribute(:ref,      :ref,    :required => true)
-    define_attribute(:'r:id',   :string)
+    define_attribute(:ref, :ref, :required => true)
+    define_relationship
     define_attribute(:location, :string)
     define_attribute(:tooltip,  :string)
     define_attribute(:display,  :string)
@@ -323,7 +322,7 @@ module RubyXL
     define_attribute(:oleUpdate, RubyXL::ST_OleUpdate)
     define_attribute(:autoLoad,  :bool, :default => false)
     define_attribute(:shapeId,   :int,  :required => true)
-    define_attribute(:'r:id',    :string)
+    define_relationship
     define_element_name 'oleObject'
   end
 
@@ -339,7 +338,7 @@ module RubyXL
     define_attribute(:ref,    :ref)
     define_attribute(:name,   :string)
     define_attribute(:sheet,  :string)
-    define_attribute(:'r:id', :string)
+    define_relationship
     define_element_name 'dataRef'
   end
 
@@ -408,9 +407,9 @@ module RubyXL
     define_attribute(:hiddenRows,     :bool,   :default => false)
     define_attribute(:hiddenColumns,  :bool,   :default => false)
     define_attribute(:state,          RubyXL::ST_Visibility, :default => 'visible')
-    define_attribute(:filterUnique,   :bool,   :default => false)
+    define_attribute(:filterUnique,   :bool, :default => false)
     define_attribute(:view,           RubyXL::ST_SheetViewType, :default => 'normal')
-    define_attribute(:showRuler,      :bool,   :default => true)
+    define_attribute(:showRuler,      :bool, :default => true)
     define_attribute(:topLeftCell,    :ref)
     define_child_node(RubyXL::Pane)
     define_child_node(RubyXL::Selection)
@@ -433,9 +432,9 @@ module RubyXL
 
   # http://www.datypic.com/sc/ooxml/e-ssml_control-1.html
   class EmbeddedControl < OOXMLObject
-    define_attribute(:shapeId, :int,    :required => true)
-    define_attribute(:'r:id',  :string, :required => true)
-    define_attribute(:name,    :string)
+    define_attribute(:shapeId, :int, :required => true)
+    define_relationship(:required => true)
+    define_attribute(:name, :string)
     define_element_name 'control'
   end
 
@@ -489,8 +488,8 @@ module RubyXL
 
   # http://www.datypic.com/sc/ooxml/e-ssml_customPr-1.html
   class CustomProperty < OOXMLObject
-    define_attribute(:name,   :string, :required => true)
-    define_attribute(:'r:id', :string, :required => true)
+    define_attribute(:name, :string, :required => true)
+    define_relationship(:required => true)
     define_element_name 'customPr'
   end
 
@@ -546,7 +545,7 @@ module RubyXL
     define_attribute(:cacheIndex,    :bool, :default => false)
     define_attribute(:outline,       :bool, :default => true)
     define_attribute(:offset,        :ref)
-    define_attribute(:collapsedLevelsAreSubtotals, :bool,   :default => false)
+    define_attribute(:collapsedLevelsAreSubtotals, :bool, :default => false)
     define_attribute(:axis,          RubyXL::ST_Axis)
     define_attribute(:fieldPosition, :int,  :default => 0)
     define_child_node(RubyXL::PivotReferences)
@@ -572,7 +571,7 @@ module RubyXL
     define_attribute(:previousRow, :uint, :default => 0)
     define_attribute(:previousCol, :uint, :default => 0)
     define_attribute(:click,       :uint, :default => 0)
-    define_attribute(:'r:id',      :string)
+    define_relationship
     define_child_node(RubyXL::PivotArea)
     define_element_name 'pivotSelection'
   end
@@ -597,10 +596,10 @@ module RubyXL
     define_attribute(:zoomScaleNormal,          :uint, :default => 0)
     define_attribute(:zoomScaleSheetLayoutView, :uint, :default => 0)
     define_attribute(:zoomScalePageLayoutView,  :uint, :default => 0)
-    define_attribute(:workbookViewId,           :uint, :required => true, :default => 0 )
+    define_attribute(:workbookViewId,           :uint, :required => true, :default => 0)
     define_child_node(RubyXL::Pane)
     define_child_node(RubyXL::Selection, :collection => true, :accessor => :selections)
-    define_child_node(RubyXL::PivotTableSelection, :collection => true, :accessor => :pivot_table_selections )
+    define_child_node(RubyXL::PivotTableSelection, :collection => true, :accessor => :pivot_table_selections)
     define_child_node(RubyXL::ExtensionStorageArea)
     define_element_name 'sheetView'
   end
@@ -614,8 +613,8 @@ module RubyXL
 
   # http://www.datypic.com/sc/ooxml/e-ssml_worksheet.html
   class Worksheet < OOXMLTopLevelObject
-    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml'
-    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet'
+    CONTENT_TYPE = 'application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml'.freeze
+    REL_TYPE     = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet'.freeze
 
     include RubyXL::RelationshipSupport
 
@@ -651,7 +650,7 @@ module RubyXL
     define_child_node(RubyXL::SortState)
     define_child_node(RubyXL::DataConsolidate)
     define_child_node(RubyXL::CustomSheetViews)
-    define_child_node(RubyXL::MergedCells,           :accessor => :merged_cells)
+    define_child_node(RubyXL::MergedCells, :accessor => :merged_cells)
     define_child_node(RubyXL::PhoneticProperties)
     define_child_node(RubyXL::ConditionalFormatting, :collection => [0..-1])
     define_child_node(RubyXL::DataValidations)
@@ -677,11 +676,11 @@ module RubyXL
     define_child_node(RubyXL::ExtensionStorageArea)
     define_child_node(RubyXL::AlternateContent)
     define_element_name 'worksheet'
-    set_namespaces('http://schemas.openxmlformats.org/spreadsheetml/2006/main' => nil,
+    set_namespaces('http://schemas.openxmlformats.org/spreadsheetml/2006/main'           => nil,
                    'http://schemas.openxmlformats.org/officeDocument/2006/relationships' => 'r',
-                   'http://schemas.openxmlformats.org/markup-compatibility/2006' => 'mc',
-                   'http://schemas.microsoft.com/office/spreadsheetml/2009/9/ac' => 'x14ac',
-                   'urn:schemas-microsoft-com:mac:vml' => 'mv')
+                   'http://schemas.openxmlformats.org/markup-compatibility/2006'         => 'mc',
+                   'http://schemas.microsoft.com/office/spreadsheetml/2009/9/ac'         => 'x14ac',
+                   'urn:schemas-microsoft-com:mac:vml'                                   => 'mv')
 
     attr_accessor :workbook, :state, :sheet_name, :sheet_id, :rels
 
@@ -752,7 +751,12 @@ module RubyXL
       workbook.stylesheet.cell_xfs[get_row_style(row)]
     end
 
+    def cell_at(ref)
+      reference = RubyXL::Reference.new(ref)
+      raise "Invalid reference: #{ref}" unless reference.valid? && reference.single_cell?
+      sheet_data&.rows&.[](reference.first_row)&.cells&.[](reference.first_col)
+    end
+
     include LegacyWorksheet
   end
-
 end

data/lib/rubyXL/parser.rb

@@ -1,6 +1,5 @@
 module RubyXL
   class Parser
-
     # Parse <tt>.xslx</tt> file by reading it from local disk.
     def self.parse(src_file_path)
       begin
@@ -18,12 +17,11 @@ module RubyXL
     def self.parse_buffer(buffer)
       root = nil # Zip::File.open_buffer somehow fails to return the value from the block :(
       begin
-        ::Zip::File.open_buffer(buffer) { |zip_file| root = RubyXL::WorkbookRoot.parse_zip_file(zip_file)  } 
+        ::Zip::File.open_buffer(buffer) { |zip_file| root = RubyXL::WorkbookRoot.parse_zip_file(zip_file) }
         root.workbook
       rescue ::Zip::Error => e
         raise e, "XLSX file format error: #{e}", e.backtrace
       end
     end
-
   end
 end

data/lib/rubyXL/worksheet.rb

@@ -1,98 +1,97 @@
 module RubyXL
-module LegacyWorksheet
-  include Enumerable
-
-  def initialize(params = {})
-    super
-    self.workbook   = params[:workbook]
-    self.sheet_name = params[:sheet_name]
-    self.sheet_id   = params[:sheet_id]
-    self.sheet_data = RubyXL::SheetData.new
-    self.cols = RubyXL::ColumnRanges.new
-    @comments = [] # Do not optimize! These are arrays, so they will share the pointer!
-    @printer_settings = []
-    @generic_storage = []
-  end
-
-  # allows for easier access to sheet_data
-  def [](row = 0)
-    sheet_data[row]
-  end
-
-  def each
-    sheet_data.rows.each { |row| yield(row) }
-  end
-
-  def add_row(row_index = 0, params = {})
-    new_row = RubyXL::Row.new(params)
-    new_row.worksheet = self
-    sheet_data.rows[row_index] = new_row
-  end
-
-  def add_cell(row_index = 0, column_index = 0, data = '', formula = nil, overwrite = true)
-    validate_workbook
-    validate_nonnegative(row_index)
-    validate_nonnegative(column_index)
-    row = sheet_data.rows[row_index] || add_row(row_index)
-
-    c = row.cells[column_index]
-
-    if overwrite || c.nil?
-      c = RubyXL::Cell.new
-      c.worksheet = self
-      c.row = row_index
-      c.column = column_index
-
-      if formula then
-        c.formula = RubyXL::Formula.new(:expression => formula)
-        c.raw_value = data
-      else
-        case data
-        when Numeric          then c.raw_value = data
-        when String           then
+  module LegacyWorksheet
+    include Enumerable
+
+    def initialize(params = {})
+      super
+      self.workbook   = params[:workbook]
+      self.sheet_name = params[:sheet_name]
+      self.sheet_id   = params[:sheet_id]
+      self.sheet_data = RubyXL::SheetData.new
+      self.cols = RubyXL::ColumnRanges.new
+      @comments = [] # Do not optimize! These are arrays, so they will share the pointer!
+      @printer_settings = []
+      @generic_storage = []
+    end
+
+    # allows for easier access to sheet_data
+    def [](row = 0)
+      sheet_data[row]
+    end
+
+    def each
+      sheet_data.rows.each { |row| yield(row) }
+    end
+
+    def add_row(row_index = 0, params = {})
+      new_row = RubyXL::Row.new(params)
+      new_row.worksheet = self
+      sheet_data.rows[row_index] = new_row
+    end
+
+    def add_cell(row_index = 0, column_index = 0, data = '', formula = nil, overwrite = true)
+      validate_workbook
+      validate_nonnegative(row_index)
+      validate_nonnegative(column_index)
+      row = sheet_data.rows[row_index] || add_row(row_index)
+
+      c = row.cells[column_index]
+
+      if overwrite || c.nil?
+        c = RubyXL::Cell.new
+        c.worksheet = self
+        c.row = row_index
+        c.column = column_index
+
+        if formula then
+          c.formula = RubyXL::Formula.new(:expression => formula)
           c.raw_value = data
-          c.datatype = RubyXL::DataType::RAW_STRING
-        when RubyXL::RichText then
-          c.is = data
-          c.datatype = RubyXL::DataType::INLINE_STRING
-        when Date, DateTime then
-          c.raw_value = workbook.date_to_num(data)
-        when NilClass         then nil
+        else
+          case data
+          when Numeric          then c.raw_value = data
+          when String           then
+            c.raw_value = data
+            c.datatype = RubyXL::DataType::RAW_STRING
+          when RubyXL::RichText then
+            c.is = data
+            c.datatype = RubyXL::DataType::INLINE_STRING
+          when Time, Date, DateTime then
+            c.raw_value = workbook.date_to_num(data)
+          when NilClass then nil
+          end
         end
+
+        range = cols && cols.locate_range(column_index)
+        c.style_index = row.style_index || (range && range.style_index) || 0
+        row.cells[column_index] = c
       end
 
-      range = cols && cols.locate_range(column_index)
-      c.style_index = row.style_index || (range && range.style_index) || 0
-      row.cells[column_index] = c
+      c
     end
 
-    c
-  end
+    private
 
-  private
+    # validates Workbook, ensures that this worksheet is in @workbook
+    def validate_workbook
+      unless @workbook.nil? || @workbook.worksheets.nil?
+        return if @workbook.worksheets.any? { |sheet| sheet.equal?(self) }
+      end
 
-  #validates Workbook, ensures that this worksheet is in @workbook
-  def validate_workbook()
-    unless @workbook.nil? || @workbook.worksheets.nil?
-      return if @workbook.worksheets.any? { |sheet| sheet.equal?(self) }
+      raise "This worksheet #{self} is not in workbook #{@workbook}"
     end
 
-    raise "This worksheet #{self} is not in workbook #{@workbook}"
-  end
+    # Ensures that storage space for a cell with +row_index+ and +column_index+
+    # exists in +sheet_data+ arrays, growing them up if necessary.
+    def ensure_cell_exists(row_index, column_index = 0)
+      validate_nonnegative(row_index)
+      validate_nonnegative(column_index)
 
-  # Ensures that storage space for a cell with +row_index+ and +column_index+
-  # exists in +sheet_data+ arrays, growing them up if necessary.
-  def ensure_cell_exists(row_index, column_index = 0)
-    validate_nonnegative(row_index)
-    validate_nonnegative(column_index)
-
-    sheet_data.rows[row_index] || add_row(row_index)
-  end
-
-  def validate_nonnegative(row_or_col)
-    raise 'Row and Column arguments must be nonnegative' if row_or_col < 0
-  end
-  private :validate_nonnegative
+      sheet_data.rows[row_index] || add_row(row_index)
+    end
 
-end #end class
+    def validate_nonnegative(row_or_col)
+      raise 'Row and Column arguments must be nonnegative' if row_or_col < 0
+    end
+    private :validate_nonnegative
+  end # end class
 end

data/lib/rubyXL.rb

@@ -9,5 +9,4 @@ module RubyXL
     return path unless path.absolute?
     path.relative_path_from(OOXMLTopLevelObject::ROOT)
   end
-
 end

data/rdoc/README_rdoc.html

@@ -4,7 +4,7 @@
 <head>
 <meta charset="UTF-8">
 
-<title>README - rubyXL 3.4.12</title>
+<title>README - rubyXL 3.4.25</title>
 
 <script type="text/javascript">
   var rdoc_rel_prefix = "./";
@@ -21,7 +21,6 @@
 <link href="./css/rdoc.css" rel="stylesheet">
 
 
-
 <body id="top" role="document" class="file">
 <nav role="navigation">
   <div id="project-navigation">
@@ -94,9 +93,11 @@
     <li><a href="#label-Insert+Cell">Insert Cell</a>
     <li><a href="#label-Delete+Cell">Delete Cell</a>
     <li><a href="#label-Modifying+Cell+Format">Modifying Cell Format</a>
+    <li><a href="#label-Add+hyperlink+to+a+Cell">Add hyperlink to a Cell</a>
     <li><a href="#label-I-2FO">I/O</a>
     <li><a href="#label-Miscellaneous">Miscellaneous</a>
     <li><a href="#label-Suppress+warnings+about+malformed+input+files">Suppress warnings about malformed input files</a>
+    <li><a href="#label-Data+validation+-28colloquially+referred+to+as+-22dropdown+list-22-29">Data validation (colloquially referred to as “dropdown list”)</a>
     <li><a href="#label-For+more+information">For more information</a>
     <li><a href="#label-Contributing+to+rubyXL">Contributing to rubyXL</a>
     <li><a href="#label-Copyright">Copyright</a>
@@ -105,13 +106,12 @@
 
 
   <div id="project-metadata">
-    <div id="fileindex-section" class="nav-section">
+    
+<div id="fileindex-section" class="nav-section">
   <h3>Pages</h3>
 
   <ul class="link-list">
-  
     <li><a href="./README_rdoc.html">README</a>
-  
   </ul>
 </div>
 
@@ -189,6 +189,15 @@
 <pre class="ruby"><span class="ruby-identifier">worksheet</span> = <span class="ruby-identifier">workbook</span>[<span class="ruby-value">0</span>]
 <span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>] <span class="ruby-comment"># Returns cell A1 in the worksheet</span>
 <span class="ruby-identifier">worksheet</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>]            <span class="ruby-comment"># Returns cell A1 in the worksheet</span>
+
+<span class="ruby-identifier">cell</span> = <span class="ruby-identifier">worksheet</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>]
+<span class="ruby-identifier">cell</span>.<span class="ruby-identifier">value</span>                 <span class="ruby-comment"># Returns a properly converted value in the cell (if the file claims that the cell</span>
+                           <span class="ruby-comment"># is holding a number, returns a respective Integer or Float, and so on).</span>
+</pre>
+
+<p>Or, if you prefer Excel-style references (single-cell only!)</p>
+
+<pre class="ruby"><span class="ruby-identifier">cell</span> = <span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">cell_at</span>(<span class="ruby-string">&#39;B11&#39;</span>)
 </pre>
 
 <h4 id="label-Wrappers+for+accessing+Cell+properties">Wrappers for accessing Cell properties<span><a href="#label-Wrappers+for+accessing+Cell+properties">&para;</a> <a href="#top">&uarr;</a></span></h4>
@@ -294,38 +303,30 @@
 
 <h5 id="label-Horizontal">Horizontal<span><a href="#label-Horizontal">&para;</a> <a href="#top">&uarr;</a></span></h5>
 
-<p>center, distributed, justify, left, right</p>
-
-<pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>].<span class="ruby-identifier">change_horizontal_alignment</span>(<span class="ruby-string">&#39;center&#39;</span>) <span class="ruby-comment"># Sets A1 to be centered</span>
+<pre class="ruby"><span class="ruby-comment"># Possible alignments: center, distributed, justify, left, right</span>
+<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>].<span class="ruby-identifier">change_horizontal_alignment</span>(<span class="ruby-string">&#39;center&#39;</span>) <span class="ruby-comment"># Sets A1 to be centered</span>
 <span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_row_horizontal_alignment</span>(<span class="ruby-value">0</span>, <span class="ruby-string">&#39;justify&#39;</span>)          <span class="ruby-comment"># Sets first row to be justified</span>
 <span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_column_horizontal_alignment</span>(<span class="ruby-value">0</span>, <span class="ruby-string">&#39;right&#39;</span>)         <span class="ruby-comment"># Sets first column to be right-aligned</span>
 </pre>
 
 <h5 id="label-Vertical">Vertical<span><a href="#label-Vertical">&para;</a> <a href="#top">&uarr;</a></span></h5>
 
-<p>bottom, center, distributed, top</p>
-
-<pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>].<span class="ruby-identifier">change_vertical_alignment</span>(<span class="ruby-string">&#39;bottom&#39;</span>)  <span class="ruby-comment"># Sets A1 to be bottom aligned</span>
+<pre class="ruby"><span class="ruby-comment"># Possible alignments: bottom, center, distributed, top</span>
+<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>].<span class="ruby-identifier">change_vertical_alignment</span>(<span class="ruby-string">&#39;bottom&#39;</span>)  <span class="ruby-comment"># Sets A1 to be bottom aligned</span>
 <span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_row_vertical_alignment</span>(<span class="ruby-value">0</span>, <span class="ruby-string">&#39;distributed&#39;</span>)       <span class="ruby-comment"># Sets first row to be distributed vertically</span>
 <span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_column_vertical_alignment</span>(<span class="ruby-value">0</span>, <span class="ruby-string">&#39;top&#39;</span>)            <span class="ruby-comment"># Sets first column to be top aligned</span>
 </pre>
 
 <h5 id="label-Rotation">Rotation<span><a href="#label-Rotation">&para;</a> <a href="#top">&uarr;</a></span></h5>
 
-<pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>].<span class="ruby-identifier">change_text_rotation</span>(<span class="ruby-value">90</span>)  <span class="ruby-comment"># Sets A1 to be rotated by 90 degrees</span>
+<pre class="ruby"><span class="ruby-comment"># Possible values:</span>
+<span class="ruby-comment"># * 0-90 - degrees counterclockwise, around the bottom LEFT corner of the cell;</span>
+<span class="ruby-comment"># * 91-179 - degrees clockwise, around the bottom RIGHT corner of the cell;</span>
+<span class="ruby-comment"># * 180-254 - degrees clockwise, around the bottom LEFT corner of the cell, text becomes progressively invisible</span>
+<span class="ruby-comment"># * 255 - text is in normal rotation but displayed vertically (one letter under another), line feed starts new line to the right of the previous.</span>
+<span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">sheet_data</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>].<span class="ruby-identifier">change_text_rotation</span>(<span class="ruby-value">90</span>)  <span class="ruby-comment"># Sets A1 to be rotated by 90 degrees</span>
 </pre>
 
-<p>Values:</p>
-<ul><li>
-<p>0-90 - degrees counterclockwise, around the bottom LEFT corner of the cell;</p>
-</li><li>
-<p>91-179 - degrees clockwise, around the bottom RIGHT corner of the cell;</p>
-</li><li>
-<p>180-254 - degrees clockwise, around the bottom LEFT corner of the cell, text becomes progressively invisible</p>
-</li><li>
-<p>255 - text is in normal rotation but displayed vertically (one letter under another), line feed starts new line to the right of the previous.</p>
-</li></ul>
-
 <h4 id="label-Changing+Row+Height">Changing Row Height<span><a href="#label-Changing+Row+Height">&para;</a> <a href="#top">&uarr;</a></span></h4>
 
 <pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">change_row_height</span>(<span class="ruby-value">0</span>, <span class="ruby-value">30</span>)  <span class="ruby-comment"># Sets first row height to 30</span>
@@ -404,9 +405,16 @@
 <pre class="ruby"><span class="ruby-identifier">cell</span> = <span class="ruby-identifier">worksheet</span>[<span class="ruby-value">0</span>][<span class="ruby-value">0</span>]
 <span class="ruby-identifier">cell</span>.<span class="ruby-identifier">set_number_format</span> <span class="ruby-string">&#39;0.0000%&#39;</span>    <span class="ruby-comment"># For formats, see https://support.office.com/en-us/article/5026bbd6-04bc-48cd-bf33-80f18b4eae68</span>
 <span class="ruby-identifier">cell</span>.<span class="ruby-identifier">change_text_wrap</span>(<span class="ruby-keyword">true</span>)         <span class="ruby-comment"># Makes the text in the cell to wrap.</span>
+<span class="ruby-identifier">cell</span>.<span class="ruby-identifier">change_shrink_to_fit</span>(<span class="ruby-keyword">true</span>)     <span class="ruby-comment"># Makes the text in the cell to shrink to fit.</span>
 <span class="ruby-identifier">cell</span>.<span class="ruby-identifier">change_text_indent</span>(<span class="ruby-value">1</span>)          <span class="ruby-comment"># Indents the text in the cell by 1 level</span>
 </pre>
 
+<h4 id="label-Add+hyperlink+to+a+Cell">Add hyperlink to a Cell<span><a href="#label-Add+hyperlink+to+a+Cell">&para;</a> <a href="#top">&uarr;</a></span></h4>
+
+<pre class="ruby"><span class="ruby-identifier">cell</span>.<span class="ruby-identifier">add_hyperlink</span>(<span class="ruby-string">&#39;http://example.com&#39;</span>)
+<span class="ruby-identifier">cell</span>.<span class="ruby-identifier">add_hyperlink</span>(<span class="ruby-string">&#39;http://example.com&#39;</span>, <span class="ruby-string">&#39;Some tooltip text&#39;</span>)
+</pre>
+
 <h2 id="label-I-2FO">I/O<span><a href="#label-I-2FO">&para;</a> <a href="#top">&uarr;</a></span></h2>
 
 <p>By default, the gem operates with files on the local filesystem:</p>
@@ -432,15 +440,20 @@
 <pre class="ruby"><span class="ruby-constant">RubyXL</span>.<span class="ruby-identifier">class_variable_set</span>(<span class="ruby-value">:@@suppress_warnings</span>, <span class="ruby-keyword">true</span>)
 </pre>
 
+<h2 id="label-Data+validation+-28colloquially+referred+to+as+-22dropdown+list-22-29">Data validation (colloquially referred to as “dropdown list”)<span><a href="#label-Data+validation+-28colloquially+referred+to+as+-22dropdown+list-22-29">&para;</a> <a href="#top">&uarr;</a></span></h2>
+
+<pre class="ruby"><span class="ruby-identifier">worksheet</span>.<span class="ruby-identifier">add_validation_list</span>(<span class="ruby-string">&quot;A1&quot;</span>, [ <span class="ruby-string">&quot;value1&quot;</span>, <span class="ruby-string">&quot;value2&quot;</span> ])
+</pre>
+
 <h2 id="label-For+more+information">For more information<span><a href="#label-For+more+information">&para;</a> <a href="#top">&uarr;</a></span></h2>
 
 <p>Take a look at the files in spec/lib/ for rspecs on most methods</p>
 
 <h2 id="label-Contributing+to+rubyXL">Contributing to rubyXL<span><a href="#label-Contributing+to+rubyXL">&para;</a> <a href="#top">&uarr;</a></span></h2>
 <ul><li>
-<p>Check out the latest master to make sure the feature hasn&#39;t been implemented or the bug hasn&#39;t been fixed yet</p>
+<p>Check out the latest master to make sure the feature hasn’t been implemented or the bug hasn’t been fixed yet</p>
 </li><li>
-<p>Check out the issue tracker to make sure someone already hasn&#39;t requested it and/or contributed it</p>
+<p>Check out the issue tracker to make sure someone already hasn’t requested it and/or contributed it</p>
 </li><li>
 <p>Fork the project</p>
 </li><li>
@@ -448,21 +461,22 @@
 </li><li>
 <p>Commit and push until you are happy with your contribution</p>
 </li><li>
-<p>Make sure to add tests for it. This is important so I don&#39;t break it in a future version unintentionally.</p>
+<p>Make sure to add tests for it. This is important so I don’t break it in a future version unintentionally.</p>
 </li><li>
 <p>Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.</p>
 </li></ul>
 
 <h2 id="label-Copyright">Copyright<span><a href="#label-Copyright">&para;</a> <a href="#top">&uarr;</a></span></h2>
 
-<p>Copyright © 2011 Vivek Bhagwat, 2013-2020 Wesha. See LICENSE.txt for further details.</p>
+<p>Copyright © 2011 Vivek Bhagwat, 2013-2022 Wesha. See LICENSE.txt for further details.</p>
+
 </main>
 
 
 
 <footer id="validator-badges" role="contentinfo">
   <p><a href="https://validator.w3.org/check/referer">Validate</a>
-  <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.2.0.
+  <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.4.0.
   <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
 </footer>