Metadata-Version: 2.0
Name: aslack
Version: 0.3.3
Summary: Asynchronous Slack API integration.
Home-page: http://github.com/textbook/aslack/
Author: Jonathan Sharpe
Author-email: mail@jonrshar.pe
License: License :: OSI Approved :: ISC License (ISCL)
Platform: any
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Communications :: Chat
Requires-Dist: aiohttp (>=0.15.0)

aSlack
======

*/əˈslæk/*

.. image:: https://img.shields.io/pypi/v/aslack.svg
    :target: https://pypi.python.org/pypi/aslack
    :alt: PyPI Version

.. image:: https://travis-ci.org/textbook/aslack.svg
    :target: https://travis-ci.org/textbook/aslack
    :alt: Travis Build Status

.. image:: https://coveralls.io/repos/textbook/aslack/badge.svg?branch=master&service=github
    :target: https://coveralls.io/github/textbook/aslack?branch=master
    :alt: Code Coverage

.. image:: https://www.quantifiedcode.com/api/v1/project/482551d8368740c68fb1d3e80c4f6664/badge.svg
    :target: https://www.quantifiedcode.com/app/project/482551d8368740c68fb1d3e80c4f6664
    :alt: Code Issues

.. image:: https://img.shields.io/badge/license-ISC-blue.svg
    :target: https://github.com/textbook/aslack/blob/master/LICENSE
    :alt: ISC License

aSlack is a lightweight, asynchronous wrapper for Slack's Web and Real-Time
Messaging (RTM) APIs, designed to allow the easy development of Slack tools and
bots in Python. It defines two principal components:

- ``SlackApi`` - a wrapper around the Web API; and
- ``SlackBot`` - a messaging bot built on top of the RTM API.

Compatibility
-------------

aSlack uses asyncio_ with the ``async`` and ``await`` syntax, so is only
compatible with Python versions 3.5 and above.

Dependencies
------------

Asynchronous HTTP and WebSocket functionality is provided by aiohttp_ (version
0.15 and above required for out-of-the-box WebSocket client support).

Documentation
-------------

aSlack's documentation is available on PythonHosted_.

Installation
------------

aSlack is available through the Python Package Index, PyPI_, you can install it
with::

    pip install aslack

Alternatively, clone or fork the repository and use e.g.::

    python setup.py develop

to install locally for development. In this case, you should also install the
development dependencies (ideally in a ``virtualenv``) using::

    pip install -r requirements.txt

.. _aiohttp: http://aiohttp.rtfd.org/
.. _asyncio: https://docs.python.org/3/library/asyncio.html
.. _PyPI: https://pypi.python.org/pypi
.. _PythonHosted: http://pythonhosted.org/aslack/

