Заполнить PDF-форму
Показывает поля AcroForm и записывает значения из пар key=value в новую копию.
Что делает скрипт
Без флага --set скрипт выводит список полей, их типы и текущие значения. С флагом --set он заполняет форму и сохраняет отдельный PDF. Неизвестные ключи пропускаются с предупреждением, поэтому опечатка не испортит документ молча.
- Проверьте названия полей и значения флажков: для галочки часто нужно /Yes.
Быстрый старт
python fill_pdf_form.py form.pdf
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python fill_pdf_form.py form.pdf --set name=user --set city=demopython fill_pdf_form.py form.pdf --set agree=/Yes --outdir filled --force
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
py -m pip install pypdf
python3 -m pip install pypdf
python3 -m pip install pypdf
fill_pdf_form.py
#!/usr/bin/env python3
"""Просмотр и заполнение полей PDF-формы."""
from __future__ import annotations
import argparse
import json
import sys
from pathlib import Path
from pypdf import PdfReader, PdfWriter
from pypdf.errors import PdfReadError
def main() -> int:
parser = argparse.ArgumentParser(description="Заполнить PDF-форму")
parser.add_argument("input", type=Path, help="Исходный PDF с формой")
parser.add_argument("--set", action="append", default=[], metavar="KEY=VALUE", help="Значение поля")
parser.add_argument("--password", help="Пароль PDF")
parser.add_argument("--json", type=Path, help="Сохранить список полей в JSON")
parser.add_argument("--outdir", type=Path, default=Path("filled"), help="Папка результатов")
parser.add_argument("--force", action="store_true", help="Перезаписать результат")
args = parser.parse_args()
path = args.input.expanduser()
if not path.is_file():
print(f"Файл не найден: {path}", file=sys.stderr)
return 2
try:
reader = PdfReader(str(path))
if reader.is_encrypted and not reader.decrypt(args.password or ""):
print("Неверный пароль", file=sys.stderr)
return 2
fields = reader.get_fields() or {}
except (PdfReadError, OSError, ValueError) as error:
print(f"Не удалось прочитать PDF: {error}", file=sys.stderr)
return 1
rows = []
for name, field in fields.items():
rows.append(
{
"name": name,
"type": str(field.get("/FT", "")),
"value": str(field.get("/V", "")),
"options": [str(item) for item in field.get("/Opt", [])] if field.get("/Opt") else [],
}
)
if args.json:
target = args.json.expanduser()
target.parent.mkdir(parents=True, exist_ok=True)
target.write_text(json.dumps(rows, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
print(f"Список полей сохранён: {target}")
if not rows:
print("В PDF нет полей AcroForm")
return 1
print(f"Полей: {len(rows)}")
for row in rows:
options = f", варианты: {row['options']}" if row["options"] else ""
print(f"{row['name']} [{row['type']}] = {row['value']}{options}")
if not args.set:
print("Для заполнения добавьте --set key=value")
return 0
values: dict[str, str] = {}
for pair in args.set:
if "=" not in pair:
print(f"Пропуск, нужен формат key=value: {pair}", file=sys.stderr)
continue
key, value = pair.split("=", 1)
key = key.strip()
if key not in fields:
print(f"Поле не найдено, пропуск: {key}", file=sys.stderr)
continue
values[key] = value
if not values:
print("Не задано ни одного корректного значения", file=sys.stderr)
return 2
target = args.outdir.expanduser() / f"{path.stem}_filled.pdf"
if target.exists() and not args.force:
print(f"Файл уже существует: {target}. Добавьте --force.", file=sys.stderr)
return 2
try:
writer = PdfWriter()
writer.append(reader)
try:
writer.update_page_form_field_values(None, values, auto_regenerate=False)
except TypeError:
for page in writer.pages:
writer.update_page_form_field_values(page, values, auto_regenerate=False)
try:
writer.set_need_appearances_writer(True)
except AttributeError:
pass
target.parent.mkdir(parents=True, exist_ok=True)
with target.open("wb") as handle:
writer.write(handle)
except (PdfReadError, OSError, ValueError) as error:
print(f"Не удалось заполнить форму: {error}", file=sys.stderr)
return 1
print(f"Готово: {target}, заполнено полей: {len(values)}")
return 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.