axlsx 1.2.0 → 1.3.3

data/lib/axlsx/stylesheet/color.rb

@@ -2,6 +2,21 @@
 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
@@ -31,17 +46,7 @@ module Axlsx
     # @return [Float]
     attr_reader :tint
 
-    # Creates a new Color object
-    # @option options [Boolean] auto
-    # @option options [String] rgb
-    # @option options [Float] tint
-    def initialize(options={})
-      @rgb = "FF000000"
-      options.each do |o|
-        self.send("#{o[0]}=", o[1]) if self.respond_to? o[0]
-      end
-    end
-    # @see auto
+     # @see auto
     def auto=(v) Axlsx::validate_boolean v; @auto = v end
     # @see color
     def rgb=(v)
@@ -64,11 +69,9 @@ module Axlsx
     # Serializes the object
     # @param [String] str
     # @return [String]
-    def to_xml_string(str = '')
-      str << "<color "
-      self.instance_values.each do |key, value|
-        str << key.to_s << '="' << value.to_s << '" '
-      end
+    def to_xml_string(str = '', tag_name = 'color')
+      str << "<" << tag_name << " "
+      serialized_attributes str
       str << "/>"
     end
   end

data/lib/axlsx/stylesheet/dxf.rb

@@ -3,6 +3,9 @@ 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]
@@ -42,10 +45,7 @@ module Axlsx
     # @option options [CellAlignment] alignment
     # @option options [CellProtection] protection
     def initialize(options={})
-      options.each do |o|
-        next if o[1].nil?
-        self.send("#{o[0]}=", o[1]) if self.respond_to? "#{o[0]}="
-      end
+      parse_options options
     end
 
     # @see Dxf#alignment

data/lib/axlsx/stylesheet/font.rb

@@ -4,6 +4,27 @@ module Axlsx
   # @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
@@ -86,28 +107,7 @@ module Axlsx
     # @return [Integer]
     attr_reader :sz
 
-    # 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={})
-      options.each do |o|
-        next if o[1].nil?
-        self.send("#{o[0]}=", o[1]) if self.respond_to? "#{o[0]}="
-      end
-    end
-    # @see name
+     # @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

data/lib/axlsx/stylesheet/gradient_fill.rb

@@ -4,6 +4,24 @@ module Axlsx
   # @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
@@ -36,41 +54,47 @@ module Axlsx
     # @return [SimpleTypedList]
     attr_reader :stop
 
-    # 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
-      options.each do |o|
-        self.send("#{o[0]}=", o[1]) if self.respond_to? o[0]
-      end
-      @stop = SimpleTypedList.new GradientStop
-    end
-
     # @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) DataTypeValidator.validate "GradientFill.left", Float, v, lambda { |arg| arg >= 0.0 && arg <= 1.0}; @left = v end
+    def left=(v)
+      validate_format_percentage "GradientFill.left", v
+      @left = v
+    end
+
     # @see right
-    def right=(v) DataTypeValidator.validate "GradientFill.right", Float, v, lambda { |arg| arg >= 0.0 && arg <= 1.0}; @right = v end
+    def right=(v)
+     validate_format_percentage "GradientFill.right", v
+     @right = v
+    end
+
     # @see top
-    def top=(v) DataTypeValidator.validate "GradientFill.top", Float, v, lambda { |arg| arg >= 0.0 && arg <= 1.0}; @top = v end
+    def top=(v)
+      validate_format_percentage "GradientFill.top", v
+      @top = v
+    end
+
     # @see bottom
-    def bottom=(v) DataTypeValidator.validate "GradientFill.bottom", Float, v, lambda { |arg| arg >= 0.0 && arg <= 1.0}; @bottom= v end
+    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 '
-      h = self.instance_values.reject { |k,v| k.to_sym == :stop }
-      str << h.map { |key, value| '' << key.to_s << '="' << value.to_s << '"' }.join(' ')
+      serialized_attributes str
       str << '>'
       @stop.each { |s| s.to_xml_string(str) }
       str << '</gradientFill>'

