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.
.. image:: https://circleci.com/gh/makinacorpus/convertit.svg?style=shield :target: https://circleci.com/gh/makinacorpus/convertit
Supported conversions:
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: attachment; 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 "file=@tiger.svg" http://convertit/?to=image/png
HTTP/1.1 302 Found
Content-Disposition: attachment; filename=tiger.png
application/pdf
if not provided);unoconv
inkscape
Conversion binaries should be in system PATH
(which
is used internally.)
pypi <http://pypi.python.org/pypi/convertit>
_The bleeding edge version is hosted on github <https://github.com/makinacorpus/convertit>
_ ::
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
Using Docker :
::
sudo docker build -t="convertit" .
sudo docker run -p :6543 convertit
Open an issue <https://github.com/makinacorpus/convertit/issues>
_ to report a
bug or request a new feature.
|makinacom|_
Planet Makina Corpus <https://www.makina-corpus.com>
_Contact us <mailto:python@makina-corpus.com>
_.. |makinacom| image:: https://github.com/makinacorpus.png .. _makinacom: https://www.makina-corpus.com