hexapdf 0.30.0 → 0.32.0

data/lib/hexapdf/type/page.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -104,8 +104,16 @@ module HexaPDF
         Executive: [0, 0, 522, 756].freeze,
       }.freeze
 
-      # Returns the media box for the given paper size. See PAPER_SIZE for the defined paper sizes.
+      # Returns the media box for the given paper size or array.
+      #
+      # If an array is specified, it needs to contain exactly four numbers. The +orientation+
+      # argument is not used in this case.
+      #
+      # See PAPER_SIZE for the defined paper sizes.
       def self.media_box(paper_size, orientation: :portrait)
+        return paper_size if paper_size.kind_of?(Array) && paper_size.size == 4 &&
+          paper_size.all?(Numeric)
+
         unless PAPER_SIZE.key?(paper_size)
           raise HexaPDF::Error, "Invalid paper size specified: #{paper_size}"
         end
@@ -118,9 +126,6 @@ module HexaPDF
       # The inheritable fields.
       INHERITABLE_FIELDS = [:Resources, :MediaBox, :CropBox, :Rotate].freeze
 
-      # The required inheritable fields.
-      REQUIRED_INHERITABLE_FIELDS = [:Resources, :MediaBox].freeze
-
       define_type :Page
 
       define_field :Type,                 type: Symbol, required: true, default: type
@@ -571,6 +576,12 @@ module HexaPDF
           left, right = [llx, ulx, lrx, lrx + (ulx - llx)].minmax
           bottom, top = [lly, uly, lry, lry + (uly - lly)].minmax
 
+          # Handle degenerate case of the transformed bounding box being a line or point
+          if right - left == 0 || top - bottom == 0
+            to_delete << annotation
+            next
+          end
+
           # Step b) Fit calculated rectangle to annotation rectangle by translating/scaling
           a = HexaPDF::Content::TransformationMatrix.new
           a.translate(rect.left - left, rect.bottom - bottom)
@@ -609,10 +620,26 @@ module HexaPDF
         return unless parent_node
 
         super
-        REQUIRED_INHERITABLE_FIELDS.each do |name|
-          next if self[name]
-          yield("Inheritable page field #{name} not set", name == :Resources)
-          resources.validate(&block) if name == :Ressources
+
+        unless self[:Resources]
+          yield("Required inheritable page field Resources not set", true)
+          resources.validate(&block)
+        end
+
+        unless self[:MediaBox]
+          yield("Required inheritable page field MediaBox not set", true)
+          index = self.index
+          box_before = index == 0 ? nil : document.pages[index - 1][:MediaBox]
+          box_after = index == document.pages.count - 1 ? nil : document.pages[index + 1]&.[](:MediaBox)
+          self[:MediaBox] =
+            if box_before && (box_before&.value == box_after&.value || box_after.nil?)
+              box_before.dup
+            elsif box_after && box_before.nil?
+              box_after
+            else
+              self.class.media_box(document.config['page.default_media_box'],
+                                   orientation: document.config['page.default_media_orientation'])
+            end
         end
       end
 

data/lib/hexapdf/type/page_label.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/type/page_tree_node.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/type/resources.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/type/trailer.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/type/viewer_preferences.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/type/xref_stream.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -72,12 +72,10 @@ module HexaPDF
 
       define_field :Type,  type: Symbol, default: type, required: true, indirect: false,
                            version: '1.5'
-      # Size is not required because it will be auto-filled before the object is written
-      define_field :Size,  type: Integer, indirect: false
+      define_field :Size,  type: Integer, indirect: false, required: true
       define_field :Index, type: PDFArray, indirect: false
       define_field :Prev,  type: Integer, indirect: false
-      # W is not required because it will be auto-filled on #update_with_xref_section_and_trailer
-      define_field :W,     type: PDFArray, indirect: false
+      define_field :W,     type: PDFArray, indirect: false, required: true
 
       # Returns an XRefSection that represents the content of this cross-reference stream.
       #
