prawn-html 0.3.0 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c519c9608664ef77b5b4489752f49d29ae4dfda7ee42e43685ee5951524bd1e3
-  data.tar.gz: c768fa73bc5601bec246a963153a3d20f0d6712fa72dea6441a27495dc374cee
+  metadata.gz: 998ac3f3429812cc60dfe2bdf0184a86c116b1b80c7522376f99e044f185207c
+  data.tar.gz: 1a4ce4f9055fa8dd8ed121665102698b6077d69986974c366098d69759555d80
 SHA512:
-  metadata.gz: b62ed1e07608cdb62829fe50ae708c16d55b1510c49ff8e02eb47442dca105cfeb2b18e751dd5f84e421687ba970fecb3078db904d3fc867af93ecbe67361e07
-  data.tar.gz: 503c65d6d22d496c634634dca3c57eda3e864ce91448ad2c119e0cb89857e7731cdef7fd209a1f48d8bda82ad0dc8eff724e407a957bd4d8323f410385ebc906
+  metadata.gz: d443116a4be710f698f02da8092b19b0d83f9b319c0e7b431ae9cfe67d11c208ddea48ff5c995057bd3b28056dafcb2ff8461c1ad3be8134f9dcaa926b96ef73
+  data.tar.gz: 530a30ff700f75312a5f72b38ef433f9f03a3eab9ac9d83297a3eacc20d680df4ab1f8a4bc3c5134146b3da71be6ffa23d151bc71824dc21022fe7c5aa592758

data/README.md

@@ -62,6 +62,8 @@ HTML tags:
 CSS attributes (dimensional units are ignored and considered in pixel):
 
 - **background**: for *mark* tag (3/6 hex digits or RGB or color name), ex. `style="background: #FECD08"`
+- **break-after**: go to a new page after some elements, ex. `style="break-after: auto"`
+- **break-before**: go to a new page before some elements, ex. `style="break-before: auto"`
 - **color**: (3/6 hex digits or RGB or color name) ex. `style="color: #FB1"`
 - **font-family**: font must be registered, quotes are optional, ex. `style="font-family: Courier"`
 - **font-size**: ex. `style="font-size: 20px"`

data/lib/prawn-html.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require 'prawn'
-
 module PrawnHtml
   PX = 0.66 # conversion constant for pixel sixes
 
@@ -157,13 +155,17 @@ module PrawnHtml
   }.freeze
 
   def append_html(pdf, html)
-    html_parser = PrawnHtml::HtmlParser.new(pdf)
+    pdf_wrapper = PdfWrapper.new(pdf)
+    renderer = DocumentRenderer.new(pdf_wrapper)
+    html_parser = PrawnHtml::HtmlParser.new(renderer)
     html_parser.process(html)
   end
 
   module_function :append_html
 end
 
+require 'prawn'
+
 require 'prawn_html/utils'
 
 require 'prawn_html/tag'
@@ -172,5 +174,6 @@ Dir["#{__dir__}/prawn_html/callbacks/*.rb"].sort.each { |f| require f }
 
 require 'prawn_html/attributes'
 require 'prawn_html/context'
+require 'prawn_html/pdf_wrapper'
 require 'prawn_html/document_renderer'
 require 'prawn_html/html_parser'

data/lib/prawn_html/attributes.rb

@@ -8,8 +8,8 @@ module PrawnHtml
 
     STYLES_APPLY = {
       block: %i[align leading left margin_left padding_left position top],
-      tag_close: %i[margin_bottom padding_bottom],
-      tag_open: %i[margin_top padding_top],
+      tag_close: %i[margin_bottom padding_bottom break_after],
+      tag_open: %i[margin_top padding_top break_before],
       text_node: %i[background callback character_spacing color font link list_style_type size styles]
     }.freeze
 
@@ -27,9 +27,11 @@ module PrawnHtml
       'list-style-type' => { key: :list_style_type, set: :unquote },
       'text-decoration' => { key: :styles, set: :append_symbol },
       # tag opening styles
+      'break-before' => { key: :break_before, set: :convert_symbol },
       'margin-top' => { key: :margin_top, set: :convert_size },
       'padding-top' => { key: :padding_top, set: :convert_size },
       # tag closing styles
+      'break-after' => { key: :break_after, set: :convert_symbol },
       'margin-bottom' => { key: :margin_bottom, set: :convert_size },
       'padding-bottom' => { key: :padding_bottom, set: :convert_size },
       # block styles

data/lib/prawn_html/callbacks/highlight.rb

@@ -11,10 +11,8 @@ module PrawnHtml
       end
 
       def render_behind(fragment)
