Created
August 26, 2020 08:51
-
-
Save simolus3/e53810ef299584cac799f619066fd6d5 to your computer and use it in GitHub Desktop.
JSON schema for dart_test.yaml files
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
{ | |
"$schema": "http://json-schema.org/draft-07/schema", | |
"$id": "http://json.schemastore.org/dart_test", | |
"title": "dart_test.yaml", | |
"description": "Configuration for Dart tests", | |
"definitions": { | |
"timeout": { | |
"$comment": "Based on https://github.com/dart-lang/test/blob/3b8d3b90efd24f55f7316cd414716d1cb031761c/pkgs/test_api/lib/src/frontend/timeout.dart#L55-L68", | |
"oneOf": [ | |
{ | |
"const": "none", | |
"type": "string", | |
"title": "No timeout", | |
"description": "Indicates that tests should never time out." | |
}, | |
{ | |
"type": "string", | |
"title": "Exact timeout", | |
"description": "A number followed by a unit abbreviation indicates an exact time.", | |
"pattern": "^(?:[^a-df-zA-DF-Z\\s]+(?:[umUM][sS]|[dhmsDHMS])\\s?)+$", | |
"examples": [ | |
"1m", | |
"30s", | |
"1m 30s" | |
] | |
}, | |
{ | |
"type": "string", | |
"title": "Multiplicative timeout", | |
"description": "Timeout is applied as a multiple of the default value (30 seconds)", | |
"pattern": "^[^a-df-zA-DF-Z\\s]+[xX]$", | |
"examples": [ | |
"12x", | |
"1.5X" | |
] | |
} | |
] | |
}, | |
"skip": { | |
"oneOf": [ | |
{ | |
"type": "boolean", | |
"title": "Skip the test if true" | |
}, | |
{ | |
"type": "string", | |
"title": "Reason for skipping the test" | |
} | |
] | |
}, | |
"executable": { | |
"type": "string", | |
"description": "The executable to run. Can be a plain basename, an absolute path or a relative path on Windows." | |
}, | |
"browserAndNodeSettings": { | |
"type": "object", | |
"title": "Settings for browsers and Node.js", | |
"additionalProperties": false, | |
"properties": { | |
"arguments": { | |
"type": "string", | |
"title": "Extra arguments to the executable", | |
"description": "The arguments are parsed in the same way as the POSIX shell" | |
}, | |
"executable": { | |
"oneOf": [ | |
{ | |
"$ref": "#/definitions/executable" | |
}, | |
{ | |
"type": "object", | |
"additionalProperties": false, | |
"properties": { | |
"linux": { | |
"$ref": "#/definitions/executable" | |
}, | |
"mac_os": { | |
"$ref": "#/definitions/executable" | |
}, | |
"windows": { | |
"$ref": "#/definitions/executable" | |
} | |
} | |
} | |
] | |
}, | |
"headless": { | |
"type": "boolean", | |
"title": "Run the browser in headless mode" | |
} | |
} | |
}, | |
"testConfiguration": { | |
"type": "object", | |
"properties": { | |
"timeout": { | |
"$ref": "#/definitions/timeout" | |
}, | |
"verbose_trace": { | |
"type": "boolean", | |
"title": "Remove internal stack frames", | |
"description": "This field controls whether or not traces caused by errors are trimmed to remove internal stack frames. This includes frames from the Dart core libraries, the stack_trace package, and the test package itself.", | |
"default": false | |
}, | |
"js_trace": { | |
"type": "boolean", | |
"title": "Convert JS traces to Dart traces", | |
"description": "Whether or not stack traces caused by errors while running Dart compiled to JS are converted back to Dart style.", | |
"default": false | |
}, | |
"skip": { | |
"$ref": "#/definitions/skip" | |
}, | |
"retry": { | |
"type": "number", | |
"description": "This field controls how many times a test is retried upon failure." | |
}, | |
"test_on": { | |
"type": "string", | |
"$comment": "TODO: Find a regex matching boolean selectors", | |
"examples": [ | |
"browser && !ie" | |
] | |
}, | |
"tags": { | |
"type": "object", | |
"additionalProperties": { | |
"$ref": "#/definitions/_testConfigurationInner" | |
} | |
}, | |
"add_tags": { | |
"type": "array", | |
"description": "Adds additional tags. This is usually used in a tag definition to enable tag inheritance.", | |
"items": { | |
"type": "string" | |
} | |
}, | |
"on_platform": { | |
"type": "object", | |
"additionalProperties": { | |
"$ref": "#/definitions/_testConfigurationInner" | |
} | |
} | |
} | |
}, | |
"_testConfigurationInner": { | |
"$comment": "presets and on_os can have different properties when used in a test vs runner configuration. We make runnerConfiguration extend from testConfiguration, so this configuration is used when we're definitely in a test configuration context.", | |
"allOf": [ | |
{ | |
"$ref": "#/definitions/testConfiguration" | |
}, | |
{ | |
"properties": { | |
"presets": { | |
"type": "object", | |
"description": "A preset used in a test configuration can contain test configuration.", | |
"additionalProperties": { | |
"$ref": "#/definitions/testConfiguration" | |
} | |
}, | |
"on_os": { | |
"type": "object", | |
"description": "Applies test options when a specific operating system is used", | |
"additionalProperties": { | |
"$ref": "#/definitions/testConfiguration" | |
} | |
} | |
} | |
} | |
] | |
}, | |
"runnerConfiguration": { | |
"allOf": [ | |
{ | |
"$comment": "Runner configurations are a superset of test configurations", | |
"$ref": "#/definitions/testConfiguration" | |
}, | |
{ | |
"properties": { | |
"include": { | |
"type": "string", | |
"format": "uri" | |
}, | |
"paths": { | |
"type": "array", | |
"items": { | |
"type": "string" | |
}, | |
"default": ["test"] | |
}, | |
"filename": { | |
"type": "string", | |
"description": "Filename pattern that the test runner uses to find test files in directories." | |
}, | |
"names": { | |
"type": "array", | |
"description": "Only run tests whose names match the given regular expressions A test's name must match all regular expressions in names in order to be run.", | |
"items": { | |
"type": "string" | |
} | |
}, | |
"plain_names": { | |
"type": "array", | |
"description": "This field causes the runner to only run tests whose names contain the given strings. A test's name must contain all strings in order to be run.", | |
"items": { | |
"type": "string" | |
} | |
}, | |
"include_tags": { | |
"type": "string", | |
"description": "This field causes the runner to only run tests whose tags match the given boolean selector." | |
}, | |
"exclude_tags": { | |
"type": "string", | |
"description": "This field causes the runner to only run tests whose tags match the given boolean selector. This takes precedence over include_tags" | |
}, | |
"platforms": { | |
"description": "The platforms on which tests should be run.", | |
"type": "array", | |
"items": { | |
"type": "string" | |
}, | |
"default": ["vm"] | |
}, | |
"concurrency": { | |
"type": "integer", | |
"description": "The default number of test suites to run in parallel. This defaults to approximately half the number of processors on the current machine. Setting it to 1 will disable concurrency" | |
}, | |
"pause_after_load": { | |
"type": "boolean", | |
"description": "Indicates that the test runner should pause for debugging after each test suite is loaded but before its tests are executed. This disables concurrency and timeouts." | |
}, | |
"run_skipped": { | |
"type": "boolean", | |
"description": "Run tests even if they're marked as skipped." | |
}, | |
"reporter": { | |
"type": "string", | |
"description": "This field indicates the default reporter to use.", | |
"examples": [ | |
"compact", | |
"expanded", | |
"json" | |
] | |
}, | |
"file_reporters": { | |
"type": "object", | |
"description": "Specifies additional reporters that will write their output to a file rather than stdout", | |
"additionalProperties": { | |
"type": "string" | |
} | |
}, | |
"fold_stack_frames": { | |
"type": "object" | |
}, | |
"custom_html_template_path": { | |
"description": "This field specifies the path of the HTML template to be used for tests run in an HTML environment.", | |
"type": "string" | |
}, | |
"presets": { | |
"type": "object", | |
"additionalProperties": { | |
"$ref": "#/definitions/runnerConfiguration" | |
} | |
}, | |
"add_presets": { | |
"type": "array", | |
"description": "Commonly used in a preset, it can be used to enable present inheritance by adding the configuration from another preset.", | |
"items": { | |
"type": "string" | |
} | |
}, | |
"on_os": { | |
"type": "object", | |
"description": "Applies test or runner options when a specific operating system is used", | |
"additionalProperties": { | |
"$ref": "#/definitions/runnerConfiguration" | |
} | |
}, | |
"override_platforms": { | |
"type": "object", | |
"additionalProperties": { | |
"type": "object", | |
"properties": { | |
"settings": { | |
"$ref": "#/definitions/browserAndNodeSettings" | |
} | |
} | |
} | |
}, | |
"define_platforms": { | |
"type": "object", | |
"additionalProperties": { | |
"type": "object", | |
"properties": { | |
"name": { | |
"type": "string" | |
}, | |
"extends": { | |
"type": "string" | |
}, | |
"settings": { | |
"$ref": "#/definitions/browserAndNodeSettings" | |
} | |
} | |
} | |
} | |
} | |
} | |
] | |
} | |
}, | |
"$ref": "#/definitions/runnerConfiguration" | |
} |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment