hexapdf-extras 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ea614bc7163af0c86933d2861f6c55fbab0e7a95cb799fd28167823db3f5b476
+  data.tar.gz: 2ae5cc1c597b8d6040c3a0f0803328692dad49cc011faf2e903e95758ee35260
+SHA512:
+  metadata.gz: e8dc9518929b83e6ca2248fce24d1d0123b328af01e92c5f8831c3cf1ecd47655b640529ca8027aa6705c317e6875a54d701dbbbc3be17a9f0478cf3dc7dc0d3
+  data.tar.gz: 9266e72303a8c0a13608e24f74c6e5e47528e3875a198e5cdd1d6ded55dd0131978247b8646645e34019e4764396f5a512f4eb3ffd96d1b0f130723c08293eaf

data/LICENSE

@@ -0,0 +1,21 @@
+hexapdf-extra - Additional functionality for HexaPDF
+Copyright (C) 2022 Thomas Leitner <t_leitner@gmx.at>
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,38 @@
+== HexaPDF Extras
+
+This library contains additional functionality that is not provided by the main
+{HexaPDF}[https://hexapdf.gettalong.org] library.
+
+To use it, just <tt>require 'hexapdf-extras'</tt> and it will update the HexaPDF configuration
+settings to make the various extensions available.
+
+Note that you need to install the dependencies of the features you use yourself as they are not
+listed in the gem file!
+
+=== QR code Generator
+
+This extension plugs into the graphic objects and boxes system of HexaPDF and allows one to easily
+create a fully-scalable QR code:
+
+  require 'hexapdf'
+  require 'hexapdf-extras'
+
+  doc = HexaPDF::Document.new
+  canvas = doc.pages.add.canvas
+  canvas.draw(:qrcode, at: [100, 100], size: 200, data: "https://hexapdf.gettalong.org")
+  doc.write('qrcode.pdf')
+
+Underneath the +rqrcode_core+ library is used for actually generating the QR code. This means you
+need to install that library for this extension to work.
+
+The +data+ argument can be any data that +rqrcode_core+ understands. The other options understood by
++rqrcode_core+ are also supported.
+
+See
+{HexaPDF::Extras::GraphicObject::QRCode}[https://hexapdf-extras.gettalong.org/api/HexaPDF/Extras/GraphicObject/QRCode.html]
+and
+{HexaPDF::Extras::Layout::QRCodeBox}[https://hexapdf-extras.gettalong.org/api/HexaPDF/Extras/Layout/QRCodeBox.html]
+for details.
+
+Note: There was a {bug in poppler}[https://gitlab.freedesktop.org/poppler/poppler/-/issues/1281]
+(already fixed) which leads to invalid rendering in Okular (as of 2022-08-06).

data/Rakefile

@@ -0,0 +1,40 @@
+require 'rake/clean'
+require 'rake/testtask'
+require 'rubygems/package_task'
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.test_files = FileList['test/**/*.rb']
+  t.verbose = false
+  t.warning = true
+end
+
+CLOBBER << 'webgen-out'
+CLOBBER << 'webgen-tmp'
+
+task default: 'test'
+
+spec = eval(File.read('hexapdf-extras.gemspec'), binding, 'hexapdf-extras.gemspec')
+Gem::PackageTask.new(spec) do |pkg|
+  pkg.need_zip = true
+  pkg.need_tar = true
+end
+
+desc "Upload the release to Rubygems"
+task publish_files: [:package] do
+  sh "gem push pkg/hexapdf-extras-#{HexaPDF::Extras::VERSION}.gem"
+  puts 'done'
+end
+
+task :test_all do
+  versions = `rbenv versions --bare | grep -i 2.[67]\\\\\\|3.`.split("\n")
+  versions.each do |version|
+    sh "eval \"$(rbenv init -)\"; rbenv shell #{version} && ruby -v && rake test"
+  end
+  puts "Looks okay? (enter to continue, Ctrl-c to abort)"
+  $stdin.gets
+end
+
+desc "Release HexaPDF Extras version #{HexaPDF::Extras::VERSION}"
+task release: [:clobber, :test_all, :package, :publish_files]
+

data/lib/hexapdf/extras/graphic_object/qr_code.rb

@@ -0,0 +1,206 @@
+# frozen_string_literal: true
+
+require 'rqrcode_core'
+
+module HexaPDF
+  module Extras
+    module GraphicObject
+
+      # Generates a QR code and renders it using simple PDF canvas graphics.
+      #
+      # It implements the {HexaPDF graphic object
+      # interface}[https://hexapdf.gettalong.org/documentation/reference/api/HexaPDF/Content/GraphicObject/index.html]
+      # and can therefore easily be used via the +:qrcode+ name:
+      #
+      #   #>pdf-canvas100
+      #   canvas.draw(:qrcode, data: 'hello', size: 100)
+      #
+      # This class relies on {rqrcode_core}[https://github.com/whomwah/rqrcode_core/] to generate
+      # the QR code from the given data. All options of rqrcode_core are supported, have a look at
+      # their documentation to see the allowed values.
+      class QRCode
+
+        # Creates and configures a new QRCode drawing support object.
+        #
+        # See #configure for the allowed keyword arguments.
+        def self.configure(**kwargs)
+          new.configure(**kwargs)
+        end
+
+        # The position of the bottom-left corner of the QR code.
+        #
+        # Default: [0, 0].
+        #
+        # Examples:
+        #
+        #   #>pdf-canvas100
+        #   canvas.draw(:qrcode, data: 'test', size: 30)
+        #   canvas.draw(:qrcode, data: 'test', size: 20, at: [50, 50])
+        attr_accessor :at
+
+        # The size of the whole rendered QR code.
+        #
+        # Default: none
+        #
+        # Examples:
+        #
+        #   #>pdf-canvas100
+        #   canvas.draw(:qrcode, data: 'test', size: 80, at: [10, 10])
+        attr_accessor :size
+
+        # The color for the dark QR code modules ('pixels')
+        #
+        # Default: 'black'.
+        #
+        # Examples:
+        #
+        #   #>pdf-canvas100
+        #   canvas.draw(:qrcode, data: 'test', size: 100, dark_color: 'green')
+        attr_accessor :dark_color
+
+        # The color for the light QR code modules ('pixels').
+        #
+        # Default: none (i.e. they are not drawn).
+        #
+        # Examples:
+        #
+        #   #>pdf-canvas100
+        #   canvas.draw(:qrcode, data: 'test', size: 100, light_color: 'yellow')
+        attr_accessor :light_color
+
+        # The data for which the QR code should be generated.
+        #
+        # This is directly passed to rqrcode_core as the +data+ argument.
+        #
+        # Default: none
+        attr_accessor :data
+
+        # The code size of the the QR code (normally called 'version').
+        #
+        # This is directly passed to rqrcode_core as the +size+ argument.
+        #
+        # Default: nil (i.e. let rqrcode_core decide)
+        #
+        # Examples:
+        #
+        #   #>pdf-canvas100
+        #   canvas.draw(:qrcode, data: 'test', size: 100, code_size: 10)
+        attr_accessor :code_size
+
+        # The maximum code size of the QR code.
+        #
+        # This is directly passed to rqrcode_core as the +max_size+ argument.
+        #
+        # Default: nil (i.e. let rqrcode_core decide)
+        #
+        # Examples:
+        #
+        #   #>pdf-canvas100
+        #   canvas.draw(:qrcode, data: 't'*100, size: 100, max_code_size: 10)
+        attr_accessor :max_code_size
+
+        # The error correction level of the QR code.
+        #
+        # This is directly passed to rqrcode_core as the +level+ argument.
+        #
+        # Default: nil (i.e. let rqrcode_core decide)
+        #
+        # Examples:
+        #
+        #   #>pdf-canvas100
+        #   canvas.draw(:qrcode, data: 'test', size: 100, level: :l)
+        attr_accessor :level
+
+        # The mode of the QR code, i.e. which data it holds.
+        #
+        # This is directly passed to rqrcode_core as the +mode+ argument.
+        #
+        # Default: nil (i.e. let rqrcode_core decide)
+        #
+        # Examples:
+        #
+        #   #>pdf-canvas100
+        #   canvas.draw(:qrcode, data: 'test', size: 100, mode: :kanji)
+        attr_accessor :mode
+
+        # Creates a QRCode object.
+        def initialize
+          @data = @size = @code_size = @max_code_size = @level = @mode = nil
+          @at = [0, 0]
+          @dark_color = 'black'
+          @light_color = nil
+        end
+
+        # Configures the QRCode object and returns self.
+        #
+        # The following arguments are allowed:
+        #
+        # :at:: The position of the bottom-left corner.
+        # :size:: The size of the whole rendered QR code.
+        # :dark_color:: The color used for the dark QR code modules ('pixels').
+        # :light_color:: The color used for the light QR code modules ('pixels').
+        # :data:: The data for the QR code.
+        # :code_size:: The code size of the QR code.
+        # :max_code_size:: The maximum code size of the QR code.
+        # :level:: The error correction level of the QR code
+        # :mode:: The mode of the of the QR code.
+        #
+        # Any arguments not specified are not modified and retain their old value, see the attribute
+        # methods for the inital default values.
+        def configure(at: nil, size: nil, dark_color: nil, light_color: nil,
+                      data: nil, code_size: nil, max_code_size: nil, level: nil, mode: nil)
+          @at = at if at
+          @size = size if size
+          @dark_color = dark_color if dark_color
+          @light_color = light_color if light_color
+          @data = data if data
+          @code_size = code_size if code_size
+          @max_code_size = max_code_size if max_code_size
+          @level = level if level
+          @mode = mode if mode
+          self
+        end
+
+        # Draws the QRCode object onto the given Canvas, with the bottom-left corner at the position
+        # specified by #at and the size specified by #size.
+        def draw(canvas)
+          qrcode = RQRCodeCore::QRCode.new(data, size: code_size, max_size: max_code_size,
+                                           level: level, mode: mode)
+
+          canvas.save_graphics_state do
+            canvas.translate(*at)
+            canvas.fill_color(light_color).rectangle(0, 0, size, size).fill if light_color
+
+            module_count = qrcode.modules.size
+            module_size = size.to_f / module_count
+            y_start = size - module_size / 2
+            canvas.line_cap_style(:butt)
+            canvas.line_width(module_size)
+            canvas.stroke_color(dark_color)
+
+            qrcode.modules.each_with_index do |row, row_index|
+              pattern = [0]
+              last_is_dark = row[0]
+              row.each do |col|
+                if col == last_is_dark
+                  pattern[-1] += module_size
+                else
+                  last_is_dark = !last_is_dark
+                  pattern << module_size
+                end
+              end
+              pattern.unshift(0) unless row[0]
+
+              canvas.line_dash_pattern(pattern)
+              canvas.line(0, y_start - module_size * row_index,
+                          size, y_start - module_size * row_index).
+                stroke
+            end
+          end
+        end
+
+      end
+
+    end
+  end
+end

data/lib/hexapdf/extras/graphic_object.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module HexaPDF
+  module Extras
+    module GraphicObject
+      autoload(:QRCode, 'hexapdf/extras/graphic_object/qr_code')
+    end
+  end
+end

data/lib/hexapdf/extras/layout/qr_code_box.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require 'hexapdf/layout/box'
+
+module HexaPDF
+  module Extras
+    module Layout
+
+      # A QRCodeBox object is used for displaying a QR code.
+      #
+      # The size of the QR code is determined by the width and height of the box (to be exact: by
+      # the smaller of the two values). The QR code is always placed at the top left corner of the
+      # box.
+      #
+      # Internally, HexaPDF::Extras::GraphicObject::QRCode is used, so any option except +at+ and
+      # +size+ supported there can be used here.
+      #
+      # Example:
+      #
+      #   #>pdf-composer100
+      #   composer.box(:qrcode, height: 50, data: 'Test', style: {position: :float})
+      #   composer.box(:qrcode, width: 20, data: 'Test', dark_color: 'red', style: {position: :float})
+      #   composer.box(:qrcode, width: 30, height: 50, data: 'Test', dark_color: 'green',
+      #                style: {position: :float})
+      #   composer.box(:qrcode, data: 'Test', dark_color: 'blue')
+      class QRCodeBox < HexaPDF::Layout::Box
+
+        # The HexaPDF::Extras::GraphicObject::QRCode object that will be drawn.
+        attr_reader :qr_code
+
+        # Creates a new QRCodeBox object with the given arguments (see
+        # HexaPDF::Extras::GraphicObject::QRCode for details).
+        #
+        # At least +data+ needs to be specified.
+        def initialize(dark_color: nil, light_color: nil, data: nil, code_size: nil,
+                       max_code_size: nil, level: nil, mode: nil, **kwargs)
+          super(**kwargs)
+          @qr_code = HexaPDF::Extras::GraphicObject::QRCode.configure(
+            dark_color: dark_color, light_color: light_color, data: data, code_size: code_size,
+            max_code_size: max_code_size, level: level, mode: mode
+          )
+        end
+
+        # Fits the QRCode into the given area.
+        def fit(available_width, available_height, _frame)
+          super
+          @width = @height = [@width, @height].min
+          @qr_code.size = [content_width, content_height].min
+          @fit_successful = (@width <= available_width && @height <= available_height)
+        end
+
+        private
+
+        # Draws the QR code onto the canvas at position [x, y].
+        def draw_content(canvas, x, y)
+          @qr_code.at = [x, y]
+          canvas.draw(@qr_code)
+        end
+
+      end
+
+    end
+  end
+end

data/lib/hexapdf/extras/layout.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module HexaPDF
+  module Extras
+    module Layout
+      autoload(:QRCodeBox, 'hexapdf/extras/layout/qr_code_box')
+    end
+  end
+end

data/lib/hexapdf/extras/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module HexaPDF
+  module Extras
+    VERSION = '1.0.0'
+  end
+end

data/lib/hexapdf/extras.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require 'hexapdf/configuration'
+
+module HexaPDF
+  module Extras
+    autoload(:GraphicObject, 'hexapdf/extras/graphic_object')
+    autoload(:Layout, 'hexapdf/extras/layout')
+  end
+end
+
+HexaPDF::DefaultDocumentConfiguration['graphic_object.map'][:qrcode] =
+  'HexaPDF::Extras::GraphicObject::QRCode'
+
+HexaPDF::DefaultDocumentConfiguration['layout.boxes.map'][:qrcode] =
+  'HexaPDF::Extras::Layout::QRCodeBox'

data/lib/hexapdf-extras.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require 'hexapdf/extras'

data/test/hexapdf/extras/graphic_object/test_qr_code.rb

@@ -0,0 +1,107 @@
+require 'test_helper'
+require 'hexapdf'
+require 'hexapdf/extras/graphic_object/qr_code'
+
+describe HexaPDF::Extras::GraphicObject::QRCode do
+  before do
+    @obj = HexaPDF::Extras::GraphicObject::QRCode.new
+  end
+
+  it "allows creation via the ::configure method" do
+    obj = HexaPDF::Extras::GraphicObject::QRCode.configure(data: 'test')
+    assert_equal('test', obj.data)
+  end
+
+  it "creates a default Geom2D drawing support object" do
+    [:size, :light_color, :data, :code_size, :max_code_size, :level, :mode].each do |method_name|
+      assert_nil(@obj.send(method_name))
+    end
+    assert_equal([0, 0], @obj.at)
+    assert_equal('black', @obj.dark_color)
+  end
+
+  it "allows configuration of the object" do
+    @obj.configure(data: 'test', size: 30)
+    assert_equal('test', @obj.data)
+    assert_equal(30, @obj.size)
+  end
+
+  describe "draw" do
+    before do
+      doc = HexaPDF::Document.new
+      @canvas = doc.pages.add.canvas
+    end
+
+    it "draws a QRCode onto the canvas" do
+      @obj.configure(data: 'test', size: 210)
+      @obj.draw(@canvas)
+      assert_operators(@canvas.contents,
+                       [[:save_graphics_state],
+                        [:concatenate_matrix, [1, 0, 0, 1, 0, 0]],
+                        [:set_line_width, [10]],
+                        [:set_device_rgb_stroking_color, [0, 0, 0]],
+                        [:set_line_dash_pattern, [[70, 10, 30, 10, 10, 10, 70], 0]],
+                        [:move_to, [0, 205]], [:line_to, [210, 205]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[10, 50, 10, 10, 20, 40, 10, 50, 10], 0]],
+                        [:move_to, [0, 195]], [:line_to, [210, 195]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[10, 10, 30, 10, 10, 30, 20, 20, 10, 10, 30, 10, 10], 0]],
+                        [:move_to, [0, 185]], [:line_to, [210, 185]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[10, 10, 30, 10, 10, 10, 10, 20, 20, 10, 10, 10, 30, 10, 10], 0]],
+                        [:move_to, [0, 175]], [:line_to, [210, 175]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[10, 10, 30, 10, 10, 10, 10, 20, 10, 20, 10, 10, 30, 10, 10], 0]],
+                        [:move_to, [0, 165]], [:line_to, [210, 165]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[10, 50, 10, 10, 20, 40, 10, 50, 10], 0]],
+                        [:move_to, [0, 155]], [:line_to, [210, 155]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[70, 10, 10, 10, 10, 10, 10, 10, 70], 0]],
+                        [:move_to, [0, 145]], [:line_to, [210, 145]], [:stroke_path],
+                        [:set_line_dash_pattern, [[0, 90, 20, 10, 10, 80], 0]],
+                        [:move_to, [0, 135]], [:line_to, [210, 135]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[0, 30, 10, 20, 10, 20, 10, 10, 10, 30, 30, 10, 20], 0]],
+                        [:move_to, [0, 125]], [:line_to, [210, 125]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[0, 30, 20, 20, 20, 30, 10, 10, 20, 30, 20], 0]],
+                        [:move_to, [0, 115]], [:line_to, [210, 115]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[10, 10, 20, 20, 30, 10, 10, 10, 10, 10, 50, 10, 10], 0]],
+                        [:move_to, [0, 105]], [:line_to, [210, 105]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[20, 10, 10, 50, 10, 20, 10, 10, 40, 10, 20], 0]],
+                        [:move_to, [0, 95]], [:line_to, [210, 95]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[20, 30, 20, 10, 30, 40, 10, 10, 10, 10, 20], 0]],
+                        [:move_to, [0, 85]], [:line_to, [210, 85]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[0, 80, 10, 20, 30, 20, 20, 10, 20], 0]],
+                        [:move_to, [0, 75]], [:line_to, [210, 75]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[70, 20, 30, 20, 10, 10, 10, 20, 10, 10], 0]],
+                        [:move_to, [0, 65]], [:line_to, [210, 65]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[10, 50, 10, 20, 20, 10, 10, 10, 10, 40, 10, 10], 0]],
+                        [:move_to, [0, 55]], [:line_to, [210, 55]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[10, 10, 30, 10, 10, 40, 10, 10, 20, 20, 10, 20, 10], 0]],
+                        [:move_to, [0, 45]], [:line_to, [210, 45]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[10, 10, 30, 10, 10, 10, 20, 10, 10, 30, 10, 10, 10, 10, 20], 0]],
+                        [:move_to, [0, 35]], [:line_to, [210, 35]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[10, 10, 30, 10, 10, 50, 20, 10, 10, 20, 10, 10, 10], 0]],
+                        [:move_to, [0, 25]], [:line_to, [210, 25]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[10, 50, 10, 20, 10, 10, 10, 20, 20, 10, 10, 30], 0]],
+                        [:move_to, [0, 15]], [:line_to, [210, 15]], [:stroke_path],
+                        [:set_line_dash_pattern,
+                         [[70, 30, 20, 10, 10, 10, 10, 10, 30, 10], 0]],
+                        [:move_to, [0, 5]], [:line_to, [210, 5]], [:stroke_path],
+                        [:restore_graphics_state]])
+    end
+  end
+end

