Объединить PDF в один файл
Собирает несколько PDF в один документ, сохраняет порядок файлов и умеет добавить закладки.
Что делает скрипт
Скрипт принимает список PDF, проверяет каждый файл и последовательно добавляет страницы в итоговый документ. При включённом --bookmarks создаётся закладка на начало каждого исходника. Выходной файл не перезаписывается без флага --force.
Быстрый старт
python merge_pdfs.py -o result.pdf a.pdf b.pdf
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python merge_pdfs.py -o report.pdf january.pdf february.pdfpython merge_pdfs.py -o book.pdf part1.pdf part2.pdf --bookmarks --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
merge_pdfs.py
#!/usr/bin/env python3
"""Объединение нескольких PDF в один документ."""
from __future__ import annotations
import argparse
import sys
from pathlib import Path
from pypdf import PdfReader, PdfWriter
from pypdf.errors import PdfReadError
def parse_args() -> argparse.Namespace:
parser = argparse.ArgumentParser(description="Объединить PDF в один файл")
parser.add_argument("inputs", nargs="+", type=Path, help="Входные PDF-файлы")
parser.add_argument("-o", "--output", type=Path, required=True, help="Итоговый PDF")
parser.add_argument("--bookmarks", action="store_true", help="Добавить закладку на каждый файл")
parser.add_argument("--force", action="store_true", help="Перезаписать итоговый файл")
return parser.parse_args()
def main() -> int:
args = parse_args()
output = args.output.expanduser()
if output.suffix.lower() != ".pdf":
print("Итоговый файл должен иметь расширение .pdf", file=sys.stderr)
return 2
if output.exists() and not args.force:
print(f"Файл уже существует: {output}. Добавьте --force.", file=sys.stderr)
return 2
writer = PdfWriter()
total = 0
for item in args.inputs:
path = item.expanduser()
if not path.is_file():
print(f"Пропуск, файл не найден: {path}", file=sys.stderr)
continue
try:
reader = PdfReader(str(path))
start = total
for page in reader.pages:
writer.add_page(page)
total += 1
if args.bookmarks and total > start:
writer.add_outline_item(path.stem, start)
print(f"{path.name}: {len(reader.pages)} страниц")
except (PdfReadError, OSError, ValueError) as error:
print(f"Не удалось прочитать {path}: {error}", file=sys.stderr)
if total == 0:
print("Не добавлено ни одной страницы", file=sys.stderr)
return 1
output.parent.mkdir(parents=True, exist_ok=True)
with output.open("wb") as handle:
writer.write(handle)
print(f"Готово: {output} ({total} страниц)")
return 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.