A li'l class for data URI manipulation in Python
Project description
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 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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file python_datauri-2.1.1.tar.gz
.
File metadata
- Download URL: python_datauri-2.1.1.tar.gz
- Upload date:
- Size: 8.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.13
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 842614009a2347cd7bf593aff124f371671eff6df06ab14bbdf643f230c2bfd9 |
|
MD5 | 34210bdd61cc932fa52e61c94750c380 |
|
BLAKE2b-256 | 74a6f26405673d841208af6eb80f161638a55597f1d25569ccbe1bfb52f9fd08 |
Provenance
File details
Details for the file python_datauri-2.1.1-py2.py3-none-any.whl
.
File metadata
- Download URL: python_datauri-2.1.1-py2.py3-none-any.whl
- Upload date:
- Size: 5.6 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.13
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | a952f1dba9103631536b0c01ca946f5a0afecb32e4a4e8ea6029c7f250073389 |
|
MD5 | 10304170aaafa540cb409eb66603988d |
|
BLAKE2b-256 | 61c12c369dbbf2d05582a2b78c59bdc41d80e3837c04b2c426a94e387e47308e |