lua-any(1)

NAME
lua-any - Helper script for multi-Lua-version shebang lines

DESCRIPTION
Some Lua scripts work with multiple versions of Lua but not all of them. The upstream author of the software may hence have chosen the loose shebang line:

                #!/usr/bin/env lua

In Debian /usr/bin/lua is a valid Lua interpreter but it is under the control of the user, that can set its value to the Lua version of its choice, even one that is not able to run the script in question.

lua-any is a helper that understands metadata written in comments and selects a valid Lua interpreter. Example:

                #!/usr/bin/env lua-any
                -- Lua-Versions: 5.1 5.3

lua-any tests in turn the existence of lua5.1 and lua5.3 and executes the script with the first existing interpreter.

SYNTAX
lua-any looks only at the first 10 lines of the script for metadata, i.e. it processes the file trough the head utility.

The format of a line is essentially key:value, where leading and trailing spaces are removed from value. The key is matched in a case insensitive way. The Lua comment, --, must have no leading spaces.

The following keys are supported:

Lua-Versions
    Space separated list of Lua versions.

Lua-Root
    The common root of all interpreters. By default its value is /usr/bin/lua. Each Lua version selected in Lua-Versions is simply appended to it in order to obtain the full name of the interpreter.

Lua-Args
    Extra arguments to be passed to Lua interpreters, like -l lfs. By default this is empty.

DEBIAN NOTES
A package using lua-any should declare its dependencies on Lua interpreters using a disjunction. Example:

                Depends: lua-any, lua5.1 | lua5.3

AUTHOR
Enrico Tassi <gareuselesinge@debian.org>