NAME

Emilua - Lua execution engine

SYNOPSIS

emilua [OPTION]... SCRIPT_FILE
emilua -h|--help
emilua --version

DESCRIPTION

Emilua glues a LuaJIT interpreter to the Boost.Asio execution engine by exposing fiber and async IO APIs. It also allows multiple Lua VMs to share the same execution context and to communicate with each other through actor-inspired APIs. Threading capabilities are also exposed. In short, Emilua is a complete execution engine for Lua.

If SCRIPT_FILE is a directory, the file init.lua inside this directory is executed.

OPTIONS

--main-context-concurrency-hint HINT

Use HINT=1 to inform spawn_context_threads() won’t be called from the main execution context and enable a few optimisations. Recompile Emilua with the proper configure flags to enable even more aggressive optimizations. Check <https://www.boost.org/doc/libs/1_72_0/doc/html/boost_asio/overview/core/concurrency_hint.html> for more info.

The default is HINT=0.

The old default was HINT=safe.

--test

Run the application with _CONTEXT="test".

This _CONTEXT propagates to imported modules and is meant to trigger the execution of unit tests written in every module from the application. This _CONTEXT won’t propagate to imported external modules.

-h, --help

Show help and exit.

--version

Show version and exit.

ENVIRONMENT

EMILUA_COLORS=1

Disable colour support auto-detection and force colour output on log messages.

EMILUA_COLORS=0

Disable colour support on log messages altogether.

EMILUA_PATH

A colon-separated list of directories to augment the default search path for modules. The modules from this search set have higher priority than the ones in the default search path. On Windows, the list is semicolon-separated.

EMILUA_LOG_LEVELS

A comma-separated list of log specs. Each spec is a colon-separated pair where second element is a number indicating maximum log level (inclusive) and the first element indicates the affected log category. You can optionally pass a spec containing just the log level that will affect the default category as the first spec.

Example:

EMILUA_LOG_LEVELS="2,glib:7,dbus:3" emilua src/init.lua

AUTHOR

Vinícius dos Santos Oliveira