caxlsx 3.3.0 → 3.4.0

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

@@ -1,8 +1,6 @@
 module Axlsx
-
   # A worksheet hyperlink object. Note that this is not the same as a drawing hyperlink object.
   class WorksheetHyperlink
-
     include Axlsx::OptionsParser
     include Axlsx::Accessors
     include Axlsx::SerializedAttributes
@@ -15,7 +13,7 @@ module Axlsx
     # @option [String] tooltip The tip to display when the user positions the mouse cursor over this hyperlink
     # @option [Symbol] target This is :external by default. If you set it to anything else, the location is interpreted to be the current workbook.
     # @option [String|Cell] ref The location of this hyperlink in the worksheet
-    def initialize(worksheet, options={})
+    def initialize(worksheet, options = {})
       DataTypeValidator.validate "Hyperlink.worksheet", [Worksheet], worksheet
       @worksheet = worksheet
       @target = :external
@@ -27,7 +25,7 @@ module Axlsx
 
     serializable_attributes :display, :tooltip, :ref
 
-    #Cell location of hyperlink on worksheet.
+    # Cell location of hyperlink on worksheet.
     # @return [String]
     attr_reader :ref
 
@@ -51,13 +49,14 @@ module Axlsx
     # @return [Relationship]
     def relationship
       return unless @target == :external
+
       Relationship.new(self, HYPERLINK_R, location, :target_mode => :External)
     end
 
     # Seralize the object
     # @param [String] str
     # @return [String]
-    def to_xml_string(str='')
+    def to_xml_string(str = '')
       str << '<hyperlink '
       serialized_attributes str, location_or_id
       str << '/>'
@@ -68,7 +67,7 @@ module Axlsx
     # r:id should only be specified for external targets.
     # @return [Hash]
     def location_or_id
-      @target == :external ?  { :"r:id" => relationship.Id } : { :location => Axlsx::coder.encode(location) }
+      @target == :external ? { :"r:id" => relationship.Id } : { :location => Axlsx::coder.encode(location) }
     end
   end
 end

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

@@ -1,8 +1,6 @@
 module Axlsx
-
-  #A collection of hyperlink objects for a worksheet
+  # A collection of hyperlink objects for a worksheet
   class WorksheetHyperlinks < SimpleTypedList
-
     # Creates a new Hyperlinks collection
     # @param [Worksheet] worksheet the worksheet that owns these hyperlinks
     def initialize(worksheet)
@@ -23,13 +21,15 @@ module Axlsx
     # @return Array
     def relationships
       return [] if empty?
+
       map { |hyperlink| hyperlink.relationship }
     end
 
     # seralize the collection of hyperlinks
     # @return [String]
-    def to_xml_string(str='')
+    def to_xml_string(str = '')
       return if empty?
+
       str << '<hyperlinks>'
       each { |hyperlink| hyperlink.to_xml_string(str) }
       str << '</hyperlinks>'

data/lib/axlsx.rb

@@ -1,4 +1,3 @@
-# encoding: UTF-8
 require 'htmlentities'
 require 'axlsx/version.rb'
 require 'marcel'
@@ -22,11 +21,11 @@ require 'axlsx/rels/relationships.rb'
 require 'axlsx/drawing/drawing.rb'
 require 'axlsx/workbook/workbook.rb'
 require 'axlsx/package.rb'
-#required gems
+# required gems
 require 'nokogiri'
 require 'zip'
 
-#core dependencies
+# core dependencies
 require 'bigdecimal'
 require 'set'
 require 'time'
@@ -55,7 +54,7 @@ module Axlsx
   end
 
   # determines the cell range for the items provided
-  def self.cell_range(cells, absolute=true)
+  def self.cell_range(cells, absolute = true)
     return "" unless cells.first.is_a? Cell
 
     first_cell, last_cell = cells.minmax_by(&:pos)
@@ -76,7 +75,7 @@ module Axlsx
     cells.sort_by(&:pos)
   end
 
-  #global reference html entity encoding
+  # global reference html entity encoding
   # @return [HtmlEntities]
   def self.coder
     @@coder ||= ::HTMLEntities.new
@@ -89,7 +88,7 @@ module Axlsx
     letters_str = name[/[A-Z]+/]
 
     # capitalization?!?
-    v = letters_str.reverse.chars.reduce({:base=>1, :i=>0}) do  |val, c|
+    v = letters_str.reverse.chars.reduce({ :base => 1, :i => 0 }) do |val, c|
       val[:i] += ((c.bytes.first - 64) * val[:base])
 
       val[:base] *= 26
@@ -124,7 +123,7 @@ module Axlsx
   # @example Relative Cell Reference
   #   ws.rows.first.cells.first.r #=> "A1"
   def self.cell_r(c_index, r_index)
-    col_ref(c_index) << (r_index+1).to_s
+    col_ref(c_index) << (r_index + 1).to_s
   end
 
   # Creates an array of individual cell references based on an excel reference range.
@@ -144,10 +143,10 @@ module Axlsx
   # performs the increadible feat of changing snake_case to CamelCase
   # @param [String] s The snake case string to camelize
   # @return [String]
-  def self.camel(s="", all_caps = true)
+  def self.camel(s = "", all_caps = true)
     s = s.to_s
     s = s.capitalize if all_caps
-    s.gsub(/_(.)/){ $1.upcase }
+    s.gsub(/_(.)/) { $1.upcase }
   end
 
   # returns the provided string with all invalid control charaters
@@ -201,4 +200,19 @@ module Axlsx
   def self.trust_input=(trust_me)
     @trust_input = trust_me
   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.
+  # See https://www.owasp.org/index.php/CSV_Injection for details.
+  # @return [Boolean]
+  def self.escape_formulas
+    !defined?(@escape_formulas) || @escape_formulas.nil? ? false : @escape_formulas
+  end
+
+  # Sets whether to treat values starting with an equals sign as formulas or as literal strings.
+  # @param [Boolean] value The value to set.
+  def self.escape_formulas=(value)
+    Axlsx.validate_boolean(value)
+    @escape_formulas = value
+  end
 end

data/lib/caxlsx.rb

@@ -1,2 +1 @@
-# encoding: UTF-8
 require 'axlsx.rb'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: caxlsx
 version: !ruby/object:Gem::Version
-  version: 3.3.0
+  version: 3.4.0
 platform: ruby
 authors:
 - Randy Morgan
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-10-21 00:00:00.000000000 Z
+date: 2023-04-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -344,7 +344,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.9
+rubygems_version: 3.2.3
 signing_key:
 specification_version: 4
 summary: Excel OOXML (xlsx) with charts, styles, images and autowidth columns.