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

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.

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

Uploaded Source

Built Distribution

python_datauri-2.2.0-py2.py3-none-any.whl (5.7 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

  • Download URL: python_datauri-2.2.0.tar.gz
  • Upload date:
  • Size: 8.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.5

File hashes

Hashes for python_datauri-2.2.0.tar.gz
Algorithm Hash digest
SHA256 8fa58222975fee541ce39e6b0b9d5653cefcc2481ad2629efc0378d48b13f43b
MD5 5c50ec28dbc03d3e2031f322941f6152
BLAKE2b-256 565233d83724f3d9681c2364bce421ca7a42bc9ff64f635a902164af0d42c5df

See more details on using hashes here.

Provenance

File details

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

File metadata

File hashes

Hashes for python_datauri-2.2.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 8fdbd6fc544a936eb492aa609ac457b08bbd7b9a77819c555805372cc76d7118
MD5 b542f6c78a8eae52cb7dcd52baac0fc1
BLAKE2b-256 fbcb2f12fbd0637c3950e139c63bc076eceb25ac1589e947104466a13f2080e4

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