caxlsx 2.0.2

data/lib/axlsx/stylesheet/table_style.rb

@@ -0,0 +1,54 @@
+# encoding: UTF-8
+module Axlsx
+  # A single table style definition and is a collection for tableStyleElements
+  # @note Table are not supported in this version and only the defaults required for a valid workbook are created.
+  class TableStyle < SimpleTypedList
+
+    include Axlsx::OptionsParser
+    include Axlsx::SerializedAttributes
+
+    # creates a new TableStyle object
+    # @raise [ArgumentError] if name option is not provided.
+    # @param [String] name
+    # @option options [Boolean] pivot
+    # @option options [Boolean] table
+    def initialize(name, options={})
+      self.name = name
+      parse_options options
+      super TableStyleElement
+    end
+
+    serializable_attributes :name, :pivot, :table
+
+    # The name of this table style
+    # @return [string]
+    attr_reader :name
+
+    # indicates if this style should be applied to pivot tables
+    # @return [Boolean]
+    attr_reader :pivot
+
+    # indicates if this style should be applied to tables
+    # @return [Boolean]
+    attr_reader :table
+
+    # @see name
+    def name=(v) Axlsx::validate_string v; @name=v end
+    # @see pivot
+    def pivot=(v) Axlsx::validate_boolean v; @pivot=v end
+    # @see table
+    def table=(v) Axlsx::validate_boolean v; @table=v end
+
+    # Serializes the object
+    # @param [String] str
+    # @return [String]
+    def to_xml_string(str = '')
+      str << '<tableStyle '
+      serialized_attributes str, {:count => self.size}
+      str << '>'
+      each { |table_style_el| table_style_el.to_xml_string(str) }
+      str << '</tableStyle>'
+    end
+
+  end
+end

data/lib/axlsx/stylesheet/table_style_element.rb

@@ -0,0 +1,79 @@
+# encoding: UTF-8
+module Axlsx
+  # an element of style that belongs to a table style.
+  # @note tables and table styles are not supported in this version. This class exists in preparation for that support.
+  class TableStyleElement
+
+    include Axlsx::OptionsParser
+    include Axlsx::SerializedAttributes
+
+    # creates a new TableStyleElement object
+    # @option options [Symbol] type
+    # @option options [Integer] size
+    # @option options [Integer] dxfId
+    def initialize(options={})
+      parse_options options
+    end
+
+    serializable_attributes :type, :size, :dxfId
+
+    # The type of style element. The following type are allowed
+    #   :wholeTable
+    #   :headerRow
+    #   :totalRow
+    #   :firstColumn
+    #   :lastColumn
+    #   :firstRowStripe
+    #   :secondRowStripe
+    #   :firstColumnStripe
+    #   :secondColumnStripe
+    #   :firstHeaderCell
+    #   :lastHeaderCell
+    #   :firstTotalCell
+    #   :lastTotalCell
+    #   :firstSubtotalColumn
+    #   :secondSubtotalColumn
+    #   :thirdSubtotalColumn
+    #   :firstSubtotalRow
+    #   :secondSubtotalRow
+    #   :thirdSubtotalRow
+    #   :blankRow
+    #   :firstColumnSubheading
+    #   :secondColumnSubheading
+    #   :thirdColumnSubheading
+    #   :firstRowSubheading
+    #   :secondRowSubheading
+    #   :thirdRowSubheading
+    #   :pageFieldLabels
+    #   :pageFieldValues
+    # @return [Symbol]
+    attr_reader :type
+
+    # Number of rows or columns used in striping when the type is firstRowStripe, secondRowStripe, firstColumnStripe, or secondColumnStripe.
+    # @return [Integer]
+    attr_reader :size
+
+    # The dxfId this style element points to
+    # @return [Integer]
+    attr_reader :dxfId
+
+    # @see type
+    def type=(v) Axlsx::validate_table_element_type v; @type = v end
+
+    # @see size
+    def size=(v) Axlsx::validate_unsigned_int v; @size = v end
+
+    # @see dxfId
+    def dxfId=(v) Axlsx::validate_unsigned_int v; @dxfId = v end
+
+    # Serializes the object
+    # @param [String] str
+    # @return [String]
+    def to_xml_string(str = '')
+      str << '<tableStyleElement '
+      serialized_attributes str
+      str << '/>'
+    end
+
+  end
+end

