pdfcrate 0.1.1-x86_64-linux

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1084b07c72613fef85f5fef3c8847137df9e1303c79a660a6b18a306685faff7
+  data.tar.gz: ed296301f9eaddc69ce6dfdd4a5c57bb761d5d0e75fa0d584a39dab6f01025dd
+SHA512:
+  metadata.gz: 64b62b849f1f18425d44a76ad324ad7bff993a556f022ebfda05e72ca46111d99112f8bf27e78c4bf76185fb12cf96a5c130b137c8cb47eb5298c762ed88a1cb
+  data.tar.gz: 3b94fe5eb559320dc072801c7c393ed0e0d22477027a81bd2523042dd094121680a47e10959d5011fa260f3c1805b29e505f88d89b28f2a354902df317deba54

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/extconf.rb

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

data/lib/pdfcrate/version.rb

@@ -0,0 +1,3 @@
+module Pdfcrate
+  VERSION = "0.1.1"
+end

data/lib/pdfcrate.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+require "pdfcrate/version"
+require "pdfcrate/pdfcrate"
+
+module Pdfcrate
+  # Prawn::View-compatible mixin: delegates method calls to self.document
+  module View
+    def document
+      @document
+    end
+
+    private
+
+    def method_missing(name, *args, **kwargs, &block)
+      return super unless document.respond_to?(name)
+
+      if kwargs.empty?
+        document.send(name, *args, &block)
+      else
+        document.send(name, *args, **kwargs, &block)
+      end
+    end
+
+    def respond_to_missing?(name, include_private = false)
+      document.respond_to?(name) || super
+    end
+  end
+
+  # Extend GridProxy with bounding_box method that delegates to Document
+  class GridProxy
+    attr_accessor :_document
+
+    def bounding_box(&block)
+      raise "GridProxy must be associated with a Document" unless _document
+
+      if is_span
+        _document.grid_span_bounding_box(row, col, end_row, end_col, &block)
+      else
+        _document.grid_cell_bounding_box(row, col, &block)
+      end
+    end
+  end
+
+  class Document
+    # Override grid to attach document reference
+    alias_method :_grid_raw, :grid
+
+    def grid(*args)
+      proxy = _grid_raw(*args)
+      proxy._document = self
+      proxy
+    end
+
+    # Grid cell bounding box - uses grid layout coordinates
+    def grid_cell_bounding_box(row, col, &block)
+      _grid_cell_bb(row, col, &block)
+    end
+
+    def grid_span_bounding_box(r1, c1, r2, c2, &block)
+      _grid_span_bb(r1, c1, r2, c2, &block)
+    end
+
+    # font_families.update() compatibility
+    # Returns a FontFamiliesUpdater that intercepts .update()
+    class FontFamiliesUpdater
+      def initialize(doc)
+        @doc = doc
+      end
+
+      def update(families)
+        families.each do |name, styles|
+          kwargs = {}
+          styles.each do |style, path|
+            kwargs[style] = path
+          end
+          @doc.register_font_family(name, **kwargs)
+        end
+      end
+    end
+
+    def font_families
+      FontFamiliesUpdater.new(self)
+    end
+  end
+end

data/pdfcrate.gemspec

@@ -0,0 +1,43 @@
+require_relative 'lib/pdfcrate/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "pdfcrate"
+  spec.version       = Pdfcrate::VERSION
+  spec.authors       = ["ratazzi"]
+  spec.email         = ["ratazzi@gmail.com"]
+
+  spec.summary       = "Ruby bindings for pdfcrate PDF generation library"
+  spec.description   = "A Ruby gem providing Prawn-compatible API bindings to the pdfcrate Rust PDF generation library using Magnus."
+  spec.homepage      = "https://github.com/ratazzi/pdfcrate"
+  spec.license       = "MIT"
+  spec.required_ruby_version = ">= 3.1.0"
+
+  spec.files = Dir[
+    'lib/**/*.rb',
+    'ext/**/*.{rb,rs,toml}',
+    'ext/**/src/**/*.rs',
+    'README.md',
+    'LICENSE',
+    'Gemfile',
+    '*.gemspec'
+  ]
+
+  spec.files += Dir['lib/**/*.{bundle,so,dll}'] if spec.respond_to?(:platform) && spec.platform != "ruby"
+
+  spec.require_paths = ["lib"]
+
+  spec.extensions = ["ext/pdfcrate/extconf.rb"] if !spec.respond_to?(:platform) || spec.platform == "ruby"
+
+  if !spec.respond_to?(:platform) || spec.platform == "ruby"
+    spec.add_development_dependency "rake", "~> 13.0"
+    spec.add_development_dependency "rake-compiler", "~> 1.2"
+  end
+
+  spec.add_dependency "rb_sys", "~> 0.9.124"
+
+  spec.metadata = {
+    "source_code_uri" => "https://github.com/ratazzi/pdfcrate",
+    "rubygems_mfa_required" => "true",
+    "cargo_crate_name" => "pdfcrate-ruby"
+  }
+end

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification
+name: pdfcrate
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: x86_64-linux
+authors:
+- ratazzi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-03-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rake-compiler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+description: A Ruby gem providing Prawn-compatible API bindings to the pdfcrate Rust
+  PDF generation library using Magnus.
+email:
+- ratazzi@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- LICENSE
+- README.md
+- ext/pdfcrate/extconf.rb
+- lib/pdfcrate.rb
+- lib/pdfcrate/3.3/pdfcrate.so
+- lib/pdfcrate/3.4/pdfcrate.so
+- lib/pdfcrate/version.rb
+- pdfcrate.gemspec
+homepage: https://github.com/ratazzi/pdfcrate
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/ratazzi/pdfcrate
+  rubygems_mfa_required: 'true'
+  cargo_crate_name: pdfcrate-ruby
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 3.5.dev
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.23
+signing_key: 
+specification_version: 4
+summary: Ruby bindings for pdfcrate PDF generation library
+test_files: []