Skip to main content

A li'l class for data URI manipulation in Python

Project description

Build status of the master branch on Mac/Linux 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 a string.

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-1.2.0.tar.gz (4.6 kB view details)

Uploaded Source

Built Distribution

python_datauri-1.2.0-py3-none-any.whl (4.8 kB view details)

Uploaded Python 3

File details

Details for the file python_datauri-1.2.0.tar.gz.

File metadata

  • Download URL: python_datauri-1.2.0.tar.gz
  • Upload date:
  • Size: 4.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.3.2 CPython/3.10.5 Darwin/22.4.0

File hashes

Hashes for python_datauri-1.2.0.tar.gz
Algorithm Hash digest
SHA256 3deb5abb4e5a4a65bc324e8799a31743cb6e8aee5096bc000431ab229a388d53
MD5 f918405e12a589f46c931f8c4b942045
BLAKE2b-256 bdd633a5ef22827f940d8e6930c90eb59cf6a1f1d7838cef0dc870f6046ada96

See more details on using hashes here.

Provenance

File details

Details for the file python_datauri-1.2.0-py3-none-any.whl.

File metadata

  • Download URL: python_datauri-1.2.0-py3-none-any.whl
  • Upload date:
  • Size: 4.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.3.2 CPython/3.10.5 Darwin/22.4.0

File hashes

Hashes for python_datauri-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 19e1046fcfdde68274c086fc9679a8a144ad0dfc9a38dc16c981424bdf687f71
MD5 1fe9ec4a998e20d77d2779ca69088dcf
BLAKE2b-256 6f139fac68d36dd4ad7936c77402c78f00bbde3c0681e7c16c3443b294d557c4

See more details on using hashes here.

Provenance

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