pdffill 2026.6.19.0__tar.gz

pdffill-2026.6.19.0/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: pdffill
+Version: 2026.6.19.0
+Summary: Command line utility to manipulate PDF fields. It can list, rename, fill-in or delete PDF fields.
+Author-email: Ernesto Alfonso <erjoalgo@gmail.com>
+Maintainer-email: Ernesto Alfonso <erjoalgo@gmail.com>
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://github.com/erjoalgo/dotfiles/tree/master/bin/pdffill
+Project-URL: Documentation, https://github.com/erjoalgo/dotfiles/tree/master/bin/pdffill/README.md
+Project-URL: Repository, https://github.com/erjoalgo/dotfiles/tree/master/bin/pdffill
+Project-URL: Bug Tracker, https://github.com/erjoalgo/dotfiles/issues
+Keywords: pdf,fields,fill
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: pypdf
+Requires-Dist: fillpdf
+Requires-Dist: PyMuPDF
+
+This is a command line utility to manipulate a PDF's fields. 
+
+$ pip install pdffill
+
+# List field names
+$ pdffill input.pdf -l
+
+# Rename some fields
+$ pdffill.py input.pdf -r text_3uwum=seller text_4vpsr=buyer text_5ovhg=address
+
+# Fill in some fields, write to a separate output file
+$ pdffill.py input.pdf -o filled.pdf -f "seller=Wollam Bonnie C Estate" "buyer=John Doe" address=20235 Majestic Street, Orlando, Fl, 32833
+
+# Delete some fields, write to a separate output file
+$ pdffill.py input.pdf -o slim.pdf -d balance-to-close -d purchase-price-other-item -d purchase-price-other-item-value
+
+# Fill in all fields with their own names, helpful for seeing where fields are on the page.
+$ pdffill.py input.pdf -o debug.pdf -F
+
+This utility doesn't handle checkboxes well, and it is recommended to use plain text fields instead.

pdffill-2026.6.19.0/README.md

@@ -0,0 +1,20 @@
+This is a command line utility to manipulate a PDF's fields. 
+
+$ pip install pdffill
+
+# List field names
+$ pdffill input.pdf -l
+
+# Rename some fields
+$ pdffill.py input.pdf -r text_3uwum=seller text_4vpsr=buyer text_5ovhg=address
+
+# Fill in some fields, write to a separate output file
+$ pdffill.py input.pdf -o filled.pdf -f "seller=Wollam Bonnie C Estate" "buyer=John Doe" address=20235 Majestic Street, Orlando, Fl, 32833
+
+# Delete some fields, write to a separate output file
+$ pdffill.py input.pdf -o slim.pdf -d balance-to-close -d purchase-price-other-item -d purchase-price-other-item-value
+
+# Fill in all fields with their own names, helpful for seeing where fields are on the page.
+$ pdffill.py input.pdf -o debug.pdf -F
+
+This utility doesn't handle checkboxes well, and it is recommended to use plain text fields instead.

pdffill-2026.6.19.0/pdffill.egg-info/PKG-INFO

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: pdffill
+Version: 2026.6.19.0
+Summary: Command line utility to manipulate PDF fields. It can list, rename, fill-in or delete PDF fields.
+Author-email: Ernesto Alfonso <erjoalgo@gmail.com>
+Maintainer-email: Ernesto Alfonso <erjoalgo@gmail.com>
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://github.com/erjoalgo/dotfiles/tree/master/bin/pdffill
+Project-URL: Documentation, https://github.com/erjoalgo/dotfiles/tree/master/bin/pdffill/README.md
+Project-URL: Repository, https://github.com/erjoalgo/dotfiles/tree/master/bin/pdffill
+Project-URL: Bug Tracker, https://github.com/erjoalgo/dotfiles/issues
+Keywords: pdf,fields,fill
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: pypdf
+Requires-Dist: fillpdf
+Requires-Dist: PyMuPDF
+
+This is a command line utility to manipulate a PDF's fields. 
+
+$ pip install pdffill
+
+# List field names
+$ pdffill input.pdf -l
+
+# Rename some fields
+$ pdffill.py input.pdf -r text_3uwum=seller text_4vpsr=buyer text_5ovhg=address
+
+# Fill in some fields, write to a separate output file
+$ pdffill.py input.pdf -o filled.pdf -f "seller=Wollam Bonnie C Estate" "buyer=John Doe" address=20235 Majestic Street, Orlando, Fl, 32833
+
+# Delete some fields, write to a separate output file
+$ pdffill.py input.pdf -o slim.pdf -d balance-to-close -d purchase-price-other-item -d purchase-price-other-item-value
+
+# Fill in all fields with their own names, helpful for seeing where fields are on the page.
+$ pdffill.py input.pdf -o debug.pdf -F
+
+This utility doesn't handle checkboxes well, and it is recommended to use plain text fields instead.

