ooxml_parser 0.3.0 → 0.6.0

data/lib/ooxml_parser/common_parser/common_data/alternate_content/drawing/graphic/shape/shape_properties/docx_shape_properties/text_box.rb

@@ -1,5 +1,7 @@
-# Class for working with TextBox (w:txbxContent)
+# frozen_string_literal: true
+
 module OoxmlParser
+  # Class for working with TextBox (w:txbxContent)
   class TextBox
     # Parse TextBox List
     # @param [Nokogiri::XML:Node] node with TextBox
@@ -7,16 +9,15 @@ module OoxmlParser
     def self.parse_list(node, parent: nil)
       elements = []
       text_box_content_node = node.xpath('w:txbxContent').first
-      unless text_box_content_node.nil?
-        text_box_content_node.xpath('*').each_with_index do |textbox_element, i|
-          case textbox_element.name
-          when 'p'
-            DocumentStructure.default_paragraph_style = DocxParagraph.new
-            DocumentStructure.default_paragraph_style.spacing = Spacing.new(0, 0.35, 1.15, :multiple)
-            elements << DocumentStructure.default_paragraph_style.dup.parse(textbox_element, i, parent: parent)
-          when 'tbl'
-            elements << Table.new(parent: parent).parse(textbox_element, i)
-          end
+
+      text_box_content_node&.xpath('*')&.each_with_index do |textbox_element, i|
+        case textbox_element.name
+        when 'p'
+          DocumentStructure.default_paragraph_style = DocxParagraph.new
+          DocumentStructure.default_paragraph_style.spacing = Spacing.new(0, 0.35, 1.15, :multiple)
+          elements << DocumentStructure.default_paragraph_style.dup.parse(textbox_element, i, parent: parent)
+        when 'tbl'
+          elements << Table.new(parent: parent).parse(textbox_element, i)
         end
       end
       elements

data/lib/ooxml_parser/common_parser/common_data/alternate_content/drawing/graphic/shape/shape_properties/docx_shape_size.rb

@@ -1,9 +1,15 @@
-# Docx Shape Size
+# frozen_string_literal: true
+
 module OoxmlParser
+  # Docx Shape Size
   class DocxShapeSize < OOXMLDocumentObject
-    attr_accessor :rotation, :flip_horizontal, :flip_vertical, :offset, :extent
+    attr_accessor :rotation, :offset, :extent
     attr_accessor :child_offset
     attr_accessor :child_extent
+    # @return [True, False] is image flipped horizontally
+    attr_reader :flip_horizontal
+    # @return [True, False] is image flipped vertically
+    attr_reader :flip_vertical
 
     alias extents extent
 
@@ -14,11 +20,11 @@ module OoxmlParser
       node.attributes.each do |key, value|
         case key
         when 'rot'
-          @rotation = value.value.to_f
+          @rotation = OoxmlSize.new(value.value.to_f, :one_60000th_degree)
         when 'flipH'
-          @flip_horizontal = value.value.to_f
+          @flip_horizontal = attribute_enabled?(value)
         when 'flipV'
-          @flip_vertical = value.value.to_f
+          @flip_vertical = attribute_enabled?(value)
         end
       end
       node.xpath('*').each do |node_child|

data/lib/ooxml_parser/common_parser/common_data/alternate_content/drawing/graphic/shape/shape_properties/line/line_end.rb

@@ -1,4 +1,7 @@
+# frozen_string_literal: true
+
 module OoxmlParser
+  # Class for working with LineEnd data
   class LineEnd < OOXMLDocumentObject
     attr_accessor :type, :length, :width
 

data/lib/ooxml_parser/common_parser/common_data/alternate_content/picture/group/old_docx_group.rb

@@ -1,7 +1,9 @@
+# frozen_string_literal: true
+
 require_relative 'old_docx_group_properties'
 require_relative 'old_docx_group_element'
-# Fallback DOCX group data
 module OoxmlParser
+  # Fallback DOCX group data
   class OldDocxGroup < OOXMLDocumentObject
     attr_accessor :elements, :properties
 

data/lib/ooxml_parser/common_parser/common_data/alternate_content/picture/group/old_docx_group_element.rb

@@ -1,5 +1,7 @@
-# Fallback DOCX Gropu Element data
+# frozen_string_literal: true
+
 module OoxmlParser
+  # Fallback DOCX group element data
   class OldDocxGroupElement
     attr_accessor :type, :object
 

data/lib/ooxml_parser/common_parser/common_data/alternate_content/picture/group/old_docx_group_properties.rb

@@ -1,5 +1,7 @@
-# Fallback DOCX group properties
+# frozen_string_literal: true
+
 module OoxmlParser
