Streaming parser for multipart/form-data
Project description
streaming_form_data
provides a Python parser for parsing
multipart/form-data
input chunks (the most commonly used encoding when
submitting data over HTTP through HTML forms).
Installation
$ pip install streaming-form-data
In case you prefer cloning the Github repository and installing manually, please
note that master
is the development branch, so stable
is what
you should be working with.
Usage
>>> from streaming_form_data import StreamingFormDataParser
>>> from streaming_form_data.targets import ValueTarget, FileTarget, NullTarget
>>>
>>> headers = {'Content-Type': 'multipart/form-data; boundary=boundary'}
>>>
>>> parser = StreamingFormDataParser(headers=headers)
>>>
>>> parser.register('name', ValueTarget())
>>> parser.register('file', FileTarget('/tmp/file.txt'))
>>> parser.register('discard-me', NullTarget())
>>>
>>> for chunk in request.body:
... parser.data_received(chunk)
...
>>>
Documentation
Up-to-date documentation is available on Read the Docs.
Development
Please make sure you have Python 3.5+ and pip-tools installed.
Git clone the repository -
git clone https://github.com/siddhantgoel/streaming-form-data
Install the packages required for development -
pip install -r requirements-dev.txt
That’s basically it. You should now be able to run the test suite -
make test
.
Please note that tests/test_parser_stress.py
stress tests the parser
with large inputs, which can take a while. As an alternative, pass the filename
as an argument to py.test
to run tests selectively.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for streaming-form-data-1.7.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | c074b7c8e717f7886ff984378a574426f95587ed33986ca35cd211d511c14ce5 |
|
MD5 | 2f9553cc68e90b6bfa63b0b7d0bb7e9f |
|
BLAKE2b-256 | 641111b504f2285cbfccc5ee5e81119af9ef22f71ff3bec2ce2f3600a4872ace |