docs: lx test (#11)

Author: mrcjkb

docs/guides/lux-toml.md

@@ -442,5 +442,46 @@ If you want your rock to be compatible with luarocks, you should test an install
 before publishing.
 :::
 
-<!-- ## Test specification -->
-<!-- TODO -->
+## Test specification
+
+Lux supports the following test backends, specified by the `[test]` table in the lux.toml:
+
+### [`busted`](https://lunarmodules.github.io/busted/)
+
+Example:
+
+```toml
+[test]
+type = "busted"
+flags = [ ] # Optional CLI flags to pass to busted
+```
+
+:::note
+`lx test` will default to using `busted`
+if there is a `.busted` file in the project root
+and no test backend is specified.
+:::
+
+### `command`
+
+Name/file name of a shell command that will run the test suite.
+Example:
+
+```toml
+[test]
+type = "command"
+command = "make"
+flags = [ "test" ]
+```
+
+### `script`
+
+Relative path to a Lua script that will run the test suite.
+Example:
+
+```toml
+[test]
+type = "script"
+script = "tests.lua" # Expects a tests.lua file in the project root
+flags = [ ] # Optional arguments passed to the test script
+```

docs/guides/testing.md

@@ -7,14 +7,24 @@ In this guide, we'll learn how to set up a testing suite for a Lua project.
 
 ## Creating Spec Files
 
-By default, Lux uses [`busted`](https://github.com/lunarmodules/busted) as its testing suite.
-Tests are stored in a `spec/` directory in the root of your project, and only files
+By default, will try to auto-detect your test suite.
+If there is a `.busted` file in your project root,
+Lux will use[`busted`](https://github.com/lunarmodules/busted) as its test backend.
+Otherwise, you must specify the test backend in your `lux.toml`:
+
+```toml title="test specification"
+[test]
+type = "busted"
+```
+
+With busted, tests are stored in a `spec/` directory in the root of your project, and only files
 ending in `_spec.lua` are considered tests.
 
 The type of tests you will make will vary greatly depending on the type of project at hand.
 Nevertheless, refrain from making trivial tests - they bring little value to a codebase.
 
 Below is an example of a test:
+
 ```lua title="spec/request_parse_spec.lua"
 local request = require("mylib.request")
 local json = require("mylib.json")
@@ -76,3 +86,9 @@ return {
 ```
 
 For full reference, see [the `busted` website](https://lunarmodules.github.io/busted).
+
+## Alternate test backends
+
+You don't have to use `busted` as a test backend.
+See the test section in [How to declare a lux.toml file](/guides/lux-toml)
+for alternate test backends.