Ruby

gem install rustpdf
# or in a Gemfile:
#   gem "rustpdf"

require "rustpdf"
puts RustPdf.version   # native library version

require "rustpdf"

doc = RustPdf::Document.new          # A4 by default
doc.add_page
   .fill_rgb(0.86, 0.20, 0.18)
   .rect(72, 640, 200, 120)          # x, y, width, height (points)
   .fill
doc.save("out.pdf")
doc.close

doc = RustPdf::Document.new
font = doc.add_font_file("Roboto-Regular.ttf")
doc.add_page
   .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                  # a String of bytes instead of a file
doc.close

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 RustPdf::Error if forged / expired / malformed

doc = RustPdf::Document.new
doc.add_page
   .stroke_rgb(0.10, 0.45, 0.90).line_width(3)
   .rect(72, 600, 300, 160).stroke
   .fill_rgb(0.95, 0.77, 0.06)
   .rect(120, 640, 120, 80).fill
doc.save("shapes.pdf")
doc.close

doc = RustPdf::Document.new
regular = doc.add_font_file("Roboto-Regular.ttf")
# …or from bytes you already have in memory:
# regular = doc.add_font(File.binread("Roboto-Regular.ttf"))

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

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

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

doc = RustPdf::Document.new
logo = doc.add_image_file("logo.png")
doc.add_page.draw_image(logo, 72, 680, 160, 90)
doc.save("with_image.pdf")
doc.close

doc = RustPdf::Document.new
doc.pdfa(RustPdf::Pdfa::A2B).info(title: "Q3 Report", author: "Acme Inc.")
f = doc.add_font_file("Roboto-Regular.ttf")
doc.add_page.show_text(f, 20, 72, 760, "Archival report")
doc.save("report_pdfa.pdf")     # raises RustPdf::Error without a license granting PDF/A
doc.close

doc = RustPdf::Document.new
doc.pdfa(RustPdf::Pdfa::A2A).tagged.info(title: "Accessible report")
f = doc.add_font_file("Roboto-Regular.ttf")
doc.add_page
   .show_text(f, 26, 72, 760, "Annual report", heading_level: 1)   # H1
   .show_text(f, 14, 72, 720, "Overview", heading_level: 2)         # H2
   .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, "Revenue grew 18% year over year")
doc.save("accessible.pdf")
doc.close

xml = File.binread("invoice.xml")
doc = RustPdf::Document.new
doc.pdfa(RustPdf::Pdfa::A3B).info(title: "E-invoice 1024")
f = doc.add_font_file("Roboto-Regular.ttf")
doc.add_page.show_text(f, 18, 72, 760, "Invoice 1024")
doc.attach_file("invoice.xml", "text/xml", xml,
                relationship: RustPdf::Relationship::SOURCE,
                description: "Structured invoice data")
doc.save("einvoice.pdf")
doc.close

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

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

ed = RustPdf::EditableDoc.load_file("in.pdf")
puts ed.page_count
ed.close

# encrypted input:
sec = RustPdf::EditableDoc.load_file("secured.pdf", password: "user-or-owner-pw")
sec.save("plain.pdf")
sec.close

a = RustPdf::EditableDoc.load_file("a.pdf")
b = RustPdf::EditableDoc.load_file("b.pdf")
a.merge(b)                          # a now has a's pages followed by b's
a.rotate_page(0, 90)
a.reorder_pages((0...a.page_count).to_a.reverse)
a.save("merged.pdf")
b.close

subset = a.extract_pages([0, 2])    # pages 1 and 3
subset.save("subset.pdf")
subset.close
a.close

ed = RustPdf::EditableDoc.load_file("form.pdf")
ed.set_info("Title", "Filled form")
found = ed.fill_text_field("applicant.name", "Jane Doe")
puts "filled: #{found} | title: #{ed.get_info('Title')}"
ed.save("filled.pdf")
ed.close

ed = RustPdf::EditableDoc.load_file("big.pdf")
ed.optimize.compact(true)
ed.save("small.pdf")
ed.close

ed = RustPdf::EditableDoc.load_file("in.pdf")
ed.encrypt(method: RustPdf::Cipher::AES256, owner: "owner-secret", read_only: true)
ed.save("secured.pdf")          # raises RustPdf::Error without an Encryption license
ed.close

original = File.binread("in.pdf")
ed = RustPdf::EditableDoc.load(original)
ed.set_info("Subject", "reviewed")
incremental = ed.to_bytes_incremental(original)   # original bytes preserved verbatim
File.binwrite("reviewed.pdf", incremental)
ed.close

pdf      = File.binread("contract.pdf")
key_der  = File.binread("signing-key.pkcs8.der")   # PKCS#8 private key (DER)
cert_der = File.binread("signing-cert.der")        # X.509 certificate (DER)

signed = RustPdf.sign(pdf, key_der, cert_der,
                      reason: "Approved", location: "New York",
                      name: "Jane Doe", pades: true)
File.binwrite("contract.signed.pdf", signed)
# Verify in a shell: pdfsig contract.signed.pdf  →  "Signature is Valid."

signed = File.binread("contract.signed.pdf")

# 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)
File.binwrite("contract.lta.pdf", lta)

data = File.binread("report.pdf")
puts RustPdf.extract_text(data)

begin
  doc = RustPdf::Document.new
  doc.pdfa.info(title: "x")
  doc.add_page
  doc.save("out.pdf")
  doc.close
rescue RustPdf::Error => e
  warn "failed: #{e.status} #{e.message}"
  # e.g. PdfStatus=7: feature 'pdfa' requires a valid license
end