axlsx 1.1.6 → 1.2.0

data/examples/scraping_html.rb

@@ -0,0 +1,91 @@
+    require 'rubygems'
+    require 'nokogiri'
+    require 'open-uri'
+    require 'axlsx'
+
+    class Scraper
+
+       def initialize(url, selector)
+         @url = url
+         @selector = selector
+       end
+
+       def hooks
+         @hooks ||= {}
+       end
+
+       def add_hook(clue, p_roc)
+         hooks[clue] = p_roc
+       end
+
+       def export(file_name)
+         Scraper.clues.each do |clue|
+           if detail = parse_clue(clue)
+             output << [clue, detail.pop]
+             detail.each { |datum| output << ['', datum] }
+           end
+         end
+         serialize(file_name)
+       end
+
+       private
+
+       def self.clues
+         @clues ||= ['Operating system', 'Processors', 'Chipset', 'Memory type', 'Hard drive', 'Graphics',
+                     'Ports', 'Webcam', 'Pointing device', 'Keyboard', 'Network interface', 'Chipset', 'Wireless',
+                     'Power supply type', 'Energy efficiency', 'Weight', 'Minimum dimensions (W x D x H)',
+                     'Warranty', 'Software included', 'Product color']
+       end
+
+       def doc
+         @doc ||= begin 
+                    Nokogiri::HTML(open(@url))
+                  rescue
+                    raise ArgumentError, 'Invalid URL - Nothing to parse'
+                  end
+       end
+
+       def output
+         @output ||= []
+       end
+
+       def selector_for_clue(clue)
+         @selector % clue
+       end
+
+       def parse_clue(clue)
+         if element = doc.at(selector_for_clue(clue))
+           call_hook(clue, element) || element.inner_html.split('<br>').each(&:strip)
+         end
+       end
+
+       def call_hook(clue, element)
+         if hooks[clue].is_a? Proc
+            value = hooks[clue].call(element)
+            value.is_a?(Array) ? value : [value]
+         end
+       end
+
+       def package
+         @package ||= Axlsx::Package.new
+       end
+
+       def serialize(file_name)
+         package.workbook.add_worksheet do |sheet|
+           output.each { |datum| sheet.add_row datum }
+         end
+         package.serialize(file_name)
+       end
+    end
+
+    scraper = Scraper.new("http://h10010.www1.hp.com/wwpc/ie/en/ho/WF06b/321957-321957-3329742-89318-89318-5186820-5231694.html?dnr=1", "//td[text()='%s']/following-sibling::td")
+
+    # define a custom action to take against any elements found.
+    os_parse = Proc.new do |element|
+      element.inner_html.split('<br>').each(&:strip!).each(&:upcase!)
+    end
+
+    scraper.add_hook('Operating system', os_parse)
+
+    scraper.export('foo.xlsx')
+

data/examples/sheet_view.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby -w -s
+# -*- coding: utf-8 -*-
+$LOAD_PATH.unshift "#{File.dirname(__FILE__)}/../lib"
+require 'axlsx'
+
+p = Axlsx::Package.new
+ws = p.workbook.add_worksheet :name => "Sheetview - Split"
+ws.sheet_view do |vs|
+  vs.pane do |p|
+    p.active_pane = :top_right
+    p.state = :split
+    p.x_split = 11080
+    p.y_split = 5000
+    p.top_left_cell = 'C44'
+  end
+  
+  vs.add_selection(:top_left, { :active_cell => 'A2', :sqref => 'A2' })
+  vs.add_selection(:top_right, { :active_cell => 'I10', :sqref => 'I10' })
+  vs.add_selection(:bottom_left, { :active_cell => 'E55', :sqref => 'E55' })
+  vs.add_selection(:bottom_right, { :active_cell => 'I57', :sqref => 'I57' })
+end
+
+
+ws = p.workbook.add_worksheet :name => "Sheetview - Frozen"
+ws.sheet_view do |vs|
+  vs.pane do |p|
+    p.state = :frozen
+    p.x_split = 3
+    p.y_split = 4
+  end
+end
+
+
+p.serialize 'sheet_view.xlsx'