data/lib/axlsx/stylesheet/num_fmt.rb

@@ -3,6 +3,26 @@ module Axlsx
   # A NumFmt object defines an identifier and formatting code for data in cells.
   # @note The recommended way to manage styles is Styles#add_style
   class NumFmt
+
+    include Axlsx::OptionsParser
+    include Axlsx::SerializedAttributes
+
+    # Creates a new NumFmt object
+    # @param [Hash] options Options for the number format object
+    # @option [Integer] numFmtId The predefined format id or new format id for this format
+    # @option [String] fomratCode The format code for this number format
+    def initialize(options={})
+      @numFmtId = 0
+      @formatCode = ""
+      parse_options options
+    end
+
+    serializable_attributes :formatCode, :numFmtId
+
+    # @return [String] The formatting to use for this number format.
+    # @see http://support.microsoft.com/kb/264372
+    attr_reader :formatCode
+
     # @return [Integer] An unsinged integer referencing a standard or custom number format.
     # @note
     #  These are the known formats I can dig up. The constant NUM_FMT_PERCENT is 9, and uses the default % formatting. Axlsx also defines a few formats for date and time that are commonly used in asia as NUM_FMT_YYYYMMDD and NUM_FRM_YYYYMMDDHHMMSS.
@@ -40,29 +60,18 @@ module Axlsx
     # @see Axlsx
     attr_reader :numFmtId
 
-    # @return [String] The formatting to use for this number format.
-    # @see http://support.microsoft.com/kb/264372
-    attr_reader :formatCode
-    def initialize(options={})
-      @numFmtId = 0
-      @formatCode = ""
-      options.each do |o|
-        self.send("#{o[0]}=", o[1]) if self.respond_to? o[0]
-      end
-    end
-
     # @see numFmtId
     def numFmtId=(v) Axlsx::validate_unsigned_int v; @numFmtId = v end
+
     # @see formatCode
     def formatCode=(v) Axlsx::validate_string v; @formatCode = v end
 
-
     # Serializes the object
     # @param [String] str
     # @return [String]
     def to_xml_string(str = '')
       str << '<numFmt '
-      str << instance_values.map { |key, value| '' << key.to_s << '="' << value.to_s << '"' }.join(' ')
+      serialized_attributes str
       str << '/>'
     end
 

data/lib/axlsx/stylesheet/pattern_fill.rb

@@ -5,6 +5,16 @@ module Axlsx
   # @see Style#add_style
   class PatternFill
 
+    include Axlsx::OptionsParser
+    # Creates a new PatternFill Object
+    # @option options [Symbol] patternType
+    # @option options [Color] fgColor
+    # @option options [Color] bgColor
+    def initialize(options={})
+      @patternType = :none
+      parse_options options
+    end
+
     # The color to use for the the background in solid fills.
     # @return [Color]
     attr_reader :fgColor
@@ -38,16 +48,6 @@ module Axlsx
     # @see Office Open XML Part 1 18.18.55
     attr_reader :patternType
 
-    # Creates a new PatternFill Object
-    # @option options [Symbol] patternType
-    # @option options [Color] fgColor
-    # @option options [Color] bgColor
-    def initialize(options={})
-      @patternType = :none
-      options.each do |o|
-        self.send("#{o[0]}=", o[1]) if self.respond_to? "#{o[0]}="
-      end
-    end
     # @see fgColor
     def fgColor=(v) DataTypeValidator.validate "PatternFill.fgColor", Color, v; @fgColor=v end
     # @see bgColor
@@ -61,22 +61,13 @@ module Axlsx
     def to_xml_string(str = '')
       str << '<patternFill patternType="' << patternType.to_s << '">'
       if fgColor.is_a?(Color)
