Skip to content

twocngdagz/printer-webservice

 
 

Repository files navigation

HTML to PDF Web Service

A WSGI web service for rendering HTML to PDF using wkhtmltopdf.

This work was inspired by https://github.com/openlabs/docker-wkhtmltopdf

TODO

  • Add the javascript client
  • Add a routing system
  • Use URL params to generate wkhtmltopdf cmd-line options
  • Add a cache system
  • Add a Procfile and .buildpack for a better Heroku compatibility
  • Add an auth system

Running the Service localy

  1. Install python3 (virtualenv recommendend)

  2. Install wkhtmltopdf here

  3. Install dependencies:

    pip3 install -r requirements.txt
    
  4. Run server:

    python3 app.py
    

The development server listens on port 5000.

Using the Service

The web service accepts an HTML document as the "html" and "filename" parameter in the body of a URL-encoded web form POST request and responds with the rendered PDF. For example:

curl -d html='<p>Hello world!</p>' -d filename='test.pdf' http://localhost:5000 > output.pdf

An HTML file can also be included as multipart form data, for example:

cat sample.html | curl -F html=@- http://localhost:5000 > output.pdf

Running as Docker Container

To run the service as a Docker container:

  1. Build the Docker image:

    docker build -t printer-webservice .
  2. Run a Docker container (binding to port 5000):

    docker run -p 5000:8080 printer-webservice

About

A WSGI web service for rendering HTML to PDF using wkhtmltopdf

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 94.1%
  • HTML 3.7%
  • Shell 2.2%