data/lib/axlsx/stylesheet/table_styles.rb

@@ -0,0 +1,46 @@
+# encoding: UTF-8
+module Axlsx
+  # TableStyles represents a collection of style definitions for table styles and pivot table styles.
+  # @note Support for custom table styles does not exist in this version. Many of the classes required are defined in preparation for future release. Please do not attempt to add custom table styles.
+  class TableStyles < SimpleTypedList
+
+    include Axlsx::SerializedAttributes
+
+    # Creates a new TableStyles object that is a container for TableStyle objects
+    # @option options [String] defaultTableStyle
+    # @option options [String] defaultPivotStyle
+    def initialize(options={})
+      @defaultTableStyle = options[:defaultTableStyle] || "TableStyleMedium9"
+      @defaultPivotStyle = options[:defaultPivotStyle] || "PivotStyleLight16"
+      super TableStyle
+    end
+
+    serializable_attributes :defaultTableStyle, :defaultPivotStyle
+
+    # The default table style. The default value is 'TableStyleMedium9'
+    # @return [String]
+    attr_reader :defaultTableStyle
+
+    # The default pivot table style. The default value is  'PivotStyleLight6'
+    # @return [String]
+    attr_reader :defaultPivotStyle
+
+   # @see defaultTableStyle
+    def defaultTableStyle=(v) Axlsx::validate_string(v); @defaultTableStyle = v; end
+    # @see defaultPivotStyle
+    def defaultPivotStyle=(v) Axlsx::validate_string(v); @defaultPivotStyle = v; end
+
+    # Serializes the object
+    # @param [String] str
+    # @return [String]
+    def to_xml_string(str = '')
+      str << '<tableStyles '
+      serialized_attributes str, {:count => self.size }
+      str << '>'
+      each { |table_style| table_style.to_xml_string(str) }
+      str << '</tableStyles>'
+    end
+
+  end
+
+end

data/lib/axlsx/stylesheet/xf.rb