pdffill-2026.6.19.0/pdffill.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pdffill.py
+pyproject.toml
+pdffill.egg-info/PKG-INFO
+pdffill.egg-info/SOURCES.txt
+pdffill.egg-info/dependency_links.txt
+pdffill.egg-info/entry_points.txt
+pdffill.egg-info/requires.txt
+pdffill.egg-info/top_level.txt

pdffill-2026.6.19.0/pdffill.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pdffill-2026.6.19.0/pdffill.egg-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+pdffill = pdffill:main
+
+[pdffill.pdffill]
+pdffill = pdffill:pdffill

pdffill-2026.6.19.0/pdffill.egg-info/requires.txt

@@ -0,0 +1,3 @@
+pypdf
+fillpdf
+PyMuPDF

pdffill-2026.6.19.0/pdffill.egg-info/top_level.txt

@@ -0,0 +1 @@
+pdffill

pdffill-2026.6.19.0/pdffill.py

@@ -0,0 +1,169 @@
+#!/usr/bin/env python3
+
+"""Fill, rename or list a PDF's fields."""
+
+
+import argparse
+import logging
+
+from pypdf import PdfReader, PdfWriter
+from pypdf.generic import NameObject, create_string_object
+
+from fillpdf import fillpdfs
+
+import fitz
+
+def list_fields(input_pdf):
+    """List the fields in input_pdf."""
+    reader = PdfReader(input_pdf)
+    return (reader.get_fields() or {}).keys()
+
+def rename_fields(input_pdf, output_pdf, renames):
+    """Rename the fields in input_pdf."""
+    with open(input_pdf, "rb") as fh:
+        writer = PdfWriter(fileobj=fh)
+
+    for page in writer.pages:
+        for annot in (page.get("/Annots") or []):
+            full_annot = annot.get_object()
+            if "/T" not in full_annot:
+                continue
+            current_name = full_annot["/T"]
+            if "checkbox" in current_name:
+                continue
+            new_name = renames.get(current_name)
+            if new_name:
+                full_annot[NameObject("/T")] = create_string_object(new_name)
+
+    for field in writer.root_object['/AcroForm']["/Fields"]:
+        full_field = field.get_object()
+        curr_name = full_field.get("/T")
+        if "checkbox" in curr_name:
+            continue
+        new_name = renames.get(curr_name)
+        if new_name:
+            full_field[NameObject("/T")] = create_string_object(new_name)
+
+    with open(output_pdf, "wb") as f:
+        writer.write(f)
+
+def fill_pdf_pypdf(input_pdf, output_pdf, data_dict):
+    """Fill in the fields in input_pdf."""
+    with open(input_pdf, "rb") as fh:
+        writer = PdfWriter(fileobj = fh)
+
+    for i, page in enumerate(writer.pages):
+        # non_checkboxes = {k: v for k, v in data_dict.items() if "checkbox" not  in k}
+        non_checkboxes = data_dict
+        logging.debug(f"on page %s{i+1}")
+        writer.update_page_form_field_values(
+            page, non_checkboxes,
+            auto_regenerate=False)
+
+
+    with open(output_pdf, "wb") as output_stream:
+        writer.write(output_stream)
+
+
+def print_fields(input_pdf):
+    """Print the field names in the pdf."""
+    field_names = fillpdfs.get_form_fields(input_pdf)
+    for (name, value) in field_names.items():
+        print(f"{name} = {value}")
+
+
+def list_to_map(arr):
+    """Convert a list of key=value strings into a dictionary."""
+    d = {}
+    for kv in arr:
+        if "=" not in kv:
+            logging.info("warn: skipping mapping with no = sign: %s", kv)
+            continue
+
+        k, v = kv.split("=")
+        if not v:
+            logging.info("warn: skipping mapping with empty value: %s", kv)
+            continue
+        d[k] = v
+    return d
+
+
+def delete_fields(input_pdf, output_pdf, fields_to_delete):
+    """Delete the given fields and write to output_pdf."""
+    doc = fitz.open(input_pdf)
+    for page in doc:
+        # Get all interactive form widgets on the page
+        for widget in page.widgets():
+            if widget.field_name in fields_to_delete:
+                # 1. Get the internal object reference number
+                xref = widget.xref
+
+                # 2. Delete the visual widget widget from the page
+                page.delete_widget(widget)
+
+                # 3. Completely clear the internal object definitions
+                doc.update_object(xref, "<<>>")
+
+    # Save the updated PDF
+    doc.save(output_pdf, incremental=True,
+             encryption=fitz.PDF_ENCRYPT_KEEP)
+    doc.close()
+
+def main():
+    """Main function."""
+    parser = argparse.ArgumentParser()
+    parser.add_argument("input", help="input PDF")
+    parser.add_argument("-o", "--output", help="output file")
+    parser.add_argument("-l", "--list", action="store_true",
+                        help="""list the PDF fields""")
+    parser.add_argument("-r", "--rename",
+                        help="""rename the given fields.
+example: old_name1=new_name1 old_name2=new_name_2""",
+                        nargs="+")
+    parser.add_argument("-f", "--fill",
+                        help="""fill in the given fields.
+example: old_name1=new_name1 old_name2=new_name_2""",
+                        nargs="+")
+    parser.add_argument("-F", "--fill_all",
+                        help="""fill in all text fields with their own field names.""",
+                        action="store_true")
+    parser.add_argument("-d", "--delete", nargs="+",
+                        help="""delete the given fields""")
+    parser.add_argument("-v", "--verbose", action="store_true",
+                        help="""verbose logging""")
+
+    args= parser.parse_args()
+
+    logging.basicConfig(level=logging.DEBUG
+                        if args.verbose else logging.INFO)
+
+    if args.list:
+        print_fields(args.input)
+
+    if not args.output:
+        logging.warning("warn: making modifications in-place")
+        args.output = args.input
+
+    if args.rename:
+        renames = list_to_map(args.rename)
+        assert args.output
+        rename_fields(args.input, args.output, renames)
+        print_fields(args.output)
+
+    fill_pdf_fn = fill_pdf_pypdf
+    if args.fill:
+        fills = list_to_map(args.fill)
+        assert args.output
+        fill_pdf_fn(args.input, args.output, fills)
+
+    if args.fill_all:
+        fields = list_fields(args.input)
+        fills = {name: name for name in fields}
+        fill_pdf_fn(args.input, args.output, fills)
+
+    if args.delete:
+        delete_fields(args.input, args.output, args.delete)
+        print_fields(args.output)
+
+if __name__ == "__main__":
+    main()

