fillform 0.1.0

data/lib/fillform.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require_relative "fillform/version"
+
+# Fills AcroForm PDF templates in pure Ruby. The appearance of a filled field is built with the
+# formulas of pdftk (iText 2.1.7), so the documents look the same as the ones pdftk fills.
+module Fillform
+  class Error < StandardError; end
+
+  class << self
+    def fill(template, destination, data = {}, flatten: false)
+      Filler.new(template).fill(data, flatten: flatten).write(destination)
+    end
+
+    def fields(template)
+      Report.new(PDF::Document.open(template.to_s)).fields
+    end
+
+    def field_names(template)
+      fields(template).map(&:name)
+    end
+
+    # Numbers in content streams are written like iText's ByteBuffer#formatDouble writes a float: five
+    # decimals below 1, two up to 32767, none above, each truncated after adding half of the last digit.
+    def number(value)
+      value = [value].pack("e").unpack1("e")
+      return "0" if value.abs < 0.000015
+
+      sign = value.negative? ? "-" : ""
+      value = value.abs
+      text = if value < 1.0
+               fraction(value + 0.000005, 100_000, 5)
+             elsif value <= 32_767
+               fraction(value + 0.005, 100, 2)
+             else
+               (value + 0.5).to_i.to_s
+             end
+      "#{sign}#{text}"
+    end
+
+    private
+
+    def fraction(value, scale, digits)
+      return "1" if digits == 5 && value >= 1
+
+      scaled = (value * scale).to_i
+      whole, decimals = scaled.divmod(scale)
+      decimals.zero? ? whole.to_s : "#{whole}.#{decimals.to_s.rjust(digits, "0").sub(/0+\z/, "")}"
+    end
+  end
+end
+
+require_relative "fillform/pdf"
+require_relative "fillform/glyphs"
+require_relative "fillform/form"
+require_relative "fillform/merged_widget"
+require_relative "fillform/field"
+require_relative "fillform/report"
+require_relative "fillform/font"
+require_relative "fillform/float32"
+require_relative "fillform/line_breaker"
+require_relative "fillform/border"
+require_relative "fillform/appearance"
+require_relative "fillform/flattener"
+require_relative "fillform/filler"

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification
+name: fillform
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Alessandro Rodi
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: 'Fills AcroForm templates in pure Ruby and draws the filled fields with
+  the layout of pdftk (iText 2.1.7): no Java, no pdftk binary, no subprocess. Ships
+  a PdfForms-compatible API.'
+email:
+- rodi@hey.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- data/afm/Courier-Bold.afm
+- data/afm/Courier-BoldOblique.afm
+- data/afm/Courier-Oblique.afm
+- data/afm/Courier.afm
+- data/afm/Helvetica-Bold.afm
+- data/afm/Helvetica-BoldOblique.afm
+- data/afm/Helvetica-Oblique.afm
+- data/afm/Helvetica.afm
+- data/afm/MustRead.html
+- data/afm/Symbol.afm
+- data/afm/Times-Bold.afm
+- data/afm/Times-BoldItalic.afm
+- data/afm/Times-Italic.afm
+- data/afm/Times-Roman.afm
+- data/afm/ZapfDingbats.afm
+- data/agl/LICENSE.md
+- data/agl/glyphlist.txt
+- data/agl/zapfdingbats.txt
+- lib/fillform.rb
+- lib/fillform/appearance.rb
+- lib/fillform/border.rb
+- lib/fillform/data_format.rb
+- lib/fillform/field.rb
+- lib/fillform/filler.rb
+- lib/fillform/flattener.rb
+- lib/fillform/float32.rb
+- lib/fillform/font.rb
+- lib/fillform/form.rb
+- lib/fillform/glyphs.rb
+- lib/fillform/line_breaker.rb
+- lib/fillform/merged_widget.rb
+- lib/fillform/pdf.rb
+- lib/fillform/pdf/document.rb
+- lib/fillform/pdf/filters.rb
+- lib/fillform/pdf/objects.rb
+- lib/fillform/pdf/parser.rb
+- lib/fillform/pdf/serializer.rb
+- lib/fillform/pdf/text.rb
+- lib/fillform/pdf/writer.rb
+- lib/fillform/pdf_forms.rb
+- lib/fillform/pdftk_wrapper.rb
+- lib/fillform/report.rb
+- lib/fillform/version.rb
+homepage: https://github.com/coorasse/fillform
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/coorasse/fillform
+  changelog_uri: https://github.com/coorasse/fillform/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.20
+specification_version: 4
+summary: Fill PDF forms in pure Ruby, with the same output as pdftk. A drop-in replacement
+  for pdf-forms.
+test_files: []