Skip to main content

WSGI middleware to manage upload of files

Project description

infrae.fileupload is a WSGI component that can be used as a middleware in order to intercept single file upload and save them on the disk. The request to the application is then replaced by a json body describing the information about the file. The original filename and mimetype sent by the browser are kept as metadata. In addition to this, it is possible to query the status of the upload and reset it with HTTP request (by appending /status to the upload URL). An API is exposed via the environ dictionnary provided the WSGI application and can be used in order to query the files.

The API provides the following methods:

create_identifier()

Create a new upload identifier that be provided while submitting the form using the X-Progress-ID parameter in the URL.

verify_identifier(identifier)

Validate a given identifier.

access_upload_bucket(identifier)

Access the given upload. An object with the following methods is returned:

get_status()

Return a dictionnary containing metadata information about the upload.

get_filename()

Return the filename of the uploaded file.

is_complete()

Return True if the upload was complete.

clear_upload()

Delete the upload.

clear_upload_bucket(identifier)

Delete the given upload.

It is possible to use the component as a standalone WSGI application and having a dedicated upload server available at a different URL.

Paster

The upload middleware (and upload application) can be used via Paster using egg:infrae.fileupload. Configuration directives are:

directory

Pool directory where to store the uploaded files. If multiple processes accross multiple servers are configured for the same URL, they should share this directory too.

max_size

Maximum allowed size for an upload in megabytes.

upload_url

URL where to upload the files. If not specified the URL specified by the wsgi environment will be used. If it is specified, the middleware won’t intercept uploads and assume this task is handled by the given URL. This is use in large installation in order to have a dedicated upload server by using the standalone application instead of the middleware. Upload URLs always ends with /upload. If it is not the case it will appended to it.

upload_key

Private key used to hash upload identifier. This enable a basic security preventing abuse of the upload middleware or application. If multiple processes and installations shares the same upload URL they should share the same upload key too.

Changes

1.0.1 (2013/10/09)

  • Support malformed requests that are not properly terminated.

1.0 (2013/10/08)

  • Initial release.

Project details


Download files

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

Source Distribution

infrae.fileupload-1.0.1.tar.gz (7.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page