data/lib/axlsx/content_type/content_type.rb

@@ -1,5 +1,6 @@
 # encoding: UTF-8
 module Axlsx
+
   require 'axlsx/content_type/default.rb'
   require 'axlsx/content_type/override.rb'
 
@@ -21,4 +22,5 @@ module Axlsx
     end
 
   end
+
 end

data/lib/axlsx/content_type/default.rb

@@ -1,8 +1,23 @@
 # encoding: UTF-8
 module Axlsx
+
   # An default content part. These parts are automatically created by for you based on the content of your package.
   class Default
 
+    #Creates a new Default object
+    # @option options [String] extension
+    # @option options [String] content_type
+    # @raise [ArgumentError] An argument error is raised if both extension and content_type are not specified.
+    def initialize(options={})
+      raise ArgumentError, INVALID_ARGUMENTS unless validate_options(options)
+      options.each do |name, value|
+        self.send("#{name}=", value) if self.respond_to? "#{name}="
+      end
+    end
+
+    # Error string for option validation
+    INVALID_ARGUMENTS = "extension and content_type are required"
+
     # The extension of the content type.
     # @return [String]
     attr_reader :extension
@@ -13,18 +28,6 @@ module Axlsx
     attr_reader :content_type
     alias :ContentType :content_type
 
-    #Creates a new Default object
-    # @option options [String] extension
-    # @option options [String] content_type
-    # @raise [ArgumentError] An argument error is raised if both extension and content_type are not specified.
-    def initialize(options={})
-      raise ArgumentError, "extension and content_type are required" unless (options[:Extension] || options[:extension]) && (options[:content_type] || options[:ContentType])
-      options.each do |o|
-        self.send("#{o[0]}=", o[1]) if self.respond_to? "#{o[0]}="
-      end
-    end
-
-
     # Sets the file extension for this content type.
     def extension=(v) Axlsx::validate_string v; @extension = v end
     alias :Extension= :extension=
@@ -43,5 +46,11 @@ module Axlsx
       str << '/>'
     end
 
+    private
+    def validate_options(options)
+      (options[:Extension] || options[:extension]) && (options[:content_type] || options[:ContentType])
+    end
+
   end
+
 end

data/lib/axlsx/content_type/override.rb

@@ -1,8 +1,23 @@
 # encoding: UTF-8
 module Axlsx
+
   # An override content part. These parts are automatically created by for you based on the content of your package.
   class Override
 
+    #Creates a new Override object
+    # @option options [String] PartName
+    # @option options [String] ContentType
+    # @raise [ArgumentError] An argument error is raised if both PartName and ContentType are not specified.
+    def initialize(options={})
+      raise ArgumentError, INVALID_ARGUMENTS unless validate_options(options)
+      options.each do |name, value|
+        self.send("#{name}=", value) if self.respond_to? "#{name}="
+      end
+    end
+
+    # Error message for invalid options
+    INVALID_ARGUMENTS = 'part_name and content_type are required'
+
     # The type of content.
     # @return [String]
     attr_reader :content_type
@@ -13,17 +28,6 @@ module Axlsx
     attr_reader :part_name
     alias :PartName :part_name
 
-    #Creates a new Override object
-    # @option options [String] PartName
-    # @option options [String] ContentType
-    # @raise [ArgumentError] An argument error is raised if both PartName and ContentType are not specified.
-    def initialize(options={})
-      raise ArgumentError, "PartName and ContentType are required" unless (options[:PartName] || options[:part_name]) && (options[:ContentType] || options[:content_type])
-      options.each do |o|
-        self.send("#{o[0]}=", o[1]) if self.respond_to? "#{o[0]}="
-      end
-    end
-
     # The name and location of the part.
     def part_name=(v) Axlsx::validate_string v; @part_name = v end
     alias :PartName= :part_name=
@@ -42,5 +46,12 @@ module Axlsx
       str << '/>'
     end
 
+    private 
+
+    def validate_options(options)
+      (options[:PartName] || options[:part_name]) && (options[:ContentType] || options[:content_type])
+    end
+
   end
