bonio-axlsx 2.2.1

data/lib/axlsx/stylesheet/cell_style.rb

@@ -0,0 +1,72 @@
+# encoding: UTF-8
+module Axlsx
+  # CellStyle defines named styles that reference defined formatting records and can be used in your worksheet.
+  # @note Using Styles#add_style is the recommended way to manage cell styling.
+  # @see Styles#add_style
+  class CellStyle
+
+    include Axlsx::OptionsParser
+    include Axlsx::SerializedAttributes
+
+    # Creats a new CellStyle object
+    # @option options [String] name
+    # @option options [Integer] xfId
+    # @option options [Integer] buildinId
+    # @option options [Integer] iLevel
+    # @option options [Boolean] hidden
+    # @option options [Boolean] customBuiltIn
+    def initialize(options={})
+      parse_options options
+    end
+
+    serializable_attributes :name, :xfId, :buildinId, :iLevel, :hidden, :customBuilin
+
+    # The name of this cell style
+    # @return [String]
+    attr_reader :name
+
+    # The formatting record id this named style utilizes
+    # @return [Integer]
+    # @see Axlsx::Xf
+    attr_reader :xfId
+
+    # The buildinId to use when this named style is applied
+    # @return [Integer]
+    # @see Axlsx::NumFmt
+    attr_reader :builtinId
+
+    # Determines if this formatting is for an outline style, and what level of the outline it is to be applied to.
+    # @return [Integer]
+    attr_reader :iLevel
+
+    # Determines if this named style should show in the list of styles when using excel
+    # @return [Boolean]
+    attr_reader :hidden
+
+    # Indicates that the build in style reference has been customized.
+    # @return [Boolean]
+    attr_reader :customBuiltin
+
+     # @see name
+    def name=(v)  Axlsx::validate_string v; @name = v end
+    # @see xfId
+    def xfId=(v) Axlsx::validate_unsigned_int v; @xfId = v end
+    # @see builtinId
+    def builtinId=(v) Axlsx::validate_unsigned_int v; @builtinId = v end
+    # @see iLivel
+    def iLevel=(v) Axlsx::validate_unsigned_int v; @iLevel = v end
+    # @see hidden
+    def hidden=(v) Axlsx::validate_boolean v; @hidden = v end
+    # @see customBuiltin
+    def customBuiltin=(v) Axlsx::validate_boolean v; @customBuiltin = v end
+
+    # Serializes the object
+    # @param [String] str
+    # @return [String]
+    def to_xml_string(str = '')
+      serialized_tag('cellStyle', str)
+    end
+
+  end
+
+end

data/lib/axlsx/stylesheet/color.rb

@@ -0,0 +1,76 @@
+# encoding: UTF-8
+module Axlsx
+  # The color class represents a color used for borders, fills an fonts
+  class Color
+
+    include Axlsx::OptionsParser
+    include Axlsx::SerializedAttributes
+
+    # Creates a new Color object
+    # @option options [Boolean] auto
+    # @option options [String] rgb
+    # @option options [Float] tint
+    def initialize(options={})
+      @rgb = "FF000000"
+      parse_options options
+    end
+
+    serializable_attributes :auto, :rgb, :tint
+
+    # Determines if the color is system color dependant
+    # @return [Boolean]
+    attr_reader :auto
+
+    # The color as defined in rgb terms.
+    # @note
+    #  rgb colors need to conform to ST_UnsignedIntHex. That basically means put 'FF' before you color
+    # When assigning the rgb value the behavior is much like CSS selectors and can use shorthand versions as follows:
+    # If you provide a two character value it will be repeated for each r, g, b assignment
+    # If you provide data that is not 2 characters in length, and is less than 8 characters it will be padded with "F"
+    # @example
+    #        Color.new :rgb => "FF000000"
+    #          => #<Axlsx::Color:0x102106b68 @rgb="FF000000">
+    #        Color.new :rgb => "0A"
+    #          => #<Axlsx::Color:0x102106b68 @rgb="FF0A0A0A">
+    #        Color.new :rgb => "00BB"
+    #          => #<Axlsx::Color:0x102106b68 @rgb="FFFF00BB">
+    # @return [String]
+    attr_reader :rgb
+
+    # no support for theme just yet
+    # @return [Integer]
+    #attr_reader :theme
+
+    # The tint value.
+    # @note valid values are between -1.0 and 1.0
+    # @return [Float]
+    attr_reader :tint
+
+     # @see auto
+    def auto=(v) Axlsx::validate_boolean v; @auto = v end
+    # @see color
+    def rgb=(v)
+      Axlsx::validate_string(v)
+      v = v.upcase
+      v = v * 3 if v.size == 2
+      v = v.rjust(8, 'FF')
+      raise ArgumentError, "Invalid color rgb value: #{v}." unless v.match(/[0-9A-F]{8}/)
+      @rgb = v
+    end
+    # @see tint
+    def tint=(v) Axlsx::validate_float v; @tint = v end
+
+    # This version does not support themes
+    # def theme=(v) Axlsx::validate_unsigned_integer v; @theme = v end
+
+    # Indexed colors are for backward compatability which I am choosing not to support
+    # def indexed=(v) Axlsx::validate_unsigned_integer v; @indexed = v end
+
+    # Serializes the object
+    # @param [String] str
+    # @return [String]
+    def to_xml_string(str = '', tag_name = 'color')
+      serialized_tag('' + tag_name + '', str)
+    end
+  end
+end