@@ -219,6 +217,15 @@ module HexaPDF
         [[1, middle, 2], pack_string]
       end
 
+      def perform_validation #:nodoc
+        # Size is not required because it will be auto-filled before the object is written
+        # W is not required because it will be auto-filled on #update_with_xref_section_and_trailer
+        # Set both here to dummy values to make validation work for the required values
+        self[:Size] ||= 1
+        self[:W] ||= [1, 1, 1]
+        super
+      end
+
     end
 
   end

data/lib/hexapdf/type.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/utils/bit_field.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/utils/bit_stream.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/utils/graphics_helpers.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/utils/lru_cache.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/utils/math_helpers.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/utils/object_hash.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/utils/pdf_doc_encoding.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/utils/sorted_tree_node.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf/version.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -37,6 +37,6 @@
 module HexaPDF
 
   # The version of HexaPDF.
-  VERSION = '0.30.0'
+  VERSION = '0.32.0'
 
 end

data/lib/hexapdf/writer.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as
@@ -207,7 +207,7 @@ module HexaPDF
       end
 
       if (!object_streams.empty? || @use_xref_streams) && xref_stream.nil?
-        xref_stream = @document.wrap({Type: :XRef}, oid: @document.revisions.next_oid)
+        xref_stream = @document.wrap({}, type: Type::XRefStream, oid: @document.revisions.next_oid)
         rev.add(xref_stream)
       end
 

data/lib/hexapdf/xref_section.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/lib/hexapdf.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2022 Thomas Leitner
+# Copyright (C) 2014-2023 Thomas Leitner
 #
 # HexaPDF is free software: you can redistribute it and/or modify it
 # under the terms of the GNU Affero General Public License version 3 as

data/test/hexapdf/document/test_layout.rb

@@ -34,29 +34,24 @@ describe HexaPDF::Document::Layout::ChildrenCollector do
     assert_equal(2, @collector.children[0].size)
   end
 
-  it "allows appending boxes through method names of the Layout class" do
-    @collector.lorem_ipsum_box
-    assert_equal(1, @collector.children.size)
-    assert_kind_of(HexaPDF::Layout::TextBox, @collector.children[0])
-  end
-
-  it "allows appending boxes through method names without the _box suffix of the Layout class" do
+  it "allows appending boxes created by the Layout class" do
     @collector.lorem_ipsum
-    assert_equal(1, @collector.children.size)
+    @collector.lorem_ipsum_box
+    @collector.column
+    @collector.column_box
+    assert_equal(4, @collector.children.size)
     assert_kind_of(HexaPDF::Layout::TextBox, @collector.children[0])
+    assert_kind_of(HexaPDF::Layout::TextBox, @collector.children[1])
+    assert_kind_of(HexaPDF::Layout::ColumnBox, @collector.children[2])
+    assert_kind_of(HexaPDF::Layout::ColumnBox, @collector.children[3])
   end
 
-  it "allows appending boxes through their registered names" do
-    @collector.column
-    assert_equal(1, @collector.children.size)
-    assert_kind_of(HexaPDF::Layout::ColumnBox, @collector.children[0])
+  it "can be asked which methods it supports" do
+    assert(@collector.respond_to?(:lorem_ipsum))
   end
 
-  it "can be asked which methods it supports" do
-    assert(@collector.respond_to?(:text_box))
-    assert(@collector.respond_to?(:text))
-    assert(@collector.respond_to?(:column))
-    refute(@collector.respond_to?(:unknown))
+  it "only allows using box creation methods from the Layout class" do
+    assert_raises(NameError) { @collector.style }
   end
 
   it "raises an error on an unknown method name" do
@@ -88,6 +83,27 @@ describe HexaPDF::Document::Layout do
     end
   end
 
