Metadata-Version: 1.1
Name: pulsar-cloud
Version: 0.5.5
Summary: Asynchronous clients for AWS and Pusher
Home-page: https://github.com/quantmind/pulsar-cloud
Author: Luca Sbardella
Author-email: luca@quantmind.com
License: BSD
Description: 
        :Badges: |license|  |pyversions| |status| |pypiversion|
        :Master CI: |master-build|_ |coverage-master|
        :Downloads: http://pypi.python.org/pypi/pulsar-cloud
        :Source: https://github.com/quantmind/pulsar-cloud
        :Mailing list: `google user group`_
        :Design by: `Quantmind`_ and `Luca Sbardella`_
        :Platforms: Linux, OSX, Windows. Python 3.5 and above
        :Keywords: amazon, aws, botocore, pusher, websocket, async, pulsar, greenlet
        
        .. |pypiversion| image:: https://badge.fury.io/py/pulsar-cloud.svg
            :target: https://pypi.python.org/pypi/pulsar-cloud
        .. |pyversions| image:: https://img.shields.io/pypi/pyversions/pulsar-cloud.svg
          :target: https://pypi.python.org/pypi/pulsar-cloud
        .. |license| image:: https://img.shields.io/pypi/l/pulsar-cloud.svg
          :target: https://pypi.python.org/pypi/pulsar-cloud
        .. |status| image:: https://img.shields.io/pypi/status/pulsar-cloud.svg
          :target: https://pypi.python.org/pypi/pulsar-cloud
        .. |master-build| image:: https://travis-ci.org/quantmind/pulsar-cloud.svg?branch=master
        .. _master-build: http://travis-ci.org/quantmind/pulsar-cloud
        .. |coverage-master| image:: https://coveralls.io/repos/quantmind/pulsar-cloud/badge.svg?branch=master&service=github
          :target: https://coveralls.io/github/quantmind/pulsar-cloud?branch=master
        
        .. contents:: **CONTENTS**
        
        `CHANGELOG </docs/changelog.md>`_
        
        
        Requirements
        ==================
        
        * Python 3.5 or above
        * pulsar_
        * botocore_
        * greenlet_
        
        
        Botocore
        ==================
        
        This library provides two asynchronous implementations of botocore_.
        
        Some part of the module are taken from aiobotocore_ - `apache LICENSE <https://github.com/aio-libs/aiobotocore/blob/master/LICENSE>`_.
        
        Asyncio Botocore
        --------------------
        
        The first implementation uses asyncio from the python standard libray only and
        requires an asyncio compatible HTTP client such as the pulsar one
        (used by default):
        
        .. code:: python
        
            from cloud.aws import AsyncioBotocore
        
            s3 = AsyncioBotocore('s3', 'us-east-1')
            s3 = await s3.put_object(...)
        
        
        Green Botocore
        ------------------
        
        The second implementation, build on top of asyncio botocore, uses
        pulsar_ and greenlet_ to obtain an implicit asynchronous behaviour.
        
        Usage:
        
        .. code:: python
        
            from cloud.aws import GreenBotocore
            from pulsar.apps.greenio import GreenPool
        
            def execute():
                s3 = GreenBotocore('s3', 'us-east-1')
                ec2.put_object(...)
        
            pool = GreenPool()
            await pool.submit(execute)
        
        
        S3 uploader
        ---------------
        
        Usage::
        
            s3upload <path> -b bucket/my/location
        
        
        Pusher
        ==================
        A client and server pusher_ implementation using
        pulsar_ asynchronous framework.
        Create a pusher instance
        
        .. code:: python
        
            from cloud import Pusher
        
            pusher = Pusher(app_id, key, secret)
        
        
        Subscribe to a channel as a client
        
        .. code:: python
        
            channel = await pusher.subscribe('test_channel')
            channel.bind('event', mycallback)
        
        
        .. _`Luca Sbardella`: http://lucasbardella.com
        .. _`Quantmind`: http://quantmind.com
        .. _`google user group`: https://groups.google.com/forum/?fromgroups#!forum/python-pulsar
        .. _pusher: https://pusher.com/
        .. _pulsar: https://github.com/quantmind/pulsar
        .. _botocore: https://github.com/boto/botocore
        .. _greenlet: https://greenlet.readthedocs.org/en/latest/
        .. _aiobotocore: https://github.com/aio-libs/aiobotocore
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Plugins
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Utilities
