Metadata-Version: 2.0
Name: python-datauri
Version: 0.2.0
Summary: A li'l class for data URI manipulation in Python
Home-page: https://github.com/fcurella/python-datauri/
Author: Flavio Curella
Author-email: flavio.curella@gmail.com
License: MIT
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5

# DataURI.py

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

```shell
$ pip install python-datauri
```

### Parsing

```python
>>> 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 (a string on Python 2).
Use DataURI.text to get the text type (`str` on Python 3.x, `unicode` on Python 2.x).

### Creating from a string

```python
>>> 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
'This is a message.'
```


### Creating from a file

This is really just a convenience method.

```python
>>> from datauri import DataURI
>>> png_uri = DataURI.from_file('somefile.png')
>>> png_uri.mimetype
'image/png'
>>> png_uri.data
'\x89PNG\r\n...'
```

### License

This code is released under the Unlicense (c.f. <http://unlicense.org/>).

### Credits

This is a repackaging of [this Gist](https://gist.github.com/zacharyvoase/5538178)
originally written by Zachary Voase.