+
 end

data/lib/axlsx/doc_props/app.rb

@@ -1,5 +1,6 @@
 # encoding: UTF-8
 module Axlsx
+
   # App represents the app.xml document. The attributes for this object are primarily managed by the application the end user uses to edit the document. None of the attributes are required to serialize a valid xlsx object.
   # @see shared-documentPropertiesExtended.xsd
   # @note Support is not implemented for the following complex types:
@@ -10,6 +11,35 @@ module Axlsx
   #    DigSig (DigSigBlob)
   class App
 
+    # Creates an App object
+    # @option options [String] template
+    # @option options [String] manager
+    # @option options [Integer] pages
+    # @option options [Integer] words
+    # @option options [Integer] characters
+    # @option options [String] presentation_format
+    # @option options [Integer] lines
+    # @option options [Integer] paragraphs
+    # @option options [Integer] slides
+    # @option options [Integer] notes
+    # @option options [Integer] total_time
+    # @option options [Integer] hidden_slides
+    # @option options [Integer] m_m_clips
+    # @option options [Boolean] scale_crop
+    # @option options [Boolean] links_up_to_date
+    # @option options [Integer] characters_with_spaces
+    # @option options [Boolean] share_doc
+    # @option options [String] hyperlink_base
+    # @option options [String] hyperlinks_changed
+    # @option options [String] application
+    # @option options [String] app_version
+    # @option options [Integer] doc_security
+    def initialize(options={})
+      options.each do |name, value|
+        self.send("#{name}=", value) if self.respond_to? "#{name}="
+      end
+    end
+
     # @return [String] The name of the document template.
     attr_reader :template
     alias :Template :template
@@ -89,7 +119,7 @@ module Axlsx
     # @return [Boolean] Indicates that the hyper links in the document have been changed.
     attr_reader :hyperlinks_changed
     alias :HyperlinksChanged :hyperlinks_changed
-    
+
     # @return [String] The name of the application
     attr_reader :application
     alias :Applicatoin :application
@@ -102,44 +132,17 @@ module Axlsx
     attr_reader :doc_security
     alias :DocSecurity :doc_security
 
-    # Creates an App object
-    # @option options [String] template
-    # @option options [String] manager
-    # @option options [Integer] pages
-    # @option options [Integer] words
-    # @option options [Integer] characters
-    # @option options [String] presentation_format
-    # @option options [Integer] lines
-    # @option options [Integer] paragraphs
-    # @option options [Integer] slides
-    # @option options [Integer] notes
-    # @option options [Integer] total_time
-    # @option options [Integer] hidden_slides
-    # @option options [Integer] m_m_clips
-    # @option options [Boolean] scale_crop
-    # @option options [Boolean] links_up_to_date
-    # @option options [Integer] characters_with_spaces
-    # @option options [Boolean] share_doc
-    # @option options [String] hyperlink_base
-    # @option options [String] hyperlinks_changed
-    # @option options [String] application
-    # @option options [String] app_version
-    # @option options [Integer] doc_security
-    def initialize(options={})
-      options.each do |o|
-        self.send("#{o[0]}=", o[1]) if self.respond_to? "#{o[0]}="
-      end
-    end
-
     # Sets the template property of your app.xml file
     def template=(v) Axlsx::validate_string v; @template = v; end
+    alias :Template :template
 
     # Sets the manager property of your app.xml file
     def manager=(v) Axlsx::validate_string v; @manager = v; end
+    alias :Manager :manager
 
     # Sets the company property of your app.xml file
     def company=(v) Axlsx::validate_string v; @company = v; end
-
+    alias :Company :company
     # Sets the pages property of your app.xml file
     def pages=(v) Axlsx::validate_int v; @pages = v; end
 
@@ -214,7 +217,7 @@ module Axlsx
     # Sets the doc_security property of your app.xml file
     def doc_security=(v) Axlsx::validate_int v; @doc_security = v; end
     alias :DocSecurity= :doc_security=
-     
+
     # Serialize the app.xml document
     # @return [String]
     def to_xml_string(str = '')