data/lib/axlsx/stylesheet/dxf.rb

@@ -0,0 +1,79 @@
+# encoding: UTF-8
+module Axlsx
+  # The Dxf class defines an incremental formatting record for use in Styles. The recommended way to manage styles for your workbook is with Styles#add_style
+  # @see Styles#add_style
+  class Dxf
+
+    include Axlsx::OptionsParser
+
+    # The order in which the child elements is put in the XML seems to
+    # be important for Excel
+    CHILD_ELEMENTS = [:font, :numFmt, :fill, :alignment, :border, :protection]
+    #does not support extList (ExtensionList)
+
+    # The cell alignment for this style
+    # @return [CellAlignment]
+    # @see CellAlignment
+    attr_reader :alignment
+
+    # The cell protection for this style
+    # @return [CellProtection]
+    # @see CellProtection
+    attr_reader :protection
+
+    # the child NumFmt to be used to this style
+    # @return [NumFmt]
+    attr_reader :numFmt
+
+    # the child font to be used for this style
+    # @return [Font]
+    attr_reader :font
+
+    # the child fill to be used in this style
+    # @return [Fill]
+    attr_reader :fill
+
+    # the border to be used in this style
+    # @return [Border]
+    attr_reader :border
+
+    # Creates a new Xf object
+    # @option options [Border] border
+    # @option options [NumFmt] numFmt
+    # @option options [Fill] fill
+    # @option options [Font] font
+    # @option options [CellAlignment] alignment
+    # @option options [CellProtection] protection
+    def initialize(options={})
+      parse_options options
+    end
+
+    # @see Dxf#alignment
+    def alignment=(v) DataTypeValidator.validate "Dxf.alignment", CellAlignment, v; @alignment = v end
+    # @see protection
+    def protection=(v) DataTypeValidator.validate "Dxf.protection", CellProtection, v; @protection = v end
+    # @see numFmt
+    def numFmt=(v) DataTypeValidator.validate "Dxf.numFmt", NumFmt, v; @numFmt = v end
+    # @see font
+    def font=(v) DataTypeValidator.validate "Dxf.font", Font, v; @font = v end
+    # @see border
+    def border=(v) DataTypeValidator.validate "Dxf.border", Border, v; @border = v end
+    # @see fill
+    def fill=(v) DataTypeValidator.validate "Dxf.fill", Fill, v; @fill = v end
+
+    # Serializes the object
+    # @param [String] str
+    # @return [String]
+    def to_xml_string(str = '')
+      str << '<dxf>'
+      # Dxf elements have no attributes. All of the instance variables
+      # are child elements.
+      CHILD_ELEMENTS.each do |element|
+        self.send(element).to_xml_string(str) if self.send(element)
+      end
+      str << '</dxf>'
+    end
+
+  end
+
+end

data/lib/axlsx/stylesheet/fill.rb

