princepdf

Go library and HTTP service wrapper around Prince XML that makes it easy to generate PDFs from HTML sources.

Usage

You'll need to have prince installed on your machine and available in your $PATH to be able to use this library. The included Dockerfile may be helpful for running the service inside the container using the official binary without having to install anything locally.

Go Package

go get github.com/invopop/princepdf

// Prepare the Client and start the binary connection
pc := princepdf.New()
if err := pc.Start(); err != nil {
    panic(err)
}

// Prepare a Job with source HTML data
j := &princepdf.Job{
    Input: &princepdf.Job{
        Src: "data.html",
    },
    Files: map[string][]byte{
        "data.html": data,
    }
}

// Run it, deal with the `out`
out, err := pc.client.Run(j)
if err != nil {
    panic(err)
}

Launch as Web Service

Build and run from Go:

go build ./cmd/princepdf
./princepdf -p 3000

Alternatively you can also use the included Dockerfile.

Once running, the princepdf service has a single API endpoint:

POST /pdf

Example using curl:

curl -X POST -F files=@examples/simple.html -F input='{"src":"simple.html"}' -F metadata='{"title":"Test Output","creator":"Go"}'  http://localhost:3000/pdf -v > output.pdf