minipdf-cli-0.1.0 is not a library.

MiniPdf Rust

This directory contains the experimental Rust implementation of MiniPdf. It is an independent Rust workspace with a reusable minipdf library crate and a minipdf CLI binary.

The first implementation focuses on proving the end-to-end shape: detect .xlsx and .docx ZIP packages, extract basic workbook/document text, render simple PDF pages, and keep the CLI close to the existing .NET tool.

Install

cargo add minipdf
cargo install minipdf-cli

Rust packages are published to crates.io, not NuGet. Repository releases tagged rust-v<version> publish both packages through GitHub Actions.

Layout

minipdf-rs/
├── Cargo.toml
└── crates/
    ├── minipdf/       # Library API and conversion engine
    └── minipdf-cli/   # CLI binary named minipdf

Commands

cd minipdf-rs
cargo fmt --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
cargo run -p minipdf-cli -- convert path\to\input.xlsx -o output.pdf
cargo run -p minipdf-cli -- path\to\input.docx

Run the shared visual fixtures against LibreOffice from the repository root:

.\scripts\Run-Rust-Benchmark.ps1 -Suite classic -Format xlsx
.\scripts\Run-Rust-Benchmark.ps1 -Suite classic -Format docx
.\scripts\Run-Rust-Benchmark.ps1 -Suite issue -Format xlsx
.\scripts\Run-Rust-Benchmark.ps1 -Suite issue -Format docx
.\scripts\Run-Rust-Benchmark-Matrix.ps1 -MaxComparePages 1

The benchmark reuses the same on-disk fixtures, references, and PDF comparison pipeline as the .NET visual benchmarks. It does not execute the C# xUnit test methods or their assertions. Each run writes a coverage manifest, Markdown/JSON report, side-by-side images, and pixel-difference heatmaps under artifacts/rust-benchmark/<suite>/<format> and fails on missing output or scores below -MinimumScore.

Current Scope

Supports .xlsx and .docx package detection.
Extracts shared strings and basic worksheet cell values from .xlsx.
Extracts paragraph text from .docx.
Writes valid PDF 1.4 files using built-in Helvetica fonts.
Renders basic unstyled XLSX sheets with spreadsheet-compatible page geometry, text overflow, and General-format numeric alignment.
Supports the existing CLI shape: shorthand input, convert, -o/--output, and --fonts.

Known Gaps