@@ -225,4 +228,5 @@ module Axlsx
     end
 
   end
+
 end

data/lib/axlsx/doc_props/core.rb

@@ -1,19 +1,21 @@
 # encoding: UTF-8
 module Axlsx
+
   # The core object for the package.
   # @note Packages manage their own core object.
   # @see Package#core
   class Core
-    # The author of the document. By default this is 'axlsx'
-    # @return [String]
-    attr_accessor :creator
-
+ 
     # Creates a new Core object.
     # @option options [String] creator
     def initialize(options={})
       @creator = options[:creator] || 'axlsx'
     end
 
+    # The author of the document. By default this is 'axlsx'
+    # @return [String]
+    attr_accessor :creator
+
     # serializes the core.xml document
     # @return [String]
     def to_xml_string(str = '')
@@ -22,9 +24,11 @@ module Axlsx
       str << 'xmlns:dcmitype="' << CORE_NS_DCMIT << '" xmlns:dcterms="' << CORE_NS_DCT << '" '
       str << 'xmlns:xsi="' << CORE_NS_XSI << '">'
       str << '<dc:creator>' << self.creator << '</dc:creator>'
-      str << '<dcterms:created xsi:type="dcterms:W3CDTF">' << Time.now.strftime('%Y-%m-%dT%H:%M:%S') << '</dcterms:created>'
+      str << '<dcterms:created xsi:type="dcterms:W3CDTF">' << Time.now.strftime('%Y-%m-%dT%H:%M:%S') << 'Z</dcterms:created>'
       str << '<cp:revision>0</cp:revision>'
       str << '</cp:coreProperties>'
     end
+
   end
+
 end

data/lib/axlsx/drawing/ax_data_source.rb

@@ -1,14 +1,9 @@
 module Axlsx
+
   # An axis data source that can contain referenced or literal strings or numbers
   # @note only string data types are supported - mainly because we have not implemented a chart type that requires a numerical axis value
   class AxDataSource < NumDataSource
 
-    # allowed element tag names
-    # @return [Array]
-    def self.allowed_tag_names
-      [:xVal, :cat]
-    end
-
     # creates a new NumDataSource object
     # @option options [Array] data An array of Cells or Numeric objects
     # @option options [Symbol] tag_name see tag_name
@@ -19,6 +14,12 @@ module Axlsx
       super(options)
     end
 
+    # allowed element tag names for serialization
+    # @return [Array]
+    def self.allowed_tag_names
+      [:xVal, :cat]
+    end
+
   end
 
 end

data/lib/axlsx/drawing/axis.rb

@@ -1,8 +1,40 @@
 # encoding: UTF-8
 module Axlsx
- # the access class defines common properties and values for a chart axis.
+
+  # the access class defines common properties and values for a chart axis.
   class Axis
 
+    # Creates an Axis object
+    # @param [Integer] ax_id the id of this axis
+    # @param [Integer] cross_ax the id of the perpendicular axis
+    # @option options [Symbol] ax_pos
+    # @option options [Symbol] crosses
+    # @option options [Symbol] tick_lbl_pos
+    # @raise [ArgumentError] If axi_id or cross_ax are not unsigned integers
+    def initialize(ax_id, cross_ax, options={})
+      Axlsx::validate_unsigned_int(ax_id)
+      Axlsx::validate_unsigned_int(cross_ax)
+      @ax_id = ax_id
+      @cross_ax = cross_ax
+      @format_code = "General"
+      @delete = @label_rotation = 0
+      @scaling = Scaling.new(:orientation=>:minMax)
+      @title = @color = nil
+      self.ax_pos = :b
+      self.tick_lbl_pos = :nextTo
+      self.format_code = "General"
+      self.crosses = :autoZero
+      self.gridlines = true
+      options.each do |name, value|
+        self.send("#{name}=", value) if self.respond_to? "#{name}="
+      end
+    end
+
+    # the fill color to use in the axis shape properties. This should be a 6 character long hex string
+    # e.g. FF0000 for red
+    # @return [String]
+    attr_reader :color
+
     # the id of the axis.
     # @return [Integer]
     attr_reader :ax_id