+  # Fallback DOCX group properties
   class OldDocxGroupProperties
     attr_accessor :wrap
   end

data/lib/ooxml_parser/common_parser/common_data/alternate_content/picture/old_docx_picture.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative 'shape/old_docx_shape'
 require_relative 'shape/old_docx_shape_fill'
 require_relative 'group/old_docx_group'

data/lib/ooxml_parser/common_parser/common_data/alternate_content/picture/shape/old_docx_shape.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative 'old_docx_shape_properties'
 module OoxmlParser
   # Fallback DOCX shape data

data/lib/ooxml_parser/common_parser/common_data/alternate_content/picture/shape/old_docx_shape_fill.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module OoxmlParser
   # Fallback DOCX shape fill properties
   class OldDocxShapeFill < OOXMLDocumentObject

data/lib/ooxml_parser/common_parser/common_data/alternate_content/picture/shape/old_docx_shape_properties.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module OoxmlParser
   # Fallback DOCX Shape Properties
   class OldDocxShapeProperties < OOXMLDocumentObject

data/lib/ooxml_parser/common_parser/common_data/borders_properties.rb

@@ -1,33 +1,45 @@
-# Border Properties Data
+# frozen_string_literal: true
+
 module OoxmlParser
+  # Border Properties Data
   class BordersProperties < OOXMLDocumentObject
-    attr_accessor :color, :space, :sz, :val, :shadow, :frame, :side
+    attr_accessor :color, :space, :val, :shadow, :frame, :side
+    # @return [OoxmlSize] size of border
+    attr_reader :size
 
-    def initialize(color = :auto, sz = 0, val = :none, space = 0, parent: nil)
+    def initialize(color = :auto, size = 0, val = :none, space = 0, parent: nil)
       @color = color
-      @sz = sz
+      @size = size
       @val = val
       @space = space
       @parent = parent
     end
 
-    alias size sz
+    # @return [OoxmlSize] alias for sz
+    def sz
+      size
+    end
+
+    extend Gem::Deprecate
+    deprecate :sz, 'size', 2020, 1
 
     def nil?
-      @sz.zero? && val == :none
+      size.zero? && val == :none
     end
 
     def to_s
       return '' if nil?
-      "borders color: #{@color}, size: #{@sz}, space: #{@space}, value: #{@val}"
+
+      "borders color: #{@color}, size: #{size}, space: #{@space}, value: #{@val}"
     end
 
     def copy
-      BordersProperties.new(@color, @sz, @val, @space)
+      BordersProperties.new(@color, size, @val, @space)
     end
 
     def visible?
       return false if nil?
+
       val != 'none'
     end
 
@@ -36,12 +48,13 @@ module OoxmlParser
     # @return [BordersProperties] value of BordersProperties
     def parse(node)
       return nil if node.attribute('val').value == 'nil'
+
       node.attributes.each do |key, value|
         case key
         when 'val'
           @val = value.value.to_sym
         when 'sz'
-          @sz = OoxmlSize.new(value.value.to_f, :one_eighth_point)
+          @size = OoxmlSize.new(value.value.to_f, :one_eighth_point)
         when 'space'
           @space = OoxmlSize.new(value.value.to_f, :point)
         when 'color'

data/lib/ooxml_parser/common_parser/common_data/color.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative 'color/color_helper'
 require_relative 'color/ooxml_color'
 require_relative 'colors/color_alpha_channel'
@@ -6,8 +8,8 @@ require_relative 'colors/scheme_color'
 require_relative 'colors/color_properties'
 require_relative 'colors/theme_colors'
 # @author Pavel.Lobashov
-# Class for Color in RGB
 module OoxmlParser
+  # Class for Color in RGB
   class Color < OOXMLDocumentObject
     include ColorHelper
     # @return [Array] Deprecated Indexed colors
@@ -91,12 +93,14 @@ module OoxmlParser
     attr_accessor :blue
     # @return [String] Value of Color Style
     attr_accessor :style
+
     alias set_style style=
     # @return [String] color scheme of color
     attr_accessor :scheme
 
     # @return [Integer] Value of alpha-channel
     attr_accessor :alpha_channel
+
     alias set_alpha_channel alpha_channel=
 
     attr_accessor :position
@@ -152,9 +156,7 @@ module OoxmlParser
 
     def ==(other)
       if other.is_a?(Color)
-        if nil?
-          false
-        elsif (@red == other.red) && (@green == other.green) && (@blue == other.blue)
+        if (@red == other.red) && (@green == other.green) && (@blue == other.blue)
           true
         elsif (none? && other.white?) || (white? && other.none?)
           true