@@ -0,0 +1,147 @@
+# encoding: UTF-8
+module Axlsx
+  # The Xf class defines a 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 Xf
+    #does not support extList (ExtensionList)
+
+    include Axlsx::SerializedAttributes
+    include Axlsx::OptionsParser
+    # Creates a new Xf object
+    # @option options [Integer] numFmtId
+    # @option options [Integer] fontId
+    # @option options [Integer] fillId
+    # @option options [Integer] borderId
+    # @option options [Integer] xfId
+    # @option options [Boolean] quotePrefix
+    # @option options [Boolean] pivotButton
+    # @option options [Boolean] applyNumberFormat
+    # @option options [Boolean] applyFont
+    # @option options [Boolean] applyFill
+    # @option options [Boolean] applyBorder
+    # @option options [Boolean] applyAlignment
+    # @option options [Boolean] applyProtection
+    # @option options [CellAlignment] alignment
+    # @option options [CellProtection] protection
+    def initialize(options={})
+      parse_options options
+    end
+
+    serializable_attributes :numFmtId, :fontId, :fillId, :borderId, :xfId, :quotePrefix,
+                            :pivotButton, :applyNumberFormat, :applyFont, :applyFill, :applyBorder, :applyAlignment,
+                            :applyProtection
+
+    # 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
+
+    # id of the numFmt to apply to this style
+    # @return [Integer]
+    attr_reader :numFmtId
+
+    # index (0 based) of the font to be used in this style
+    # @return [Integer]
+    attr_reader :fontId
+
+    # index (0 based) of the fill to be used in this style
+    # @return [Integer]
+    attr_reader :fillId
+
+    # index (0 based) of the border to be used in this style
+    # @return [Integer]
+    attr_reader :borderId
+
+    # index (0 based) of cellStylesXfs item to be used in this style. Only applies to cellXfs items
+    # @return [Integer]
+    attr_reader :xfId
+
+    # indecates if text should be prefixed by a single quote in the cell
+    # @return [Boolean]
+    attr_reader :quotePrefix
+
+    # indicates if the cell has a pivot table drop down button
+    # @return [Boolean]
+    attr_reader :pivotButton
+
+    # indicates if the numFmtId should be applied
+    # @return [Boolean]
+    attr_reader :applyNumberFormat
+
+    # indicates if the fontId should be applied
+    # @return [Boolean]
+    attr_reader :applyFont
+
+    # indicates if the fillId should be applied
+    # @return [Boolean]
+    attr_reader :applyFill
+
+    # indicates if the borderId should be applied
+    # @return [Boolean]
+    attr_reader :applyBorder
+
+    # Indicates if the alignment options should be applied
+    # @return [Boolean]
+    attr_reader :applyAlignment
+
+    # Indicates if the protection options should be applied
+    # @return [Boolean]
+    attr_reader :applyProtection
+
+      # @see Xf#alignment
+    def alignment=(v) DataTypeValidator.validate "Xf.alignment", CellAlignment, v; @alignment = v end
+
+    # @see protection
+    def protection=(v) DataTypeValidator.validate "Xf.protection", CellProtection, v; @protection = v end
+
+    # @see numFmtId
+    def numFmtId=(v) Axlsx::validate_unsigned_int v; @numFmtId = v end
+
+    # @see fontId
+    def fontId=(v) Axlsx::validate_unsigned_int v; @fontId = v end
+    # @see fillId
+    def fillId=(v) Axlsx::validate_unsigned_int v; @fillId = v end
+    # @see borderId
+    def borderId=(v) Axlsx::validate_unsigned_int v; @borderId = v end
+    # @see xfId
+    def xfId=(v) Axlsx::validate_unsigned_int v; @xfId = v end
+    # @see quotePrefix
+    def quotePrefix=(v) Axlsx::validate_boolean v; @quotePrefix = v end
+    # @see pivotButton
+    def pivotButton=(v) Axlsx::validate_boolean v; @pivotButton = v end
+    # @see applyNumberFormat
+    def applyNumberFormat=(v) Axlsx::validate_boolean v; @applyNumberFormat = v end
+    # @see applyFont
+    def applyFont=(v) Axlsx::validate_boolean v; @applyFont = v end
+    # @see applyFill
+    def applyFill=(v) Axlsx::validate_boolean v; @applyFill = v end
+
+    # @see applyBorder
+    def applyBorder=(v) Axlsx::validate_boolean v; @applyBorder = v end
+
+    # @see applyAlignment
+    def applyAlignment=(v) Axlsx::validate_boolean v; @applyAlignment = v end
+
+    # @see applyProtection
+    def applyProtection=(v) Axlsx::validate_boolean v; @applyProtection = v end
+
+    # Serializes the object
+    # @param [String] str
+    # @return [String]
+    def to_xml_string(str = '')
+      str << '<xf '
+      serialized_attributes str
+      str << '>'
+      alignment.to_xml_string(str) if self.alignment
+      protection.to_xml_string(str) if self.protection
+      str << '</xf>'
+    end
+
+
+  end
+end

data/lib/axlsx/util/accessors.rb

