https://github.com/peopledoc/multipart-reader

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

approved-public ghec-mig-migrated

Last synced: 3 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/peopledoc/multipart-reader
• Owner: peopledoc
• License: apache-2.0
• Created: 2015-12-29T09:14:47.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2023-02-12T10:48:51.000Z (over 2 years ago)
• Last Synced: 2025-06-26T15:52:17.120Z (5 months ago)
• Topics: approved-public, ghec-mig-migrated
• Language: Python
• Size: 31.3 KB
• Stars: 5
• Watchers: 13
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG
  • License: LICENSE

Awesome Lists containing this project

README

          
================

Multipart Reader

================

.. image:: https://travis-ci.org/novafloss/multipart-reader.svg

   :target: https://travis-ci.org/novafloss/multipart-reader

   :alt: 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 ...