Metadata-Version: 1.1
Name: aioethereum
Version: 0.2.1
Summary: Ethereum RPC client library for Python asyncio (PEP 3156)
Home-page: https://github.com/DeV1doR/aioethereum
Author: Bogdan Kurinnyi
Author-email: bogdankurinniy.dev1@gmail.com
License: MIT
Description-Content-Type: UNKNOWN
Description: |pypi| |travis-ci| |codecov| |docs|
        
        aioethereum
        ===========
        
        Ethereum RPC client library for the `PEP 3156`_ Python event loop.
        
        .. _PEP 3156: http://legacy.python.org/dev/peps/pep-3156/
        
        Features
        --------
        
        ================================  ==============================
        ujson_ support                      Yes
        uvloop_ support                     Yes
        High-level APIs                     Yes
        HTTP support                        Yes
        Unix domain socket (IPC) support    Yes
        SSL/TLS support                     Yes
        Tested CPython versions             `3.4, 3.5, 3.6 <travis_>`_
        Tested Geth versions                `1.7.0 <travis_>`_
        Implemented RPC apis                `admin, db, debug, eth, miner, net, personal, shh, txpool, web3`
        ================================  ==============================
        
        Documentation
        -------------
        
        http://aioethereum.readthedocs.io/
        
        Usage examples
        --------------
        
        Simple high-level interface (through HTTP):
        
        .. code:: python
        
            import asyncio
            import aioethereum
        
            loop = asyncio.get_event_loop()
        
            async def go():
                client = await aioethereum.create_ethereum_client(
                    'http://localhost:8545', loop=loop)
                val = await client.web3_clientVersion()
                print(val)
        
            loop.run_until_complete(go())
            # will print like 'Geth/v1.7.0-stable-6c6c7b2a/darwin-amd64/go1.9'
        
        
        or via IPC
        
        .. code:: python
        
            import asyncio
            import aioethereum
        
            loop = asyncio.get_event_loop()
        
            async def go():
                client = await aioethereum.create_ethereum_client(
                    'ipc://<path_to_unix_socket>', loop=loop)
                val = await client.web3_clientVersion()
                print(val)
        
            loop.run_until_complete(go())
            # will print like 'Geth/v1.7.0-stable-6c6c7b2a/darwin-amd64/go1.9'
        
        
        Requirements
        ------------
        
        * Python_ 3.3+
        * asyncio_ or Python_ 3.4+
        * ujson_
        * aiohttp_
        
        .. note::
        
            ujson is preferred requirement.
            Pure C JSON encoder and decoder is implemented as well and can be used
            automatically when installed.
        
        
        License
        -------
        
        The aioethereum is offered under MIT license.
        
        .. _Python: https://www.python.org
        .. _asyncio: https://pypi.python.org/pypi/asyncio
        .. _aiohttp: https://pypi.python.org/pypi/aiohttp
        .. _ujson: https://pypi.python.org/pypi/ujson
        .. _uvloop: https://pypi.python.org/pypi/uvloop
        .. _travis: https://travis-ci.org/DeV1doR/aioethereum
        
        
        .. |pypi| image:: https://badge.fury.io/py/aioethereum.svg
            :target: https://badge.fury.io/py/aioethereum
            :alt: Latest version released on PyPi
        
        .. |travis-ci| image:: https://travis-ci.org/DeV1doR/aioethereum.svg?branch=master
            :target: https://travis-ci.org/DeV1doR/aioethereum
            :alt: Travis CI status
        
        .. |docs| image:: https://readthedocs.org/projects/aioethereum/badge/?version=stable
            :target: https://aioethereum.readthedocs.io/
            :alt: Documentation status
        
        .. |codecov| image:: https://codecov.io/gh/DeV1doR/aioethereum/branch/master/graph/badge.svg
            :target: https://codecov.io/gh/DeV1doR/aioethereum
            :alt: Test coverage
        
        .. |license| image:: https://img.shields.io/pypi/l/aioethereum.svg?style=flat&label=license
            :target: https://github.com/DeV1doR/aioethereum/blob/master/LICENSE.md
            :alt: MIT License
        
        0.2.1 (2017-10-08)
        ^^^^^^^^^^^^^^^^^^
        
        * Add admin and debug management apis;
        * Add new tests;
        * Add uvloop support (python 3.5+ required);
        
        
        0.2.0 (2017-10-05)
        ^^^^^^^^^^^^^^^^^^
        
        * Add more docstrings to the code;
        * Add tests for all rpc methods;
        * Add admin and debug;
        * Fix error for unixsocket retring;
        * Fix unixsocket invalid loop for Python 3.4;
        * BaseAsyncIOClient._rpc marked as deprecated and will be removed in 0.3.0;
        
        
        0.1.1 (2017-10-01)
        ^^^^^^^^^^^^^^^^^^
        
        * Add sphinx docs;
        
        
        0.1.0 (2017-09-30)
        ^^^^^^^^^^^^^^^^^^
        
        * Initial release;
        * Ethereum client implemented;
        * WIP on RPC management.
Platform: POSIX
Classifier: License :: OSI Approved :: MIT License
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Operating System :: POSIX
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Framework :: AsyncIO
