erlang-templates

erlang-templates copied to clipboard

SUMMARY:

The Erlang Open Telecom Platform (OTP) is a set of libraries and practices for building robust services. It relies on 'behaviors', callback modules implementing common patterns like state machines, servers, event handlers, and others.

This is a powerful tool with many benefits, but involves some boilerplate code when you start a new module. These templates solve that problem.

GUIDELINES:

Export wrapper functions for messages, to ensure a clean interface. Example: add_user(Uid) -> gen_fsm:send_event(?MODULE, {add, Foo}). kick_user(Uid) -> gen_fsm:send_event(Uid, kick).

Use edoc tags (@doc and @spec mostly) in your comments, it's trivial to do and produces great-looking docs. (See: erl -man edoc, or man 3 edoc.) The @spec tag in particular is crucial, to avoid dynamic typing mismatch screwups!

TODO:

cover the major stuff, gen_fsm, gen_server, gen_event, supervisor, app, etc link useful docs from README (OTP, Erlang, tutorials on designing/making OTP supervision trees, and edoc?) ensure everything necessary is present edoc support, comments, consistency, vsn tag

OTHER STUFF:

extras/ contains miscellaneous code ffi/ contains FFI tests/attempts, mostly doesn't work examples/ contains interesting reference code