An open API service indexing awesome lists of open source software.

https://github.com/exercism/haxe-test-runner


https://github.com/exercism/haxe-test-runner

community-contributions-paused exercism-test-runner exercism-tooling

Last synced: 3 months ago
JSON representation

Awesome Lists containing this project

README

        

# Exercism Haxe Test Runner

The Docker image to automatically run tests on Haxe solutions submitted to [Exercism].

## Running the Tests
To run all of the tests, do the following:
1. Open a terminal in the project's root
2. Run `bin/run-tests.sh`

These are [golden tests][golden] that compare the `results.json` generated by running the current state of the code against the "known good" `test//results.json`. All files created during the test run itself are discarded.

When you've made modifications to the code that will result in a new "golden" state, you'll need to generate and commit a new `test//results.json` file.

To run the tests of an arbitrary exercise, do the following:

1. Open a terminal in the project's root
2. Run `./bin/run.sh `

Once the test runner has finished, its results will be written to `/path/to/output/dir/results.json`.

## Run the test runner on an exercise with Docker

_This script is provided for testing purposes, as it mimics how test runners run in Exercism's production environment._

To run the tests of an arbitrary exercise using the Docker container, do the following:

1. Open a terminal in the project's root
2. Run `./bin/run-in-docker.sh <./relative/path/to/solution/dir/> <./relative/path/to/output/dir/>`

Once the test runner has finished, its results will be written to `./relative/path/to/output/dir/results.json`.

**Note**: the solution and output directory's **MUST** be relative paths!

[test-runners]: https://github.com/exercism/automated-tests/blob/master/docs/introduction.md
[golden]: https://ro-che.info/articles/2017-12-04-golden-tests
[exercism]: https://exercism.io