README.md - Issue 1730173004: Add on_os and on_platform fields.

Side by Side Diff: README.md

Issue 1730173004: Add on_os and on_platform fields. (Closed) Base URL: git@github.com:dart-lang/test@master

Patch Set: Created 4 years, 10 months ago

Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.

Jump to:

« no previous file with comments | « no previous file | doc/package_config.md » ('j') | lib/src/backend/operating_system.dart » ('J')

OLD	NEW
1 `test` provides a standard way of writing and running tests in Dart.	1 `test` provides a standard way of writing and running tests in Dart.

2	2

3 * [Writing Tests](#writing-tests)	3 * [Writing Tests](#writing-tests)

4 * [Running Tests](#running-tests)	4 * [Running Tests](#running-tests)

5 * [Restricting Tests to Certain Platforms](#restricting-tests-to-certain-platf orms)	5 * [Restricting Tests to Certain Platforms](#restricting-tests-to-certain-platf orms)

6 * [Platform Selectors](#platform-selectors)	6 * [Platform Selectors](#platform-selectors)

7 * [Running Tests on Dartium](#running-tests-on-dartium)	7 * [Running Tests on Dartium](#running-tests-on-dartium)

8 * [Asynchronous Tests](#asynchronous-tests)	8 * [Asynchronous Tests](#asynchronous-tests)

9 * [Running Tests With Custom HTML](#running-tests-with-custom-html)	9 * [Running Tests With Custom HTML](#running-tests-with-custom-html)

10 * [Configuring Tests](#configuring-tests)	10 * [Configuring Tests](#configuring-tests)

(...skipping 482 matching lines...) Expand 10 before \| Expand all \| Expand 10 after Loading...
493 Both the annotation and the parameter take a map. The map's keys are [platform	493 Both the annotation and the parameter take a map. The map's keys are [platform

494 selectors](#platform-selector-syntax) which describe the platforms for which the	494 selectors](#platform-selector-syntax) which describe the platforms for which the

495 specialized configuration applies. Its values are instances of some of the same	495 specialized configuration applies. Its values are instances of some of the same

496 annotation classes that can be used for a suite: `Skip` and `Timeout`. A value	496 annotation classes that can be used for a suite: `Skip` and `Timeout`. A value

497 can also be a list of these values.	497 can also be a list of these values.

498	498

499 If multiple platforms match, the configuration is applied in order from first to	499 If multiple platforms match, the configuration is applied in order from first to

500 last, just as they would in nested groups. This means that for configuration	500 last, just as they would in nested groups. This means that for configuration

501 like duration-based timeouts, the last matching value wins.	501 like duration-based timeouts, the last matching value wins.

502	502

	503 You can also set up global platform-specific configuration using the

	504 [package configuration file][configuring platforms].

	505

	506 [configuring platforms]: https://github.com/dart-lang/test/blob/master/doc/packa ge_config.md#configuring-platforms

	507

503 ### Tagging Tests	508 ### Tagging Tests

504	509

505 Tags are short strings that you can associate with tests, groups, and suites.	510 Tags are short strings that you can associate with tests, groups, and suites.

506 They don't have any built-in meaning, but they're very useful nonetheless: you	511 They don't have any built-in meaning, but they're very useful nonetheless: you

507 can associate your own custom configuration with them, or you can use them to	512 can associate your own custom configuration with them, or you can use them to

508 easily filter tests so you only run the ones you need to.	513 easily filter tests so you only run the ones you need to.

509	514

510 Tags are defined using the `@Tags` annotation for suites and the `tags` named	515 Tags are defined using the `@Tags` annotation for suites and the `tags` named

511 parameter to `test()` and `group()`. For example:	516 parameter to `test()` and `group()`. For example:

512	517

(...skipping 135 matching lines...) Expand 10 before \| Expand all \| Expand 10 after Loading...
648 available to tests.	653 available to tests.

649	654

650 [api]: http://www.dartdocs.org/documentation/test/latest/index.html	655 [api]: http://www.dartdocs.org/documentation/test/latest/index.html

651	656

652 The test runner also supports a machine-readable JSON-based reporter. This	657 The test runner also supports a machine-readable JSON-based reporter. This

653 reporter allows the test runner to be wrapped and its progress presented in	658 reporter allows the test runner to be wrapped and its progress presented in

654 custom ways (for example, in an IDE). See [the protocol documentation][json] for	659 custom ways (for example, in an IDE). See [the protocol documentation][json] for

655 more details.	660 more details.

656	661

657 [json]: https://github.com/dart-lang/test/blob/master/doc/json_reporter.md	662 [json]: https://github.com/dart-lang/test/blob/master/doc/json_reporter.md

OLD	NEW