+  describe "inline_box" do
+    it "takes a box as argument" do
+      box = HexaPDF::Layout::Box.create(width: 10, height: 10)
+      ibox = @layout.inline_box(box)
+      assert_same(box, ibox.box)
+    end
+
+    it "correctly passes on the valign argument" do
+      box = HexaPDF::Layout::Box.create(width: 10, height: 10)
+      ibox = @layout.inline_box(box, valign: :top)
+      assert_equal(:top, ibox.valign)
+    end
+
+    it "can create a box using any box creation method of the Layout class" do
+      ibox = @layout.inline_box(:text, "Some text", valign: :bottom, width: 10, background_color: "red")
+      assert_equal(:bottom, ibox.valign)
+      assert_equal(10, ibox.width)
+      assert_equal("red", ibox.box.style.background_color)
+    end
+  end
+
   describe "box" do
     it "creates the request box" do
       box = @layout.box(:column, columns: 3, gaps: 20, width: 15, height: 30, style: {font_size: 10},
@@ -232,6 +248,24 @@ describe HexaPDF::Document::Layout do
       items = box.instance_variable_get(:@items)
       assert_equal({named_dest: 'test'}, items[0].properties)
     end
+
+    it "allows adding an inline box" do
+      ibox = @layout.inline_box(:base, width: 10, height: 10)
+      box = @layout.formatted_text_box([ibox])
+      assert_equal(ibox, box.instance_variable_get(:@items).first)
+    end
+
+    it "allows creating an inline box through a hash with a :box key" do
+      block = lambda {|item| item.box(:base, width: 5, height: 15) }
+      box = @layout.formatted_text_box([{box: :list, width: 10, block: block}])
+      ibox = box.instance_variable_get(:@items).first
+      assert_equal(10, ibox.width)
+      assert_equal(15, ibox.height)
+    end
+
+    it "fails if the data array contains unsupported items" do
+      assert_raises(ArgumentError) { @layout.formatted_text_box([5]) }
+    end
   end
 
   describe "image_box" do
@@ -277,4 +311,33 @@ describe HexaPDF::Document::Layout do
       assert_equal(HexaPDF::Document::Layout::LOREM_IPSUM[0, 2].join(" ").size * 2 + 2, items[0].items.length)
     end
   end
+
+  describe "method_missing" do
+    it "resolves to internal methods with the _box suffix, e.g. text_box" do
+      box = @layout.text("Test", width: 10, height: 15, properties: {key: :value})
+      assert_kind_of(HexaPDF::Layout::TextBox, box)
+      assert_equal(10, box.width)
+      assert_equal(15, box.height)
+      assert_equal({key: :value}, box.properties)
+    end
+
+    it "resolves to the box method when a configured name is used" do
+      box = @layout.column
+      assert_kind_of(HexaPDF::Layout::ColumnBox, box)
+      box = @layout.column_box
+      assert_kind_of(HexaPDF::Layout::ColumnBox, box)
+    end
+
+    it "fails if nothing could be resolved" do
+      assert_raises(NameError) { @layout.unknown }
+    end
+  end
+
+  describe "respond_to_missing?" do
+    it "can be asked which methods it supports" do
+      assert(@layout.respond_to?(:text))
+      assert(@layout.respond_to?(:column))
+      refute(@layout.respond_to?(:unknown))
+    end
+  end
 end

data/test/hexapdf/encryption/common.rb

@@ -84,4 +84,8 @@ module ARC4EncryptionTests
                  small.process('some') << small.process(' big') << small.process(' data chunk'))
   end
 
+  def test_works_with_empty_strings
+    assert_equal('', @algorithm_class.new('key').process(''))
+  end
+
 end

data/test/hexapdf/encryption/test_aes.rb

@@ -48,6 +48,10 @@ describe HexaPDF::Encryption::AES do
       end
     end
 
+    it "handles invalid files with empty strings" do
+      assert_equal('', @algorithm_class.decrypt('key', ''))
+    end
+
     it "handles invalid files with missing 16 byte padding" do
       assert_equal('', @algorithm_class.decrypt('some key' * 2, 'iv' * 8))
     end
@@ -118,6 +122,10 @@ describe HexaPDF::Encryption::AES do
       assert_equal('a' * 13 << "\x00\x01\x03", result)
     end
 
