Офис и PDF

Заполнить PDF-форму

Показывает поля AcroForm и записывает значения из пар key=value в новую копию.

Python Windows macOS Linux Продвинутый
Скачать fill_pdf_form.py
Описание

Что делает скрипт

Без флага --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=demo
  • python fill_pdf_form.py form.pdf --set agree=/Yes --outdir filled --force
Зависимости

Что понадобится

Python 3.10+ Интерпретатор и стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
pypdf
Windows py -m pip install pypdf
macOS python3 -m pip install pypdf
Linux 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())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get office-pdf-forms
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Офис и PDF

PDF, Word, Excel, презентации, документы и печать.