Convertit is a format conversion webservice.
Retrieve your document in an other format ! The input file is converted and served back !
Using a dead simple GET
request, documents are pulled. Using POST
request, it takes the attachment.
Supported conversions:
- odt -> pdf
- odt -> doc
- ods -> xls
- csv -> ods
- csv -> xls
- svg -> pdf
- svg -> png
- doc -> pdf
- docx -> pdf
- ppt -> pdf
- pptx -> pdf
Previously converted documents are cleaned along the way (on each request).
Example, convert from odt to pdf :
curl http://convertit/?url=http://server/document.odt&to=application/pdf HTTP/1.1 302 Found Content-Disposition: attachement; filename=document.pdf ...
GET parameters:
url: absolute url of the document to be converted.
"url" also supports a "{X_FORWARDED_FOR}" placeholder for requests not knowing their own host. "{X_FORWARDED_FOR}" will be replaced with the corresponding "X_FORWARDED_FOR" header if available. Be warned that "X_FORWARDED_FOR" is not a safe value since it can be modified by user agents or given false value by forward proxies. Use only if really needed. Exemple:
curl "http://convertit/?url=http://{X_FORWARDED_FOR}/document.odt&to=application/pdf"
Upload data in POST parameter named file
:
curl -F "[email protected]" http://convertit/?to=image/png HTTP/1.1 302 Found Content-Disposition: attachement; filename=tiger.png
- to: output mimetype (optional, default to
application/pdf
if not provided); - from: input mimetype (optional, guessed from input url or file if not provided).
list of mimetypes: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Complete_list_of_MIME_types
- for OpenDocument support:
unoconv
- for SVG support:
inkscape
Conversion binaries should be in system PATH
(which
is used internally.)
Download and extract a released tarball from pypi
The bleeding edge version is hosted on github
git clone https://github.com/makinacorpus/convertit.git cd convertit
make serve
Once the application is running, you may visit http://localhost:6543/ in your browser.
Run tests:
make tests
Using gunicorn for example :
gunicorn --workers=1 --paste=production.ini
sudo docker build -t="convertit" . sudo docker run -p :6543 convertit curl -LF "[email protected]" http://localhost:6543/?to=application/pdf -o output.pdf % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 95 4484 0 0 100 4277 0 3314 0:00:01 0:00:01 --:--:-- 3312 100 6791 100 6791 0 0 5239 0 0:00:01 0:00:01 --:--:-- 5239
Open an issue to report a bug or request a new feature.
- Antoine Cezar
- Alex Marandon
- kiorky <[email protected]>
- Mathieu Leplatre <[email protected]>
- Gaël Utard <[email protected]>
- Jean-Etienne Castagnede <[email protected]>