Allow @Nested test classes to be ordered

[sbrannen]

Overview

PR #2488 introduced support for ordering top-level test classes but did not provide support for ordering @Nested test classes.

This PR adds support for ordering @Nested test classes as well.

Closes: #2699

Definition of Done

• There are no TODOs left in the code
• Method preconditions are checked and documented in the method's Javadoc
• Coding conventions (e.g. for logging) have been followed
• Change is covered by automated tests including corner cases, errors, and exception handling
• Public API has Javadoc and @API annotations
• Change is documented in the User Guide and Release Notes
• All continuous integration builds pass

[codecov]

Codecov Report

Merging #2701 (a8ef251) into main (a2c5f86) will increase coverage by 0.02%.
The diff coverage is 93.67%.

@@            Coverage Diff             @@
##             main    #2701      +/-   ##
==========================================
+ Coverage   91.40%   91.43%   +0.02%     
==========================================
  Files         427      427              
  Lines       12116    12149      +33     
  Branches      948      951       +3     
==========================================
+ Hits        11075    11108      +33     
  Misses        801      801              
  Partials      240      240              

Impacted Files	Coverage Δ
.../main/java/org/junit/jupiter/api/ClassOrderer.java	86.11% <ø> (ø)
...main/java/org/junit/jupiter/api/MethodOrderer.java	100.00% <ø> (ø)
...piter/engine/discovery/DefaultClassDescriptor.java	75.00% <ø> (ø)
...iter/engine/discovery/DefaultMethodDescriptor.java	75.00% <ø> (ø)
...jupiter/engine/discovery/ClassOrderingVisitor.java	80.76% <78.26%> (+12.01%)	⬆️
.../discovery/AbstractAnnotatedDescriptorWrapper.java	69.23% <100.00%> (ø)
...iter/engine/discovery/AbstractOrderingVisitor.java	100.00% <100.00%> (ø)
.../engine/discovery/DefaultMethodOrdererContext.java	77.77% <100.00%> (ø)
...upiter/engine/discovery/MethodOrderingVisitor.java	100.00% <100.00%> (ø)

---

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 a2c5f86...a8ef251. Read the comment docs.

[sbrannen]

This PR now includes a new @TestClassOrder annotation for ordering @Nested test classes declaratively.

Once this PR has been approved, I will update the release notes and user guide accordingly.

[sormuras]

LGTM and should ship with 5.8.0

[sbrannen]

This has been merged into main.