A file conversion Web API in Pyramid
Project description
Convertit is a format conversion webservice.
Retrieve your document in an other format using a dead simple GET request. Documents are pulled, converted and served back !
Supported conversions: - odt -> pdf - odt -> doc - ods -> xls - csv -> ods - csv -> xls - svg -> pdf - svg -> png
Previously converted documents are cleaned along the way (on each request).
USAGE
Using GET 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;
Using POST request
Upload data in POST parameter named file:
curl -F "file=@tiger.svg" http://convertit/?to=image/png HTTP/1.1 302 Found Content-Disposition: attachement; filename=tiger.png
Query parameters
to: output mimetype (optionnal, default to application/pdf if not provided);
from: input mimetype (optionnal, guessed from input url or file if not provided).
INSTALL
System dependencies
for OpenDocument support: unoconv
for SVG support: inkscape
Conversion binaries should be in system PATH (which is used internally.)
Download
Development
python setup.py develop pserve --reload development.ini
Once the application is running, you may visit http://localhost:6543/ in your browser.
Run tests:
python setup.py test
Production
Using gunicorn for example :
gunicorn_paster --workers=4 production.ini
Feedback
Open an issue to report a bug or request a new feature.
CREDITS
Companies
Contributors
kiorky <kiorky@cryptelium.net>
Mathieu Leplatre <mathieu.leplatre@makina-corpus.com>
CHANGELOG
1.0 (2013-09-03)
Initial working version
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
