Skip to main content

A li'l class for data URI manipulation in Python

Project description

https://travis-ci.org/fcurella/python-datauri.svg?branch=master https://coveralls.io/repos/github/fcurella/python-datauri/badge.svg?branch=master

Data URI manipulation made easy.

This isn’t very robust, and will reject a number of valid data URIs. However, it meets the most useful case: a mimetype, a charset, and the base64 flag.

Installation

$ pip install python-datauri

Parsing

>>> from datauri import DataURI
>>> uri = DataURI('data:text/plain;charset=utf-8;base64,VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wZWQgb3ZlciB0aGUgbGF6eSBkb2cu')
>>> uri.mimetype
'text/plain'
>>> uri.charset
'utf-8'
>>> uri.is_base64
True
>>> uri.data
b'The quick brown fox jumped over the lazy dog.'

Note that DataURI.data will always return bytes, (which in Python 2 is the same as a string). Use DataURI.text to get the text type (str on Python 3.x, unicode on Python 2.x).

Creating from a string

>>> from datauri import DataURI
>>> made = DataURI.make('text/plain', charset='us-ascii', base64=True, data='This is a message.')
>>> made
DataURI('data:text/plain;charset=us-ascii;base64,VGhpcyBpcyBhIG1lc3NhZ2Uu')
>>> made.data
b'This is a message.'

Creating from a file

This is really just a convenience method.

>>> from datauri import DataURI
>>> png_uri = DataURI.from_file('somefile.png')
>>> png_uri.mimetype
'image/png'
>>> png_uri.data
b'\x89PNG\r\n...'

License

This code is released under the Unlicense.

Credits

This is a repackaging of this Gist originally written by Zachary Voase.

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

python-datauri-0.2.8.tar.gz (8.4 kB view details)

Uploaded Source

Built Distribution

python_datauri-0.2.8-py2.py3-none-any.whl (7.6 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file python-datauri-0.2.8.tar.gz.

File metadata

File hashes

Hashes for python-datauri-0.2.8.tar.gz
Algorithm Hash digest
SHA256 5d6062ff85bc785a2230c40151d5aded80f1ce8652d5a31e3a64c78aa6e52a20
MD5 a9a361be5e5071478231ebf52ecc9a49
BLAKE2b-256 7b8dc51c4fd9513a9a8f6b10db8bb89fd43afad4c24819d1d113e03268aeca2e

See more details on using hashes here.

File details

Details for the file python_datauri-0.2.8-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for python_datauri-0.2.8-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 68e8699cf2754a66f185f486c8d4c73e7ee5304aa53253bad0434fdbbde3f0b7
MD5 53555e7e17403bf14fba811a61d9bad1
BLAKE2b-256 80c26f31183e02912dfff286dbf321ce01ac6ff5dd20453f2f72989292a80de5

See more details on using hashes here.

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