ooxml_parser 0.6.0 → 0.8.1

data/lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/chartsheet.rb

@@ -11,6 +11,9 @@ module OoxmlParser
       @parent = parent
     end
 
+    # Parse Chartsheet object
+    # @param file [String] file to parse
+    # @return [Chartsheet] result of parsing
     def parse(file)
       OOXMLDocumentObject.add_to_xmls_stack(OOXMLDocumentObject.root_subfolder + file)
       doc = parse_xml(OOXMLDocumentObject.current_xml)

data/lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/pivot_cache.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative 'pivot_cache/pivot_cache_definition'
+
+module OoxmlParser
+  # Class for parsing <pivotCache> tag
+  class PivotCache < OOXMLDocumentObject
+    # @return [Integer] cacheId of pivot cache
+    attr_reader :cache_id
+    # @return [String] id of pivot cache
+    attr_reader :id
+    # @return [PivotCacheDefinition] parsed pivot cache definition
+    attr_reader :pivot_cache_definition
+
+    # Parse Pivot Cache data
+    # @param [Nokogiri::XML:Element] node with Pivot Cache data
+    # @return [PivotCache] value of PivotCache
+    def parse(node)
+      node.attributes.each do |key, value|
+        case key
+        when 'cacheId'
+          @cache_id = value.value.to_i
+        when 'id'
+          @id = value.value.to_s
+        end
+      end
+      parse_pivot_cache_definition
+      self
+    end
+
+    private
+
+    # @return [PivotCacheDefinition] pivot cache definition for current pivot cache
+    def parse_pivot_cache_definition
+      definition_file = root_object.relationships.target_by_id(id)
+      full_file_path = "#{OOXMLDocumentObject.path_to_folder}/xl/#{definition_file}"
+      @pivot_cache_definition = PivotCacheDefinition.new(parent: root_object)
+                                                    .parse(full_file_path)
+    end
+  end
+end

data/lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/pivot_cache/pivot_cache_definition.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require_relative 'pivot_cache_definition/cache_source'
+module OoxmlParser
+  # Class for parsing <pivotCacheDefinition> file
+  class PivotCacheDefinition < OOXMLDocumentObject
+    # @return [String] id of pivot cache definition
+    attr_reader :id
+    # @return [CacheSource] source of pivot cache
+    attr_reader :cache_source
+
+    # Parse PivotCacheDefinition file
+    # @param file [String] path to file
+    # @return [PivotCacheDefinition]
+    def parse(file)
+      return nil unless File.exist?(file)
+
+      document = parse_xml(file)
+      node = document.xpath('*').first
+
+      node.attributes.each do |key, value|
+        case key
+        when 'id'
+          @id = value.value.to_s
+        end
+      end
+
+      node.xpath('*').each do |node_child|
+        case node_child.name
+        when 'cacheSource'
+          @cache_source = CacheSource.new(parent: self).parse(node_child)
+        end
+      end
+      self
+    end
+  end
+end

data/lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/pivot_cache/pivot_cache_definition/cache_source.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative 'cache_source/worksheet_source'
+
+module OoxmlParser
+  # Class for parsing <cacheSource> file
+  class CacheSource < OOXMLDocumentObject
+    # @return [String] type
+    attr_reader :type
+    # @return [WorksheetSource] source of worksheet data
+    attr_reader :worksheet_source
+
+    # Parse `<cacheSource>` tag
+    # # @param [Nokogiri::XML:Element] node with CacheSource data
+    # @return [CacheSource]
+    def parse(node)
+      node.attributes.each do |key, value|
+        case key
+        when 'type'
+          @type = value.value.to_s
+        end
+      end
+
+      node.xpath('*').each do |node_child|
+        case node_child.name
+        when 'worksheetSource'
+          @worksheet_source = WorksheetSource.new(parent: self).parse(node_child)
+        end
+      end
+      self
+    end
+  end
+end

data/lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/pivot_cache/pivot_cache_definition/cache_source/worksheet_source.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module OoxmlParser
+  # Class for parsing <worksheetSource> file
+  class WorksheetSource < OOXMLDocumentObject
+    # @return [String] ref of cells
+    attr_reader :ref
+    # @return [String] sheet name
+    attr_reader :sheet
+
+    # Parse `<worksheetSource>` tag
+    # # @param [Nokogiri::XML:Element] node with WorksheetSource data
+    # @return [WorksheetSource]
+    def parse(node)
+      node.attributes.each do |key, value|
+        case key
+        when 'ref'
+          @ref = value.value.to_s
+        when 'sheet'
+          @sheet = value.value.to_s
+        end
+      end
+      self
+    end
+  end
+end

data/lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/style_sheet.rb

@@ -26,6 +26,8 @@ module OoxmlParser
       @parent = parent
     end
 
+    # Parse StyleSheet object
+    # @return [StyleSheet] result of parsing
     def parse
       doc = parse_xml("#{OOXMLDocumentObject.path_to_folder}/#{OOXMLDocumentObject.root_subfolder}/styles.xml")
       doc.root.xpath('*').each do |node_child|

data/lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/style_sheet/cell_xfs/xf.rb

@@ -4,6 +4,7 @@ require_relative 'cell_style/alignment'
 module OoxmlParser
   # Class for parsing `xf` object
   class Xf < OOXMLDocumentObject
