nvim-busted-action

A composite GitHub action for running busted tests with Neovim.

Supports stable releases, nightly releases and specifying versions.

Usage

Setup

To run tests with busted, you need

A rockspec, to specify test dependencies. It should have nlua in its test_dependencies list. See also: Rockspec format
A .busted file that tells busted how to run your tests with Neovim as the Lua interpreter.
A spec directory containing test files, their names ending in _spec.lua.

Example

---
name: Run tests
on:
  pull_request: ~
  push:
    branches:
      - main

jobs:
  build:
    name: Run tests
    runs-on: ubuntu-latest
    strategy:
      matrix:
        neovim_version: ['nightly', 'stable']

    steps:
      - uses: actions/checkout@v4
      - name: Run tests
        uses: nvim-neorocks/nvim-busted-action@v1
        with:
          nvim_version: ${{ matrix.neovim_version }}

Running tests locally

With the above setup, you can run tests locally, if you have luarocks or busted installed¹.

You can then run:

luarocks test --local
# or
busted

Or if you want to run a single test file:

luarocks test spec/path_to_file.lua --local
# or
busted spec/path_to_file.lua

If you see a module 'busted.runner' not found error you need to update your LUA_PATH:

eval $(luarocks path --no-bin --lua-version 5.1)
busted --lua nlua spec/mytest_spec.lua

Inputs

`nvim_version`

Version of Neovim to install. Valid values are stable, nightly or version tag such as v0.9.2.

Default: stable

Important

This value must exactly match to a tag name when installing the specific version.

`luarocks_version`

Version of LuaRocks² to install.

Default: 3.11.1

Resources

The test suite assumes that nlua has been installed using luarocks into ~/.luarocks/bin/. ↩
This action uses LuaRocks to install busted and test dependencies. ↩

nvim-neorocks/nvim-busted-action