pdf_stamp.py 5.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143
  1. #!/usr/bin/env python3
  2. """Stamp text or an image at coordinates onto selected PDF pages.
  3. Builds an in-memory single-page overlay with reportlab, then merges it
  4. onto each selected page with pypdf. Coordinates are PDF points, origin
  5. bottom-left. Covers 'sign here' arrows, diagonal DRAFT banners, and
  6. page-corner labels.
  7. Examples:
  8. pdf_stamp.py in.pdf -o out.pdf --text "DRAFT" --x 200 --y 400 \
  9. --font-size 60 --rotation 45 --opacity 0.3 --color "#cc0000"
  10. pdf_stamp.py in.pdf -o out.pdf --image sig.png --x 400 --y 60 \
  11. --width 120 --pages 3
  12. """
  13. from __future__ import annotations
  14. import argparse
  15. import io
  16. import json
  17. import sys
  18. def parse_pages(spec: str, page_count: int) -> list[int]:
  19. pages: set[int] = set()
  20. for part in spec.split(","):
  21. part = part.strip()
  22. if not part:
  23. continue
  24. if "-" in part:
  25. start_s, _, end_s = part.partition("-")
  26. start = int(start_s) if start_s else 1
  27. end = int(end_s) if end_s else page_count
  28. pages.update(range(start, end + 1))
  29. else:
  30. pages.add(int(part))
  31. bad = [p for p in pages if not 1 <= p <= page_count]
  32. if bad:
  33. raise ValueError(f"pages out of range 1-{page_count}: {sorted(bad)}")
  34. return sorted(pages)
  35. def build_overlay(args, page_width: float, page_height: float) -> bytes:
  36. from reportlab.lib.colors import HexColor
  37. from reportlab.pdfgen import canvas
  38. buf = io.BytesIO()
  39. c = canvas.Canvas(buf, pagesize=(page_width, page_height))
  40. c.saveState()
  41. try:
  42. c.setFillAlpha(float(args.opacity))
  43. c.setStrokeAlpha(float(args.opacity))
  44. except Exception:
  45. pass # very old reportlab: no alpha support
  46. c.translate(float(args.x), float(args.y))
  47. if args.rotation:
  48. c.rotate(float(args.rotation))
  49. if args.text:
  50. c.setFont(args.font, float(args.font_size))
  51. c.setFillColor(HexColor(args.color))
  52. c.drawString(0, 0, args.text)
  53. else:
  54. kwargs = {}
  55. if args.width:
  56. kwargs["width"] = float(args.width)
  57. if args.height:
  58. kwargs["height"] = float(args.height)
  59. if "width" in kwargs and "height" not in kwargs:
  60. from PIL import Image as PILImage
  61. with PILImage.open(args.image) as im:
  62. kwargs["height"] = kwargs["width"] * im.height / im.width
  63. c.drawImage(args.image, 0, 0, mask="auto", **kwargs)
  64. c.restoreState()
  65. c.save()
  66. return buf.getvalue()
  67. def main() -> int:
  68. for stream in (sys.stdout, sys.stderr):
  69. try:
  70. stream.reconfigure(encoding="utf-8")
  71. except Exception:
  72. pass
  73. parser = argparse.ArgumentParser(description="Stamp text or an image onto PDF pages.")
  74. parser.add_argument("pdf", help="Input PDF path")
  75. parser.add_argument("-o", "--output", required=True, help="Output PDF path")
  76. what = parser.add_mutually_exclusive_group(required=True)
  77. what.add_argument("--text", help="Text to stamp")
  78. what.add_argument("--image", help="Image file to stamp (PNG/JPEG)")
  79. parser.add_argument("--x", type=float, required=True, help="X in points (origin bottom-left)")
  80. parser.add_argument("--y", type=float, required=True, help="Y in points")
  81. parser.add_argument("--pages", default="1-", help="1-based ranges, e.g. '1-3,5' (default: all)")
  82. parser.add_argument("--font", default="Helvetica", help="Font name (default Helvetica)")
  83. parser.add_argument("--font-size", type=float, default=24, help="Font size in points")
  84. parser.add_argument("--color", default="#000000", help="Text color as #RRGGBB")
  85. parser.add_argument("--rotation", type=float, default=0, help="Degrees counterclockwise")
  86. parser.add_argument("--opacity", type=float, default=1.0, help="0.0-1.0 (default 1.0)")
  87. parser.add_argument("--width", type=float, help="Image width in points")
  88. parser.add_argument("--height", type=float, help="Image height in points")
  89. parser.add_argument("--under", action="store_true",
  90. help="Place the stamp under existing content instead of over it")
  91. parser.add_argument("--password", help="Password if the input is encrypted")
  92. args = parser.parse_args()
  93. try:
  94. from pypdf import PdfReader, PdfWriter
  95. except ImportError:
  96. print("Missing dependency: 'pypdf reportlab' is not importable here; rerun with the documents interpreter $PY from the pdf skill's Prerequisites setup block",
  97. file=sys.stderr)
  98. return 2
  99. reader = PdfReader(args.pdf)
  100. if reader.is_encrypted:
  101. if args.password is None or not reader.decrypt(args.password):
  102. print("Error: input is encrypted; pass --password", file=sys.stderr)
  103. return 3
  104. try:
  105. pages = set(parse_pages(args.pages, len(reader.pages)))
  106. except ValueError as exc:
  107. print(f"Error: {exc}", file=sys.stderr)
  108. return 4
  109. writer = PdfWriter()
  110. overlay_cache: dict[tuple[float, float], object] = {}
  111. for idx, page in enumerate(reader.pages, start=1):
  112. if idx in pages:
  113. size = (float(page.mediabox.width), float(page.mediabox.height))
  114. if size not in overlay_cache:
  115. overlay_pdf = PdfReader(io.BytesIO(build_overlay(args, *size)))
  116. overlay_cache[size] = overlay_pdf.pages[0]
  117. stamp = overlay_cache[size]
  118. if args.under:
  119. page.merge_page(stamp, over=False)
  120. else:
  121. page.merge_page(stamp)
  122. writer.add_page(page)
  123. with open(args.output, "wb") as fh:
  124. writer.write(fh)
  125. print(json.dumps({"output": args.output, "stamped_pages": sorted(pages),
  126. "kind": "text" if args.text else "image"}, ensure_ascii=False))
  127. return 0
  128. if __name__ == "__main__":
  129. sys.exit(main())