https://github.com/tieske/luawinmulti

Lua build and installation script for Windows, building multiple Lua versions in parallel, including LuaRocks.
https://github.com/tieske/luawinmulti

Last synced: about 1 month ago
JSON representation

Lua build and installation script for Windows, building multiple Lua versions in parallel, including LuaRocks.

• Host: GitHub
• URL: https://github.com/tieske/luawinmulti
• Owner: Tieske
• License: other
• Created: 2015-11-12T23:22:11.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2024-07-03T12:39:59.000Z (6 months ago)
• Last Synced: 2024-11-05T09:44:44.523Z (about 2 months ago)
• Language: Batchfile
• Size: 3.61 MB
• Stars: 57
• Watchers: 7
• Forks: 5
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Awesome Lists containing this project

README

        
Multi-lua for Windows script

============================

This batchfile will download, compile and configure a Lua installation with 

versions 5.1, 5.2, 5.3, and 5.4 in parallel. Including the accompanying 

LuaRocks package manager for each version.

Prerequisites

=============

Make sure you have a compiler in your path;

 - MinGW in your system path (msys is not required)

 - for MS compilers, call `make.bat` from the Visual Studio (or Win SDK) commandshell

Command

=======

````

Command:

  MAKE [--clean] [--cleantarget] [--nocompat] [--51] [--52] [--53] [--54] [install []]

  --51,--52,--53,--54: specify the versions to install, default is to install

                       all versions. Applies only to installing, all versions will be

                       build independent of this option.

                       The first version listed will be set as the unversioned default.

  --clean            : removes downloaded and build artifacts, forcing a rebuild

  --cleantarget      : removes the target directory before installing. NOTE: the LuaRocks

                       installation will ALWAYS be removed, independent of this option!

  --nocompat         : build Lua without compatibility options. NOTE: this option

                       will not automatically clean. So clean when switching compatibility.

  install  : will install (and build if necessary) the Lua versions. Default

                       location is 'C:\Lua'

  --help             : Display this help text

Example: the following commands, executed after each other will;

  make install

                 Will download, build and install 4 Lua versions in 'C:\Lua', 5.1 will

                 be set as the default.

  make --51 --52 install C:\lua2

                 Will only install (no rebuild, binaries allready exist) 5.1 and 5.2 in

                 'C:\Lua2'. 5.1 will be set as the default.

  make --clean --53 --nocompat install C:\Lua_NoCompat

                 Will download and build all versions again, without compatibility options,

                 and then install only 5.3 in 'C:\Lua_NoCompat'. 5.3 will be set as the

                 default.

````

What it does

============

- Downloads and unpacks sources of LuaRocks, LuaWinmake (used for building), and Lua

- Compiles the Lua versions from source (using [LuaWinMake](https://github.com/Tieske/luawinmake))

- Installs the Lua versions (versioned; using the LuaWinMake command `installv`)

- Installs LuaRocks for each version

- default Lua version will be set to Lua 5.1 (see `setlua` below)

Usage

=====

Each Lua version will have its own executable; `lua51.exe`, `lua52.exe`, `lua53.exe`, and 

`lua54.exe`. And for LuaRocks 4 batchfiles will be generated; `luarocks51.bat`,

`luarocks52.bat`, `luarocks53.bat`, and `luarocks54.bat`.

The luarocks batch files will be in the same directory as the lua executables, so

only the Lua path has to be added to the system path.

The utility `setlua.bat` will setup default versions for Lua and LuaRocks unversioned

commands. eg. `setlua 54` will create a copy of `lua54.exe` as `lua.exe`, and will 

create a batch file `luarocks.bat` that will invoke `luarocks54.bat`.

Besides that it will add the Lua location to the system path and install all LuaRocks

system rocktrees into the respective Lua path environment variables.

Calling `setlua.bat` without a parameter will only set the paths and not change the 

unversioned `lua` and `luarocks` commands. This can be used as a Lua commandshell 

specific for this environment. For example; create a shortcut with target

`C:\Windows\System32\cmd.exe /k c:\lua\bin\setlua.bat` (assuming the default Lua 

location `c:\lua`).

License

=======

Copyright 2015-2023, Thijs Schreijer.

MIT license for this project. Please note that other components are included

which are covered by different licenses. See COPYING file for details.