-        str << "<fgColor "
-        fgColor.instance_values.each do |key, value|
-          str << key.to_s << '="' << value.to_s << '" '
-        end
-        str << "/>"
+        fgColor.to_xml_string str, "fgColor"
       end
 
       if bgColor.is_a?(Color)
-        str << "<bgColor "
-        bgColor.instance_values.each do |key, value|
-          str << key.to_s << '="' << value.to_s << '" '
-        end
-        str << "/>"
+        bgColor.to_xml_string str, "bgColor"
       end
       str << '</patternFill>'
     end
-
   end
 end

data/lib/axlsx/stylesheet/styles.rb

@@ -135,6 +135,7 @@ module Axlsx
     # @option options [Integer] num_fmt The number format to apply
     # @option options [String] format_code The formatting to apply. 
     # @option options [Integer|Hash] border The border style to use.
+    #   borders support style, color and edges options @see parse_border_options
     # @option options [String] bg_color The background color to apply to the cell
     # @option options [Boolean] hidden Indicates if the cell should be hidden
     # @option options [Boolean] locked Indicates if the cell should be locked
@@ -278,6 +279,10 @@ module Axlsx
     # @return [Font|Integer]
     def parse_font_options(options={})
       return if (options.keys & [:fg_color, :sz, :b, :i, :u, :strike, :outline, :shadow, :charset, :family, :font_name]).empty?
+      fonts.first.instance_values.each do |key, value|
+        # Thanks for that 1.8.7 - cant do a simple merge...
+        options[key.to_sym] = value unless options.keys.include?(key.to_sym)
+      end
       font = Font.new(options)
       font.color = Color.new(:rgb => options[:fg_color]) if options[:fg_color]
       font.name = options[:font_name] if options[:font_name]
@@ -298,7 +303,11 @@ module Axlsx
 
     # parses Style#add_style options for borders.
     # @note noop if :border is not specified in options
-    # @option options [Hash|Integer] A border style definition hash or the index of an existing border. Border style definition hashes must include :style and color: key-value entries and may include an :edges entry that references an array of symbols identifying which border edges you wish to apply the style or any other valid Border initializer options. If the :edges entity is not provided the style is applied to all edges of cells that reference this style.
+    # @option options [Hash|Integer] A border style definition hash or the index of an existing border. 
+    # Border style definition hashes must include :style and :color key-value entries and 
+    # may include an :edges entry that references an array of symbols identifying which border edges 
+    # you wish to apply the style or any other valid Border initializer options.
+    # If the :edges entity is not provided the style is applied to all edges of cells that reference this style.
     # @example
     #   #apply a thick red border to the top and bottom
     #   { :border => { :style => :thick, :color => "FFFF0000", :edges => [:top, :bottom] }
@@ -307,7 +316,7 @@ module Axlsx
       return unless options[:border]
       b_opts = options[:border]
       if b_opts.is_a?(Hash)
-        raise ArgumentError, (ERR_INVALID_BORDER_OPTIONS % b_opts) unless b_opts.values_at(:style, :color).size == 2
+        raise ArgumentError, (ERR_INVALID_BORDER_OPTIONS % b_opts) unless b_opts.keys.include?(:style) && b_opts.keys.include?(:color)
         border = Border.new b_opts
         (b_opts[:edges] || [:left, :right, :top, :bottom]).each do |edge|
           b_options = { :name => edge, :style => b_opts[:style], :color => Color.new(:rgb => b_opts[:color]) }

data/lib/axlsx/stylesheet/table_style.rb

@@ -4,6 +4,22 @@ module Axlsx
   # @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
@@ -16,19 +32,6 @@ module Axlsx
     # @return [Boolean]
     attr_reader :table
 
-    # 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
-      options.each do |o|
-        self.send("#{o[0]}=", o[1]) if self.respond_to? o[0]
-      end
-      super TableStyleElement
-    end
-
     # @see name
     def name=(v) Axlsx::validate_string v; @name=v end
     # @see pivot
