hexapdf 0.46.0 → 1.6.0

data/lib/hexapdf/cli.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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
@@ -49,6 +49,7 @@ require 'hexapdf/cli/image2pdf'
 require 'hexapdf/cli/form'
 require 'hexapdf/cli/fonts'
 require 'hexapdf/cli/usage'
+require 'hexapdf/cli/debug_info'
 require 'hexapdf/version'
 require 'hexapdf/document'
 
@@ -61,11 +62,27 @@ module HexaPDF
     # Runs the CLI application.
     def self.run(args = ARGV)
       Application.new.parse(args)
+    rescue Errno::ENOENT => e
+      path = e.message.scan(/(?<= - ).*?$/).first
+      $stderr.puts "Problem encountered: No such file - #{path}"
     rescue StandardError => e
       $stderr.puts "Problem encountered: #{e.message}"
       unless e.kind_of?(HexaPDF::Error)
+        $stderr.puts "Backtrace (last 10 lines):"
+        $stderr.puts e.backtrace[0, 10]
+        $stderr.puts
         $stderr.puts "--> The problem might indicate a faulty PDF or a bug in HexaPDF."
-        $stderr.puts "--> Please report this at https://github.com/gettalong/hexapdf/issues - thanks!"
+        $stderr.puts "--> Please report this at"
+        $stderr.puts "-->"
+        $stderr.puts "-->     https://github.com/gettalong/hexapdf/issues"
+        $stderr.puts "-->"
+        $stderr.puts "--> and include the information above as well as the output of running"
+        $stderr.puts "--> the following command on the input PDF:"
+        $stderr.puts "-->"
+        $stderr.puts "-->     hexapdf info --check INPUT.PDF"
+        $stderr.puts "-->"
+        $stderr.puts "--> If possible, please also provide the input PDF."
+        $stderr.puts "--> Thanks!"
       end
       exit(1)
     end
@@ -109,6 +126,7 @@ module HexaPDF
         add_command(HexaPDF::CLI::Form.new)
         add_command(HexaPDF::CLI::Fonts.new)
         add_command(HexaPDF::CLI::Usage.new)
+        add_command(HexaPDF::CLI::DebugInfo.new)
         add_command(CmdParse::HelpCommand.new)
         version_command = CmdParse::VersionCommand.new(add_switches: false)
         add_command(version_command)

data/lib/hexapdf/composer.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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
@@ -231,6 +231,13 @@ module HexaPDF
       @document.write(output, optimize: optimize, **options)
     end
 
+    # Writes the created PDF document to a string and returns that string.
+    #
+    # See HexaPDF::Document#write for details.
+    def write_to_string(optimize: true, **options)
+      @document.write_to_string(optimize: optimize, **options)
+    end
+
     # :call-seq:
     #    composer.style(name)                              -> style
     #    composer.style(name, base: :base, **properties)   -> style
@@ -254,6 +261,20 @@ module HexaPDF
       @document.layout.style(name, base: base, **properties)
     end
 
+    # Returns +true+ if a style with the given +name+ exists, else +false+.
+    #
+    # See HexaPDF::Document::Layout#style for details; this method is just a thin wrapper around
+    # that method.
+    #
+    # Example:
+    #
+    #   composer.style(:header, font: 'Helvetica')
+    #   composer.style?(:header)     # => true
+    #   composer.style?(:paragraph)  # => false
+    def style?(name)
+      @document.layout.style?(name)
+    end
+
     # :call-seq:
     #    composer.styles              -> styles
     #    composer.styles(**mapping)   -> styles

data/lib/hexapdf/configuration.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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
@@ -182,6 +182,16 @@ module HexaPDF
   # acro_form.default_font_size::
   #    A number specifying the default font size of AcroForm text fields which should be auto-sized.
   #