@@ -181,6 +183,7 @@ module OoxmlParser
       return false if none? && color_to_check.any?
       return false if !none? && color_to_check.none?
       return true if self == color_to_check
+
       red = color_to_check.red
       green = color_to_check.green
       blue = color_to_check.blue
@@ -199,6 +202,83 @@ module OoxmlParser
       @blue = (@blue * shade.to_f).to_i
     end
 
+    def parse_scheme_color(scheme_color_node)
+      color = root_object.theme.color_scheme[scheme_color_node.attribute('val').value.to_sym].color
+      hls = HSLColor.rgb_to_hsl(color)
+      scheme_name = nil
+      scheme_color_node.xpath('*').each do |scheme_color_node_child|
+        case scheme_color_node_child.name
+        when 'lumMod'
+          hls.l = hls.l * (scheme_color_node_child.attribute('val').value.to_f / 100_000.0)
+        when 'lumOff'
+          hls.l = hls.l + (scheme_color_node_child.attribute('val').value.to_f / 100_000.0)
+        end
+      end
+      scheme_color_node.attributes.each do |key, value|
+        case key
+        when 'val'
+          scheme_name = value.to_s
+        end
+      end
+      color = hls.to_rgb
+      @red = color.red
+      @green = color.green
+      @blue = color.blue
+      @alpha_channel = ColorAlphaChannel.parse(scheme_color_node)
+      @scheme = scheme_name
+      self
+    end
+
+    def parse_color_model(color_model_parent_node)
+      color = nil
+      tint = nil
+      color_model_parent_node.xpath('*').each do |color_model_node|
+        color_model_node.xpath('*').each do |color_mode_node_child|
+          case color_mode_node_child.name
+          when 'tint'
+            tint = color_mode_node_child.attribute('val').value.to_f / 100_000.0
+          end
+        end
+        case color_model_node.name
+        when 'scrgbClr'
+          color = Color.new(color_model_node.attribute('r').value.to_i, color_model_node.attribute('g').value.to_i, color_model_node.attribute('b').value.to_i)
+          color.alpha_channel = ColorAlphaChannel.parse(color_model_node)
+        when 'srgbClr'
+          color = Color.new.parse_hex_string(color_model_node.attribute('val').value)
+          color.alpha_channel = ColorAlphaChannel.parse(color_model_node)
+        when 'schemeClr'
+          color = Color.new(parent: self).parse_scheme_color(color_model_node)
+        end
+      end
+      return nil unless color
+
+      color.calculate_with_tint!(1.0 - tint) if tint
+      @red = color.red
+      @green = color.green
+      @blue = color.blue
+      @alpha_channel = color.alpha_channel
+      @scheme = color.scheme
+      self
+    end
+
+    def parse_color(color_node)
+      case color_node.name
+      when 'srgbClr'
+        color = parse_hex_string(color_node.attribute('val').value)
+        color.properties = ColorProperties.new(parent: color).parse(color_node)
+        color
+      when 'schemeClr'
+        color = SchemeColor.new(parent: parent)
+        return ValuedChild.new(:string, parent: parent).parse(color_node) unless root_object.theme
+
+        color.value = root_object.theme.color_scheme[color_node.attribute('val').value.to_sym].color
+        color.properties = ColorProperties.new(parent: color).parse(color_node)
+        color.converted_color = Color.new(parent: self).parse_scheme_color(color_node)
+        color.value.calculate_with_tint!(1.0 - color.properties.tint) if color.properties.tint
+        color
+      end
+    end
+
     class << self
       def generate_random_color
         Color.new(rand(256), rand(256), rand(256))
@@ -216,12 +296,14 @@ module OoxmlParser
       def get_rgb_by_color_index(index)
         color_by_index = COLOR_INDEXED[index]
         return :unknown if color_by_index.nil?
+
         color_by_index == 'n/a' ? Color.new : Color.new.parse_hex_string(color_by_index)
       end
 
       def parse_string(str)
         return str if str.is_a?(Color)
         return Color.new(VALUE_FOR_NONE_COLOR, VALUE_FOR_NONE_COLOR, VALUE_FOR_NONE_COLOR) if str == 'none' || str == '' || str == 'transparent' || str.nil?
+
         split = if str.include?('RGB (') || str.include?('rgb(')
                   str.gsub(/[(RGBrgb\(\) )]/, '').split(',')
                 elsif str.include?('RGB ') || str.include?('rgb')
@@ -259,72 +341,6 @@ module OoxmlParser
           something
         end
       end
