Metadata-Version: 2.1
Name: data-url
Version: 1.0.0
Summary: UNKNOWN
Home-page: https://github.com/telday/data_url
Author: Ellis Wright
Author-email: ejw393@duck.com
License: UNKNOWN
Project-URL: API Documentation, https://data-url.readthedocs.io/en/latest/#
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.5
Description-Content-Type: text/markdown
License-File: LICENSE

# data_url.py

data_url is a Python 3 library which provides easy methods for creating and working with [data URL's](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs). The full API documentation is available [here](https://data-url.readthedocs.io/en/latest/).

## Examples

### Creating a data URL

If all you need is to create a URL and nothing else there is a shortcut method included so you don't need to directly instantiate the DataURL class.

```python3
import data_url

with open('image.jpeg', 'rb') as image:
  data = image.read()

url = data_url.construct_data_url(mime_type='image/jpeg', base64_encode=True, data=data, data_encoded=False)
```

If you need the information to persist it is recommended to instantiate a class through one of the factory methods on `DataURL`

```python3
import data_url

with open('image.jpeg', 'rb') as image:
  data = image.read()
  
url = data_url.DataURL.from_data('image/jpeg', True, data)
print(str(url))
```

You can access the full data URL by either converting the DataURL object to a string as above or by accessing the `url` attribute.

### Retrieving data from a URL

Given you already have a data URL you can instantiate a DataURL object and retrieve each individual attribute.

```python3
import data_url

raw_url = "data:application/json;base64,ewogICJ0ZXN0IjogMTIzCn0K"

url = data_url.DataURL.from_url(raw_url)

print(url.mime_type, url.is_base64_encoded, url.data)
```