+  # acro_form.fallback_default_appearance::
+  #    A hash containging arguments for
+  #    HexaPDF::Type::AcroForm::VariableTextField#set_defaut_appearance_string which is used as
+  #    fallback for fields without a default appearance.
+  #
+  #    If this value is set to +nil+, an error is raised in case a variable text field cannot
+  #    resolve a default appearance string.
+  #
+  #    The default is the empty hash meaning the defaults from the method are used.
+  #
   # acro_form.fallback_font::
   #    The font that should be used when a variable text field references a font that cannot be used.
   #
@@ -214,6 +224,21 @@ module HexaPDF
   # acro_form.text_field.default_width::
   #    A number specifying the default width of AcroForm text fields which should be auto-sized.
   #
+  # acro_form.text_field.on_max_len_exceeded::
+  #    Callback hook when the value of a text field exceeds the set maximum length.
+  #
+  #    The value needs to be an object that responds to \#call(field, value) where +field+ is the
+  #    AcroForm text field on which the value is set and +value+ is the invalid value. The returned
+  #    value is used instead of the invalid value.
+  #
+  #    The default implementation raises an error.
+  #
+  # annotation.appearance_generator::
+  #    The class that should be used for generating appearances for annotations. If the value is a
+  #    String, it should contain the name of a constant to such a class.
+  #
+  #    See HexaPDF::Type::Annotations::AppearanceGenerator
+  #
   # debug::
   #    If set to +true+, enables debug output.
   #
@@ -349,6 +374,11 @@ module HexaPDF
   #    The default implementation returns an object of class HexaPDF::Font::InvalidGlyph which, when
   #    not removed before encoding, will raise a HexaPDF::MissingGlyphError.
   #
+  #    Note: The 'font.on_invalid_glyph' configuration option does something similar but is used
+  #    later and only by the layout engine. If this callback hook returns an invalid glyph instance,
+  #    the 'font.on_invalid_glyph' callback hook is invoked when using the layout engine and it can
+  #    return a substitute glyph in any font.
+  #
   #    If a replacement glyph should be displayed instead of an error, the following provides a good
   #    starting implementation:
   #
@@ -485,12 +515,17 @@ module HexaPDF
     Configuration.new('acro_form.appearance_generator' => 'HexaPDF::Type::AcroForm::AppearanceGenerator',
                       'acro_form.create_appearances' => true,
                       'acro_form.default_font_size' => 10,
+                      'acro_form.fallback_default_appearance' => {},
                       'acro_form.fallback_font' => 'Helvetica',
                       'acro_form.on_invalid_value' => proc do |field, value|
                         raise HexaPDF::Error, "Invalid value #{value.inspect} for " \
                           "#{field.concrete_field_type} field named '#{field.full_field_name}'"
                       end,
                       'acro_form.text_field.default_width' => 100,
+                      'acro_form.text_field.on_max_len_exceeded' => proc do |field, value|
+                        raise HexaPDF::Error, "Value exceeds maximum allowed length of #{field[:MaxLen]}"
+                      end,
+                      'annotation.appearance_generator' => 'HexaPDF::Type::Annotations::AppearanceGenerator',
                       'debug' => false,
                       'document.auto_decrypt' => true,
                       'document.on_invalid_string' => proc do |str|
@@ -587,6 +622,7 @@ module HexaPDF
                         optimize: 'HexaPDF::Task::Optimize',
                         dereference: 'HexaPDF::Task::Dereference',
                         pdfa: 'HexaPDF::Task::PDFA',
+                        merge_acro_form: 'HexaPDF::Task::MergeAcroForm',
                       })
 
   # The global configuration object, providing the following options:
@@ -678,6 +714,7 @@ module HexaPDF
                         XXAcroFormField: 'HexaPDF::Type::AcroForm::Field',
                         XXAppearanceDictionary: 'HexaPDF::Type::Annotation::AppearanceDictionary',
                         Border: 'HexaPDF::Type::Annotation::Border',
