Skip to main content

Multipart/* reader extracted from awsome `aiohttp` project, cf.: http://aiohttp.readthedocs.org/en/stable/multipart.html.

Project description

We are under CI!!

Permits to read a multipart content like, mixed, related, etc.

Thanks to the aiohttp project for the implementation, cf.: http://aiohttp.readthedocs.org/en/stable/multipart.html. Unfortunately lot of people have not yet moved to asyncio, or do not want the full aiohttp stack to read the multipart content.

Here we tried to keep all the aiohttp logic and coverage but the coroutines mechanism.

What it does

It reads the same way multpart/x contents. Lets say we have the following multipart/related content:

>>> import json

>>> from email.mime.multipart import MIMEMultipart
>>> from email.mime.base import MIMEBase

>>> multipart = MIMEMultipart('related')

>>> part = MIMEBase('application', 'json')
>>> part.set_payload(json.dumps({'foo': 'bar'}))
>>> multipart.attach(part)

>>> part = MIMEBase('application', 'octet-stream')
>>> part.set_payload(b"Python will save the world. I don't know how. But it will.")
>>> part.add_header('Content-Disposition', 'attachment', filename='python-save-the-world.txt')
>>> multipart.attach(part)

Here is how we can read it:

>>> import io

>>> from multipart_reader import MultipartReader

>>> content = multipart.as_string().split('\n\n', 1)[1]
>>> headers = dict(multipart.items())

>>> stream = io.BytesIO()
>>> stream.write(content)
>>> stream.seek(0)

>>> reader = MultipartReader(headers, stream)

>>> json_part = reader.next()
>>> json_part.json()
{'foo': 'bar'}

>>> file_part = reader.next()
>>> file_part.read()
"Python will save the world. I don't know how. But it will."

>>> file_part.filename
'python-save-the-world.txt'

That’s it …

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

multipart-reader-0.2.tar.gz (15.3 kB view hashes)

Uploaded Source

Built Distributions

multipart_reader-0.2-py3-none-any.whl (13.6 kB view hashes)

Uploaded Python 3

multipart_reader-0.2-py2-none-any.whl (13.6 kB view hashes)

Uploaded Python 2

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