Skip to content
This repository has been archived by the owner on Nov 20, 2020. It is now read-only.

LuaDist: Configuration

Jump to bottom
drahosp edited this page Mar 12, 2013 · 3 revisions

Configuration

LuaDist is configured using a Lua configuration file which is available in lib/lua/dist/config.lua. This file is automatically generated when LuaDist is built and does not require changes in most cases.

If needed configuration values can be changed using the luadist commandline arguments, this is described in the [Use](LuaDist: Use) document. However if you would like to change how LuaDist behaves to better fit your need you can edit the following options.

Behaviour

Following variables in the configuration file affect the behavior of LuaDist.

  • binary - true by default. Allows the use of binary dists. This should be disabled in source only distribution. Enabled in binary distribution.
  • source - true by default. Allows the use of souce dists. This will allow LuaDist to build modules from source, requires a C compiler and CMake to be installed. Source and binary dists can be enabled at the same time, binary packages take precedence.
  • test - false by default. Run tests after installing a dist. Currently not fully implemented.
  • debug - false by default. Enabling debug mode will increase verbosity of LuaDist for easier debugging.
  • proxy - false by default. If you need to use proxy type its address here as string.
  • timeout - 10 by default. Timeout for HTTP fetch function, in seconds.

Repositories

LuaDist can use local and remote directories as source of dists. Searching is sequential so repositories mentioned first have higher priority than later entries.

  • repo - List of URLs to Git repositories. Eg. "git://github.com/LuaDist/Repository.git". Repositories are searched in sequence for when searching for modules.

The following rules apply:

  • First repositories have higher priority.
  • Only git:// protocol is supported
  • Repositories must contain submodules and .gitmodules file with git:// URLs to modules.

CLI Override

Any LuaDist configuration option can be set up from the command-line interface. Lists and even CMake variables can be defined as follows:

> bin/luadist _test install luadist -source=true -binary=false --repo="git://github.com/LuaDist/Repository.git" -DCMAKE_BUILD_TYPE="Debug"
Clone this wiki locally