Skip to main content

An event dispatch framework designed to be used with the Bevy dependency injection framework.

Project description

Bevy.Events

Bevy.Events is an events system designed to be used with the Bevy dependency injection framework. It uses Gully for creating observable streams of event objects.

Installation

pip install bevy.events

Documentation

Bevy.Events is incredibly straightforward. You can use it as an annotation type on any injectable class.

@bevy.injectable
class Example:
    events: bevy.events.EventDispatch
    ...

It is also possible to have multiple event dispatchers in the same Bevy context by giving them names.

@bevy.injectable
class Example:
    events: bevy.events.EventDispatch["my-event-dispatch"]
    ...

To send an event use the dispatch on the event dispatch and pass it the event name to dispatch and all the args to pass to the watchers.

@bevy.injectable
class Example:
    events: bevy.events.EventDispatch
    ...

    async def recieved_message(self, message):
        await self.dispatch("message-received", message)

To register a watcher just call watch on the event dispatch and pass it an event name to watch for and a coroutine callback. The callback will be passed all args that were given to the dispatch method.

@bevy.injectable
class Example:
    events: bevy.events.EventDispatch
    def __init__(self):
        self.events.watch("message-received", self.on_message_received)
    async def on_message_received(self, message):
        ...

watch returns a Gully observer so that the event watcher can be enabled or disabled as needed.

The event dispatchers will be shared by all class instances in the Bevy context. Events dispatched on a named dispatcher will only be sent to watchers of that event dispatcher. Any class in the context can access the same same event dispatcher just by giving the annotation the same name.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Bevy.events-0.1.4.tar.gz (3.8 kB view hashes)

Uploaded source

Built Distribution

Bevy.events-0.1.4-py3-none-any.whl (4.2 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page