Metadata-Version: 2.1
Name: mimebytes
Version: 0.1.1
Summary: Make repr of bytes better in ipython
Author-email: Bane Sullivan <hello@banesullivan.com>
Project-URL: Bug Tracker, https://github.com/banesullivan/mimebytes/issues
Project-URL: Source Code, https://github.com/banesullivan/mimebytes
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE

# mimebytes

- Make repr of `bytes` better in ipython
- Rich outputs in Jupyter using `_repr_png_` and `_repr_jpeg_`

```ipython
In [1]: from mimebytes import ImageBytes

In [2]: with open('image.png', 'rb') as f:
   ...:     content = f.read()

In [3]: ImageBytes(content, 'image/png')
Out[3]: ImageBytes<376151> (image/png)
```

![preview](https://raw.githubusercontent.com/banesullivan/mimebytes/main/jupyter.png)

## Why?

Have you ever tried to output a bytes object in ipython and seen a garbled mess
like the following? *If so, then this is for you.*

```ipython
In [1]: with open('image.png', 'rb') as f:
   ...:     content = f.read()
   ...:

In [2]: content
Out[2]: b'\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR\x00\x00\x02\x00\x00\x00\x01\xd1\x08\x06\x00\x00\x00\x1c\xf2\x01\xed\x00\x00 \x00IDATx\x9c\xec\xbdy\x9cfWU\xef\xfd\xddk\xefs\x9e\xb1\xc6\xee\xeaNO\xe9$\x9d9\x84$\x1d\x08\x19\x84@\x80\x10@\x01\x15d\x14D\x05\x15\x05\x05\xe1\xe2\xf0^\xbdr\xf5\xeau\x06\x04E#*<... continues on forever>
```