@@ -40,10 +43,8 @@ module Axlsx
     # @param [String] str
     # @return [String]
     def to_xml_string(str = '')
-      attrs = instance_values.reject { |k, v| ![:name, :pivot, :table].include?(k) }
-      attrs[:count] = self.size
       str << '<tableStyle '
-      str << attrs.map { |key, value| '' << key.to_s << '="' << value.to_s << '"' }.join(' ')
+      serialized_attributes str, {:count => self.size}
       str << '>'
       each { |table_style_el| table_style_el.to_xml_string(str) }
       str << '</tableStyle>'

data/lib/axlsx/stylesheet/table_style_element.rb

@@ -3,6 +3,20 @@ 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
@@ -43,16 +57,6 @@ module Axlsx
     # @return [Integer]
     attr_reader :dxfId
 
-    # creates a new TableStyleElement object
-    # @option options [Symbol] type
-    # @option options [Integer] size
-    # @option options [Integer] dxfId
-    def initialize(options={})
-      options.each do |o|
-        self.send("#{o[0]}=", o[1]) if self.respond_to? o[0]
-      end
-    end
-
     # @see type
     def type=(v) Axlsx::validate_table_element_type v; @type = v end
 
@@ -67,7 +71,7 @@ module Axlsx
     # @return [String]
     def to_xml_string(str = '')
       str << '<tableStyleElement '
-      str << instance_values.map { |key, value| '' << key.to_s << '="' << value.to_s << '"' }.join(' ')
+      serialized_attributes str
       str << '/>'
     end
 

data/lib/axlsx/stylesheet/table_styles.rb

@@ -4,13 +4,7 @@ module Axlsx
   # @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
 
-    # 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
+    include Axlsx::SerializedAttributes
 
     # Creates a new TableStyles object that is a container for TableStyle objects
     # @option options [String] defaultTableStyle
@@ -20,7 +14,18 @@ module Axlsx
       @defaultPivotStyle = options[:defaultPivotStyle] || "PivotStyleLight16"
       super TableStyle
     end
-    # @see defaultTableStyle
+
+    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
@@ -29,10 +34,8 @@ module Axlsx
     # @param [String] str
     # @return [String]
     def to_xml_string(str = '')
-      attr = self.instance_values.reject {|k, v| ![:defaultTableStyle, :defaultPivotStyle].include?(k.to_sym) }
-      attr[:count] = self.size
       str << '<tableStyles '
-      str << attr.map { |key, value| '' << key.to_s << '="' << value.to_s << '"' }.join(' ')
+      serialized_attributes str, {:count => self.size }
       str << '>'
       each { |table_style| table_style.to_xml_string(str) }
       str << '</tableStyles>'

data/lib/axlsx/stylesheet/xf.rb

@@ -5,6 +5,32 @@ module Axlsx
   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
@@ -67,30 +93,7 @@ module Axlsx
     # @return [Boolean]
     attr_reader :applyProtection
 
-    # 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={})
-      options.each do |o|
-        next if o[1].nil?
-        self.send("#{o[0]}=", o[1]) if self.respond_to? "#{o[0]}="
-      end
-    end
-
-    # @see Xf#alignment
+      # @see Xf#alignment
     def alignment=(v) DataTypeValidator.validate "Xf.alignment", CellAlignment, v; @alignment = v end
 
     # @see protection
@@ -132,8 +135,7 @@ module Axlsx
     # @return [String]
     def to_xml_string(str = '')
       str << '<xf '
-      h = instance_values.reject { |k, v| [:alignment, :protection, :extList, :name].include? k.to_sym}
-      str << h.map { |key, value| '' << key.to_s << '="' << value.to_s << '"' }.join(' ')
+      serialized_attributes str
       str << '>'
       alignment.to_xml_string(str) if self.alignment
       protection.to_xml_string(str) if self.protection

data/lib/axlsx/util/accessors.rb

@@ -0,0 +1,49 @@
+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 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
+