-        original_color = @pdf.fill_color
-        @pdf.fill_color = @color
-        @pdf.fill_rectangle(fragment.top_left, fragment.width, fragment.height)
-        @pdf.fill_color = original_color
+        top, left = fragment.top_left
+        @pdf.draw_rectangle(x: left, y: top, width: fragment.width, height: fragment.height, color: @color)
       end
     end
   end

data/lib/prawn_html/callbacks/strike_through.rb

@@ -8,10 +8,10 @@ module PrawnHtml
       end
 
       def render_in_front(fragment)
-        y = (fragment.top_left[1] + fragment.bottom_left[1]) / 2
-        @pdf.stroke do
-          @pdf.line [fragment.top_left[0], y], [fragment.top_right[0], y]
-        end
+        x1 = fragment.left
+        x2 = fragment.right
+        y = (fragment.top + fragment.bottom) / 2
+        @pdf.underline(x1: x1, x2: x2, y: y)
       end
     end
   end

data/lib/prawn_html/document_renderer.rb

@@ -7,7 +7,7 @@ module PrawnHtml
 
     # Init the DocumentRenderer
     #
-    # @param pdf [Prawn::Document] target Prawn PDF document
+    # @param pdf [PdfWrapper] target PDF wrapper
     def initialize(pdf)
       @buffer = []
       @context = Context.new
@@ -103,14 +103,15 @@ module PrawnHtml
     def apply_tag_close_styles(element)
       tag_styles = element.tag_close_styles
       context.last_margin = tag_styles[:margin_bottom].to_f
-      move_down = context.last_margin + tag_styles[:padding_bottom].to_f
-      pdf.move_down(move_down) if move_down > 0
+      pdf.advance_cursor(context.last_margin + tag_styles[:padding_bottom].to_f)
+      pdf.start_new_page if tag_styles[:break_after]
     end
 
     def apply_tag_open_styles(element)
       tag_styles = element.tag_open_styles
       move_down = (tag_styles[:margin_top].to_f - context.last_margin) + tag_styles[:padding_top].to_f
-      pdf.move_down(move_down) if move_down > 0
+      pdf.advance_cursor(move_down) if move_down > 0
+      pdf.start_new_page if tag_styles[:break_before]
     end
 
     def output_content(buffer, block_styles)
@@ -118,17 +119,7 @@ module PrawnHtml
       left_indent = block_styles[:margin_left].to_f + block_styles[:padding_left].to_f
       options = block_styles.slice(:align, :leading, :mode, :padding_left)
       options[:indent_paragraphs] = left_indent if left_indent > 0
-      formatted_text(buffer, options, bounding_box: bounds(block_styles))
-    end
-
-    def formatted_text(buffer, options, bounding_box: nil)
-      return pdf.formatted_text(buffer, options) unless bounding_box
-
-      current_y = pdf.cursor
-      pdf.bounding_box(*bounding_box) do
-        pdf.formatted_text(buffer, options)
-      end
-      pdf.move_cursor_to(current_y)
+      pdf.puts(buffer, options, bounding_box: bounds(block_styles))
     end
 
     def bounds(block_styles)

data/lib/prawn_html/html_parser.rb

@@ -6,13 +6,13 @@ module PrawnHtml
   class HtmlParser
     # Init the HtmlParser
     #
-    # @param pdf [Prawn::Document] Target Prawn PDF document
-    def initialize(pdf)
+    # @param renderer [DocumentRenderer] document renderer
+    def initialize(renderer)
       @processing = false
-      @renderer = DocumentRenderer.new(pdf)
+      @renderer = renderer
     end
 
-    # Processes HTML and renders it on the PDF document
+    # Processes HTML and renders it
     #
     # @param html [String] The HTML content to process
     def process(html)

