Skip to main content

pyobservable

observable module for python Version: 0.00.02


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

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

How to install

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.02

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.02
File Size Uploaded Provenance Actions
observable-0.00.02.tar.gz 2.9 kB Without provenance Details for observable-0.00.02.tar.gz

Release files / observable-0.00.02.tar.gz

Download URL observable-0.00.02.tar.gz
Size 2.9 kB
Tags Source
SHA-256 checksum
How to use checksums
ef278c1a3e0b7bb15813cfd5f2121e3f0018f1768e3b02afc417058059fca124
BLAKE2b-256 checksum
How to use checksums
53a5ec78332d400eb104ef7526a63ae8962374ab4ccdeb14f7d3eef7fe93a0b4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for observable 0.00.02

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