| Name | multipart JSON |
| Version |
1.2.0
JSON |
| download |
| home_page | None |
| Summary | Parser for multipart/form-data |
| upload_time | 2024-11-28 16:09:48 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | None |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
=================================
Python multipart/form-data parser
=================================
.. image:: https://github.com/defnull/multipart/actions/workflows/test.yaml/badge.svg
:target: https://github.com/defnull/multipart/actions/workflows/test.yaml
:alt: Tests Status
.. image:: https://img.shields.io/pypi/v/multipart.svg
:target: https://pypi.python.org/pypi/multipart/
:alt: Latest Version
.. image:: https://img.shields.io/pypi/l/multipart.svg
:target: https://pypi.python.org/pypi/multipart/
:alt: License
.. _HTML5: https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#multipart-form-data
.. _RFC7578: https://www.rfc-editor.org/rfc/rfc7578
.. _WSGI: https://peps.python.org/pep-3333
.. _ASGI: https://asgi.readthedocs.io/en/latest/
.. _SansIO: https://sans-io.readthedocs.io/
.. _asyncio: https://docs.python.org/3/library/asyncio.html
This module provides a fast incremental non-blocking parser for
``multipart/form-data`` [HTML5_, RFC7578_], as well as blocking alternatives for
easier use in WSGI_ or CGI applications:
* **PushMultipartParser**: Fast SansIO_ (incremental, non-blocking) parser suitable
for ASGI_, asyncio_ and other IO, time or memory constrained environments.
* **MultipartParser**: Streaming parser that reads from a byte stream and yields
memory- or disk-buffered `MultipartPart` instances.
* **WSGI Helper**: High-level functions and containers for WSGI_ or CGI applications with support
for both `multipart` and `urlencoded` form submissions.
Features
========
* Pure python single file module with no dependencies.
* Optimized for both blocking and non-blocking applications.
* 100% test coverage with test data from actual browsers and HTTP clients.
* High throughput and low latency (see `benchmarks <https://github.com/defnull/multipart_bench>`_).
* Predictable memory and disk resource consumption via fine grained limits.
* Strict mode: Spent less time parsing malicious or broken inputs.
Scope and compatibility
=======================
All parsers in this module implement ``multipart/form-data`` as defined by HTML5_
and RFC7578_, supporting all modern browsers or HTTP clients in use today.
Legacy browsers (e.g. IE6) are supported to some degree, but only if the
required workarounds do not impact performance or security. In detail this means:
* Just ``multipart/form-data``, not suitable for email parsing.
* No ``multipart/mixed`` support (deprecated in RFC7578_).
* No ``base64`` or ``quoted-printable`` transfer encoding (deprecated in RFC7578_).
* No ``encoded-word`` or ``name=_charset_`` encoding markers (deprecated in HTML5_).
* No support for clearly broken clients (e.g. invalid line breaks or headers).
Installation
============
``pip install multipart``
Documentation
=============
Examples and API documentation can be found at: https://multipart.readthedocs.io/
License
=======
.. __: https://github.com/defnull/multipart/raw/master/LICENSE
Code and documentation are available under MIT License (see LICENSE__).
Raw data
{
"_id": null,
"home_page": null,
"name": "multipart",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Marcel Hellkamp <marc@gsites.de>",
"download_url": "https://files.pythonhosted.org/packages/f8/5a/66075b21cf7622958e724c482ab9e0c150fe057b20743ec215706bf5dbac/multipart-1.2.0.tar.gz",
"platform": null,
"description": "=================================\nPython multipart/form-data parser\n=================================\n\n.. image:: https://github.com/defnull/multipart/actions/workflows/test.yaml/badge.svg\n :target: https://github.com/defnull/multipart/actions/workflows/test.yaml\n :alt: Tests Status\n\n.. image:: https://img.shields.io/pypi/v/multipart.svg\n :target: https://pypi.python.org/pypi/multipart/\n :alt: Latest Version\n\n.. image:: https://img.shields.io/pypi/l/multipart.svg\n :target: https://pypi.python.org/pypi/multipart/\n :alt: License\n\n.. _HTML5: https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#multipart-form-data\n.. _RFC7578: https://www.rfc-editor.org/rfc/rfc7578\n.. _WSGI: https://peps.python.org/pep-3333\n.. _ASGI: https://asgi.readthedocs.io/en/latest/\n.. _SansIO: https://sans-io.readthedocs.io/\n.. _asyncio: https://docs.python.org/3/library/asyncio.html\n\nThis module provides a fast incremental non-blocking parser for\n``multipart/form-data`` [HTML5_, RFC7578_], as well as blocking alternatives for\neasier use in WSGI_ or CGI applications:\n\n* **PushMultipartParser**: Fast SansIO_ (incremental, non-blocking) parser suitable\n for ASGI_, asyncio_ and other IO, time or memory constrained environments.\n* **MultipartParser**: Streaming parser that reads from a byte stream and yields\n memory- or disk-buffered `MultipartPart` instances.\n* **WSGI Helper**: High-level functions and containers for WSGI_ or CGI applications with support\n for both `multipart` and `urlencoded` form submissions.\n\nFeatures\n========\n\n* Pure python single file module with no dependencies.\n* Optimized for both blocking and non-blocking applications.\n* 100% test coverage with test data from actual browsers and HTTP clients.\n* High throughput and low latency (see `benchmarks <https://github.com/defnull/multipart_bench>`_).\n* Predictable memory and disk resource consumption via fine grained limits.\n* Strict mode: Spent less time parsing malicious or broken inputs.\n\nScope and compatibility\n=======================\nAll parsers in this module implement ``multipart/form-data`` as defined by HTML5_\nand RFC7578_, supporting all modern browsers or HTTP clients in use today.\nLegacy browsers (e.g. IE6) are supported to some degree, but only if the\nrequired workarounds do not impact performance or security. In detail this means:\n\n* Just ``multipart/form-data``, not suitable for email parsing.\n* No ``multipart/mixed`` support (deprecated in RFC7578_).\n* No ``base64`` or ``quoted-printable`` transfer encoding (deprecated in RFC7578_).\n* No ``encoded-word`` or ``name=_charset_`` encoding markers (deprecated in HTML5_).\n* No support for clearly broken clients (e.g. invalid line breaks or headers).\n\nInstallation\n============\n\n``pip install multipart``\n\nDocumentation\n=============\n\nExamples and API documentation can be found at: https://multipart.readthedocs.io/\n\nLicense\n=======\n\n.. __: https://github.com/defnull/multipart/raw/master/LICENSE\n\nCode and documentation are available under MIT License (see LICENSE__).\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Parser for multipart/form-data",
"version": "1.2.0",
"project_urls": {
"Changelog": "https://multipart.readthedocs.io/en/latest/changelog.html",
"Documentation": "https://multipart.readthedocs.io/",
"Homepage": "https://multipart.readthedocs.io/",
"Issues": "https://github.com/defnull/multipart/issues",
"PyPI": "https://pypi.org/project/multipart/",
"Source": "https://github.com/defnull/multipart"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5a4989bdcbefe6fdb59ef67e7d6d407c88acdce7ca6441b73945f949862081c6",
"md5": "72d590829fc5b589fd6689c1902b6295",
"sha256": "79ecedd8ad13e1b4888224cedcc7caee6b784cb89337b50c83ad24a09c66be0f"
},
"downloads": -1,
"filename": "multipart-1.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "72d590829fc5b589fd6689c1902b6295",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 12915,
"upload_time": "2024-11-28T16:09:47",
"upload_time_iso_8601": "2024-11-28T16:09:47.025905Z",
"url": "https://files.pythonhosted.org/packages/5a/49/89bdcbefe6fdb59ef67e7d6d407c88acdce7ca6441b73945f949862081c6/multipart-1.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f85a66075b21cf7622958e724c482ab9e0c150fe057b20743ec215706bf5dbac",
"md5": "9fb97ddf89edfcd0df55339917cc496d",
"sha256": "fc9ec7177b642e07c3c360126b9c845160376e65db6fcfd04df63d58135e1e8b"
},
"downloads": -1,
"filename": "multipart-1.2.0.tar.gz",
"has_sig": false,
"md5_digest": "9fb97ddf89edfcd0df55339917cc496d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 35932,
"upload_time": "2024-11-28T16:09:48",
"upload_time_iso_8601": "2024-11-28T16:09:48.568133Z",
"url": "https://files.pythonhosted.org/packages/f8/5a/66075b21cf7622958e724c482ab9e0c150fe057b20743ec215706bf5dbac/multipart-1.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-28 16:09:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "defnull",
"github_project": "multipart",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "multipart"
}
