lights FAQ Forum
This package

Standard Libraries


Structured exceptions for Lua

local errors = require'errors'

This is an API that adds structured exceptions to Lua. Exceptions, like coroutines are not used very frequently in Lua because they solve cross-cutting concerns(*) that don’t appear very often in code. But when they do appear, these devices are invaluable code decluttering tools.

Structured exceptions are an enhancement over string exceptions that enable selective catching and allow providing a context for the failure to help with recovery or logging.

(*) Coroutines address the problem of inversion-of-control head-on. Exceptions address the problem of recoverable failure head-on, so they’re most useful in network I/O contexts.


errors.error base class for errors
errors.error:init() stub: called after the error is created
errors.errortype([classname], [super]) -> eclass create/get an error class
eclass(...) -> e create an error object, [e], ... | e) -> e create/wrap/pass-through an error object[, classes]) -> true|false check an error object type
errors.raise(classname,[e],... | e) (create and) raise an error
errors.catch([classes], f, ...) -> true,... | false,e pcall f and catch errors
errors.pcall(f, ...) -> ... pcall that stores traceback in e.traceback
errors.check(v, ...) -> v | raise(...) assert with specifying an error class
errors.protect(classes, f) -> protected_f turn raising f into a nil,e function
eclass:__call(...) -> e error class constructor
eclass:__tostring() -> s to make error(e) work
eclass.addtraceback add a traceback to errors
e.message formatted error message
e.traceback traceback at error site

In the API classes can be given as 'classname1 ...' or {class1->true}. When in table form, you must include all the superclasses in the table as they are not added automatically!

Last updated: 10 months ago | Edit on GitHub

Pkg type:Lua
Version: 8748747
Last commit:
Author: Cosmin Apreutesei
License: Public Domain

Requires: none

Required by: none