infrae.fileupload

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.