Python

pip install rustpdf

import rustpdf
print(rustpdf.version())          # native library version
print(rustpdf.library_path())     # which .dylib/.so/.dll was loaded

import rustpdf

with rustpdf.Document() as doc:          # A4 by default
    doc.add_page()
    doc.set_fill_rgb(0.86, 0.20, 0.18)
    doc.rect(72, 640, 200, 120)          # x, y, width, height (points)
    doc.fill()
    doc.save("out.pdf")

with rustpdf.Document() as doc:
    font = doc.add_font_file("Roboto-Regular.ttf")
    (doc.add_page()
        .set_fill_rgb(0.1, 0.1, 0.12)
        .rect(0, 800, 595, 42).fill()
        .show_text(font, 24, 72, 740, "Olá, açúcar — café"))
    data = doc.to_bytes()                # in-memory bytes instead of a file

export RUSTPDF_LICENSE="010f0000…"           # the token we email you
# or point at a file:
export RUSTPDF_LICENSE_FILE=/etc/rustpdf/license.txt

rustpdf.activate_license(token)   # raises PdfError if forged / expired / malformed

from concurrent.futures import ThreadPoolExecutor
import rustpdf

def render(i: int) -> bytes:
    with rustpdf.Document() as doc:          # one document per task
        doc.add_page()
        doc.set_fill_rgb(0.1, 0.1, 0.12)
        doc.rect(72, 700, 200, 80).fill()
        return doc.to_bytes()

with ThreadPoolExecutor(max_workers=8) as pool:
    pdfs = list(pool.map(render, range(100)))   # 100 PDFs built concurrently

with rustpdf.Document() as doc:
    doc.add_page()
    doc.set_stroke_rgb(0.10, 0.45, 0.90).set_line_width(3)
    doc.rect(72, 600, 300, 160).stroke()
    doc.set_fill_rgb(0.95, 0.77, 0.06)
    doc.rect(120, 640, 120, 80).fill()
    doc.save("shapes.pdf")

with rustpdf.Document() as doc:
    regular = doc.add_font_file("Roboto-Regular.ttf")
    # …or from bytes you already have in memory:
    # regular = doc.add_font(open("Roboto-Regular.ttf", "rb").read())

    doc.add_page()
    doc.show_text(regular, 28, 72, 760, "Invoice #1024")
    doc.show_text(regular, 12, 72, 720, "日本語 · Ελληνικά · العربية")
    doc.save("text.pdf")

from rustpdf import Document, Align

intro = ("A long paragraph that wraps to the given width and is justified "
         "automatically; extra space is distributed between words.")

with Document() as doc:
    f = doc.add_font_file("Roboto-Regular.ttf")
    doc.add_page()
    doc.paragraph(f, 12, 72, 700, 451, intro, align=Align.JUSTIFY)
    doc.save("paragraph.pdf")

with rustpdf.Document() as doc:
    logo = doc.add_image_file("logo.png")
    doc.add_page()
    doc.draw_image(logo, 72, 680, 160, 90)
    doc.save("with_image.pdf")

from rustpdf import Document, PdfaLevel

with Document() as doc:
    doc.pdfa(PdfaLevel.A2B).set_info(title="Q3 Report", author="Acme Inc.")
    f = doc.add_font_file("Roboto-Regular.ttf")
    doc.add_page()
    doc.show_text(f, 20, 72, 760, "Archival report")
    doc.save("report_pdfa.pdf")     # raises PdfError without a license granting PDF/A

from rustpdf import Document, PdfaLevel

with Document() as doc:
    doc.pdfa(PdfaLevel.A2A).tagged().set_info(title="Accessible report")
    f = doc.add_font_file("Roboto-Regular.ttf")
    doc.add_page()
    doc.show_text(f, 26, 72, 760, "Annual report", heading_level=1)
    doc.show_text(f, 14, 72, 720, "Overview", heading_level=2)
    doc.show_text(f, 11, 72, 690, "Body paragraph of the section…")
    chart = doc.add_image_file("chart.png")
    doc.figure(chart, 72, 520, 300, 150, alt="Revenue grew 18% year over year")
    doc.save("accessible.pdf")

