[JUnit Platform] Support cucumber.features property

[mpkorstanje]

Usually it not necessary to use the cucumber.features property. See the notes section below.

JUnit 5 support is still anything but first class junit-team/junit5#2849. As such users
do need a quick and easy way to select feature files from the
commandline i.e:

mvn test -Dcucumber.features=path/to/example.feature

When enabled, other discovery selectors will be ignored. As such it would be prudent to select only the cucumber engine for execution with -Dsurefire.includeJUnit5Engines=cucumber and enabling pretty printing with -Dcucumber.plugin=pretty. I.e:

mvn test -Dsurefire.includeJUnit5Engines=cucumber -Dcucumber.plugin=pretty -Dcucumber.features=path/to/example.feature 

Of all possible options is the least-worst solution. Additionally a warning is logged prompting users to request better support. The relevant issues to request/support/sponsor are:

• IDEA

  • https://youtrack.jetbrains.com/issue/IDEA-227508
  • https://youtrack.jetbrains.com/issue/IDEA-276463
  • https://youtrack.jetbrains.com/issue/IDEA-276477

• Eclipse

  • No issue exists (yet).

• Maven Surefire

  • https://issues.apache.org/jira/browse/SUREFIRE-1724

• Gradle

  • JUnit 5: Allow resource-based testing gradle/gradle#4773

---

Note: Usually it not necessary to use the cucumber.features property.

• When using the @Suite annotation use the JUnit 5 Suite annotations dedicated to selecting tests. I.e: @SelectClasspathResource or @SelectFile.

• When using the JUnit Platform Launcher API, use DiscoverySelectors.selectClasspathResource or DiscoverySelectors.selectFile.

• When using the JUnit ConsoleLauncher use the --select-file or --select-classpath-resource CLI options.

Note: Rerun files are not (yet?) supported with JUnit 5. See: #2805.

[codecov]

Codecov Report

Merging #2498 (946e6bc) into main (517c5fb) will increase coverage by 0.05%.
The diff coverage is 100.00%.

@@             Coverage Diff              @@
##               main    #2498      +/-   ##
============================================
+ Coverage     83.70%   83.76%   +0.05%     
- Complexity     2677     2688      +11     
============================================
  Files           319      319              
  Lines          9438     9471      +33     
  Branches        916      917       +1     
============================================
+ Hits           7900     7933      +33     
  Misses         1201     1201              
  Partials        337      337              

Impacted Files	Coverage Δ
...r/junit/platform/engine/CucumberEngineOptions.java	97.14% <100.00%> (+0.36%)	⬆️
...nit/platform/engine/DiscoverySelectorResolver.java	95.74% <100.00%> (+1.80%)	⬆️
...ucumber/junit/platform/engine/FeatureResolver.java	100.00% <100.00%> (ø)
...er/junit/platform/engine/TestDescriptorOnLine.java	90.62% <100.00%> (+1.73%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 517c5fb...946e6bc. Read the comment docs.

[aslakhellesoy]

Amazing - just what I need!