Metadata-Version: 2.1
Name: aiostalk
Version: 1.1
Summary: A Python 3 asyncio client for the beanstalkd work queue
Home-page: https://github.com/koodaamo/aiostalk
Author: Petri Savolainen
Author-email: petri@koodaamo.fi
License: MIT
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
License-File: LICENSE

aiostalk
==========

aiostalk is a small and shameless Python client library for communicating
with the `beanstalkd`_ work queue.

It is based on (and requires) another library called `greenstalk`_ by Justin Mayhew.


Getting Started
---------------

Presuming beanstalkd running on localhost at standard port.

.. code-block:: pycon

    >>> import asyncio
    >>> import aiostalk
    >>> 
    >>> async def main():
    ...    client = aiostalk.Client(('127.0.0.1', 11300))
    ...    await client.connect()
    ...    job = await client.put('hello')
    ...    print(job.id)
    ...    job = await client.reserve()
    ...    print(job.id)
    ...    print(job.body)
    ...    await client.delete(job)
    ...    await client.close()
    >>> 
    >>> asyncio.run(main())
    1
    1
    hello
    
Using the Client as an asyncio context manager is also supported.


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

Please see greenstalk docs at `Read the Docs`_.

.. _`beanstalkd`: https://beanstalkd.github.io/
.. _`greenstalk`: https://github.com/justinmayhew/greenstalk
.. _`protocol`: https://raw.githubusercontent.com/beanstalkd/beanstalkd/master/doc/protocol.txt
.. _`Read the Docs`: https://greenstalk.readthedocs.io/


