Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Registration and supervision framework for the gen_event behaviour
Erlang
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
src
.gitignore
LICENCE
README.md
gen_event_registrar.epm
rebar
rebar.config

README.md

Gen-Event Registrar

This application provides a simple mechanism for supervising gen_event event handlers, packaged as an OTP library for convenient reuse.

Rationale

OTP's gen_event mechanism is different from the other OTP behaviours, because the (user) callback module does not represent (i.e, is not run in) its own, separate process. Using the standard OTP gen_event mechanism, an event hander callback module that crashes will be silently removed from its event manager. Because the event handler is not a process, it is not therefore possible to have the handler participate in a supervision tree. To compensate for this apparent lack, the gen_event module exports an add_sup_handler/3 method which offers the calling process a contract which promises notification of exit/error signals in the callback module, delivered to its message queue.

This library takes advantage of this supervision mechanism, wrapping up all the details and providing a pre-packaged supervision tree for event managers and handlers, with a simple API and configuration system for managing all the above.

License

The gen_event_registrar package is licensed under a permissive, BSD-like license, which allows for combined with other works under different (sub) license conditions.

Releases

This project will use semantic versioning, and all major releases will be made available as binary packages via github downloads and via the nebularis-maven-repository.

Something went wrong with that request. Please try again.