ironpress 1.4.1__tar.gz

ironpress-1.4.1/.gitignore

@@ -0,0 +1,12 @@
+/target
+Cargo.lock
+.claude/
+.DS_Store
+docs/
+examples/
+fuzz/corpus/
+fuzz/artifacts/
+fuzz/target/
+tests/fixtures/references/**/*.png
+bindings/python/target/
+bindings/ruby/target/

ironpress-1.4.1/CONTRIBUTING.md

@@ -0,0 +1,28 @@
+# Contributing to ironpress
+
+Thanks for your interest in contributing!
+
+## Getting Started
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b my-feature`
+3. Make your changes
+4. Run the checks:
+   ```bash
+   cargo fmt --check
+   cargo clippy -- -D warnings
+   cargo test
+   ```
+5. Commit and push your branch
+6. Open a pull request against `main`
+
+## Guidelines
+
+- All code must pass `cargo fmt`, `cargo clippy -- -D warnings`, and `cargo test`
+- Add tests for new functionality
+- Keep PRs focused on a single change
+- Follow existing code style and conventions
+
+## Reporting Issues
+
+Open an issue on GitHub with a clear description and, if possible, a minimal reproduction.

ironpress-1.4.1/Cargo.toml

@@ -0,0 +1,56 @@
+[package]
+name = "ironpress"
+version = "1.4.1"
+edition = "2024"
+rust-version = "1.85"
+description = "Pure Rust HTML/CSS/Markdown to PDF converter with layout engine, LaTeX math, tables, images, custom fonts, and streaming output. No browser, no system dependencies."
+license = "MIT"
+repository = "https://github.com/gastongouron/ironpress"
+documentation = "https://docs.rs/ironpress"
+readme = "README.md"
+keywords = ["pdf", "html", "css", "markdown", "converter"]
+categories = ["text-processing", "encoding", "template-engine"]
+exclude = [".github/", ".claude/", "target/", "docs/"]
+
+[lib]
+crate-type = ["cdylib", "rlib"]
+
+[[bin]]
+name = "ironpress"
+path = "src/bin/cli.rs"
+
+[features]
+default = []
+async = ["tokio"]
+remote = ["ureq"]
+wasm = ["wasm-bindgen", "js-sys", "getrandom/wasm_js"]
+
+[dependencies]
+html5ever = "0.38"
+lightningcss = { version = "1.0.0-alpha.71", default-features = false }
+image = { version = "0.25", default-features = false, features = ["jpeg", "png"] }
+png_decoder = { package = "png", version = "0.18" }
+pulldown-cmark = "0.13"
+markup5ever_rcdom = "0.38"
+fontdb = "0.23"
+flate2 = "1"
+resvg = "0.47"
+rustybuzz = "0.20"
+subsetter = "0.2.3"
+thiserror = "2"
+tokio = { version = "1", features = ["fs", "rt"], optional = true }
+ureq = { version = "3", optional = true }
+wasm-bindgen = { version = "0.2", optional = true }
+js-sys = { version = "0.3", optional = true }
+getrandom = { version = "0.3", optional = true }
+unicode-bidi = "0.3.18"
+
+[dev-dependencies]
+tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
+proptest = "1"
+criterion = { version = "0.5", features = ["html_reports"] }
+serde_json = "1"
+
+[[bench]]
+name = "conversion"
+harness = false

ironpress-1.4.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gaston Gouron
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ironpress-1.4.1/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: ironpress
+Version: 1.4.1
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Summary: Pure Rust HTML/CSS/Markdown to PDF converter. No browser, no system dependencies.
+Keywords: pdf,html,css,markdown,converter
+License-Expression: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/gastongouron/ironpress
+Project-URL: Repository, https://github.com/gastongouron/ironpress
+
+# ironpress
+
+Pure Rust HTML/CSS/Markdown to PDF converter. No browser, no system dependencies.
+
+## Installation
+
+```bash
+pip install ironpress
+```
+
+## Quick Start
+
+```python
+import ironpress
+
+# Simple conversion
+pdf = ironpress.html_to_pdf("<h1>Hello World</h1><p>Generated with ironpress.</p>")
+with open("output.pdf", "wb") as f:
+    f.write(pdf)
+
+# Markdown
+pdf = ironpress.markdown_to_pdf("# Hello\n\nGenerated from **Markdown**.")
+
+# Advanced options
+converter = ironpress.HtmlConverter()
+converter.page_size("Letter")
+converter.landscape(True)
+converter.margin(36.0)  # 0.5 inch margins
+pdf = converter.convert("<h1>Landscape PDF</h1>")
+```
+
+## API
+
+### `html_to_pdf(html: str) -> bytes`
+Convert an HTML string to PDF bytes.
+
+### `markdown_to_pdf(markdown: str) -> bytes`
+Convert a Markdown string to PDF bytes.
+
+### `HtmlConverter`
+Configurable converter with options:
+- `page_size(name)` — `"A4"`, `"Letter"`, or `"Legal"`
+- `landscape(enabled)` — landscape orientation
+- `margin(points)` — uniform margin in points (72 points = 1 inch)
+- `convert(html)` → PDF bytes
+- `convert_markdown(markdown)` → PDF bytes
+
+## Performance
+
+- **10-100x faster** than browser-based solutions (Puppeteer, Playwright)
+- **~5MB** binary, no runtime dependencies
+- Instant startup, no browser process
+

ironpress-1.4.1/README.md

@@ -0,0 +1,149 @@
+
+<div align="center">
+
+<img width="188" alt="4" src="https://github.com/user-attachments/assets/e8b569e6-e74c-4c0f-9e84-05cf37fae3ae" />
+
+# Ironpress
+
+Pure rust HTML/CSS/Markdown to PDF converter. No browser, no system dependencies.
+
+
+[![Crates.io](https://img.shields.io/crates/v/ironpress.svg)](https://crates.io/crates/ironpress)
+[![PyPI](https://img.shields.io/pypi/v/ironpress.svg)](https://pypi.org/project/ironpress/)
+[![Gem](https://img.shields.io/gem/v/ironpress.svg)](https://rubygems.org/gems/ironpress)
+[![npm](https://img.shields.io/npm/v/ironpress.svg)](https://www.npmjs.com/package/ironpress)
+[![docs.rs](https://docs.rs/ironpress/badge.svg)](https://docs.rs/ironpress)
+[![CI](https://github.com/gastongouron/ironpress/actions/workflows/ci.yml/badge.svg)](https://github.com/gastongouron/ironpress/actions)
+[![codecov](https://codecov.io/gh/gastongouron/ironpress/branch/main/graph/badge.svg?token=w36XIAwRxG)](https://codecov.io/gh/gastongouron/ironpress)
+[![deps.rs](https://deps.rs/repo/github/gastongouron/ironpress/status.svg)](https://deps.rs/repo/github/gastongouron/ironpress)
+[![MSRV](https://img.shields.io/badge/MSRV-1.85-blue.svg)](https://www.rust-lang.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Downloads](https://img.shields.io/crates/d/ironpress.svg)](https://crates.io/crates/ironpress)
+[![WASM](https://img.shields.io/badge/wasm-ready-blueviolet.svg)](../../wiki/WASM-Playground)
+[![Playground](https://img.shields.io/badge/try_it-playground-blueviolet.svg)](https://gastongouron.github.io/ironpress/)
+[![Parity](https://img.shields.io/badge/parity-dashboard-ff69b4.svg)](https://gastongouron.github.io/ironpress/parity/)
+
+**[Try it in your browser](https://gastongouron.github.io/ironpress/)** | **[Parity dashboard](https://gastongouron.github.io/ironpress/parity/)** | **[Wiki](../../wiki)**
+
+</div>
+
+
+## Performance
+
+<!-- AUTO:BENCH - updated by CI -->
+| Document | Time | Pages/sec |
+|----------|------|-----------|
+| Simple HTML (`<h1>` + `<p>`) | **16 us** | 62,500 |
+| Styled HTML (CSS, lists, links) | **71 us** | 14,000 |
+| Markdown (headings, code, lists) | **141 us** | 7,000 |
+| Table (5 rows, styled headers) | **341 us** | 2,900 |
+| Full report (tables, flex, progress bars) | **587 us** | 1,700 |
+<!-- /AUTO:BENCH -->
+
+Chrome headless takes ~2,500 ms per page. **ironpress is 4,000x faster**.
+
+## Quick start
+
+```rust
+use ironpress::html_to_pdf;
+
+let pdf = html_to_pdf("<h1>Hello</h1><p>World</p>").unwrap();
+std::fs::write("output.pdf", pdf).unwrap();
+```
+
+```rust
+let pdf = ironpress::markdown_to_pdf("# Hello\n\nWorld").unwrap();
+```
+
+## CLI
+
+```bash
+cargo install ironpress
+
+ironpress input.html output.pdf
+ironpress document.md output.pdf
+ironpress --page-size letter --landscape --margin 54 input.html output.pdf
+ironpress --header "Report" --footer "Page {page} of {pages}" input.html output.pdf
+echo '<h1>Hello</h1>' | ironpress --stdin output.pdf
+```
+
+## Builder API
+
+```rust
+use ironpress::{HtmlConverter, PageSize, Margin};
+
+let pdf = HtmlConverter::new()
+    .page_size(PageSize::LETTER)
+    .margin(Margin::uniform(54.0))
+    .header("My Document")
+    .footer("Page {page} of {pages}")
+    .convert("<h1>Custom page</h1>")
+    .unwrap();
+```
+
+## Features at a glance
+
+| Area | Highlights | Details |
+|------|-----------|---------|
+| **HTML** | 50+ elements: headings, tables, lists, forms, media, `<img>`, inline `<svg>` | [Layout Engine](../../wiki/Layout-Engine) |
+| **CSS** | Flexbox, grid, multi-column, `calc()`, variables, `@media`, `@page`, `@font-face` | [CSS Support](../../wiki/CSS-Support) |
+| **Fonts** | Base-14 PDF fonts, custom TTF embedding with subsetting, system font discovery, Unicode/CJK fallback | [Font System](../../wiki/Font-System) |
+| **Math** | LaTeX via `$...$` / `$$...$$`: fractions, roots, matrices, Greek, operators | [Math Engine](../../wiki/Math-Engine) |
+| **SVG** | Vector rendering: path, shapes, gradients, transforms, clip paths, `viewBox` | [Layout Engine](../../wiki/Layout-Engine) |
+| **Images** | JPEG + PNG, data URIs, local files, remote URLs (`remote` feature) | [Architecture](../../wiki/Architecture) |
+| **PDF** | PDF 1.4, bookmarks, link annotations, headers/footers, gradients, streaming output | [PDF Rendering](../../wiki/PDF-Rendering) |
+| **WASM** | `npm install ironpress` - runs 100% client-side in the browser | [WASM & Playground](../../wiki/WASM-Playground) |
+| **Testing** | 2100+ unit tests, property-based tests, 6 fuzz targets, parity dashboard | [Testing Strategy](../../wiki/Testing-Strategy) |
+
+## Custom fonts
+
+```rust
+let pdf = HtmlConverter::new()
+    .add_font("Inter", std::fs::read("Inter.ttf").unwrap())
+    .convert(r#"<p style="font-family: Inter">Shaped with HarfBuzz</p>"#)
+    .unwrap();
+```
+
+Fonts are shaped with [rustybuzz](https://crates.io/crates/rustybuzz), subset to used glyphs only, and embedded as CIDFontType2. Characters outside WinAnsi (CJK, Arabic, emoji) are rendered via automatic Unicode font fallback. See [Font System](../../wiki/Font-System).
+
+## Math
+
+```markdown
+The equation $E = mc^2$ is famous.
+
+$$\sum_{k=1}^{n} k = \frac{n(n+1)}{2}$$
+```
+
+Full LaTeX support: fractions, roots, matrices, Greek letters, operators, delimiters, accents. See [Math Engine](../../wiki/Math-Engine).
+
+## WASM
+
+```bash
+npm install ironpress
+```
+
+```javascript
+import init, { htmlToPdf, markdownToPdf } from 'ironpress';
+await init();
+
+const pdf = htmlToPdf('<h1>Hello</h1>');
+const blob = new Blob([pdf], { type: 'application/pdf' });
+```
+
+See [WASM & Playground](../../wiki/WASM-Playground).
+
+## Security
+
+HTML is sanitized by default: `<script>`, `<iframe>`, event handlers, and `javascript:` URLs are stripped. Resources are sandboxed (local-only by default, 10 MB cap). SVG sanitizer strips dangerous elements. PNG decompression capped at 50 MB. Disable with `.sanitize(false)` if you trust the input.
+
+## How it works
+
+```
+HTML/Markdown → Sanitize → Parse (html5ever) → Style cascade → Layout engine → PDF 1.4
+```
+
+See [Architecture](../../wiki/Architecture) for the full pipeline.
+
+## License
+
+MIT

ironpress-1.4.1/benches/conversion.rs

@@ -0,0 +1,177 @@
+use criterion::{Criterion, black_box, criterion_group, criterion_main};
+
+const SIMPLE_HTML: &str = "<h1>Hello</h1><p>World</p>";
+
+const STYLED_HTML: &str = r#"
+<style>
+  body { font-size: 11pt; }
+  h1 { color: navy; border-bottom: 2pt solid #ccc; }
+  .box { background-color: #f5f5f5; padding: 8pt; border-radius: 4pt; }
+</style>
+<h1>Report</h1>
+<p>Some <strong>bold</strong> and <em>italic</em> text with <a href="https://example.com">a link</a>.</p>
+<div class="box"><p>Styled content with background and border-radius.</p></div>
+<ul><li>Item one</li><li>Item two</li><li>Item three</li></ul>
+"#;
+
+const TABLE_HTML: &str = r#"
+<style>
+  table { border-collapse: collapse; width: 100%; }
+  td, th { border: 1pt solid #ddd; padding: 6pt; }
+  th { background-color: #336699; color: white; }
+</style>
+<h1>Data Report</h1>
+<table>
+  <thead><tr><th>Name</th><th>Role</th><th>Department</th><th>Status</th></tr></thead>
+  <tbody>
+    <tr><td>Alice</td><td>Engineer</td><td>Backend</td><td>Active</td></tr>
+    <tr><td>Bob</td><td>Designer</td><td>Frontend</td><td>Active</td></tr>
+    <tr><td>Charlie</td><td>Manager</td><td>Product</td><td>On leave</td></tr>
+    <tr><td>Diana</td><td>Engineer</td><td>Infra</td><td>Active</td></tr>
+    <tr><td>Eve</td><td>Analyst</td><td>Data</td><td>Active</td></tr>
+  </tbody>
+</table>
+"#;
+
+const FULL_DOCUMENT: &str = r#"
+<style>
+  body { font-size: 11pt; color: #333; }
+  h1 { color: navy; border-bottom: 2pt solid #ccc; padding-bottom: 4pt; }
+  h2 { color: #336699; margin-top: 12pt; }
+  table { border-collapse: collapse; width: 100%; margin: 8pt 0; }
+  td, th { border: 1pt solid #ddd; padding: 6pt; }
+  th { background-color: #336699; color: white; font-weight: bold; }
+  .highlight { background-color: #ffffcc; }
+  blockquote { border-left: 3pt solid #ccc; padding-left: 10pt; font-style: italic; color: #666; }
+  code { background-color: #f5f5f5; padding: 2pt 4pt; font-size: 10pt; }
+  .flex { display: flex; gap: 10pt; }
+  .flex > div { flex: 1; padding: 8pt; background-color: #f0f0f0; border-radius: 4pt; }
+</style>
+<h1>Annual Report 2026</h1>
+<p>This is a comprehensive document with <strong>bold</strong>, <em>italic</em>, <code>inline code</code>, and <a href="https://example.com">links</a>.</p>
+
+<h2>Financial Summary</h2>
+<table>
+  <thead><tr><th>Quarter</th><th>Revenue</th><th>Expenses</th><th>Growth</th></tr></thead>
+  <tbody>
+    <tr><td>Q1</td><td>$1.2M</td><td>$0.8M</td><td class="highlight">+15%</td></tr>
+    <tr><td>Q2</td><td>$1.4M</td><td>$0.9M</td><td class="highlight">+17%</td></tr>
+    <tr><td>Q3</td><td>$1.1M</td><td>$0.7M</td><td>-2%</td></tr>
+    <tr><td>Q4</td><td>$1.8M</td><td>$1.0M</td><td class="highlight">+22%</td></tr>
+  </tbody>
+</table>
+
+<h2>Key Metrics</h2>
+<div class="flex">
+  <div><strong>Users</strong><br>12,450</div>
+  <div><strong>Revenue</strong><br>$5.5M</div>
+  <div><strong>Growth</strong><br>+13%</div>
+</div>
+
+<h2>Team Updates</h2>
+<ul>
+  <li>Engineering: shipped 42 features</li>
+  <li>Design: completed brand refresh</li>
+  <li>Sales: exceeded Q4 target by 15%</li>
+</ul>
+<ol>
+  <li>Expand to European market</li>
+  <li>Launch mobile application</li>
+  <li>Achieve SOC 2 certification</li>
+</ol>
+
+<blockquote>Quality is not an act, it is a habit. — Aristotle</blockquote>
+
+<h2>Progress</h2>
+<p>Project Alpha: <progress value="85" max="100"></progress></p>
+<p>Project Beta: <progress value="40" max="100"></progress></p>
+
+<hr>
+<p><small>Confidential — Internal use only — Generated with ironpress</small></p>
+"#;
+
+const MARKDOWN: &str = r#"# Project Documentation
+
+## Overview
+
+This is a **comprehensive** project document with *various* formatting.
+
+## Features
+
+- Feature one with `inline code`
+- Feature two with **bold emphasis**
+- Feature three with [a link](https://example.com)
+
+## Code Example
+
+```rust
+fn main() {
+    println!("Hello, world!");
+}
+```
+
+## Roadmap
+
+1. Phase one: Research
+2. Phase two: Development
+3. Phase three: Launch
+
+> This project represents our commitment to excellence.
+
+---
+
+*Last updated: 2026*
+"#;
+
+fn bench_simple(c: &mut Criterion) {
+    c.bench_function("simple_html", |b| {
+        b.iter(|| ironpress::html_to_pdf(black_box(SIMPLE_HTML)).unwrap())
+    });
+}
+
+fn bench_styled(c: &mut Criterion) {
+    c.bench_function("styled_html", |b| {
+        b.iter(|| ironpress::html_to_pdf(black_box(STYLED_HTML)).unwrap())
+    });
+}
+
+fn bench_table(c: &mut Criterion) {
+    c.bench_function("table_html", |b| {
+        b.iter(|| ironpress::html_to_pdf(black_box(TABLE_HTML)).unwrap())
+    });
+}
+
+fn bench_full_document(c: &mut Criterion) {
+    c.bench_function("full_document", |b| {
+        b.iter(|| ironpress::html_to_pdf(black_box(FULL_DOCUMENT)).unwrap())
+    });
+}
+
+fn bench_markdown(c: &mut Criterion) {
+    c.bench_function("markdown", |b| {
+        b.iter(|| ironpress::markdown_to_pdf(black_box(MARKDOWN)).unwrap())
+    });
+}
+
+fn bench_with_header_footer(c: &mut Criterion) {
+    c.bench_function("header_footer", |b| {
+        b.iter(|| {
+            ironpress::HtmlConverter::new()
+                .header("Report Title")
+                .footer("Page {page} of {pages}")
+                .convert(black_box(FULL_DOCUMENT))
+                .unwrap()
+        })
+    });
+}
+
+criterion_group!(
+    benches,
+    bench_simple,
+    bench_styled,
+    bench_table,
+    bench_full_document,
+    bench_markdown,
+    bench_with_header_footer,
+);
+criterion_main!(benches);