4teamwork/pdflatex repository overview

⁠pdflatex

A dockerized webservice for creating PDFs from LaTeX files.

⁠Description

pdflatex uses the TeXLive distribution for PDF creation. It exposes an endpoint for uploading a .tex file and any additionally required files. The webservice is written in Python using the aiohttp web server.

⁠Usage

To start the webservice just run

docker-compose up

The .tex file and and any additional files must be uploaded as multipart/form-data with a part named latex containing them main .tex file. Additional files have to be in parts with names that start with the preifx file..

Example:

curl -F "latex=@tests/image.tex" -F "file.image=@tests/image.jpg" http://localhost:3000 -o image.pdf

⁠Testing

To execute the tests, Python 3.8 with pytest and requests is required.

python3.8 -m venv venv
./venv bin/activate
pip install pytest requests

Tests are run by executing pytest:

pytest