Schema
The test matrix
has two on-disk representations:
- A compiled single-file
- Uncompiled file per test-definition
The single-file variant is compiled using the Proctor builder and loaded by applications via the Proctor loader implementations. The single-file schema contains information about when the file was generated and which version it represents.
Single-file JSON Schema
JSON Property | Description |
---|---|
tests |
Collection of test-definitions. A map of testName => test-definition , see test-definition schema for the expected format. |
audit |
Metadata about the test matrix. |
audit.version |
Version number for the test matrix. At Indeed, the test-definitions are stored in SVN and the version value is the Subversion revision from which the matrix was compiled. |
audit.updatedBy |
String indicating who was responsible for compiling the matrix. At Indeed, the builder is initiated by Jenkins and the updatedBy is set as the Jenkins job id. |
audit.updated |
Timestamp of the generated file. |
File per test-definition
In its uncompiled format, the test-matrix is stored as a single file per test-definition. In the test-definitions directory, each test must have a corresponding directory and definition.json file. The directory name dictates the test name and the definition.json file describes the buckets, allocations, and other attributes of the test definition.
.
├── test-definitions
| ├── appfeatureatst
| ├── definition.json
| ├── appfeaturebtst
| ├── definition.json
| ├── otherappfeaturetst
| ├── definition.json
The above example would describe a test matrix with three tests: appfeaturetst, appserptst, otherappfeaturetst
Test Naming Conventions
If you’re using Proctor across multiple applications, it’s advisable to use standard test naming conventions to help differentiate the tests you use for each application.
Indeed has used a convention similar to this example: [application-name][feature-name]tst
application-name
: A short name you use for your application, such as a product codename or JIRA project.
feature-name
: Description of the feature impacted by the test.