@@ -52,29 +84,15 @@ module Axlsx
     # @return [Boolean]
     attr_reader :delete
 
-    # Creates an Axis object
-    # @param [Integer] ax_id the id of this axis
-    # @param [Integer] cross_ax the id of the perpendicular axis
-    # @option options [Symbol] ax_pos
-    # @option options [Symbol] crosses
-    # @option options [Symbol] tick_lbl_pos
-    # @raise [ArgumentError] If axi_id or cross_ax are not unsigned integers
-    def initialize(ax_id, cross_ax, options={})
-      Axlsx::validate_unsigned_int(ax_id)
-      Axlsx::validate_unsigned_int(cross_ax)
-      @ax_id = ax_id
-      @cross_ax = cross_ax
-      @format_code = "General"
-      @delete = @label_rotation = 0
-      @scaling = Scaling.new(:orientation=>:minMax)
-      self.ax_pos = :b
-      self.tick_lbl_pos = :nextTo
-      self.format_code = "General"
-      self.crosses = :autoZero
-      self.gridlines = true
-      options.each do |o|
-        self.send("#{o[0]}=", o[1]) if self.respond_to? "#{o[0]}="
-      end
+    # the title for the axis. This can be a cell or a fixed string.
+    attr_reader :title
+
+    # The color for this axis. This value is used when rendering the axis line in the chart. 
+    # colors should be in 6 character rbg format
+    # @return [String] the rbg color assinged.
+    # @see color
+    def color=(color_rgb)
+      @color = color_rgb
     end
 
     # The position of the axis
@@ -95,7 +113,6 @@ module Axlsx
     # default true
     def gridlines=(v) Axlsx::validate_boolean(v); @gridlines = v; end
 
-
     # Specify if axis should be removed from the chart
     # default false
     def delete=(v) Axlsx::validate_boolean(v); @delete = v; end
@@ -113,6 +130,18 @@ module Axlsx
       @label_rotation = adjusted
     end
 
+    # The title object for the chart.
+    # @param [String, Cell] v
+    # @return [Title]
+    def title=(v)
+      DataTypeValidator.validate "#{self.class}.title", [String, Cell], v
+      @title ||= Title.new
+      if v.is_a?(String)
+        @title.text = v
+      elsif v.is_a?(Cell)
+        @title.cell = v
+      end
+    end
 
     # Serializes the object
     # @param [String] str
@@ -123,6 +152,7 @@ module Axlsx
       str << '<c:delete val="'<< @delete.to_s << '"/>'
       str << '<c:axPos val="' << @ax_pos.to_s << '"/>'
       str << '<c:majorGridlines>'
+      # TODO shape properties need to be extracted into a class
       if gridlines == false
         str << '<c:spPr>'
         str << '<a:ln>'
@@ -131,10 +161,18 @@ module Axlsx
         str << '</c:spPr>'
       end
       str << '</c:majorGridlines>'
+      @title.to_xml_string(str) unless @title == nil
       str << '<c:numFmt formatCode="' << @format_code << '" sourceLinked="1"/>'
       str << '<c:majorTickMark val="none"/>'
       str << '<c:minorTickMark val="none"/>'
       str << '<c:tickLblPos val="' << @tick_lbl_pos.to_s << '"/>'
+      # TODO - this is also being used for series colors
+      # time to extract this into a class spPr - Shape Properties
+      if @color
+        str << '<c:spPr><a:ln><a:solidFill>'
+        str << '<a:srgbClr val="' << @color << '"/>'
+        str << '</a:solidFill></a:ln></c:spPr>'
+      end
       # some potential value in implementing this in full. Very detailed!
       str << '<c:txPr><a:bodyPr rot="' << @label_rotation.to_s << '"/><a:lstStyle/><a:p><a:pPr><a:defRPr/></a:pPr><a:endParaRPr/></a:p></c:txPr>'
       str << '<c:crossAx val="' << @cross_ax.to_s << '"/>'
@@ -142,4 +180,5 @@ module Axlsx
     end
 
   end
+
 end