Metadata-Version: 1.2
Name: python-datauri
Version: 0.2.9
Summary: A li'l class for data URI manipulation in Python
Home-page: https://github.com/fcurella/python-datauri/
Maintainer: Flavio Curella
Maintainer-email: flavio.curella@gmail.com
License: MIT
Description: DataURI
        =======
        
        .. image:: https://travis-ci.org/fcurella/python-datauri.svg?branch=master
            :target: https://travis-ci.org/fcurella/python-datauri
        
        
        .. image:: https://coveralls.io/repos/github/fcurella/python-datauri/badge.svg?branch=master
            :target: https://coveralls.io/github/fcurella/python-datauri?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
        ------------
        
        .. code-block:: bash
        
          $ pip install python-datauri
        
        
        Parsing
        -------
        
        .. code-block:: 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, (which in Python 2 is the same as a string).
        Use ``DataURI.text`` to get the text type (``str`` on Python 3.x, ``unicode`` on Python 2.x).
        
        Creating from a string
        ----------------------
        
        .. code-block:: 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
          b'This is a message.'
        
        Creating from a file
        --------------------
        
        This is really just a convenience method.
        
        .. code-block:: python
        
          >>> from datauri import DataURI
          >>> png_uri = DataURI.from_file('somefile.png')
          >>> png_uri.mimetype
          'image/png'
          >>> png_uri.data
          b'\x89PNG\r\n...'
        
        License
        -------
        
        This code is released under the `Unlicense <http://unlicense.org/>`_.
        
        Credits
        -------
        
        This is a repackaging of `this Gist <https://gist.github.com/zacharyvoase/5538178>`_
        originally written by `Zachary Voase <https://github.com/zacharyvoase>`_.
        
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.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