+    # [Array<String,nil>] list of predefined format values
     ALL_FORMAT_VALUE = ['General',
                         '0',
                         '0.00',
@@ -119,18 +120,22 @@ module OoxmlParser
       self
     end
 
+    # @return [Font] font of object
     def font
       root_object.style_sheet.fonts[@font_id]
     end
 
+    # @return [XlsxBorder] border of object
     def borders
       root_object.style_sheet.borders.borders_array[@border_id] if @apply_border
     end
 
+    # @return [Fill] fill color of object
     def fill_color
       root_object.style_sheet.fills[@fill_id] if @apply_fill
     end
 
+    # @return [String] numerical format of object
     def numerical_format
       return @numerical_format unless @apply_number_format
 

data/lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/style_sheet/fills/fill.rb

@@ -40,6 +40,8 @@ module OoxmlParser
       self
     end
 
+    # Convert Fill to color
+    # @return [OoxmlColor] result
     def to_color
       pattern_fill.foreground_color
     end

data/lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/style_sheet/fonts/font.rb

@@ -13,6 +13,9 @@ module OoxmlParser
       @parent = parent
     end
 
+    # Parse Font object
+    # @param node [Nokogiri::XML:Element] node to parse
+    # @return [Font] result of parsing
     def parse(node)
       @font_style = FontStyle.new
       node.xpath('*').each do |node_child|

data/lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/worksheet.rb

@@ -42,6 +42,8 @@ module OoxmlParser
       @parent = parent
     end
 
+    # Perform parsing of relationships
+    # @return [nil]
     def parse_relationships
       OOXMLDocumentObject.add_to_xmls_stack("#{OOXMLDocumentObject.root_subfolder}/worksheets/_rels/#{@xml_name}.rels")
       @relationships = Relationships.new(parent: self).parse_file(OOXMLDocumentObject.current_xml) if File.exist?(OOXMLDocumentObject.current_xml)
@@ -67,6 +69,9 @@ module OoxmlParser
       end
     end
 
+    # Parse data of Worksheet
+    # @param path_to_xml_file [String] path to file to parse
+    # @return [Worksheet] parsed worksheet
     def parse(path_to_xml_file)
       @xml_name = File.basename path_to_xml_file
       parse_relationships

data/lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/worksheet/excel_comments.rb

@@ -16,6 +16,7 @@ module OoxmlParser
       @parent = parent
     end
 
+    # @return [Array<ExcelComment>] list of comments
     def comments
       comment_list.comments
     end
@@ -23,6 +24,9 @@ module OoxmlParser
     extend Gem::Deprecate
     deprecate :comments, 'comment_list.comments', 2020, 1
 
+    # Parse file with ExcelComments
+    # @param file [String] file to parse
+    # @return [ExcelComments] object with data
     def parse(file)
       doc = parse_xml(file)
       node = doc.xpath('*').first

data/lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/worksheet/xlsx_column_properties.rb

@@ -38,6 +38,10 @@ module OoxmlParser
       self
     end
 
+    # Parse list of XlsxColumnProperties
+    # @param columns_width_node [Nokogiri::XML:Element] node to parse
+    # @param parent [OOXMLDocumentObject] parent of result objects
+    # @return [Array<XlsxColumnProperties>] list of XlsxColumnProperties
     def self.parse_list(columns_width_node, parent: nil)
       columns = []
       columns_width_node.xpath('xmlns:col').each do |col_node|

data/lib/ooxml_parser/xlsx_parser/xlsx_parser.rb

@@ -5,6 +5,9 @@ require_relative 'xlsx_data/view_model/workbook'
 module OoxmlParser
   # Basic class for parsing xlsx
   class XlsxParser
+    # Parse xlsx file
+    # @param path_to_file [String] file path
+    # @return [XLSXWorkbook] result of parse
     def self.parse_xlsx(path_to_file)
       Parser.parse_format(path_to_file) do
         XLSXWorkbook.new.parse

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ooxml_parser
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.8.1
 platform: ruby
 authors:
 - ONLYOFFICE
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-29 00:00:00.000000000 Z
+date: 2020-08-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -74,6 +74,62 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.88.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.88.0
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.7.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.7.1
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.5.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.5.1
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.42.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.42.0
 description: Parse OOXML files (docx, xlsx, pptx)
 email:
 - shockwavenn@gmail.com
@@ -164,6 +220,7 @@ files:
 - lib/ooxml_parser/common_parser/common_data/borders_properties.rb
 - lib/ooxml_parser/common_parser/common_data/color.rb
 - lib/ooxml_parser/common_parser/common_data/color/color_helper.rb
+- lib/ooxml_parser/common_parser/common_data/color/color_indexes.list
 - lib/ooxml_parser/common_parser/common_data/color/ooxml_color.rb
 - lib/ooxml_parser/common_parser/common_data/colors/color_alpha_channel.rb
 - lib/ooxml_parser/common_parser/common_data/colors/color_properties.rb
@@ -365,6 +422,10 @@ files:
 - lib/ooxml_parser/version.rb
 - lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook.rb
 - lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/chartsheet.rb
+- lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/pivot_cache.rb
+- lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/pivot_cache/pivot_cache_definition.rb
+- lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/pivot_cache/pivot_cache_definition/cache_source.rb
+- lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/pivot_cache/pivot_cache_definition/cache_source/worksheet_source.rb
 - lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/shared_string_table.rb
 - lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/shared_string_table/string_index.rb
 - lib/ooxml_parser/xlsx_parser/xlsx_data/view_model/workbook/style_sheet.rb
@@ -429,14 +490,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.3'
+      version: '2.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: OoxmlParser Gem