Skip to content
moon

GitHub Action

Setup Lua/LuaJIT

v0.3 Latest version

Setup Lua/LuaJIT

moon

Setup Lua/LuaJIT

Download, build, and install Lua or LuaJIT

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Setup Lua/LuaJIT

uses: xpol/[email protected]

Learn more about this action in xpol/setup-lua

Choose a version

xpol/setup-lua

Actions Status

Github Action to install Lua/LuaJIT on Unbutu/macOS/Windows.

Builds and installs Lua into the .lua/ directory in the working directory using CMake. Adds the .lua/bin to the PATH environment variable so lua can be called directly in workflows.

This project is hightlly inspired by (and this README is initially copied from) leafo/gh-actions-lua. The difference is this project use CMake to support Unbutu/macOS/Windows.

Many thanks to leafo!

Usage

Install Lua:

Will install the latest stable release of PUC-Rio Lua.

- uses: xpol/setup-lua@v1

Install specific version of Lua:

- uses: xpol/setup-lua@v1
  with:
    lua-version: "5.1.5"

Install specific version of LuaJIT:

- uses: xpol/setup-lua@v1
  with:
    lua-version: "luajit-2.0.5"

Inputs

lua-version

Default: "5.3.5"

Specifies the version of Lua to install. The version name instructs the action where to download the source from.

All supported of versions:

  • "5.3.5"
  • "5.3.4"
  • "5.3.3"
  • "5.3.2"
  • "5.3.1"
  • "5.3.0"
  • "5.2.4"
  • "5.2.3"
  • "5.2.2"
  • "5.2.1"
  • "5.2.0"
  • "5.1.5"
  • "5.1.4"
  • "5.1.3"
  • "5.1.2"
  • "5.1.1"
  • "5.1.0"
  • "luajit-2.0.5"
  • "luajit-2.1.0-beta3"
  • "luajit-2.1.0-beta2"
  • "luajit-2.1.0-beta1"
  • "luajit-2.0.4"
  • "luajit-2.0.3"
  • "luajit-2.0.2"
  • "luajit-2.0.1"
  • "luajit-2.0.0"

Note: Beta versions will removed when the stable version is released.

Also want LuaRocks

You may also need an action to install luarocks:

Full Example

This example is for running tests on a Lua module that uses LuaRocks for dependencies and busted for a test suite.

Create .github/workflows/test.yml in your repository:

name: test

on: [push]

jobs:
  test:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@master

    - uses: xpol/setup-lua@v1
      with:
        lua-version: "5.1.5"

    - uses: leafo/gh-actions-luarocks@v2

    - name: build
      run: |
        luarocks install busted
        luarocks make

    - name: test
      run: |
        busted -o utfTerminal

This example:

  • Uses Lua 5.1.5 — You can use another version by chaning the lua-version varible. LuaJIT versions can be used by prefixing the version with luajit-, i.e. luajit-2.1.0-beta3
  • Uses a .rockspec file the root directory of your repository to install dependencies and test packaging the module via luarocks make

View the documentation for the individual actions (linked above) to learn more about how they work.

Version build matrix

You can test against multiple versions of Lua using a matrix strategy:

jobs:
  test:
    strategy:
      matrix:
        luaVersion: ["5.1.5", "5.2.4", "luajit-2.1.0-beta3"]

    steps:
    - uses: actions/checkout@master
    - uses: xpol/setup-lua@v1
      with:
        lua-version: ${{ matrix.luaVersion }}

    # ...