acro_that 0.1.0

data/lib/acro_that/pdf_writer.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module AcroThat
+  # PDFWriter - Clean PDF writer for flattening documents
+  # Writes a complete PDF from parsed objects, consolidating incremental updates
+  class PDFWriter
+    def initialize
+      # Work entirely in binary encoding to avoid UTF-8/ASCII-8BIT conflicts
+      @buffer = "".b
+      @offsets = [] # Track [obj_num, gen, offset] for xref table
+      @xref_offset = 0
+    end
+
+    def write_header
+      @buffer << "%PDF-1.6\n".b
+      # Binary marker (helps PDF readers identify binary content)
+      @buffer << "%\xE2\xE3\xCF\xD3\n".b
+    end
+
+    def write_object(ref, body)
+      obj_num, gen = ref
+      offset = @buffer.bytesize
+      @offsets << [obj_num, gen, offset]
+
+      # Write object with proper PDF syntax
+      # Use ASCII-8BIT encoding throughout to avoid conflicts
+      @buffer << "#{obj_num} #{gen} obj\n".b
+
+      # Body is already in binary from ObjectResolver
+      @buffer << body.b
+
+      # Ensure proper spacing before endobj
+      @buffer << "\n".b unless body.end_with?("\n")
+      @buffer << "endobj\n".b
+    end
+
+    def write_xref
+      @xref_offset = @buffer.bytesize
+
+      # Build xref table
+      xref = "xref\n".b
+
+      # Object 0 (free list head)
+      xref << "0 1\n".b
+      xref << "0000000000 65535 f \n".b
+
+      # Sort offsets and group consecutive objects into subsections
+      sorted = @offsets.sort_by { |num, gen, _offset| [num, gen] }
+
+      i = 0
+      while i < sorted.length
+        first_num = sorted[i][0]
+
+        # Find consecutive run
+        run_length = 1
+        while (i + run_length) < sorted.length &&
+              sorted[i + run_length][0] == first_num + run_length &&
+              sorted[i + run_length][1] == sorted[i][1]
+          run_length += 1
+        end
+
+        # Write subsection header
+        xref << "#{first_num} #{run_length}\n".b
+
+        # Write entries in this subsection
+        run_length.times do |j|
+          offset = sorted[i + j][2]
+          gen = sorted[i + j][1]
+          xref << format("%010d %05d n \n", offset, gen).b
+        end
+
+        i += run_length
+      end
+
+      @buffer << xref
+    end
+
+    def write_trailer(size, root_ref, info_ref = nil)
+      trailer = "trailer\n".b
+      trailer << "<<".b
+      trailer << " /Size #{size}".b
+      trailer << " /Root #{root_ref[0]} #{root_ref[1]} R".b
+      trailer << " /Info #{info_ref[0]} #{info_ref[1]} R".b if info_ref
+      trailer << " >>".b
+      trailer << "\n".b
+      trailer << "startxref\n".b
+      trailer << "#{@xref_offset}\n".b
+      trailer << "%%EOF\n".b
+
+      @buffer << trailer
+    end
+
+    def output
+      @buffer
+    end
+  end
+end

data/lib/acro_that/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module AcroThat
+  VERSION = "0.1.0"
+end

data/lib/acro_that.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require "strscan"
+require "stringio"
+require "zlib"
+require "base64"
+
+require_relative "acro_that/dict_scan"
+require_relative "acro_that/object_resolver"
+require_relative "acro_that/objstm"
+require_relative "acro_that/pdf_writer"
+require_relative "acro_that/incremental_writer"
+require_relative "acro_that/field"
+require_relative "acro_that/document"
+
+# Load actions
+require_relative "acro_that/actions/base"
+require_relative "acro_that/actions/add_field"
+require_relative "acro_that/actions/update_field"
+require_relative "acro_that/actions/remove_field"
+require_relative "acro_that/actions/add_signature_appearance"
+
+module AcroThat
+end

metadata

@@ -0,0 +1,143 @@
+--- !ruby/object:Gem::Specification
+name: acro_that
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Michael Wynkoop
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-11-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: chunky_png
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
+description: A minimal pure Ruby library for parsing and editing PDF AcroForm fields
+  using only stdlib
+email:
+- michaelwynkoop@corporatetools.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".DS_Store"
+- ".gitignore"
+- ".rubocop.yml"
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- acro_that.gemspec
+- docs/README.md
+- docs/dict_scan_explained.md
+- docs/object_streams.md
+- docs/pdf_structure.md
+- lib/acro_that.rb
+- lib/acro_that/actions/add_field.rb
+- lib/acro_that/actions/add_signature_appearance.rb
+- lib/acro_that/actions/base.rb
+- lib/acro_that/actions/remove_field.rb
+- lib/acro_that/actions/update_field.rb
+- lib/acro_that/dict_scan.rb
+- lib/acro_that/document.rb
+- lib/acro_that/field.rb
+- lib/acro_that/incremental_writer.rb
+- lib/acro_that/object_resolver.rb
+- lib/acro_that/objstm.rb
+- lib/acro_that/pdf_writer.rb
+- lib/acro_that/version.rb
+homepage: https://github.com/corporatetools/acro_that
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/corporatetools/acro_that
+  source_code_uri: https://github.com/corporatetools/acro_that
+  changelog_uri: https://github.com/corporatetools/acro_that/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.12
+signing_key:
+specification_version: 4
+summary: Pure Ruby PDF AcroForm editing library
+test_files: []