from rustpdf import Document, PdfaLevel, AFRelationship

xml = open("invoice.xml", "rb").read()
with Document() as doc:
    doc.pdfa(PdfaLevel.A3B).set_info(title="E-invoice 1024")
    f = doc.add_font_file("Roboto-Regular.ttf")
    doc.add_page()
    doc.show_text(f, 18, 72, 760, "Invoice 1024")
    doc.attach_file("invoice.xml", "text/xml", xml,
                    AFRelationship.SOURCE, "Structured invoice data")
    doc.save("einvoice.pdf")

from rustpdf import Document, FacturxProfile

xml = open("factur-x.xml", "rb").read()         # your Cross-Industry Invoice XML
with Document() as doc:
    doc.set_info(title="Invoice INV-2026-001")
    f = doc.add_font_file("Roboto-Regular.ttf")
    doc.add_page()
    doc.show_text(f, 18, 72, 760, "Invoice INV-2026-001")
    doc.facturx(xml, FacturxProfile.EN16931)
    doc.save("einvoice.pdf")        # PDF/A-3 + Factur-X; needs a PDF/A license

with rustpdf.Document() as doc:
    doc.add_page()
    doc.text_field("applicant.name", 0, (72, 700, 320, 720), value="")
    doc.checkbox("agree", 0, (72, 660, 88, 676), checked=False)
    doc.dropdown("plan", 0, (72, 620, 240, 640),
                 ["Starter", "Pro", "Enterprise"], selected=1)
    doc.radio_group("billing", 0, [
        ((72, 580, 88, 596), "monthly"),
        ((140, 580, 156, 596), "annual"),
    ], selected=1)
    doc.save("form.pdf")

with rustpdf.Document() as doc:
    f = doc.add_font_file("Roboto-Regular.ttf")
    doc.add_page()
    doc.show_text(f, 14, 72, 760, "Visit rustpdf.dev (see page 2)")
    doc.link_uri((72, 756, 320, 776), "https://rustpdf.dev/")   # web link
    doc.link_to_page((330, 756, 430, 776), 1, top=800)          # jump to page 2
    doc.add_page()
    doc.save("links.pdf")

from rustpdf import Document, Bookmark

with Document() as doc:
    f = doc.add_font_file("Roboto-Regular.ttf")
    for _ in range(3):
        doc.add_page()
    doc.add_bookmark(
        Bookmark("Chapter 1", 0, top=820)
            .child(Bookmark("Section 1.1", 1))
            .child(Bookmark("Section 1.2", 2)))
    doc.add_bookmark(Bookmark("Chapter 2", 2))
    doc.save("outline.pdf")

doc.set_info(title="Q3 Report", author="Acme Inc.",
             subject="Quarterly results", keywords="finance, q3")

from rustpdf import EditableDoc

with EditableDoc.load_file("in.pdf") as ed:
    print(ed.page_count)

# encrypted input:
with EditableDoc.load_file("secured.pdf", password="user-or-owner-pw") as ed:
    ed.save("plain.pdf")

with EditableDoc.load_file("a.pdf") as a, EditableDoc.load_file("b.pdf") as b:
    a.merge(b)                       # a now has a's pages followed by b's
    a.rotate_page(0, 90)
    a.reorder_pages(list(reversed(range(a.page_count))))
    a.save("merged.pdf")

with EditableDoc.load_file("merged.pdf") as doc:
    with doc.extract_pages([0, 2]) as subset:   # pages 1 and 3
        subset.save("subset.pdf")

with EditableDoc.load_file("form.pdf") as ed:
    ed.set_info("Title", "Filled form")
    found = ed.fill_text_field("applicant.name", "Jane Doe")
    print("filled:", found, "| title:", ed.get_info("Title"))
    ed.save("filled.pdf")