@@ -0,0 +1,64 @@
+module Axlsx
+  # This module defines some of the more common validating attribute
+  # accessors that we use in Axlsx
+  #
+  # When this module is included in your class you can simply call
+  #
+  # string_attr_access :foo
+  #
+  # To generate a new, validating set of accessors for foo.
+  module Accessors
+    def self.included(base)
+      base.send :extend, ClassMethods
+    end
+
+    # Defines the class level xxx_attr_accessor methods
+    module ClassMethods
+
+      # Creates one or more string validated attr_accessors
+      # @param [Array] symbols An array of symbols representing the
+      # names of the attributes you will add to your class.
+      def string_attr_accessor(*symbols)
+        validated_attr_accessor(symbols, 'validate_string')
+      end
+
+
+      # Creates one or more usigned integer attr_accessors
+      # @param [Array] symbols An array of symbols representing the
+      # names of the attributes you will add to your class
+      def unsigned_int_attr_accessor(*symbols)
+        validated_attr_accessor(symbols, 'validate_unsigned_int')
+      end
+
+      # Creates one or more float (double?) attr_accessors
+      # @param [Array] symbols An array of symbols representing the
+      # names of the attributes you will add to your class
+      def float_attr_accessor(*symbols)
+        validated_attr_accessor(symbols, 'validate_float')
+      end
+
+      # Creates on or more boolean validated attr_accessors
+      # @param [Array] symbols An array of symbols representing the
+      # names of the attributes you will add to your class.
+      def boolean_attr_accessor(*symbols)
+        validated_attr_accessor(symbols, 'validate_boolean')
+      end
+
+      # Template for defining validated write accessors
+      SETTER = "def %s=(value) Axlsx::%s(value); @%s = value; end"
+
+      # Creates the reader and writer access methods
+      # @param [Array] symbols The names of the attributes to create
+      # @param [String] validator The axlsx validation method to use when
+      # validating assignation.
+      # @see lib/axlsx/util/validators.rb 
+      def validated_attr_accessor(symbols, validator)
+        symbols.each do |symbol|
+          attr_reader symbol
+          module_eval(SETTER % [symbol.to_s, validator, symbol.to_s], __FILE__, __LINE__)
+        end
+      end
+    end
+  end
+end
+

data/lib/axlsx/util/constants.rb

