Skip to main content

pyobservable

observable module for python Version: 0.00.03


Writing this module was an inspiration by https://github.com/js-coder/observable.

Author: Timo Furrer tuxtimo@gmail.com Version: 0.00.03

How to install

Over pip:

$ pip install observable

Just clone this repository with:

$ git clone https://github.com/timofurrer/pyobservable.git

and install it with:

# python setup.py install

Note: you may need root privileges to execute setup.py

with make

When you have cloned the repository you can install it with

sudo make install

If you want to install just if all nose tests are passing

sudo make

nose tests

There are some nose tests in the test/ directory. If you haven’t installed nose yet - do it with

sudo pip install nose

After you’ve nose installed - test pyobservable with:

make tests

The output should be something like:

nosetests -v
test event registering with the on decorator ... ok
test event registering with the on method ... ok
test event registering with the once decorator ... ok
test event registering with the once method ... ok
test event triggering with event registered with on ... ok
test event triggering with event registered with once ... ok
test exception raising for not existing events ... ok
test obs.off method ... ok
test exception raising in the off method ... ok
test event triggering with arguments ... ok
test event triggering with argument list ... ok
test event triggering with keyword-arguments ... ok

----------------------------------------------------------------------
Ran 12 tests in 0.003s

OK

… where just the last OK is important!

How to use

Import it with the following statement in your own program

```python from observable import Observable

obs = Observable() ```

on: Register event handler with on

There are two ways to register a function to an event. The first way is to register the event with a decorator like this:

python @obs.on("error") def error_func(message): print("Error: %s" % message)

The second way is to register it with a method call:

python def error_func(message): print("Error: %s" % message) obs.on("error", error_func)

once: Register event handler with once

once works like on, but once the event handler is triggered it will be removed and cannot be triggered again.

trigger: trigger event

You can trigger a registered event with the trigger method:

python obs.trigger("error", "This is my error message")

If no handler for the event error could be found an Observable.NoHandlerFound-Exception will be raised.

off: remove handler and events

Remove a handler from a specified event:

python obs.off("error", error_func)

python obs.off("error", [error_func, second_error_func])

Remove all handlers from a specified event:

python obs.off("error")

Clear all events:

python obs.off()

Metadata

Release files for observable 0.00.03

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for observable 0.00.03
File Size Uploaded Provenance Actions
observable-0.00.03.tar.gz 2.9 kB Without provenance Details for observable-0.00.03.tar.gz

Release files / observable-0.00.03.tar.gz

Download URL observable-0.00.03.tar.gz
Size 2.9 kB
Tags Source
SHA-256 checksum
How to use checksums
0ac95d135748ea7034ab2df9928c2ad63a71392883389b54221e4b1f9e3360a6
BLAKE2b-256 checksum
How to use checksums
708f510d91a8ce6f9a3f151bd44068f8ea6745e584c6eeec0d582e0e3da82b9a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for observable 0.00.03

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page