isabella232 / repository

Repository of LuaDist modules available for installation using the luadist-git command line tool

Primary LuaDist Repository

This repository aggregates all the supported modules of the LuaDist project. Its primary purpose is to provide a manifest for modules. Modules are referenced using git submodules and should always point to individual module repositories in the LuaDist project. Its secondary purpose is to act as an install and bootstrap process for LuaDist based installations.

This repository contains an installation script that allows automated building of LuaDist modules. There are two modes of operation available. First mode is for bootstrapping the luadist deployment utility that offers complete package management functionality and automated dependency resolving. However this requires compilation of openssl and other utilities you may not want.

The second mode of operation directly checks out repositories using git or available submodules and installs the modules without dependency handling. Using this approach you can tailor your distribution from ground up without unneeded dependencies.

Bootstraping LuaDist deployment tool

Please make sure your system has git, CMake 2.8 and a compiler tool-chain available. On Ubuntu this requires git, cmake, build-essential. This build will take quite a while to compile, please be patient.

git clone git://github.com/LuaDist/Repository.git
cd Repository
git submodule update --init --recursive bootstrap
./install bootstrap

Once the installation finishes the LuaDist folder should contain a fully versioned LuaDist distribution.

cd _install/bin
./luadist list # lists installed modules
./luadist search # lists online repository
./luadist install luaexpat # installs luaexpat

Using the install script to generate distribution without versioning.

To make a distribution containing luajit, luasocket and luafilesystem you can use the install utility directly:

./install luajit luasocket luafilesystem

Note that this mode of installation installs most recent versions of modules and does not handle dependencies automatically. If you checked out any of the modules using submodules the utility will use the local files, otherwise it will access remote git repositories. However, the installation script is able to install specific tags of modules. It is up to you to install correct dependencies, otherwise the distribution may be unusable.

./install lua-5.1.4 md5-1.1.2 
./_install/bin/lua
> require "md5"

Cloning

To clone the full repository:

git clone git://github.com/LuaDist/Repository.git
cd Repository
git submodule update --init --recursive

To clone individual modules you can specify the module name as follows:

git submodule update --init --recursive lua

Note that submodules do not point to latest versions of modules but rather to stable versions. To update to latest version do:

cd module
git checkout master
git pull

By default all submodules are accessed using the git:// protocol. Developers can update all remotes to support push through ssl as reqired by GitHub using the following command:

git submodule foreach 'git remote set-url --push origin [email protected]:LuaDist/$path.git'

We also recommend switching all submodules to the master branch using the following command:

git submodule foreach 'git checkout master && git pull'

Contributing

1. Submit a issue with a link to your git repository of the module.
2. A maintainer will fork the module into LuaDist grant you the rights to push changes into it.
3. The maintainer will add a submodule referencing the forked module into this LuaDist/Repository.

Call for Maintainers

If you would like to help us maintain the repository and update modules without maintainers you are more than welcome. Please contact us at our development list