from rustpdf import EditableDoc

with EditableDoc.load_file("form.pdf") as ed:
    print(ed.field_names())              # ['applicant.name', 'agree', 'plan', ...]
    ed.fill_text_field("applicant.name", "Jane Doe")
    ed.set_checkbox("agree", True)
    ed.set_radio("billing", "annual")
    ed.set_choice("plan", "Pro")
    ed.flatten_forms()                  # optional: make it non-editable
    ed.save("filled.pdf")

with EditableDoc.load_file("report.pdf") as ed:
    ed.watermark_text("CONFIDENTIAL", opacity=0.25, rotation_deg=45)
    ed.save("stamped.pdf")

with EditableDoc.load_file("statement.pdf") as ed:
    # rects = list of (x0, y0, x1, y1) on that page
    ed.redact(0, [(60, 590, 400, 620), (60, 540, 400, 570)])
    ed.save("redacted.pdf")     # raises PdfError without a license granting redaction

from rustpdf import EditableDoc, PdfaLevel

with EditableDoc.load_file("in.pdf") as ed:
    ed.convert_to_pdfa(PdfaLevel.A2B)   # raises PdfError if fonts aren't embedded
    ed.save("archival.pdf")             # veraPDF: PDF/A-2b compliant

with EditableDoc.load_file("big.pdf") as ed:
    ed.optimize().compact(True)
    ed.save("small.pdf")

from rustpdf import EditableDoc, Encryption

with EditableDoc.load_file("in.pdf") as ed:
    ed.encrypt(user="", owner="owner-secret",
               method=Encryption.AES256, read_only=True)
    ed.save("secured.pdf")          # raises PdfError without an Encryption license

original = open("in.pdf", "rb").read()
with EditableDoc.load(original) as ed:
    ed.set_info("Subject", "reviewed")
    incremental = ed.to_bytes_incremental(original)   # original bytes preserved verbatim
open("reviewed.pdf", "wb").write(incremental)

import rustpdf

pdf_bytes = open("contract.pdf", "rb").read()
key_der   = open("signing-key.pkcs8.der", "rb").read()   # PKCS#8 private key (DER)
cert_der  = open("signing-cert.der", "rb").read()        # X.509 certificate (DER)

signed = rustpdf.sign(pdf_bytes, key_der, cert_der,
                      reason="Approved", location="New York",
                      name="Jane Doe", pades=True)
open("contract.signed.pdf", "wb").write(signed)
# Verify in a shell: pdfsig contract.signed.pdf  →  "Signature is Valid."

signed = open("contract.signed.pdf", "rb").read()

# B-LT: embed validation material (caller supplies DER certs/CRLs)
lt = rustpdf.add_dss(signed, certs=[cert_der], crls=[crl_der])

# B-LTA: add a document timestamp signed by a TSA key/cert
lta = rustpdf.timestamp(lt, tsa_key_der, tsa_cert_der)
open("contract.lta.pdf", "wb").write(lta)

data = open("contract.signed.pdf", "rb").read()
for sig in rustpdf.verify_signatures(data):
    print(sig["signer"], "valid:", sig["is_valid"],
          "covers whole doc:", sig["covers_whole_document"])

data = open("report.pdf", "rb").read()
print(rustpdf.extract_text(data))

n = rustpdf.extract_images_to_dir(data, "out_images/")   # returns how many were written
print(f"wrote {n} image(s)")

data = open("report.pdf", "rb").read()
print(f"{rustpdf.page_count(data)} page(s)")
png = rustpdf.render_page_to_png(data, page=0, dpi=150.0)
open("page1.png", "wb").write(png)

from rustpdf import Document, PdfError

try:
    with Document() as doc:
        doc.pdfa().set_info(title="x")
        doc.add_page()
        doc.save("out.pdf")
except PdfError as e:
    print("failed:", e)        # e.g. PdfStatus=7: feature 'pdfa' requires a valid license