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

Uploaded Source

Built Distribution

python_datauri-1.2.1-py3-none-any.whl (4.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: python_datauri-1.2.1.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.1.tar.gz
Algorithm Hash digest
SHA256 f173c26c6745baa33cd94055d6f3aa49c4e95b6860026874d4eaf5424a5c17b9
MD5 f9a7115b3ac8ff2131ae5d70c5e7cfad
BLAKE2b-256 35fa6441fd73a72591acaa12baec831066961c8be58a0fc7a70df2d6fa2ddc5c

See more details on using hashes here.

File details

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

File metadata

  • Download URL: python_datauri-1.2.1-py3-none-any.whl
  • Upload date:
  • Size: 4.7 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 097ec758f73f7e9bc476f27c8a8c5a7578c9cfca650042d327109b0c95f224d2
MD5 7409abaa7d75abb23b6803e6c0488aaa
BLAKE2b-256 5ad42a2b88549973e1ebb395ced24245de591e46c17bddffd8642ca8bef5cb92

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