gotenberg

gotenberg-client

A high-performance Go client for the Gotenberg HTTP API with a fluent interface. Built using only the Go standard library (via http-client).

Features:

• Minimal dependencies (only stdlib + http-client)
• Fluent API for building requests
• Support for HTML/URL/Markdown to PDF conversion
• Webhook support
• Easy file/multipart uploads
• Paper size, margins, and advanced PDF options

Quick Start: Synchronous HTML to PDF

See examples/cmd/chromium/helloworld for a basic HTML to PDF conversion example.

go run ./examples/cmd/chromium/helloworld

Markdown to PDF Conversion

Convert Markdown files to PDF with custom HTML templates. See examples/cmd/chromium/markdown for a complete example.

go run ./examples/cmd/chromium/markdown

Example: Async PDF Generation with Webhook

See examples/cmd/chromium/webhook for a full async webhook demo (HTML invoice to PDF, with logo, webhook server, and error handling).

# Run webhook example
go run ./examples/cmd/chromium/webhook

This will:

• Start a local webhook server
• Generate an invoice PDF using HTML template and logo
• Receive the PDF via webhook callback from Gotenberg

Installation

go get github.com/nativebpm/gotenberg-client

Testing

Run all tests and benchmarks:

go test -v -bench=. ./...

Project Structure

• chromium.go — main client implementation
• examples/ — real-world usage examples
• examples/cmd/chromium/webhook — async webhook demo
• examples/cmd/chromium/markdown — basic markdown to PDF conversion
• examples/cmd/chromium/helloworld — basic HTML to PDF conversion
• examples/model — invoice data structs
• examples/pkg/templates/invoice — HTML template for invoice
• examples/pkg/templates/markdown — HTML template for markdown
• examples/pkg/image — logo generator

Dependencies

• Go standard library
• github.com/nativebpm/http-client

No third-party dependencies are required, ensuring minimal bloat and maximum compatibility.

📄 License

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