-
-      def parse_scheme_color(scheme_color_node)
-        color = ThemeColors.list[scheme_color_node.attribute('val').value.to_sym]
-        hls = HSLColor.rgb_to_hsl(color)
-        scheme_name = nil
-        scheme_color_node.xpath('*').each do |scheme_color_node_child|
-          case scheme_color_node_child.name
-          when 'lumMod'
-            hls.l = hls.l * (scheme_color_node_child.attribute('val').value.to_f / 100_000.0)
-          when 'lumOff'
-            hls.l = hls.l + (scheme_color_node_child.attribute('val').value.to_f / 100_000.0)
-          end
-        end
-        scheme_color_node.attributes.each do |key, value|
-          case key
-          when 'val'
-            scheme_name = value.to_s
-          end
-        end
-        color = hls.to_rgb
-        color.alpha_channel = ColorAlphaChannel.parse(scheme_color_node)
-        color.scheme = scheme_name
-        color
-      end
-
-      def parse_color_model(color_model_parent_node)
-        color = nil
-        tint = nil
-        color_model_parent_node.xpath('*').each do |color_model_node|
-          color_model_node.xpath('*').each do |color_mode_node_child|
-            case color_mode_node_child.name
-            when 'tint'
-              tint = color_mode_node_child.attribute('val').value.to_f / 100_000.0
-            end
-          end
-          case color_model_node.name
-          when 'scrgbClr'
-            color = Color.new(color_model_node.attribute('r').value.to_i, color_model_node.attribute('g').value.to_i, color_model_node.attribute('b').value.to_i)
-            color.alpha_channel = ColorAlphaChannel.parse(color_model_node)
-          when 'srgbClr'
-            color = Color.new.parse_hex_string(color_model_node.attribute('val').value)
-            color.alpha_channel = ColorAlphaChannel.parse(color_model_node)
-          when 'schemeClr'
-            color = parse_scheme_color(color_model_node)
-          end
-        end
-        return nil unless color
-        color.calculate_with_tint!(1.0 - tint) if tint
-        color
-      end
-
-      def parse_color(color_node)
-        case color_node.name
-        when 'srgbClr'
-          color = Color.new.parse_hex_string(color_node.attribute('val').value)
-          color.properties = ColorProperties.new(parent: color).parse(color_node)
-          color
-        when 'schemeClr'
-          color = SchemeColor.new
-          color.value = ThemeColors.list[color_node.attribute('val').value.to_sym]
-          color.properties = ColorProperties.new(parent: color).parse(color_node)
-          color.converted_color = parse_scheme_color(color_node)
-          color.value.calculate_with_tint!(1.0 - color.properties.tint) if color.properties.tint
-          color
-        end
-      end
     end
   end
 end

data/lib/ooxml_parser/common_parser/common_data/color/color_helper.rb

@@ -1,25 +1,29 @@
-# Helper methods for color
-module ColorHelper
-  # Parse string in hex
-  # @param [String] hex_string with or without alpha-channel
-  def parse_hex_string(hex_string)
-    return self if %w[auto null].include?(hex_string)
+# frozen_string_literal: true
 
-    char_array = hex_string.split(//)
-    if char_array.length == 3
-      @red = char_array[0].hex
-      @green = char_array[1].hex
-      @blue = char_array[2].hex
-    elsif char_array.length == 6
-      @red = (char_array[0] + char_array[1]).hex
-      @green = (char_array[2] + char_array[3]).hex
-      @blue = (char_array[4] + char_array[5]).hex
-    elsif char_array.length == 8
-      @alpha_channel = (char_array[0] + char_array[1]).hex
-      @red = (char_array[2] + char_array[3]).hex
-      @green = (char_array[4] + char_array[5]).hex
-      @blue = (char_array[6] + char_array[7]).hex
+module OoxmlParser
+  # Helper methods for color
+  module ColorHelper
+    # Parse string in hex
+    # @param [String] hex_string with or without alpha-channel
+    def parse_hex_string(hex_string)
+      return self if %w[auto null].include?(hex_string)
+
+      char_array = hex_string.split(//)
+      if char_array.length == 3
+        @red = char_array[0].hex
+        @green = char_array[1].hex
+        @blue = char_array[2].hex
+      elsif char_array.length == 6
+        @red = (char_array[0] + char_array[1]).hex
+        @green = (char_array[2] + char_array[3]).hex
+        @blue = (char_array[4] + char_array[5]).hex
+      elsif char_array.length == 8
+        @alpha_channel = (char_array[0] + char_array[1]).hex
+        @red = (char_array[2] + char_array[3]).hex
+        @green = (char_array[4] + char_array[5]).hex
+        @blue = (char_array[6] + char_array[7]).hex
+      end
+      self
     end
-    self
   end
 end