@@ -0,0 +1,392 @@
+module Axlsx
+
+  # XML Encoding
+  ENCODING = "UTF-8"
+
+  # spreadsheetML namespace
+  XML_NS = "http://schemas.openxmlformats.org/spreadsheetml/2006/main"
+
+  # content-types namespace
+  XML_NS_T = "http://schemas.openxmlformats.org/package/2006/content-types"
+
+  # extended-properties namespace
+  APP_NS = "http://schemas.openxmlformats.org/officeDocument/2006/extended-properties"
+
+  # doc props namespace
+  APP_NS_VT = "http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes"
+
+  # core properties namespace
+  CORE_NS = "http://schemas.openxmlformats.org/package/2006/metadata/core-properties"
+
+  # dc elements (core) namespace
+  CORE_NS_DC = "http://purl.org/dc/elements/1.1/"
+
+  # dcmit (core) namespcace
+  CORE_NS_DCMIT = "http://purl.org/dc/dcmitype/"
+
+  # dc terms namespace
+  CORE_NS_DCT = "http://purl.org/dc/terms/"
+
+  # xml schema namespace
+  CORE_NS_XSI = "http://www.w3.org/2001/XMLSchema-instance"
+
+  # Digital signature namespace
+  DIGITAL_SIGNATURE_NS = "http://schemas.openxmlformats.org/package/2006/digital-signature"
+
+  # spreadsheet drawing namespace
+  XML_NS_XDR = "http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing"
+
+  # drawing namespace
+  XML_NS_A  = "http://schemas.openxmlformats.org/drawingml/2006/main"
+
+  # chart namespace
+  XML_NS_C  = "http://schemas.openxmlformats.org/drawingml/2006/chart"
+
+  # relationships namespace
+  XML_NS_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships"
+
+  # relationships name space
+  RELS_R = "http://schemas.openxmlformats.org/package/2006/relationships"
+
+  # table rels namespace
+  TABLE_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/table"
+
+  # pivot table rels namespace
+  PIVOT_TABLE_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotTable"
+
+  # pivot table cache definition namespace
+  PIVOT_TABLE_CACHE_DEFINITION_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotCacheDefinition"
+
+  # workbook rels namespace
+  WORKBOOK_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument"
+
+  # worksheet rels namespace
+  WORKSHEET_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet"
+
+  # app rels namespace
+  APP_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/extended-properties"
+
+  # core rels namespace
+  CORE_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/metadata/core-properties"
+
+  # digital signature rels namespace
+  DIGITAL_SIGNATURE_R = "http://schemas.openxmlformats.org/package/2006/relationships/digital- signature/signature"
+
+  # styles rels namespace
+  STYLES_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles"
+
+  # shared strings namespace
+  SHARED_STRINGS_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/sharedStrings"
+
+  # drawing rels namespace
+  DRAWING_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing"
+
+  # chart rels namespace
+  CHART_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart"
+
+  # image rels namespace
+  IMAGE_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image"
+
+  # hyperlink rels namespace
+  HYPERLINK_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink"
+
+  # comment rels namespace
+  COMMENT_R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments"
+
+  # comment relation for nil target
+  COMMENT_R_NULL = "http://purl.oclc.org/ooxml/officeDocument/relationships/comments"
+
+  #vml drawing relation namespace
+  VML_DRAWING_R = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/vmlDrawing'
+
+  # VML Drawing content type
+  VML_DRAWING_CT = "application/vnd.openxmlformats-officedocument.vmlDrawing"
+
+  # table content type
+  TABLE_CT = "application/vnd.openxmlformats-officedocument.spreadsheetml.table+xml"
+
+  # pivot table content type
+  PIVOT_TABLE_CT = "application/vnd.openxmlformats-officedocument.spreadsheetml.pivotTable+xml"
+
+  # pivot table cache definition content type
+  PIVOT_TABLE_CACHE_DEFINITION_CT = "application/vnd.openxmlformats-officedocument.spreadsheetml.pivotCacheDefinition+xml"
+
+  # workbook content type
+  WORKBOOK_CT = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml"
+
+  # app content type
+  APP_CT = "application/vnd.openxmlformats-officedocument.extended-properties+xml"
+
+  # rels content type
+  RELS_CT = "application/vnd.openxmlformats-package.relationships+xml"
+
+  # styles content type
+  STYLES_CT = "application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml"
+
+  # xml content type
+  XML_CT = "application/xml"
+
+  # worksheet content type
+  WORKSHEET_CT = "application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml"
+
+  # shared strings content type
+  SHARED_STRINGS_CT = "application/vnd.openxmlformats-officedocument.spreadsheetml.sharedStrings+xml"
+
+  # core content type
+  CORE_CT = "application/vnd.openxmlformats-package.core-properties+xml"
+
+  # digital signature xml content type
+  DIGITAL_SIGNATURE_XML_CT = "application/vnd.openxmlformats-package.digital-signature-xmlsignature+xml"
+
+  # digital signature origin content type
+  DIGITAL_SIGNATURE_ORIGIN_CT = "application/vnd.openxmlformats-package.digital-signature-origin"
+
+  # digital signature certificate content type
+  DIGITAL_SIGNATURE_CERTIFICATE_CT = "application/vnd.openxmlformats-package.digital-signature-certificate"
+
+  # chart content type
+  CHART_CT = "application/vnd.openxmlformats-officedocument.drawingml.chart+xml"
+
+  # comments content type
+  COMMENT_CT = "application/vnd.openxmlformats-officedocument.spreadsheetml.comments+xml"
+
+  # jpeg content type
+  JPEG_CT = "image/jpeg"
+
+  # gif content type
+  GIF_CT = "image/gif"
+
+  # png content type
+  PNG_CT = "image/png"
+
+  #drawing content type
+  DRAWING_CT = "application/vnd.openxmlformats-officedocument.drawing+xml"
+
+
+  # xml content type extensions
+  XML_EX = "xml"
+
+  # jpeg extension
+  JPEG_EX = "jpeg"
+
+  # gif extension
+  GIF_EX = "gif"
+
+  # png extension
+  PNG_EX = "png"
+
+  # rels content type extension
+  RELS_EX = "rels"
+
+  # workbook part
+  WORKBOOK_PN = "xl/workbook.xml"
+
+  # styles part
+  STYLES_PN = "styles.xml"
+
+  # shared_strings  part
+  SHARED_STRINGS_PN = "sharedStrings.xml"
+
+  # app part
+  APP_PN = "docProps/app.xml"
+
+  # core part
+  CORE_PN = "docProps/core.xml"
+
+  # content types part
+  CONTENT_TYPES_PN = "[Content_Types].xml"
+
+  # rels part
+  RELS_PN = "_rels/.rels"
+
+  # workbook rels part
+  WORKBOOK_RELS_PN = "xl/_rels/workbook.xml.rels"
+
+  # worksheet part
+  WORKSHEET_PN = "worksheets/sheet%d.xml"
+
+  # worksheet rels part
+  WORKSHEET_RELS_PN = "worksheets/_rels/sheet%d.xml.rels"
+
+  # drawing part
+  DRAWING_PN = "drawings/drawing%d.xml"
+
+  # drawing rels part
+  DRAWING_RELS_PN = "drawings/_rels/drawing%d.xml.rels"
+
+  # vml drawing part
+  VML_DRAWING_PN = "drawings/vmlDrawing%d.vml"
+
+  # drawing part
+  TABLE_PN = "tables/table%d.xml"
+
+  # pivot table parts
+  PIVOT_TABLE_PN = "pivotTables/pivotTable%d.xml"
+
+  # pivot table cache definition part name
+  PIVOT_TABLE_CACHE_DEFINITION_PN = "pivotCache/pivotCacheDefinition%d.xml"
+
+  # pivot table rels parts
+  PIVOT_TABLE_RELS_PN = "pivotTables/_rels/pivotTable%d.xml.rels"
+
+  # chart part
+  CHART_PN = "charts/chart%d.xml"
+
+  # chart part
+  IMAGE_PN = "media/image%d.%s"
+
+  # comment part
+  COMMENT_PN = "comments%d.xml"
+
+  # location of schema files for validation
+  SCHEMA_BASE = File.dirname(__FILE__)+'/../../schema/'
+
+  # App validation schema
+  APP_XSD = SCHEMA_BASE + "shared-documentPropertiesExtended.xsd"
+
+  # core validation schema
+  CORE_XSD = SCHEMA_BASE + "opc-coreProperties.xsd"
+
+  # content types validation schema
+  CONTENT_TYPES_XSD = SCHEMA_BASE + "opc-contentTypes.xsd"
+
+  # rels validation schema
+  RELS_XSD = SCHEMA_BASE + "opc-relationships.xsd"
+
+  # spreadsheetML validation schema
+  SML_XSD = SCHEMA_BASE + "sml.xsd"
+
+  # drawing validation schema
+  DRAWING_XSD = SCHEMA_BASE + "dml-spreadsheetDrawing.xsd"
+
+  # number format id for pecentage formatting using the default formatting id.
+  NUM_FMT_PERCENT = 9
+
+  # number format id for date format like 2011/11/13
+  NUM_FMT_YYYYMMDD = 100
+
+  # number format id for time format the creates 2011/11/13 12:23:10
+  NUM_FMT_YYYYMMDDHHMMSS = 101
+
+  # cellXfs id for thin borders around the cell
+  STYLE_THIN_BORDER = 1
+
+  # cellXfs id for default date styling
+  STYLE_DATE = 2
+
+  # error messages RestrictionValidor
+  ERR_RESTRICTION = "Invalid Data: %s. %s must be one of %s."
+
+  # error message DataTypeValidator
+  ERR_TYPE = "Invalid Data %s for %s. must be %s."
+
+  # error message for RegexValidator
+  ERR_REGEX = "Invalid Data. %s does not match %s."
+
+  # error message for RangeValidator
+  ERR_RANGE = "Invalid Data. %s must be between %s and %s, (inclusive:%s) you gave: %s"
+
+  # error message for sheets that use a name which is longer than 31 bytes
+  ERR_SHEET_NAME_TOO_LONG = "Your worksheet name '%s' is too long. Worksheet names must be 31 characters (bytes) or less"
+
+  # error message for sheets that use a name which include invalid characters
+  ERR_SHEET_NAME_CHARACTER_FORBIDDEN = "Your worksheet name '%s' contains a character which is not allowed by MS Excel and will cause repair warnings. Please change the name of your sheet."
+
+  # error message for duplicate sheet names
+  ERR_DUPLICATE_SHEET_NAME = "There is already a worksheet in this workbook named '%s'. Please use a unique name"
+
+  # error message when user does not provide color and or style options for border in Style#add_sytle
+  ERR_INVALID_BORDER_OPTIONS = "border hash must include both style and color. e.g. :border => { :color => 'FF000000', :style => :thin }. You provided: %s"
+
+  # error message for invalid border id reference
+  ERR_INVALID_BORDER_ID = "The border id you specified (%s) does not exist. Please add a border with Style#add_style before referencing its index."
+
+  # error message for invalid angles
+  ERR_ANGLE = "Angles must be a value between -90 and 90. You provided: %s"
+
+  # error message for non 'integerish' value
+  ERR_INTEGERISH = "You value must be, or be castable via to_i, an Integer. You provided %s"
+
+  # Regex to match forbidden control characters
+  # The following will be automatically stripped from worksheets.
+  #
+  # x00 Null
+  # x01 Start Of Heading
+  # x02 Start Of Text
+  # x03End Of Text
+  # x04 End Of Transmission
+  # x05 Enquiry
+  # x06 Acknowledge
+  # x07 Bell
+  # x08 Backspace
+  # x0B Line Tabulation
+  # x0C Form Feed
+  # x0E Shift Out
+  # x0F Shift In
+  # x10 Data Link Escape
+  # x11 Device Control One
+  # x12 Device Control Two
+  # x13 Device Control Three
+  # x14 Device Control Four
+  # x15 Negative Acknowledge
+  # x16 Synchronous Idle
+  # x17 End Of Transmission Block
+  # x18 Cancel
+  # x19 End Of Medium
+  # x1A Substitute
+  # x1B Escape
+  # x1C Information Separator Four
+  # x1D Information Separator Three
+  # x1E Information Separator Two
+  # x1F Information Separator One
+  #
+  # The following are not dealt with.
+  # If you have this in your data, expect excel to blow up!
+  #
+  # x7F	Delete
+  # x80	Control 0080
+  # x81	Control 0081
+  # x82	Break Permitted Here
+  # x83	No Break Here
+  # x84	Control 0084
+  # x85	Next Line (Nel)
+  # x86	Start Of Selected Area
+  # x87	End Of Selected Area
+  # x88	Character Tabulation Set
+  # x89	Character Tabulation With Justification
+  # x8A	Line Tabulation Set
+  # x8B	Partial Line Forward
+  # x8C	Partial Line Backward
+  # x8D	Reverse Line Feed
+  # x8E	Single Shift Two
+  # x8F	Single Shift Three
+  # x90	Device Control String
+  # x91	Private Use One
+  # x92	Private Use Two
+  # x93	Set Transmit State
+  # x94	Cancel Character
+  # x95	Message Waiting
+  # x96	Start Of Guarded Area
+  # x97	End Of Guarded Area
+  # x98	Start Of String
+  # x99	Control 0099
+  # x9A	Single Character Introducer
+  # x9B	Control Sequence Introducer
+  # x9C	String Terminator
+  # x9D	Operating System Command
+  # x9E	Privacy Message
+  # x9F	Application Program Command
+  #
+  # The following are allowed:
+  #
+  # x0A Line Feed (Lf)
+  # x0D Carriage Return (Cr)
+  # x09 Character Tabulation
+  # @see http://www.codetable.net/asciikeycodes
+  pattern = "[\x0-\x08\x0B\x0C\x0E-\x1F]"
+  pattern= pattern.respond_to?(:encode) ? pattern.encode('UTF-8') : pattern
+
+  # The regular expression used to remove control characters from worksheets
+  CONTROL_CHAR_REGEX = Regexp.new(pattern, 'n')
+
+end