pdfcrate 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8895658522be956bec8bc47ab1e8116564bb96d265319c3b45b9b067aeac5a32
+  data.tar.gz: e29951729a289b339a23d45620ea6048ca584663fc4664f5dfe8b22dbebbd9c8
+SHA512:
+  metadata.gz: 58b64f6606cf2c17933dd79515d6f22e9755910bac69751757b40dbec437251e0a59204094eb7d2bd6318828484d6b00efc230929c3ad622dd72cbb83f0fb6ce
+  data.tar.gz: 3fcba47bff5c6b599e337baf7970d0973bcbe31fa2482821a0967707a4def84faf30d4147cd83469b4627718bc5cbf778f0f9d64339fe0bccd71ae2199e15203

data/Gemfile

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec
+
+gem "rake-compiler", "~> 1.2"
+gem "rake-compiler-dock", "~> 1.3"
+gem "rb_sys", "~> 0.9.124"

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 pdfcrate contributors
+
+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.

data/README.md

@@ -0,0 +1,177 @@
+# pdfcrate
+
+> **Warning**: This project is under active development. The API is unstable and subject to breaking changes. **Do not use in production environments.**
+
+A Rust library for creating and manipulating PDF documents with a focus on ease of use and comprehensive text layout support.
+
+## Features
+
+- **Layout-based document creation** - Cursor-based layout with automatic text flow, margins, and bounding boxes
+- **Rich text formatting** - Bold, italic, colors, alignment (left/center/right/justify)
+- **Font support** - 14 standard PDF fonts + TrueType/OpenType embedding with text shaping
+- **Font fallback** - Automatic fallback for mixed-language text (CJK, emoji, etc.)
+- **Tables** - Full-featured tables with borders, cell styles, column spans, and overflow handling
+- **Images** - PNG and JPEG embedding with fit/fill modes
+- **SVG rendering** - Embed SVG graphics directly
+- **Links and outlines** - Hyperlinks, internal links, and document bookmarks
+- **Forms** - Interactive form fields (text, checkbox, radio, dropdown)
+- **WASM support** - Works in WebAssembly environments (tested with Cloudflare Workers)
+- **Python bindings** - Use pdfcrate from Python via PyO3
+
+## Installation
+
+Add to your `Cargo.toml`:
+
+```toml
+[dependencies]
+pdfcrate = "0.1"
+```
+
+## Quick Start
+
+```rust
+use pdfcrate::prelude::*;
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    Document::generate("hello.pdf", |doc| {
+        doc.title("Hello PDF").author("pdfcrate");
+
+        doc.font("Helvetica-Bold").size(24.0);
+        doc.text("Hello, World!");
+
+        doc.move_down(20.0);
+
+        doc.font("Helvetica").size(12.0);
+        doc.text_wrap("This is a simple PDF document created with pdfcrate. \
+                       Text automatically wraps within the page margins.");
+
+        Ok(())
+    })?;
+
+    Ok(())
+}
+```
+
+## Examples
+
+### Custom Fonts
+
+```rust
+use pdfcrate::prelude::*;
+
+Document::generate("custom_font.pdf", |doc| {
+    // Embed a TrueType font
+    let font = doc.embed_font_file("fonts/MyFont.ttf")?;
+
+    doc.font(&font).size(16.0);
+    doc.text("Text with custom font!");
+
+    Ok(())
+})?;
+```
+
+### Font Fallback for CJK
+
+```rust
+use pdfcrate::prelude::*;
+
+Document::generate("multilingual.pdf", |doc| {
+    let cjk_font = doc.embed_font_file("fonts/NotoSansCJK.ttf")?;
+
+    // Configure fallback fonts
+    doc.fallback_fonts(vec![cjk_font]);
+
+    doc.font("Helvetica").size(14.0);
+    doc.text_wrap("English text mixed with 中文 and 日本語");
+
+    Ok(())
+})?;
+```
+
+### Tables
+
+```rust
+use pdfcrate::prelude::*;
+
+Document::generate("table.pdf", |doc| {
+    let table = Table::new(&[100.0, 150.0, 100.0])
+        .header(&["Name", "Description", "Price"])
+        .row(&["Item 1", "First item", "$10.00"])
+        .row(&["Item 2", "Second item", "$20.00"])
+        .borders(BorderStyle::all(0.5, Color::BLACK));
+
+    doc.table(&table);
+
+    Ok(())
+})?;
+```
+
+### Images
+
+```rust
+use pdfcrate::prelude::*;
+
+Document::generate("with_image.pdf", |doc| {
+    // Embed and draw image
+    doc.image_fit("photo.png", [0.0, 0.0], 200.0, 150.0)?;
+
+    Ok(())
+})?;
+```
+
+## Python
+
+pdfcrate provides Python bindings via [PyO3](https://pyo3.rs/) and [maturin](https://www.maturin.rs/).
+
+```bash
+# Install in development mode
+uv run maturin develop --features python
+
+# Run the showcase
+uv run python examples/showcase.py
+```
+
+```python
+from pdfcrate import Document, Margin, Color, TextFragment
+
+doc = Document(margin=Margin(36, 36, 36, 36))
+doc.title("Hello from Python")
+
+doc.font("Helvetica", 24)
+doc.text("Hello, World!")
+
+doc.move_down(20)
+doc.font("Helvetica", 12)
+doc.text("Created with pdfcrate Python bindings.")
+
+doc.save("hello.pdf")
+```
+
+## Feature Flags
+
+All features are pure Rust and WASM-compatible.
+
+| Feature | Default | Description |
+|---------|---------|-------------|
+| `std` | Yes | Standard library support (file I/O) |
+| `png` | Yes | PNG image support (JPEG is always supported) |
+| `fonts` | Yes | TrueType/OpenType font embedding |
+| `text-shaping` | Yes | Complex text shaping via rustybuzz |
+| `svg` | Yes | SVG rendering support |
+| `barcode` | Yes | QR code and barcode generation |
+| `python` | No | Python bindings (PyO3) |
+
+To use minimal features:
+
+```toml
+[dependencies]
+pdfcrate = { version = "0.1", default-features = false }
+```
+
+## Minimum Supported Rust Version (MSRV)
+
+Rust 1.87 or later.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

data/ext/pdfcrate/Cargo.toml

@@ -0,0 +1,16 @@
+[package]
+name = "pdfcrate-ruby"
+version = "0.1.0"
+edition = "2021"
+
+[lib]
+name = "pdfcrate"
+crate-type = ["cdylib"]
+
+[dependencies]
+magnus = "0.7"
+rb-sys = { version = "*", default-features = false, features = ["stable-api-compiled-fallback"] }
+pdfcrate = { path = "../..", features = ["full"] }
+
+[build-dependencies]
+rb-sys = "0.9.124"

data/ext/pdfcrate/extconf.rb

@@ -0,0 +1,3 @@
+require "mkmf"
+require "rb_sys/mkmf"
+create_rust_makefile("pdfcrate/pdfcrate")