Skip to content

Document URI TestSource support of dynamic tests in User Guide #1916

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jun 20, 2019
Merged

Document URI TestSource support of dynamic tests in User Guide #1916

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
488a8c1
Document URI TestSource support of dynamic tests in User Guide
ielatif Jun 5, 2019
427653a
Polishing
sormuras Jun 20, 2019
17f0a80
Delete TestSourceUrisDemo.java
sormuras Jun 20, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions documentation/src/docs/asciidoc/user-guide/writing-tests.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1570,6 +1570,25 @@ The last method generates a nested hierarchy of dynamic tests utilizing
include::{testDir}/example/DynamicTestsDemo.java[tags=user_guide]
----

[[writing-tests-uris-test-source-examples]]
===== URI Test Source Examples

The JUnit Platform provides `TestSource`, a representation of the source of a test
or container used to navigate to its location by IDEs and build tools.

Test sources can be constructed using URIs :

- `ClasspathResourceSource`
Use the `classpath` scheme, for example: `classpath:/test/foo.xml?line=20,column=2`

- `DirectorySource` and `FileSource`
Use file system paths.

- `MethodSource`
Use the `method` scheme and the fully-qualified-method-name ex
`method:org.junit.Foo#bar(java.lang.String, java.lang.String[])`. Please refer to the Javadoc for
`DiscoverySelectors.selectMethod(String)` for the supported formats for a FQMN.


[[writing-tests-declarative-timeouts]]
=== Timeouts
Expand Down