+    it "handles invalid files with empty streams" do
+      assert_equal('', collector(@algorithm_class.decryption_fiber('key', Fiber.new { '' })))
+    end
+
     it "fails on decryption if not enough bytes are provided" do
       [4, 20, 40].each do |length|
         assert_raises(HexaPDF::EncryptionError) do

data/test/hexapdf/encryption/test_security_handler.rb

@@ -325,6 +325,12 @@ describe HexaPDF::Encryption::SecurityHandler do
       assert_equal("test", @handler.decrypt(@obj)[:Contents])
     end
 
+    it "enhances a thrown EncryptionError by setting the PDF object" do
+      @handler.set_up_encryption(key_length: 256)
+      error = assert_raises(HexaPDF::EncryptionError) { @handler.decrypt(@obj) }
+      assert_match(/Object \(1,0\):/, error.message)
+    end
+
     it "fails if V < 5 and the object number changes" do
       @obj.oid = 55
       @handler.decrypt(@obj)

data/test/hexapdf/filter/test_flate_decode.rb

@@ -26,12 +26,26 @@ describe HexaPDF::Filter::FlateDecode do
       assert_equal(@decoded, collector(@obj.decoder(feeder(@encoded_predictor), @predictor_opts)))
     end
 
-    it "fails on invalid input" do
-      assert_raises(HexaPDF::FilterError) do
-        collector(@obj.decoder(feeder(@encoded[0..-2], @encoded.length - 3)))
+    describe "invalid input is handled as good as possible" do
+      def strict_mode
+        HexaPDF::GlobalConfiguration['filter.flate.on_error'] = proc { true }
+        yield
+      ensure
+        HexaPDF::GlobalConfiguration['filter.flate.on_error'] = proc { false }
       end
-      assert_raises(HexaPDF::FilterError) do
-        collector(@obj.decoder(feeder("some data")))
+
+      it "handles completely invalid data" do
+        assert_equal('', collector(@obj.decoder(feeder("some data"))))
+        assert_raises(HexaPDF::FilterError) do
+          strict_mode { collector(@obj.decoder(feeder("some data"))) }
+        end
+      end
+
+      it "handles missing data" do
+        assert_equal('abcdefg', collector(@obj.decoder(feeder(@encoded[0..-2]))))
+        assert_raises(HexaPDF::FilterError) do
+          strict_mode { collector(@obj.decoder(feeder(@encoded[0..-2]))) }
+        end
       end
     end
   end

data/test/hexapdf/layout/test_inline_box.rb

@@ -2,31 +2,51 @@
 
 require 'test_helper'
 require 'hexapdf/layout/inline_box'
+require 'hexapdf/document'
 
 describe HexaPDF::Layout::InlineBox do
+  def inline_box(box, valign: :baseline)
+    HexaPDF::Layout::InlineBox.new(box, valign: valign)
+  end
+
   before do
     @box = HexaPDF::Layout::InlineBox.create(width: 10, height: 15, margin: [15, 10])
   end
 
-  it "needs a box to wrap and an optional alignment on initialization" do
-    ibox = HexaPDF::Layout::InlineBox.new(@box)
-    assert_equal(@box, ibox.box)
-    assert_equal(:baseline, ibox.valign)
+  describe "initialize" do
+    it "needs a box to wrap and an optional alignment on initialization" do
+      box = HexaPDF::Layout::Box.create(width: 10, height: 15)
+      ibox = inline_box(box)
+      assert_equal(box, ibox.box)
+      assert_equal(:baseline, ibox.valign)
 
-    ibox = HexaPDF::Layout::InlineBox.new(@box, valign: :top)
-    assert_equal(:top, ibox.valign)
-  end
+      ibox = inline_box(box, valign: :top)
+      assert_equal(:top, ibox.valign)
+    end
 