@@ -0,0 +1,35 @@
+# encoding: UTF-8
+module Axlsx
+  # The Fill is a formatting object that manages the background color, and pattern for cells.
+  # @note The recommended way to manage styles in your workbook is to use Styles#add_style.
+  # @see Styles#add_style
+  # @see PatternFill
+  # @see GradientFill
+  class Fill
+
+    # The type of fill
+    # @return [PatternFill, GradientFill]
+    attr_reader :fill_type
+
+    # Creates a new Fill object
+    # @param [PatternFill, GradientFill] fill_type
+    # @raise [ArgumentError] if the fill_type parameter is not a PatternFill or a GradientFill instance
+    def initialize(fill_type)
+      self.fill_type = fill_type
+    end
+
+    # Serializes the object
+    # @param [String] str
+    # @return [String]
+    def to_xml_string(str = '')
+      str << '<fill>'
+      @fill_type.to_xml_string(str)
+      str << '</fill>'
+    end
+
+    # @see fill_type
+    def fill_type=(v) DataTypeValidator.validate "Fill.fill_type", [PatternFill, GradientFill], v; @fill_type = v; end
+
+
+  end
+end

data/lib/axlsx/stylesheet/font.rb

@@ -0,0 +1,148 @@
+# encoding: UTF-8
+module Axlsx
+  # The Font class details a font instance for use in styling cells.
+  # @note The recommended way to manage fonts, and other styles is Styles#add_style
+  # @see Styles#add_style
+  class Font
+    include Axlsx::OptionsParser
+
+    # Creates a new Font
+    # @option options [String] name
+    # @option options [Integer] charset
+    # @option options [Integer] family
+    # @option options [Integer] family
+    # @option options [Boolean] b
+    # @option options [Boolean] i
+    # @option options [Boolean] u
+    # @option options [Boolean] strike
+    # @option options [Boolean] outline
+    # @option options [Boolean] shadow
+    # @option options [Boolean] condense
+    # @option options [Boolean] extend
+    # @option options [Color] color
+    # @option options [Integer] sz
+    def initialize(options={})
+      parse_options options
+    end
+
+    # The name of the font
+    # @return [String]
+    attr_reader :name
+
+    # The charset of the font
+    # @return [Integer]
+    # @note
+    #  The following values are defined in the OOXML specification and are OS dependant values
+    #   0   ANSI_CHARSET
+    #   1   DEFAULT_CHARSET
+    #   2   SYMBOL_CHARSET
+    #   77  MAC_CHARSET
+    #   128 SHIFTJIS_CHARSET
+    #   129 HANGUL_CHARSET
+    #   130 JOHAB_CHARSET
+    #   134 GB2312_CHARSET
+    #   136 CHINESEBIG5_CHARSET
+    #   161 GREEK_CHARSET
+    #   162 TURKISH_CHARSET
+    #   163 VIETNAMESE_CHARSET
+    #   177 HEBREW_CHARSET
+    #   178 ARABIC_CHARSET
+    #   186 BALTIC_CHARSET
+    #   204 RUSSIAN_CHARSET
+    #   222 THAI_CHARSET
+    #   238 EASTEUROPE_CHARSET
+    #   255 OEM_CHARSET
+    attr_reader :charset
+
+    # The font's family
+    # @note
+    #  The following are defined OOXML specification
+    #   0 Not applicable.
+    #   1 Roman
+    #   2 Swiss
+    #   3 Modern
+    #   4 Script
+    #   5 Decorative
+    #   6..14 Reserved for future use
+    # @return [Integer]
+    attr_reader :family
+
+    # Indicates if the font should be rendered in *bold*
+    # @return [Boolean]
+    attr_reader :b
+
+    # Indicates if the font should be rendered italicized
+    # @return [Boolean]
+    attr_reader :i
+
+    # Indicates if the font should be rendered underlined
+    # @return [Boolean]
+    attr_reader :u
+
+    # Indicates if the font should be rendered with a strikthrough
+    # @return [Boolean]
+    attr_reader :strike
+
+    # Indicates if the font should be rendered with an outline
+    # @return [Boolean]
+    attr_reader :outline
+
+    # Indicates if the font should be rendered with a shadow
+    # @return [Boolean]
+    attr_reader :shadow
+
+    # Indicates if the font should be condensed
+    # @return [Boolean]
+    attr_reader :condense
+
+    # The font's extend property
+    # @return [Boolean]
+    attr_reader  :extend
+
+    # The color of the font
+    # @return [Color]
+    attr_reader :color
+
+    # The size of the font.
+    # @return [Integer]
+    attr_reader :sz
+
+     # @see name
+    def name=(v) Axlsx::validate_string v; @name = v end
+    # @see charset
+    def charset=(v) Axlsx::validate_unsigned_int v; @charset = v end
+    # @see family
+    def family=(v) Axlsx::validate_unsigned_int v; @family = v end
+    # @see b
+    def b=(v) Axlsx::validate_boolean v; @b = v end
+    # @see i
+    def i=(v) Axlsx::validate_boolean v; @i = v end
+    # @see u
+    def u=(v) Axlsx::validate_boolean v; @u = v end
+    # @see strike
+    def strike=(v) Axlsx::validate_boolean v; @strike = v end
+    # @see outline
+    def outline=(v) Axlsx::validate_boolean v; @outline = v end
+    # @see shadow
+    def shadow=(v) Axlsx::validate_boolean v; @shadow = v end
+    # @see condense
+    def condense=(v) Axlsx::validate_boolean v; @condense = v end
+    # @see extend
+    def extend=(v) Axlsx::validate_boolean v; @extend = v end
+    # @see color
+    def color=(v) DataTypeValidator.validate "Font.color", Color, v; @color=v end
+    # @see sz
+    def sz=(v) Axlsx::validate_unsigned_int v; @sz=v end
+
+    # Serializes the object
+    # @param [String] str
+    # @return [String]
+    def to_xml_string(str = '')
+      str << '<font>'
+      instance_values.each do |k, v|
+        v.is_a?(Color) ? v.to_xml_string(str) : (str << ('<' << k.to_s << ' val="' << Axlsx.booleanize(v).to_s << '"/>'))
+      end
+      str << '</font>'
+    end
+  end
+end

