tiny-listener 0.0.12

lightning-fast, high-performance event handle framework

A lightweight event framework

---

Documentation: https://molto0504.github.io/tiny-listener

Source Code: https://github.com/molto0504/tiny-listener

---

Introduction

Tiny-listener is a lightweight and flexible event framework.

Requirements

Python 3.6+

Installation

$ pip install tiny-listener

Why use tiny-listener

• ✔ Pure Python.
• ✔ Lighting-fast, based on native coroutine.
• ✔ 100% test coverage.

Example

Create a file example.py with:

from tiny_listener import Listener, Event

class App(Listener):
    async def listen(self):
        self.fire("Say hi to Alice")
        self.fire("Say hi to Bob")
        self.fire("Say hi to Carol")

        
app = App()


@app.on_event("Say hi to {name}")
async def say_hi(event: Event):
    print("Hi,", event.params["name"])

Run it:

$ tiny-listener example:app
>>> Hi, Alice
>>> Hi, Bob
>>> Hi, Carol

How it works

• Create your own Listener and listen something(e.g. port, queue ...):

from tiny_listener import Listener, Event

class App(Listener):
   async def listen(self):
      self.fire("Say hi to Alice")
      self.fire("Say hi to Bob")
      self.fire("Say hi to Carol")

• Add event handler to your listener:

app = App()

@app.on_event("Say hi to {name}")
async def say_hi(event: Event):
   print("Hi,", event.params["name"])

• Run listener with command:

$ tiny-listener example:app

• Tiny-listener will dispatch every event automatically:

>>> Hi, Alice
>>> Hi, Bob
>>> Hi, Carol