nguyen 1.0.3 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: acfaf8065a261f6cc2b2f5b95887a48d450686b6529a315664982c13ecc0c8d0
-  data.tar.gz: 99729f86c46f23fc9846f1af8c727da593066dc9df39c4283eceba5b6bd2bb68
+  metadata.gz: f506bb08df03fd015f7b9abac64a8788717daf5c3f3c7eaacc58f9c96590c7ef
+  data.tar.gz: 7f425f695f794dbddef3e7550e212e845b9cbb85cd6c5e121c9f066e3b1beb53
 SHA512:
-  metadata.gz: 5d65ce412084256c66f6061c32301f4d48772aafd28b438049877191bb93d72592cc13b9727c46d445be4d7cb8d41fb1db2163ba22c1d03d3739fd0a64907d8f
-  data.tar.gz: b8ebe36c4cbff4e667b38dad208c305035bfc18623b68bace90ff8753f0a6aa7fb203fcec0332a959b155166c9a646d3cee455bb9601cf26b2abeee9d85f7d07
+  metadata.gz: 0ed2625129d36a1175e10316e771591815b6f1ed71dd85c9d6a07c38ec237cc80dad4fd6df20c2fb6de4a165d067434bafb095ab1d93d70bc3c7a58fe3da0f07
+  data.tar.gz: 4ceb1deadd047804d440e31230eeb49eaca8ddd6be5cf2c4295b6dbedb6001ea7aa9c9e63cc7c4336baa20a7ccb7c7dd803cff847f5ef60128910b5236ec9135

data/LICENSE

@@ -1,6 +1,6 @@
 (The MIT License)
 
-Copyright (c) 2014 Trung Lê
+Copyright (c) 2014 - 2026 Trung Lê
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -1,13 +1,16 @@
-# Nguyên the PDF Field Merger
+# Nguyễn the PDF Field Merger
 
 A very lightweight library that fill PDF forms using XFDF/FDF with pdftk
 
 You could download pdftk at http://www.accesspdf.com/pdftk/
 
-Nguyên is a fork of Jens Krämer's pdf-forms with addition of filling forms with XFDF feature.
+Nguyễn is a fork of Jens Krämer's pdf-forms with addition of filling forms with XFDF feature.
 
