Metadata-Version: 2.1
Name: lightbus
Version: 1.0.2
Summary: RPC & event framework for Python 3
Home-page: https://lightbus.org
Keywords: python,messaging,redis,bus,queue
Author: Adam Charnock
Author-email: adam@adamcharnock.com
Requires-Python: >=3.7
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Communications
Classifier: Topic :: System :: Networking
Requires-Dist: aioredis (>=1.2.0)
Requires-Dist: jsonschema (>=3.2)
Requires-Dist: pyyaml (>=3.12)
Project-URL: Documentation, https://lightbus.org
Project-URL: Repository, https://github.com/adamcharnock/lightbus/
Description-Content-Type: text/x-rst


What is Lightbus?
=================


.. image:: https://img.shields.io/circleci/build/github/adamcharnock/lightbus
   :target: https://circleci.com/gh/adamcharnock/lightbus/tree/master
   :alt: CircleCI


.. image:: https://api.codacy.com/project/badge/Grade/801d031fd2714b4f9c643182f1fbbd0b
   :target: https://www.codacy.com/app/adamcharnock/lightbus?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=adamcharnock/lightbus&amp;utm_campaign=Badge_Grade
   :alt: Codacy Badge


.. image:: https://api.codacy.com/project/badge/Coverage/801d031fd2714b4f9c643182f1fbbd0b
   :target: https://www.codacy.com/app/adamcharnock/lightbus?utm_source=github.com&utm_medium=referral&utm_content=adamcharnock/lightbus&utm_campaign=Badge_Coverage
   :alt: Codacy Badge


.. image:: https://img.shields.io/discord/645218336229031946
   :target: https://discord.gg/2j594ws
   :alt: Discord


.. image:: https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg
   :target: https://lightbus.org/reference/code-of-conduct/
   :alt: Contributor Covenant


Lightbus allows your backend processes to communicate, run background tasks,
and expose internal APIs.

Lightbus uses Redis as its underlying transport, although support
for other platforms may eventually be added.

Lightbus requires Python 3.7 or above.

**Full documentation can be found at https://lightbus.org**

Designed for ease of use
------------------------

Lightbus is designed with developers in mind. The syntax aims to
be intuitive and familiar, and common problems are caught with
clear and helpful error messages.

For example, a naïve authentication API:

.. code-block:: python3

   class AuthApi(Api):
       user_registered = Event(parameters=('username', 'email'))

       class Meta:
           name = 'auth'

       def check_password(self, user, password):
           return (
               user == 'admin'
               and password == 'secret'
           )

This can be called as follows:

.. code-block:: python3

   import lightbus

   bus = lightbus.create()

   bus.auth.check_password(
       user='admin',
       password='secret'
   )
   # Returns true

You can also listen for events:

.. code-block:: python3

   import lightbus

   bus = lightbus.create()

   def send_signup_email(event_message,
                         username, email):
       send_mail(email,
           subject=f'Welcome {username}'
       )

   @bus.client.on_start()
   def bus_start():
       bus.auth.user_registered.listen(
           send_signup_email
       )

**To get started checkout the documentation at https://lightbus.org.**