data/test/hexapdf/extras/layout/test_qr_code_box.rb

@@ -0,0 +1,71 @@
+require 'test_helper'
+require 'hexapdf'
+require 'hexapdf/extras/layout/qr_code_box'
+
+describe HexaPDF::Extras::Layout::QRCodeBox do
+  def create_box(**kwargs)
+    HexaPDF::Extras::Layout::QRCodeBox.new(**kwargs)
+  end
+
+  describe "initialize" do
+    it "can take the common box arguments" do
+      box = create_box(width: 10, height: 15)
+      assert_equal(10, box.width)
+      assert_equal(15, box.height)
+    end
+
+    it "creates the QRCode graphic object" do
+      box = create_box(data: 'test', level: :l)
+      assert_equal(:l, box.qr_code.level)
+      assert_equal('test', box.qr_code.data)
+    end
+  end
+
+  describe "fit" do
+    it "uses the smaller value of width/height for the dimensions if smaller than available_width/height" do
+      [{width: 10}, {width: 10, height: 50}, {height: 10}, {width: 50, height: 10}].each do |args|
+        box = create_box(**args)
+        assert(box.fit(100, 100, nil))
+        assert_equal(10, box.width)
+        assert_equal(10, box.height)
+        assert_equal(10, box.qr_code.size)
+      end
+    end
+
+    it "uses the smaller value of available_width/height for the dimensions" do
+      box = create_box
+      assert(box.fit(10, 20, nil))
+      assert_equal(10, box.width)
+      assert_equal(10, box.height)
+      assert_equal(10, box.qr_code.size)
+
+      assert(box.fit(20, 15, nil))
+      assert_equal(15, box.width)
+      assert_equal(15, box.height)
+      assert_equal(15, box.qr_code.size)
+    end
+
+    it "takes the border and padding into account for the QR code size" do
+      box = create_box(style: {padding: [1, 2], border: {width: [3, 4]}})
+      assert(box.fit(100, 100, nil))
+      assert_equal(88, box.qr_code.size)
+
+      box = create_box(style: {padding: [2, 1], border: {width: [4, 3]}})
+      assert(box.fit(100, 100, nil))
+      assert_equal(88, box.qr_code.size)
+    end
+  end
+
+  describe "draw" do
+    it "draws the qrcode" do
+      box = create_box(width: 10)
+      box.fit(100, 100, nil)
+
+      canvas = Minitest::Mock.new
+      canvas.expect(:draw, nil, [box.qr_code])
+      box.draw(canvas, 5, 7)
+      assert_equal([5, 7], box.qr_code.at)
+      canvas.verify
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,17 @@
+# -*- encoding: utf-8 -*-
+
+begin
+  require 'simplecov'
+  SimpleCov.start do
+    minimum_coverage line: 100
+    add_filter '/test/'
+  end
+rescue LoadError
+  puts "No code coverage because simplecov is not installed"
+end
+
+gem 'minitest'
+require 'minitest/autorun'
+require 'hexapdf/test_utils'
+
+Minitest::Test.make_my_diffs_pretty!

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: hexapdf-extras
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Thomas Leitner
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2022-08-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: hexapdf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.24'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.24'
+- !ruby/object:Gem::Dependency
+  name: rqrcode_core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+description: 
+email: t_leitner@gmx.at
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.rdoc
+- Rakefile
+- lib/hexapdf-extras.rb
+- lib/hexapdf/extras.rb
+- lib/hexapdf/extras/graphic_object.rb
+- lib/hexapdf/extras/graphic_object/qr_code.rb
+- lib/hexapdf/extras/layout.rb
+- lib/hexapdf/extras/layout/qr_code_box.rb
+- lib/hexapdf/extras/version.rb
+- test/hexapdf/extras/graphic_object/test_qr_code.rb
+- test/hexapdf/extras/layout/test_qr_code_box.rb
+- test/test_helper.rb
+homepage: https://hexapdf-extras.gettalong.org
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.5'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.6
+signing_key: 
+specification_version: 4
+summary: Additional functionality for HexaPDF
+test_files: []