-[![Build Status](https://secure.travis-ci.org/ruby-journal/nguyen.png)](http://travis-ci.org/ruby-journal/nguyen)
+[![CI](https://github.com/ruby-journal/nguyen/actions/workflows/ci.yml/badge.svg)](https://github.com/ruby-journal/nguyen/actions/workflows/ci.yml)
 [![Code Climate](https://codeclimate.com/github/ruby-journal/nguyen/badges/gpa.svg)](https://codeclimate.com/github/ruby-journal/nguyen)
+[![From Vietnam with <3](https://raw.githubusercontent.com/webuild-community/badge/master/svg/love.svg)](https://webuild.community)
+[![Made in Vietnam](https://raw.githubusercontent.com/webuild-community/badge/master/svg/made.svg)](https://webuild.community)
+[![Built with WeBuild](https://raw.githubusercontent.com/webuild-community/badge/master/svg/WeBuild.svg)](https://webuild.community)
 
 ## EXAMPLE:
 
@@ -59,6 +62,19 @@ XML
 pdftk.fill_form('/path/to/form', 'myform.pdf', xfdf_string)
 ```
 
+### Stamp PDFs
+
+```ruby
+pdftk = Nguyen::PdftkWrapper.new('/usr/local/bin/pdftk')
+
+# overlay stamp.pdf (e.g. a watermark or signature) on top of every page of source.pdf
+pdftk.stamp('source.pdf', 'stamp.pdf', 'stamped.pdf')
+
+# overlay stamp.pdf page by page: page 1 of stamp.pdf onto page 1 of source.pdf, etc.
+# the last page of stamp.pdf is repeated if source.pdf has more pages
+pdftk.multistamp('source.pdf', 'stamp.pdf', 'stamped.pdf')
+```
+
 ## INSTALL:
 
     gem install nguyen

data/lib/nguyen/fdf.rb

@@ -5,9 +5,9 @@ module Nguyen
   # Straight port of Perl's PDF::FDF::Simple by Steffen Schwigon.
   # Parsing FDF files is not supported (yet).
   class Fdf
-    
+
     attr_reader :options
-    
+
     def initialize(data = {}, options = {})
       @data = data
       @options = {
@@ -20,7 +20,7 @@ module Nguyen
     # generate FDF content
     def to_fdf
       fdf = header
-      
+
       @data.each do |key, value|
         if Hash === value
           value.each do |sub_key, sub_value|
@@ -34,34 +34,42 @@ module Nguyen
       fdf << footer
       return fdf
     end
-    
+
     # write fdf content to path
     def save_to(path)
       File.write(path, to_fdf)
     end
-    
+
     protected
-    
+
     def header
-      header = "%FDF-1.2\n\n1 0 obj\n<<\n/FDF << /Fields 2 0 R"
-      
+      header = +"%FDF-1.2\n\n1 0 obj\n<<\n/FDF << /Fields 2 0 R"
+
       # /F
       header << "/F (#{options[:file]})" if options[:file]
       # /UF
       header << "/UF (#{options[:ufile]})" if options[:ufile]
       # /ID
       header << "/ID[" << options[:id].join << "]" if options[:id]
-      
+
       header << ">>\n>>\nendobj\n2 0 obj\n["
       return header
     end
 
     def field(key, value)
-      "<</T(#{key})/V" +
-        (Array === value ? "[#{value.map{ |v|"(#{quote(v)})" }.join}]" : "(#{quote(value)})") +
-        ">>\n"
+      value_string = case value
+                       when TrueClass
+                         '/1'
+                       when FalseClass
+                         '/0'
+                       when Array
+                         '[' + value.map { |v| "(#{quote(v)})" }.join + ']'
+                       else
+                         "(#{quote(value)})"
+                     end
+      "<<\n/T(#{key})\n/V #{value_string}\n>>\n"
     end
-    
+
     def quote(value)
       value.to_s.strip.
         gsub( /\\/, '\\' ).
@@ -69,7 +77,7 @@ module Nguyen
         gsub( /\)/, '\)' ).
         gsub( /\n/, '\r' )
     end
-    
+
     FOOTER =<<-EOFOOTER
 ]
 endobj
@@ -80,10 +88,10 @@ trailer
 >>
 %%EOF
 EOFOOTER
-    
+
     def footer
       FOOTER
     end
-    
+
   end
 end

data/lib/nguyen/pdf.rb

@@ -14,13 +14,13 @@ module Nguyen
 
     protected
 
-      def read_fields
-        field_output = @pdftk.call_pdftk %Q("#{path}"), 'dump_data_fields'
-        @fields = field_output.split(/^---\n/).map do |field_text|
-          if field_text =~ /^FieldName: (\w+)$/
-            $1
-          end
-        end.compact.uniq
-      end
+    def read_fields
+      field_output = @pdftk.call_pdftk path, 'dump_data_fields_utf8'
+      @fields = field_output.split("\n").map do |field_text|
+        if field_text =~ /^FieldName: (.+)$/
+          $1
+        end
+      end.compact.uniq
+    end
   end
 end

data/lib/nguyen/pdftk_wrapper.rb

@@ -28,6 +28,18 @@ module Nguyen
       tmp.unlink if tmp
     end
 
+    # pdftk.stamp '/path/to/source.pdf', '/path/to/stamp.pdf', '/path/to/destination.pdf'
+    # overlays the stamp PDF on top of every page of the source PDF
+    def stamp(template, stamp_file, destination)
+      stamp_operation 'stamp', template, stamp_file, destination
+    end
+
+    # pdftk.multistamp '/path/to/source.pdf', '/path/to/stamp.pdf', '/path/to/destination.pdf'
+    # overlays the stamp PDF onto the source PDF page by page
+    def multistamp(template, stamp_file, destination)
+      stamp_operation 'multistamp', template, stamp_file, destination
+    end
+
     # pdftk.read '/path/to/form.pdf'
     # returns an instance of Nguyen::Pdf representing the given template
     def read(path)
@@ -50,6 +62,14 @@ module Nguyen
 
     protected
 
+      def stamp_operation(operation, template, stamp_file, destination)
+        command = pdftk_command %Q("#{template}"), operation, %Q("#{stamp_file}"), 'output', %Q("#{destination}")
+        output = %x{#{command}}
+        unless File.readable?(destination) && File.size(destination) > 0
+          raise PdftkError.new("failed to #{operation} with command\n#{command}\ncommand output was:\n#{output}")
+        end
+      end
+
       def pdftk_command(*args)
         "#{pdftk} #{args.flatten.compact.join ' '} 2>&1"
       end

data/lib/nguyen/version.rb

@@ -1,3 +1,3 @@
 module Nguyen
-  VERSION = '1.0.3'
+  VERSION = '2.0.0'
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: nguyen
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 2.0.0
 platform: ruby
 authors:
 - Trung Lê
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-11 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -16,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '1.16'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '1.16'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -38,7 +37,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Forms for Nguyên is Ruby library that could merge PDF fields by XFDF/FDF
+description: Forms for Nguyễn is Ruby library that could merge PDF fields by XFDF/FDF
   via pdftk.
 email: trung.le@ruby-journal.com
 executables: []
@@ -58,7 +57,6 @@ homepage: http://github.com/ruby-journal/nguyen
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -66,7 +64,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.5.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -74,8 +72,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - pdtk 1.44.1 or newer
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Fill out PDF forms by XFDF/FDF via pdftk.
 test_files: []