: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