pdfmarker-watermark 2.0.0

Apply text and image watermarks to PDF files

PDFMarker

CLI para aplicar marcas de agua a PDFs (texto o imagen).

Install

pip install pdfmarker-watermark

El nombre de distribución en PyPI es pdfmarker-watermark; el paquete que se importa en Python continúa siendo pdfmarker.

CLI

pdfmarker-watermark

Ejemplo interactivo:

Enter base PDF path: sample.pdf
Watermark type (text/image): text
Enter watermark text: CONFIDENTIAL
✓ Watermark applied: sample_watermarked.pdf

Para marcas de agua de imagen:

Watermark type (text/image): image
Enter image path: logo.png
Image Scale Options:
  1. Small    (20%)
  2. Medium   (40%)
  3. Large    (60%)
  4. Original [default]
  5. Custom
Select scale (1-5) [4]: 2

Library

from pdfmarker.domain.models import Watermark, WatermarkStyle, WatermarkType
from pdfmarker.infrastructure.adapters import PDFRepository, ReportLabRenderer
from pdfmarker.application.services import WatermarkingServiceImpl

# Setup
service = WatermarkingServiceImpl(PDFRepository(), ReportLabRenderer())

# Text watermark
style = WatermarkStyle(opacity=0.5, rotation=30, size=36, font="Helvetica")
watermark = Watermark(type=WatermarkType.TEXT, content="DRAFT", style=style)
service.apply_watermark_to_pdf("input.pdf", watermark)

Options

Parameter	Type	Default
opacity	float	0.3
rotation	int	45
font	str	Helvetica
size	int	28

Image scale presets: Small (20%), Medium (40%), Large (60%), Original, Custom (5-100%)

Requirements

Python 3.10+ • Pillow 10+ • pypdf 5+ • ReportLab 4.0+

Para desarrollo local:

python -m pip install -e ".[dev]"
pytest tests/ -v

Architecture

graph TD
    subgraph "Domain Layer"
        WM[Watermark]
        PDF[PDFDocument]
        STYLE[WatermarkStyle]
    end

    subgraph "Application Layer"
        WS[WatermarkingService]
    end

    subgraph "Infrastructure"
        CLI[CLI Adapter]
        PDFR[PDFRepository - pypdf]
        RLR[ReportLabRenderer]
    end

    CLI --> WS
    WS --> PDFR
    WS --> RLR
    PDFR --> WM
    RLR --> WM

Hexagonal Architecture: domain → application → infrastructure

• Domain: pure business logic (0 deps)
• Application: ports + services
• Infrastructure: adapters (pypdf, ReportLab)

License

PDFMarker is distributed under the MIT License. It may be used, modified, and distributed in open-source or proprietary products, provided that the copyright and license notices are preserved.