data/lib/prawn_html/pdf_wrapper.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+require 'forwardable'
+
+module PrawnHtml
+  class PdfWrapper
+    extend Forwardable
+
+    def_delegators :@pdf, :bounds, :start_new_page
+
+    # Wrapper for Prawn PDF Document
+    #
+    # @param pdf_document [Prawn::Document] PDF document to wrap
+    def initialize(pdf_document)
+      @pdf = pdf_document
+    end
+
+    # Advance the cursor
+    #
+    # @param move_down [Float] Quantity to advance (move down)
+    def advance_cursor(move_down)
+      return if !move_down || move_down == 0
+
+      pdf.move_down(move_down)
+    end
+
+    # Draw a rectangle
+    #
+    # @param x [Float] left position of the rectangle
+    # @param y [Float] top position of the rectangle
+    # @param width [Float] width of the rectangle
+    # @param height [Float] height of the rectangle
+    # @param color [String] fill color
+    def draw_rectangle(x:, y:, width:, height:, color:)
+      current_fill_color = pdf.fill_color
+      pdf.fill_color = color
+      pdf.fill_rectangle([y, x], width, height)
+      pdf.fill_color = current_fill_color
+    end
+
+    # Horizontal line
+    #
+    # @param color [String] line color
+    # @param dash [Integer|Array] integer or array of integer with dash options
+    def horizontal_rule(color:, dash:)
+      current_color = pdf.stroke_color
+      pdf.dash(dash) if dash
+      pdf.stroke_color = color if color
+      pdf.stroke_horizontal_rule
+      pdf.stroke_color = current_color if color
+      pdf.undash if dash
+    end
+
+    # Image
+    #
+    # @param src [String] image source path
+    # @param options [Hash] hash of options
+    def image(src, options = {})
+      return unless src
+
+      pdf.image(src, options)
+    end
+
+    # Output to the PDF document
+    #
+    # @param buffer [Array] array of text items
+    # @param options [Hash] hash of options
+    # @param bounding_box [Array] bounding box arguments, if bounded
+    def puts(buffer, options, bounding_box: nil)
+      return pdf.formatted_text(buffer, options) unless bounding_box
+
+      current_y = pdf.cursor
+      pdf.bounding_box(*bounding_box) do
+        pdf.formatted_text(buffer, options)
+      end
+      pdf.move_cursor_to(current_y)
+    end
+
+    # Underline
+    #
+    # @param x1 [Float] left position of the line
+    # @param x2 [Float] right position of the line
+    # @param y [Float] vertical position of the line
+    def underline(x1:, x2:, y:)
+      pdf.stroke do
+        pdf.line [x1, y], [x2, y]
+      end
+    end
+
+    private
+
+    attr_reader :pdf
+  end
+end

data/lib/prawn_html/tags/br.rb

@@ -5,7 +5,7 @@ module PrawnHtml
     class Br < Tag
       ELEMENTS = [:br].freeze
 
-      BR_SPACING = 12
+      BR_SPACING = Utils.convert_size('12')
 
       def block?
         true
@@ -14,8 +14,7 @@ module PrawnHtml
       def custom_render(pdf, context)
         return if context.last_text_node
 
-        @spacing ||= Utils.convert_size(BR_SPACING.to_s)
-        pdf.move_down(@spacing)
+        pdf.advance_cursor(BR_SPACING)
       end
     end
   end

data/lib/prawn_html/tags/hr.rb

@@ -13,10 +13,8 @@ module PrawnHtml
       end
 
       def custom_render(pdf, _context)
-        dash = parse_dash_value(attrs.data['dash']) if attrs.data.include?('dash')
-        around_stroke(pdf, old_color: pdf.stroke_color, new_color: attrs.styles[:color], dash: dash) do
-          pdf.stroke_horizontal_rule
-        end
+        dash = attrs.data.include?('dash') ? parse_dash_value(attrs.data['dash']) : nil
+        pdf.horizontal_rule(color: attrs.styles[:color], dash: dash)
       end
 
       def tag_styles
@@ -28,14 +26,6 @@ module PrawnHtml
 
       private
 
-      def around_stroke(pdf, old_color:, new_color:, dash:)
-        pdf.dash(dash) if dash
-        pdf.stroke_color = new_color if new_color
-        yield
-        pdf.stroke_color = old_color if new_color
-        pdf.undash if dash
-      end
-
       def parse_dash_value(dash_string)
         if dash_string.match? /\A\d+\Z/
           dash_string.to_i

data/lib/prawn_html/tags/img.rb

@@ -13,7 +13,7 @@ module PrawnHtml
         parsed_styles = Attributes.parse_styles(attrs.style)
         block_styles = context.block_styles
         evaluated_styles = evaluate_styles(pdf, block_styles.merge(parsed_styles))
-        pdf.image(@attrs.src, evaluated_styles) if @attrs.src
+        pdf.image(@attrs.src, evaluated_styles)
       end
 
       private

data/lib/prawn_html/utils.rb

@@ -51,7 +51,7 @@ module PrawnHtml
         if container_size && value.include?('%')
           val.to_f * container_size * 0.01
         else
-          val.to_f * PX
+          val.to_f * PrawnHtml::PX
         end
       val.round(4)
     end

data/lib/prawn_html/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PrawnHtml # :nodoc:
-  VERSION = '0.3.0'
+  VERSION = '0.3.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: prawn-html
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.2
 platform: ruby
 authors:
 - Mattia Roccoberton
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-08-22 00:00:00.000000000 Z
+date: 2021-08-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: oga
@@ -53,6 +53,7 @@ files:
 - lib/prawn_html/context.rb
 - lib/prawn_html/document_renderer.rb
 - lib/prawn_html/html_parser.rb
+- lib/prawn_html/pdf_wrapper.rb
 - lib/prawn_html/tag.rb
 - lib/prawn_html/tags/a.rb
 - lib/prawn_html/tags/b.rb