| .reuse | ||
| config | ||
| db/migrations | ||
| LICENSES | ||
| migrations | ||
| nginx | ||
| src | ||
| tests | ||
| .env_sample | ||
| .gitignore | ||
| build.rs | ||
| Cargo.lock | ||
| Cargo.toml | ||
| Makefile | ||
| README.md | ||
ftest: compliance suite for software forge federation
Goals
- Flexible: should be able to define new tests with ease
- Transparent: test results should be transparently available
- Versioned: Evolution of a forge implementation must be easily observable
- Reproducible: test results should reproducible
- Ease of deployment
- Ease of use for developers and forge developers
- Ease of use for general public
Development Notes
Create ftest Docker subnet before running tests or deploying
docker network create --attachable -d bridge ftest
Test Runner
Choice of test runner should not be hard-codded, it should be possible to define new runner interfaces. But for now, we are going to go with Docker.
Test suites
A test suite will be made of multiple, independently defined tests, so that the same test implementation can be reused between multiple suites.
Tests suites can live anywhere on the internet, but the have to be linked in the control repository for them to be available on an ftest instance. This will enable ftest admins authorize the code that is run on their servers.
Test jobs
Each test will be it's own container image. This allows for polyglot tests, which should make it easy to define new tests. Also, containerization will offer some level of security when running untrusted code.
A new container of of the test image will be deployed whenever a new
compliance job is scheduled. The container will be given a secret
associated with the job ID. When the job is complete, the test suite
container should upload the results to the ftest server.
Test result schema
"tests": [{
"test_id": string,
"success": boolean,
"logs": string, // debug data that the test generates
"raw_logs": string // container logs (ex: docker logs <container-name>
}]
Compliance job
Compliance job consist of more than one test suite.
Scheduling new compliance test jobs
The test runner will accept new jobs through a Git repository called the
control repository. To
schedule a new compliance job(for instance when a forge instance is updated),
forge developers can send a patch to the control repository with the
docker-compsoe definition file to spin up their software and its
dependencies, and a job
file that enumerates the test suites that must be run against it.
Compliance Results
For an implementation to be 100% compliant with a test suite, it will have to successfully pass all the tests defined in the test suite. A partial compliance score can be calculated using the same method.
The compliance report will include Compliance score, test logs, and the control repository commit that triggered job. This data will be used to create a versioned report in the form of a static site deployed from a Git repository (results repository).