DataURI

Build status of the master branch on Mac/Linux

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. 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...'

Serializing

DataURI is a subclass of str, so you can just use str() to print it out:

>>> from datauri import DataURI
>>> png_uri = DataURI.from_file('somefile.png')
>>> str(png_uri)
'data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAASABIA...'

Pydantic Support

You can use DataURI as a type for Pydantic v1:

from datauri import DataURI
from datauri import DataURI
from pydantic import BaseModel


class ProfilePicture(BaseModel):
  image_data: DataURI

License

This code is released under the Unlicense.

Credits

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

Metadata

Release files for python-datauri 2.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-datauri 2.1.0
File	Size	Uploaded
python-datauri-2.1.0.tar.gz	8.2 kB	Jul 19, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for python-datauri 2.1.0
File	Interpreter	ABI	Platform	Reset
python_datauri-2.1.0-py2.py3-none-any.whl 7.1 kB Jul 19, 2023	Python 3, Python 2	none	any	Details

Total release size: 15.4 kB

Release files / python-datauri-2.1.0.tar.gz

Download URL	python-datauri-2.1.0.tar.gz
Size	8.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`fdffca8b7a19f1e2280da7f348f1cb39592b21d1cdc9092fd2440cd5d7d61fd8`
BLAKE2b-256 checksum How to use checksums	`2728f88775e0b4cca0e46cc04ab5a612f1768f1b234cb839ce5cd0b45cdf178a`
Upload date	Jul 19, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.10.12`

Release files / python_datauri-2.1.0-py2.py3-none-any.whl

Download URL	python_datauri-2.1.0-py2.py3-none-any.whl
Size	7.1 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`17a1dd7eb6c0e84c1e355aba8b6122da3084f1079cb98451def469501bfb1cac`
BLAKE2b-256 checksum How to use checksums	`6ec9fcaabd9cc0a5d06b0d07d379c2a560ec41793228e2c3094853939504b4c6`
Upload date	Jul 19, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.10.12`