RustPdf 0.4.3

RustPdf (.NET binding)

Idiomatic C#/.NET binding for the rust-pdf core over its C ABI (libpdf_ffi), using source-generated P/Invoke (LibraryImport). It mirrors the full product surface: vector graphics, embedded/subsetted fonts and text, wrapping paragraphs, images, PDF/A (levels 1b–3a), tagged/accessible output, embedded-file attachments, AcroForm fields, manipulation (merge/split/rotate/optimize/incremental update), text extraction, page rendering (page to PNG image), encryption (RC4 / AES-128 / AES-256) and digital signatures (PKCS#7 / PAdES) — plus feature licensing.

Layout:

• RustPdf/Native.cs — raw P/Invoke (1:1 with include/pdf.h) + a native-library resolver;
• RustPdf/Document.cs, EditableDoc.cs — IDisposable wrappers with fluent, exception-based APIs;
• RustPdf/Pdf.cs — static helpers (Version, ActivateLicense, ExtractText, Sign, Timestamp, AddDss) and the PdfaLevel / Align / AFRelationship / Encryption enums.

Install

dotnet add package RustPdf

The NuGet package bundles the native libpdf_ffi for every supported runtime (osx-arm64, linux-x64, linux-arm64, win-x64) under runtimes/<rid>/native/. .NET's runtime resolves the matching one automatically — no native build, no extra setup.

Loading the native library

For a published package the native lib is resolved from the package's runtimes/<rid>/native/ (the standard NuGet RID-asset convention). For local development against the repo build tree, Native.cs falls back to resolving libpdf_ffi in this order:

1. RUSTPDF_LIB (explicit path);
2. by walking up from the assembly directory looking for target/{debug,release}/libpdf_ffi.* (local build tree);
3. the platform default search path (e.g. a library shipped next to the app).

Build it from the repo root with cargo build -p pdf-ffi.

Distribution

Published to NuGet.org as the single package RustPdf that carries all four platforms' cdylibs. CI (.github/workflows/release-csharp.yml, trigger csharp-v*) fans out one build job per RID (Linux in manylinux_2_28, macOS arm64, Windows x64 — all with the production license pubkey), then a pack job stages each lib into runtimes/<rid>/native/, runs dotnet pack, and pushes via NuGet Trusted Publishing (OIDC — no long-lived API key). A free-surface smoke (bindings/csharp/Smoke) verifies each platform's lib loads.

Quick start

using RustPdf;

// A token via the RUSTPDF_LICENSE env var is auto-activated; or:
Pdf.ActivateLicense(token);

using (var doc = new Document())
{
    doc.Pdfa(PdfaLevel.A2a).SetInfo(title: "Report", author: "me");
    int f = doc.AddFontFile("assets/fonts/Roboto-Regular.ttf");
    doc.AddPage();
    doc.ShowText(f, 20, 72, 760, "Title", headingLevel: 1);
    doc.Paragraph(f, 12, 72, 720, 450, "A wrapping, justified body…", Align.Justify);
    byte[] data = doc.ToBytes();

    Console.WriteLine(Pdf.ExtractText(data));

    using var ed = EditableDoc.Load(data);     // manipulate + encrypt
    ed.SetInfo("Subject", "Edited");
    ed.Encrypt(owner: "owner", method: Encryption.Aes256);
    ed.Save("secured.pdf");

    byte[] signed = Pdf.Sign(data, keyDer, certDer, reason: "Approved", pades: true);
}

Corporate features (PDF/A, signing, encryption, accessibility, page rendering) require a license; without one they throw PdfException. Page rendering is a Pro feature. See docs/LICENSING.md.

Build & run the sample

cargo build -p pdf-ffi
dotnet run --project bindings/csharp/Sample          # exercises the whole surface

Targets net8.0 (works on .NET 8+); the source-generated P/Invoke needs C# 11+.