pdffill-2026.6.19.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pdffill"
+version = "2026.06.19.0"
+dependencies = [
+  "pypdf",
+  "fillpdf",
+  "PyMuPDF",
+]
+requires-python = ">=3.7"
+authors = [
+  {name = "Ernesto Alfonso", email = "erjoalgo@gmail.com"},
+]
+maintainers = [
+  {name = "Ernesto Alfonso", email = "erjoalgo@gmail.com"},
+]
+description = """Command line utility to manipulate PDF fields. It can list, rename, fill-in or delete PDF fields."""
+
+readme = "README.md"
+license = "GPL-3.0-or-later"
+keywords = ["pdf", "fields", "fill"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Programming Language :: Python"
+]
+
+[project.urls]
+Homepage = "https://github.com/erjoalgo/dotfiles/tree/master/bin/pdffill"
+Documentation = "https://github.com/erjoalgo/dotfiles/tree/master/bin/pdffill/README.md"
+Repository = "https://github.com/erjoalgo/dotfiles/tree/master/bin/pdffill"
+"Bug Tracker" = "https://github.com/erjoalgo/dotfiles/issues"
+
+[project.scripts]
+pdffill = "pdffill:main"
+
+[project.entry-points."pdffill.pdffill"]
+pdffill = "pdffill:pdffill"

pdffill-2026.6.19.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+