Imprintor

A fast and efficient Elixir library for generating PDF documents from Typst templates using native Rust implementations.

Features

🚀 Fast PDF generation using native Rust and Typst
📄 Template-based document creation with data integration
💾 In-memory PDF generation - returns PDF binary data
📝 Typst syntax support for beautiful document formatting
🧩 Rich data support - pass complex nested data structures

Installation

Add imprintor to your list of dependencies in mix.exs:

def deps do
  [
    {:imprintor, "~> 0.1.0"}
  ]
end

Usage

Basic PDF Generation

# Define a Typst template with data access
template = """
= Hello #elixir_data.name!

*Date:* #elixir_data.date

This is a sample document generated using Imprintor.

== Details

Here are some details:
- *Name:* #elixir_data.name
- *Email:* #elixir_data.email
- *Age:* #elixir_data.age

Thanks for using Imprintor!
"""

# Provide data to fill the template
data = %{
  "name" => "John Doe",
  "date" => "2024-01-15",
  "email" => "john@example.com",
  "age" => 30
}

# Create a configuration and generate PDF
config = Imprintor.Config.new(template, data)
{:ok, pdf_binary} = Imprintor.compile_to_pdf(config)

# Save to file
File.write!("output.pdf", pdf_binary)

Working with Complex Data and Iteration

# Template with data iteration using elixir_data
template = """
= Employee Directory

#for employee in elixir_data.employees [
  == #employee.name

  *Position:* #employee.position
  *Department:* #employee.department
  *Email:* #employee.email

  ---
]
"""

# Complex nested data structure
data = %{
  "employees" => [
    %{
      "name" => "Alice Johnson",
      "position" => "Software Engineer", 
      "department" => "Engineering",
      "email" => "alice@company.com"
    },
    %{
      "name" => "Bob Smith",
      "position" => "Product Manager",
      "department" => "Product", 
      "email" => "bob@company.com"
    }
  ]
}

config = Imprintor.Config.new(template, data)
{:ok, pdf_binary} = Imprintor.compile_to_pdf(config)
File.write!("employee_directory.pdf", pdf_binary)

Variable Substitution Syntax

Imprintor uses Typst syntax for data access:

= Customer Report

*Name:* #elixir_data.customer.name
*Email:* #elixir_data.customer.email

== Orders
#for order in elixir_data.orders [
  - #order.product: \\$#order.total
]

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Fork the repository
Create a feature branch
Add tests for new functionality
Submit a pull request

Changelog

0.1.0

Initial release
Basic Typst template compilation using native Rust
PDF generation with data access using elixir_data variable
Support for nested data structures and array iteration
Configuration-based API with Imprintor.Config
Custom fonts support
Comprehensive test suite