Suravi is a distribution of Lua 5.3 and Ravi
Suravi is a work-in-progress distribution of Lua 5.3 and Ravi.
Goals
- This is not a comprehensive distribution / package manager for Lua such as LuaRocks, LuaDist, or LuaPlus.
- The goal of this distribution is to create a small distro with carefully selected libraries, and ensure that the distro has been tested as a whole.
- There will be separate binary downloads for Lua and Ravi 5.3.
- Target platforms are Windows 10, Linux, and Mac OSX; 64-bit versions only.
- The build system is CMake; and the aim is to keep each module as independent of other modules as possible; however some modules such as those from Torch have interdependencies.
- Create unified documentation and user guides; the whole distro should feel like a single product.
Libraries
The following libraries have been shortlisted for inclusion:
| Library | Description | Status |
|---|---|---|
| LPegLabel | LPegLabel is a conservative extension of the LPeg library that provides an implementation of Parsing Expression Grammars (PEGs) with labeled failures. | Included |
| LPeg | LPeg is a new pattern-matching library for Lua, based on Parsing Expression Grammars. | see LPegLabel |
| lua-cjson | Lua CJSON is a fast JSON encoding/parsing module for Lua | Included |
| LuaFileSystem | LuaFileSystem is a Lua library developed to complement the set of functions related to file systems offered by the standard Lua distribution. | Included |
| lua-protobuf | Google protobuf support for Lua | Included |
| LuaSocket | LuaSocket is a Lua extension library that is composed by two parts: a C core that provides support for the TCP and UDP transport layers, and a set of Lua modules that add support for functionality commonly needed by applications that deal with the Internet | Included |
| luv | libuv bindings for Lua. libuv is a multi-platform C library that provides support for asynchronous I/O based on event loops. | Included |
| Moses | A Lua utility-belt library for functional programming | Included |
| Penlight | A set of pure Lua libraries focusing on input data handling (such as reading configuration files), functional programming (such as map, reduce, placeholder expressions,etc), and OS path management. Much of the functionality is inspired by the Python standard libraries | Included |
| Paths | This package provides portable functions and variables to manipulate the file system | Included |
| Torch7 | Torch is the main package in Torch7 where data structures for multi-dimensional tensors and mathematical operations over these are defined. Additionally, it provides many utilities for accessing files, serializing objects of arbitrary types and other useful utilities, including a Unit Testing framework | Included |
| Torch7-Autograd | Autograd automatically differentiates native Torch code | Included |
| Torch-Cephes | Provides and wraps the mathematical functions from the Cephes mathematical library, developed by Stephen L. Moshier | Broken |
| Torch7-NN | This package provides an easy and modular way to build and train simple or complex neural networks using Torch | Included |
| Torch7-Optim | This package contains a number of optimization routines for Torch | Included |
Downloads
See the Releases page for available downloads.
Installation
Lua Version and Build Info
The version of Lua supported by this distro is 5.3.5. The following changes were made to stock Lua:
- The LuaJIT
bitlibrary is included - The
LUA_COMPAT_FLOATSTRINGflag is enabled - The Lua 5.1 and 5.2 compatibility flags are enabled
- The 'defer' statement has been added.
- The Lua parser has been enhanced to ignore Ravi type annotations.
On Linux or Mac OSX
In the build folder there are some scripts to help build and install Suravi.
Assuming we are installing under $HOME/Software/ravi then we can invoke:
cd Suravi
sh build/linux_build.sh $HOME/Software/ravi
Once build is complete, we can setup the environment as follows.
source $HOME/Software/ravi/bin/ravi-env.sh
Replace ravi with lua53 if you are using Lua.
Note that the installation paths are copied to following files in the distro:
bin/ravi-env.shorbin/lua-env.shshare/lua/5.3/torch/paths.lua
On Windows
- Note: The latest build includes VC++ 2019 runtime distributable
- Install under
c:\Software\raviorc:\Software\lua53 - Set environment variables as follows:
c:\Software\ravi\bin\ravi-env.bat
Replace ravi with lua53 if you are using Lua.
Note that if you install at some other location then you need to change the paths in the following files in the distro:
bin\ravi-env.batorbin\lua-env.batshare\lua\5.3\torch\paths.lua
Docker support
Please checkout the Dockerfiles in the repo - they should be self explanatory.