pyobservable
provides a simple event system for Python with weak reference support.
This ensures that the event handlers do not stay in memory when they aren't needed anymore.
pyobservable
can be installed using pip
:
$ pip install pyobservable
Alternatively, you can download the repository and run the following command from within the source directory:
$ python setup.py install
For a quick start, a minimal example is:
from pyobservable import Observable
obs = Observable()
obs.add_event('foo')
obs.add_event('bar')
# Event keys can be any object that is hashable
event = object()
obs.add_event(event)
# Binding with decorator usage
@obs.bind('foo')
def foo_handler(foo_number):
print('foo_handler called:', foo_number)
# Binding with function usage
def bar_handler(bar_list):
print('bar_handler called:', bar_list)
obs.bind('bar', bar_handler)
obs.notify('foo', 1)
obs.notify('bar', [1, 2, 3])
The rationale behind the requirement to add events before binding to them is to ensure the code is less error-prone from mistyping event names.
Also, if a duplicated event key is present, ValueError
will be raised.
However, the next example shows that event registration can be simplified using the special _events_
attribute:
from pyobservable import Observable
class EventEmitter(Observable):
_events_ = ['foo', 2]
def triggers_foo(self):
self.notify('foo', 1, 2, 3)
event_emitter = EventEmitter()
@event_emitter.bind('foo')
def foo_handler(*args):
print(*args)
event_emitter.triggers_foo()
Also note that _events_
can be defined multiple times in an inheritance tree.
Observable
scans the MRO for this attribute and adds every event it finds.
Again, a ValueError
will be raised if a duplicate event key is present.
Finally, here's an advanced and clean example using enum
:
from enum import Enum, auto
from pyobservable import Observable
class EventType(Enum):
FOO = auto()
BAR = auto()
class EventEmitter(Observable):
_events_ = EventType # Enums are iterable
def triggers_foo(self):
self.notify(EventType.FOO, 'foo happened!')
class EventListener:
def on_foo(self, message):
print("Here's a message from foo:", message)
event_emitter = EventEmitter()
event_listener = EventListener()
event_emitter.bind(EventType.FOO, event_listener.on_foo) # pyobservable also supports bound methods
event_emitter.triggers_foo()
For more information, please refer to the Observable
class docstrings.
The simplest way to run tests:
$ python tests.py
As a more robust alternative, you can install tox
(or tox-conda
if you use conda
) to automatically support testing across the supported python versions, then run:
$ tox
Please report any bugs and enhancement ideas using the issue tracker.
pyobservable
is licensed under the terms of the MIT License (see LICENSE.txt for more information).