+                        XXBorderEffect: 'HexaPDF::Type::Annotation::BorderEffect',
                         SigFieldLock: 'HexaPDF::Type::AcroForm::SignatureField::LockDictionary',
                         SV: 'HexaPDF::Type::AcroForm::SignatureField::SeedValueDictionary',
                         SVCert: 'HexaPDF::Type::AcroForm::SignatureField::CertificateSeedValueDictionary',
@@ -709,6 +746,14 @@ module HexaPDF
                         Metadata: 'HexaPDF::Type::Metadata',
                         OutputIntent: 'HexaPDF::Type::OutputIntent',
                         XXDestOutputProfileRef: 'HexaPDF::Type::OutputIntent::DestOutputProfileRef',
+                        ExData: 'HexaPDF::Type::Annotations::MarkupAnnotation::ExData',
+                        CMap: 'HexaPDF::Type::CMap',
+                        StructTreeRoot: 'HexaPDF::Type::StructTreeRoot',
+                        StructElem: 'HexaPDF::Type::StructElem',
+                        Namespace: 'HexaPDF::Type::Namespace',
+                        MCR: 'HexaPDF::Type::MarkedContentReference',
+                        OBJR: 'HexaPDF::Type::ObjectReference',
+                        Measure: 'HexaPDF::Type::Measure',
                       },
                       'object.subtype_map' => {
                         nil => {
@@ -727,6 +772,11 @@ module HexaPDF
                           Text: 'HexaPDF::Type::Annotations::Text',
                           Link: 'HexaPDF::Type::Annotations::Link',
                           Widget: 'HexaPDF::Type::Annotations::Widget',
+                          Line: 'HexaPDF::Type::Annotations::Line',
+                          Square: 'HexaPDF::Type::Annotations::Square',
+                          Circle: 'HexaPDF::Type::Annotations::Circle',
+                          Polygon: 'HexaPDF::Type::Annotations::Polygon',
+                          PolyLine: 'HexaPDF::Type::Annotations::Polyline',
                           XML: 'HexaPDF::Type::Metadata',
                           GTS_PDFX: 'HexaPDF::Type::OutputIntent',
                           GTS_PDFA1: 'HexaPDF::Type::OutputIntent',
@@ -755,6 +805,11 @@ module HexaPDF
                           Text: 'HexaPDF::Type::Annotations::Text',
                           Link: 'HexaPDF::Type::Annotations::Link',
                           Widget: 'HexaPDF::Type::Annotations::Widget',
+                          Line: 'HexaPDF::Type::Annotations::Line',
+                          Square: 'HexaPDF::Type::Annotations::Square',
+                          Circle: 'HexaPDF::Type::Annotations::Circle',
+                          Polygon: 'HexaPDF::Type::Annotations::Polygon',
+                          PolyLine: 'HexaPDF::Type::Annotations::Polyline',
                         },
                         XXAcroFormField: {
                           Tx: 'HexaPDF::Type::AcroForm::TextField',

data/lib/hexapdf/content/canvas.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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/content/canvas_composer.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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/content/color_space.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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/content/graphic_object/arc.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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/content/graphic_object/endpoint_arc.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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/content/graphic_object/geom2d.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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/content/graphic_object/solid_arc.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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/content/graphic_object.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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/content/graphics_state.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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
@@ -255,7 +255,7 @@ module HexaPDF
           array.inject(0) {|m, n| m < 0 ? m : (n < 0 ? -1 : m + n) } <= 0)
           raise ArgumentError, "Invalid line dash pattern: #{array.inspect} #{phase.inspect}"
         end
-        @array = array.freeze
+        @array = array
         @phase = phase
       end
 

data/lib/hexapdf/content/operator.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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/content/parser.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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
@@ -84,44 +84,43 @@ module HexaPDF
       # See: HexaPDF::Tokenizer#next_token
       def next_token
         @ss.skip(WHITESPACE_MULTI_RE)
-        byte = @string.getbyte(@ss.pos) || -1
-        if (48 <= byte && byte <= 57) || byte == 45 || byte == 43 || byte == 46 # 0..9 - +  .
+        case (byte = @ss.scan_byte || -1)
+        when 43, 45, 46, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57 # + - . 0..9
+          @ss.pos -= 1
           parse_number
-        elsif (65 <= byte && byte <= 90) || (96 <= byte && byte <= 121)
-          parse_keyword
-        elsif byte == 47 # /
+        when 47 # /
           parse_name
-        elsif byte == 40 # (
+        when 40 # (
           parse_literal_string
-        elsif byte == 60 # <
-          if @string.getbyte(@ss.pos + 1) == 60
-            @ss.pos += 2
+        when 60 # <
+          if @ss.peek_byte == 60
+            @ss.pos += 1
             TOKEN_DICT_START
           else
             parse_hex_string
           end
-        elsif byte == 62 # >
-          unless @string.getbyte(@ss.pos + 1) == 62
-            raise HexaPDF::MalformedPDFError.new("Delimiter '>' found at invalid position", pos: pos)
+        when 62 # >
+          unless @ss.scan_byte == 62
+            raise HexaPDF::MalformedPDFError.new("Delimiter '>' found at invalid position", pos: pos - 1)
           end
-          @ss.pos += 2
           TOKEN_DICT_END
-        elsif byte == 91 # [
-          @ss.pos += 1
+        when 91 # [
           TOKEN_ARRAY_START
-        elsif byte == 93 # ]
-          @ss.pos += 1
+        when 93 # ]
           TOKEN_ARRAY_END
-        elsif byte == 123 || byte == 125 # { }
-          Token.new(@ss.get_byte)
-        elsif byte == 37 # %
+        when 41 # )
+          raise HexaPDF::MalformedPDFError.new("Delimiter ')' found at invalid position", pos: pos - 1)
+        when 123, 125 # { } )
+          Token.new(byte.chr.b)
+        when 37 # %
           unless @ss.skip_until(/(?=[\r\n])/)
             (@raise_on_eos ? (raise StopIteration) : (return NO_MORE_TOKENS))
           end
           next_token
-        elsif byte == -1
+        when -1
           @raise_on_eos ? raise(StopIteration) : NO_MORE_TOKENS
         else
+          @ss.pos -= 1
           parse_keyword
         end
       end
@@ -133,7 +132,7 @@ module HexaPDF
         if (val = @ss.scan(/[+-]?(?:\d+\.\d*|\.\d+)/))
           val << '0' if val.getbyte(-1) == 46 # dot '.'
           Float(val)
-        elsif (val = @ss.scan(/[+-]?\d++/))
+        elsif (val = @ss.scan_integer)
           val.to_i
         else
           parse_keyword

data/lib/hexapdf/content/processor.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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/content/transformation_matrix.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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/content.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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/data_dir.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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/dictionary.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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
@@ -301,7 +301,13 @@ module HexaPDF
             yield(msg, true)
             self[name] = obj.intern
           else
-            yield(msg, false)
+            yield(msg, !field.required? || field.default?)
+            if field.required? && field.default?
+              self[name] = obj = field.default
+            else
+              delete(name)
+              next
+            end
           end
         end
 

data/lib/hexapdf/dictionary_fields.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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
@@ -313,7 +313,7 @@ module HexaPDF
         [String, Time, Date, DateTime]
       end
 
-      DATE_RE = /\AD:(\d{4})(\d\d)?(\d\d)?(\d\d)?(\d\d)?(\d\d)?([Z+-])?(?:(\d+)(?:'|'(\d+)'?|\z)?)?\z/n # :nodoc:
+      DATE_RE = /\AD:(\d{4})(\d\d)?(\d\d)?(\d\d)?(\d\d)?(\d\d)?([Z+-])?(?:(\d+)(?:'|'(\d+)'?'?|\z)?)?\z/n # :nodoc:
 
       # Checks if the given object is a string and converts into a Time object if possible.
       # Otherwise returns +nil+.

data/lib/hexapdf/digital_signature/cms_handler.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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
@@ -49,7 +49,11 @@ module HexaPDF
       # Creates a new signature handler for the given signature dictionary.
       def initialize(signature_dict)
         super
-        @pkcs7 = OpenSSL::PKCS7.new(signature_dict.contents)
+        begin
+          @pkcs7 = OpenSSL::PKCS7.new(signature_dict.contents)
+        rescue
+          raise HexaPDF::Error, "Signature contents is invalid"
+        end
       end
 
       # Returns the common name of the signer.
@@ -155,6 +159,19 @@ module HexaPDF
           result.log(:error, "Signature verification failed")
         end
 
+        certs = [signer_certificate]
+        cur_cert = certs.first
+        while true
+          cur_cert = certificate_chain.find {|cert| cert.subject == cur_cert.issuer }
+          if cur_cert && !certs.include?(cur_cert)
+            certs << cur_cert
+          else
+            break
+          end
+        end
+        cert_subjects = certs.map {|cert| cert.subject.to_a.assoc("CN")&.[](1) }
+        result.log(:info, "Certificate chain: #{cert_subjects.join(" -> ")}")
+
         result
       end
 

data/lib/hexapdf/digital_signature/handler.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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/digital_signature/pkcs1_handler.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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/digital_signature/signature.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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
@@ -211,7 +211,7 @@ module HexaPDF
         data = ''.b
         self[:ByteRange]&.each_slice(2) do |offset, length|
           io.pos = offset
-          data << io.read(length)
+          data << io.read(length).to_s
         end
         data
       end

data/lib/hexapdf/digital_signature/signatures.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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/digital_signature/signing/default_handler.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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
@@ -289,6 +289,7 @@ module HexaPDF
           signature[:Location] = location if location
           signature[:ContactInfo] = contact_info if contact_info
           signature[:Prop_Build] = {App: {Name: :HexaPDF, REx: HexaPDF::VERSION}}
+          signature.document.version = '2.0' if signature_type == :pades
 
           if doc_mdp_permissions
             doc = signature.document
@@ -296,8 +297,7 @@ module HexaPDF
               raise HexaPDF::Error, "Can set DocMDP access permissions only on first signature"
             end
             params = doc.add({Type: :TransformParams, V: :'1.2', P: doc_mdp_permissions})
-            sigref = doc.add({Type: :SigRef, TransformMethod: :DocMDP, DigestMethod: :SHA256,
-                              TransformParams: params})
+            sigref = doc.add({Type: :SigRef, TransformMethod: :DocMDP, TransformParams: params})
             signature[:Reference] = [sigref]
             (doc.catalog[:Perms] ||= {})[:DocMDP] = signature
           end

data/lib/hexapdf/digital_signature/signing/signed_data_creator.rb

@@ -4,7 +4,7 @@
 # This file is part of HexaPDF.
 #
 # HexaPDF - A Versatile PDF Creation and Manipulation Library For Ruby
-# Copyright (C) 2014-2024 Thomas Leitner
+# Copyright (C) 2014-2025 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
@@ -108,7 +108,7 @@ module HexaPDF
         # +type+::
         #     The type can either be :cms when creating standard PDF CMS signatures or :pades when
         #     creating PAdES compatible signatures. PAdES signatures are part of PDF 2.0.
-        def create(data, type: :cms, &block) # :yield: digested_data
+        def create(data, type: :cms, &block) # :yield: digest_algorithm, hashed_data
           signed_attrs = create_signed_attrs(data, signing_time: (type == :cms))
           signature = digest_and_sign_data(set(*signed_attrs.value).to_der, &block)
           unsigned_attrs = create_unsigned_attrs(signature)