lux-cli(1) General Commands Manual lux-cli(1) NAME lux-cli - A luxurious package manager for Lua SYNOPSIS lux-cli [--dev] [--server] [--extra-servers] [--only-sources] [--namespace] [--lua-dir] [--lua-version] [--tree] [--cache-dir] [--data-dir] [--vendor-dir] [--variables] [--verbose] [--no-progress] [--nvim] [--timeout] [--max-jobs] [--no-luarc] [-h|--help] [-V|--version] DESCRIPTION A luxurious package manager for Lua OPTIONS --dev Enable the sub-repositories in luarocks servers for rockspecs of in-development versions --server Fetch rocks/rockspecs from this server (takes priority over config file) --extra-servers Fetch rocks/rockspecs from this server in addition to the main server{n} (overrides any entries in the config file) --only-sources Restrict downloads to paths matching the given URL --namespace Specify the luarocks server namespace to use --lua-dir Specify the directory in which to install Lua{n} if not found --lua-version Which Lua installation to use.{n} Valid versions are: '5.1', '5.2', '5.3', '5.4', 'jit' and 'jit52' --tree Which tree to operate on --cache-dir Specifies the cache directory for e.g. luarocks manifests --data-dir Specifies the data directory (e.g. ~/.local/share/lux) --vendor-dir Specifies a directory with locally vendored sources and RockSpecs.{n} When building or installing a package with this flag,{n} Lux will fetch sources from the instead of from a remote server --variables Override config variables.{n} Example: `lx -v "LUA=/path/to/lua" ...` --verbose Display verbose output of commands executed --no-progress Don't print any progress bars or spinners --nvim Configure lux for installing Neovim packages --timeout Timeout on network operations, in seconds.{n} 0 means no timeout (wait forever). Default is 30 --max-jobs Maximum buffer size for parallel jobs, such as downloading rockspecs and installing rocks. 0 means no limit. Default is 0 --no-luarc Do not generate or update a `.luarc.json` file when building{n} a project -h, --help Print help -V, --version Print version SUBCOMMANDS lux-cli-add(1) Add a dependency to the current project lux-cli-build(1) Build/compile a project lux-cli-check(1) [EXPERIMENTAL]{n} Type check the current project based on EmmyLua/LuaCATS annotations.{n} Respects `.emmyrc.json` and `.luarc.json` files in the project directory lux-cli-config(1) Interact with the lux configuration lux-cli-completion(1) Generate autocompletion scripts for the shell.{n} Example: `lx completion zsh > ~/.zsh/completions/_lx` lux-cli-debug(1) Internal commands for debugging Lux itself lux-cli-doc(1) Show documentation for an installed rock lux-cli-download(1) Download a specific rock file from a luarocks server lux-cli-fmt(1) Formats the codebase with stylua lux-cli-generate-rockspec(1) Generate a rockspec file from a project lux-cli-info(1) Show metadata for any rock lux-cli-install(1) Install a rock for use on the system lux-cli-install-rockspec(1) Install a local rockspec for use on the system lux-cli-install-lua(1) Manually install and manage Lua headers for various Lua versions lux-cli-lint(1) Lint the current project using `luacheck` lux-cli-list(1) List currently installed rocks lux-cli-lua(1) Run lua, with the `LUA_PATH` and `LUA_CPATH` set to the specified lux tree lux-cli-new(1) Create a new Lua project lux-cli-outdated(1) List outdated rocks lux-cli-pack(1) Create a packed rock for distribution, packing sources or binaries lux-cli-path(1) Return the currently configured package path lux-cli-pin(1) Pin an existing rock, preventing any updates to the package lux-cli-purge(1) Remove all installed rocks from a tree lux-cli-remove(1) Remove a rock from the current project's lux.toml dependencies lux-cli-run(1) Run the current project with the provided arguments lux-cli-exec(1) Execute a command that has been installed with lux. If the command is not found, a package named after the command will be installed lux-cli-search(1) Query the luarocks servers lux-cli-test(1) Run the test suite in the current project directory.{n} Lux supports the following test backends, specified by the `[test]` table in the lux.toml:{n} {n} - busted:{n} {n} https://lunarmodules.github.io/busted/{n} {n} Example:{n} {n} ```toml{n} [test]{n} type = "busted"{n} flags = [ ] # Optional CLI flags to pass to busted{n} ```{n} {n} `lx test` will default to using `busted` if no test backend is specified and:{n} * there is a `.busted` file in the project root{n} * or `busted` is one of the `test_dependencies`).{n} {n} - busted-nlua:{n}: {n} [currently broken on Windows]{n} A build backend for running busted tests with Neovim as the Lua interpreter. Used for testing Neovim plugins. {n} Example:{n} {n} ```toml{n} [test]{n} type = "busted-nlua"{n} flags = [ ] # Optional CLI flags to pass to busted{n} ```{n} {n} `lx test` will default to using `busted-nlua` if no test backend is specified and:{n} * there is a `.busted` file in the project root{n} * or `busted` and `nlua` are `test_dependencies`.{n} {n} - command:{n} {n} Name/file name of a shell command that will run the test suite.{n} Example:{n} {n} ```toml{n} [test]{n} type = "command"{n} command = "make"{n} flags = [ "test" ]{n} ```{n} {n} - script:{n} {n} Relative path to a Lua script that will run the test suite.{n} Example:{n} {n} ```toml{n} [test]{n} type = "script"{n} script = "tests.lua" # Expects a tests.lua file in the project root{n} flags = [ ] # Optional arguments passed to the test script{n} ```{n} lux-cli-uninstall(1) Uninstall a rock from the system lux-cli-unpin(1) Unpins an existing rock, allowing updates to alter the package lux-cli-update(1) Updates all rocks in a project lux-cli-upload(1) Generate a Lua rockspec for a Lux project and upload it to the public luarocks repository.{n} You can specify a source template for release and dev packages in the lux.toml.{n} {n} Example:{n} {n} ```toml{n} [source]{n} url = "https://host.com/owner/$(PACKAGE)/refs/tags/$(REF).zip"{n} dev = "git+https://host.com/owner/$(PACKAGE).git"{n} ```{n} {n} You can use the following variables in the source template:{n} {n} - $(PACKAGE): The package name.{n} - $(VERSION): The package version.{n} - $(REF): The git tag or revision (if in a git repository).{n} - You may also specify environment variables with `$()`.{n} {n} If the `version` is not set in the lux.toml, lux will search the current commit for SemVer tags and if found, will use it to generate the package version lux-cli-vendor(1) Vendor the dependencies of a project or RockSpec locally. When building or installing a package with the `--vendor-dir` option{n} or the `[vendor_dir]` config option, Lux will fetch sources from the {n} instead of from a remote server lux-cli-which(1) Tell which file corresponds to a given module name lux-cli-shell(1) Spawns an interactive shell with PATH, LUA_PATH, LUA_CPATH and LUA_INIT set lux-cli-help(1) Print this message or the help of the given subcommand(s) VERSION v0.25.2 AUTHORS vhyrro , mrcjkb lux-cli 0.25.2 lux-cli(1)