-  it "draws the wrapped box at the correct position" do
-    canvas = Object.new
-    block = lambda do |c, x, y|
-      assert_equal(canvas, c)
-      assert_equal(10, x)
-      assert_equal(15, y)
+    it "automatically fits the provided box into a frame" do
+      ibox = inline_box(HexaPDF::Document.new.layout.text("test is going good", width: 20))
+      assert_equal(20, ibox.width)
+      assert_equal(45, ibox.height)
     end
-    @box.box.stub(:draw, block) do
-      @box.draw(canvas, 0, 0)
+
+    it "fails if the wrapped box could not be fit" do
+      box = HexaPDF::Document.new.layout.text("test is not going good", width: 1)
+      assert_raises(HexaPDF::Error) { inline_box(box) }
     end
+
+    it "fails if the height is not set explicitly and during fitting" do
+      assert_raises(HexaPDF::Error) do
+        inline_box(HexaPDF::Layout::Box.create(width: 10))
+      end
+    end
+  end
+
+  it "draws the wrapped box at the correct position" do
+    doc = HexaPDF::Document.new
+    canvas = doc.pages.add.canvas
+    inline_box(doc.layout.text("", width: 20, margin: [15, 10])).draw(canvas, 100, 200)
+    assert_equal("q\n1 0 0 1 110 -99785 cm\nQ\n", canvas.contents)
   end
 
   it "returns true if the inline box is empty with no drawing operations" do

data/test/hexapdf/layout/test_page_style.rb

@@ -0,0 +1,70 @@
+# -*- encoding: utf-8 -*-
+
+require 'test_helper'
+require 'hexapdf/layout/page_style'
+require 'hexapdf/document'
+
+describe HexaPDF::Layout::PageStyle do
+  it "allows assigning the page size, orientation and template on initialization" do
+    block = lambda {}
+    style = HexaPDF::Layout::PageStyle.new(page_size: :A3, orientation: :landscape, &block)
+    assert_equal(:A3, style.page_size)
+    assert_equal(:landscape, style.orientation)
+    assert_same(block, style.template)
+  end
+
+  it "uses defaults for all values" do
+    style = HexaPDF::Layout::PageStyle.new
+    assert_equal(:A4, style.page_size)
+    assert_equal(:portrait, style.orientation)
+    assert_nil(style.template)
+    assert_nil(style.frame)
+    assert_nil(style.next_style)
+  end
+
+  describe "create_page" do
+    before do
+      @doc = HexaPDF::Document.new
+    end
+
+    it "creates a new page object" do
+      style = HexaPDF::Layout::PageStyle.new do |canvas, istyle|
+        canvas.rectangle(0, 0, 10, 10).stroke
+        istyle.frame = :frame
+        istyle.next_style = :other
+      end
+      page = style.create_page(@doc)
+      assert_equal([0, 0, 595, 842], page.box(:media))
+      assert_equal("0 0 10 10 re\nS\n", page.contents)
+      assert_equal(:frame, style.frame)
+      assert_equal(:other, style.next_style)
+      assert_equal(0, @doc.pages.count)
+    end
+
+    it "works when no template is set" do
+      style = HexaPDF::Layout::PageStyle.new
+      page = style.create_page(@doc)
+      assert_equal("", page.contents)
+    end
+
+    it "creates a default frame if none is set beforehand or during template execution" do
+      style = HexaPDF::Layout::PageStyle.new
+      style.create_page(@doc)
+      assert_kind_of(HexaPDF::Layout::Frame, style.frame)
+      assert_equal(36, style.frame.left)
+      assert_equal(36, style.frame.bottom)
+      assert_equal(523, style.frame.width)
+      assert_equal(770, style.frame.height)
+    end
+  end
+
+  it "creates new frame objects given a page and a margin specification" do
+    doc = HexaPDF::Document.new
+    style = HexaPDF::Layout::PageStyle.new
+    frame = style.create_frame(style.create_page(doc), [15, 10])
+    assert_equal(10, frame.left)
+    assert_equal(15, frame.bottom)
+    assert_equal(575, frame.width)
+    assert_equal(812, frame.height)
+  end
+end