Skip to content

README.md

Latest commit

 

History

History
38 lines (29 loc) · 1.23 KB

README.md

File metadata and controls

38 lines (29 loc) · 1.23 KB

Python multipart form data parser

A python module of Igor Afonov's multipart-parser-c.

This module leverages the state machine written in C code to provide a multipart/form-data parser to python code. This module reads from any iterable object passed to it. It avoids the need to read the entire structure into memory by returning iterators. This allows stream-to-disk or stream-to-database operations to be implemented in Python code only.

Features

  • No dependencies
  • Fast: written in C
  • Works with chunks of data
  • Support of multi-line headers
  • Uploads of unknown size (missing Content-Length header).
  • Very high test coverage

Compared to cgi.FieldStorage()

  • Fast: parsing algorithm written in c
  • Reads directly from a socket (no .readline(n), just .read(n)).
  • Is desgined for WSGI, not CGI.

Example

Example usage of parsing a POST request and saving each part to disk is shown in example/saveUpload.py. It starts an HTTP server on port 8080 of the localhost that saves all parts of the multipart upload to separate files on disk.

TODO

  • Support of Python 3
  • Handle big uploads properly
  • Provide a high level API
  • Add some utility for WSGI