skript-test-action is a GitHub Action that addon developers can use to utilize Skript's test suite within their addons! In addition to testing your own syntaxes, you can also run the vanilla Skript tests alongside your own to ensure that your addon does not change any vanilla behavior!
Using the action involves two pieces:
- Configure a GitHub Action for your repository that builds your addon
- Add skript-action-test as a step like so:
- name: Run tests
uses: SkriptLang/[email protected]
with:
# the directory where your test scripts are located relative to the repo root
test_script_directory: src/test/scripts
# you can test against a specific skript version by specifying this tag
# you can also not define it to use the latest master branch commit
skript_repo_ref: 2.8.2
# this should be where your addon jar is located relative to the repo root
extra_plugins_directory: build/libs
A good minimal example of how to use skript-test-action can be found on the skript-reflect repository. The action file is here and the test scripts directory is here. There isn't much documentation on how to write test scripts, but they are pretty simple. You can find plenty of examples on the Skript repository here.