data/lib/axlsx/stylesheet/gradient_fill.rb

@@ -0,0 +1,103 @@
+# encoding: UTF-8
+module Axlsx
+  # A GradientFill defines the color and positioning for gradiant cell fill.
+  # @see Open Office XML Part 1 §18.8.24
+  class GradientFill
+
+    include Axlsx::OptionsParser
+    include Axlsx::SerializedAttributes
+
+    # Creates a new GradientFill object
+    # @option options [Symbol] type
+    # @option options [Float] degree
+    # @option options [Float] left
+    # @option options [Float] right
+    # @option options [Float] top
+    # @option options [Float] bottom
+    def initialize(options={})
+      options[:type] ||= :linear
+      parse_options options
+      @stop = SimpleTypedList.new GradientStop
+    end
+
+    serializable_attributes :type, :degree, :left, :right, :top, :bottom
+
+    # The type of gradient.
+    # @note
+    #  valid options are
+    #   :linear
+    #   :path
+    # @return [Symbol]
+    attr_reader :type
+
+    # Angle of the linear gradient
+    # @return [Float]
+    attr_reader :degree
+
+    # Percentage format left
+    # @return [Float]
+    attr_reader :left
+
+    # Percentage format right
+    # @return [Float]
+    attr_reader :right
+
+    # Percentage format top
+    # @return [Float]
+    attr_reader :top
+
+    # Percentage format bottom
+    # @return [Float]
+    attr_reader :bottom
+
+    # Collection of stop objects
+    # @return [SimpleTypedList]
+    attr_reader :stop
+
+    # @see type
+    def type=(v) Axlsx::validate_gradient_type v; @type = v end
+
+    # @see degree
+    def degree=(v) Axlsx::validate_float v; @degree = v end
+
+    # @see left
+    def left=(v)
+      validate_format_percentage "GradientFill.left", v
+      @left = v
+    end
+
+    # @see right
+    def right=(v)
+     validate_format_percentage "GradientFill.right", v
+     @right = v
+    end
+
+    # @see top
+    def top=(v)
+      validate_format_percentage "GradientFill.top", v
+      @top = v
+    end
+
+    # @see bottom
+    def bottom=(v)
+      validate_format_percentage "GradientFill.bottom", v
+      @bottom = v
+    end
+
+    # validates that the value provided is between 0.0 and 1.0
+    def validate_format_percentage(name, value)
+      DataTypeValidator.validate name, Float, value, lambda { |arg| arg >= 0.0 && arg <= 1.0}
+    end
+
+    # Serializes the object
+    # @param [String] str
+    # @return [String]
+    def to_xml_string(str = '')
+      str << '<gradientFill '
+      serialized_attributes str
+      str << '>'
+      @stop.each { |s| s.to_xml_string(str) }
+      str << '</gradientFill>'
+    end
+  end
+end