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

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

Uploaded Source

Built Distribution

python_datauri-2.1.0-py2.py3-none-any.whl (7.1 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

  • Download URL: python-datauri-2.1.0.tar.gz
  • Upload date:
  • Size: 8.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.12

File hashes

Hashes for python-datauri-2.1.0.tar.gz
Algorithm Hash digest
SHA256 fdffca8b7a19f1e2280da7f348f1cb39592b21d1cdc9092fd2440cd5d7d61fd8
MD5 3ab1f6c87a76dca36d8f521caabcb41c
BLAKE2b-256 2728f88775e0b4cca0e46cc04ab5a612f1768f1b234cb839ce5cd0b45cdf178a

See more details on using hashes here.

Provenance

File details

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

File metadata

File hashes

Hashes for python_datauri-2.1.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 17a1dd7eb6c0e84c1e355aba8b6122da3084f1079cb98451def469501bfb1cac
MD5 a19658f51ce58779495413d700bdf564
BLAKE2b-256 6ec9fcaabd9cc0a5d06b0d07d379c2a560ec41793228e2c3094853939504b4c6

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