Skip to main content

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 !

https://secure.travis-ci.org/makinacorpus/convertit.png?branch=master

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

  • 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
    

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.

CHANGELOG

1.0 (2013-09-03)

  • Initial working version

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for convertit, version 1.0
Filename, size File type Python version Upload date Hashes
Filename, size convertit-1.0.zip (77.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page