Transition to jakarta.inject.Inject (#115)

[rvesse]

Switches to the 2.x releases of the jakarta.inject dependency which use the new jakarta.inject package.

For backwards compatibility continue to support old javax.inject based annotations. This is done by creating a airline-backcompact-javaxinject module that uses the old javax.inject dependency so that we can have mixtures of old and new annotations in our applications. This dependency change is intended to be a temporary measure for the 2.9.x releases only, 2.10.x will mark these dependencies as optional and 3.x will remove them entirely.

The ParserMetadata now declares the composition annotations that are inspected. This defaults to using the new @AirlineModule annotation which is our own new annotation, plus maintains the existing behaviour (javax.inject.Inject or com.google.inject.Inject) and supports the newer jakarta.inject.Inject annotation providing both forwards and backwards compatibility. Advanced users can choose to fully customise the choice of annotations as they see fit.

Documentation around composition and dependencies has been updated to make this as clear as possible and note the forthcoming deprecation of the ability to use @Inject out of the box.

Remaining Work

• [x] Pass through docs to update examples that use @Inject if necessary
• [x] Make choice of injection annotations fully customisable
  • [x] Default to existing choice
• [x] Document ability to remove airline-backcompat-javaxinject annotation for applications that have fully transitioned to jakarta.inject package
• [x] Test coverage for using custom annotations
• [x] Document new parser configuration support

[coveralls]

Pull Request Test Coverage Report for Build 629

• 127 of 148 (85.81%) changed or added relevant lines in 8 files are covered.
• 8 unchanged lines in 4 files lost coverage.
• Overall coverage increased (+0.1%) to 72.172%

---

Changes Missing Coverage	Covered Lines	Changed/Added Lines	%
airline-core/src/main/java/com/github/rvesse/airline/builder/GroupBuilder.java	12	13	92.31%
airline-core/src/main/java/com/github/rvesse/airline/builder/ParserBuilder.java	11	12	91.67%
airline-maven-plugin/src/main/java/com/github/rvesse/airline/maven/Source.java	0	1	0.0%
airline-core/src/main/java/com/github/rvesse/airline/help/suggester/SuggestCommand.java	0	6	0.0%
airline-core/src/main/java/com/github/rvesse/airline/model/MetadataLoader.java	92	104	88.46%
<!--	Total:	127	148	85.81%	-->

Files with Coverage Reduction	New Missed Lines	%
airline-core/src/main/java/com/github/rvesse/airline/help/suggester/CommandSuggester.java	1	0%
airline-core/src/main/java/com/github/rvesse/airline/model/MetadataLoader.java	2	91.7%
airline-core/src/main/java/com/github/rvesse/airline/model/ParserMetadata.java	2	67.31%
airline-core/src/main/java/com/github/rvesse/airline/builder/GroupBuilder.java	3	75.38%
<!--	Total:	8		-->

Totals
Change from base Build #248:	0.1%
Covered Lines:	5711
Relevant Lines:	7913

---

💛 - Coveralls

[gsmet]

@rvesse I will test this further today!

[gsmet]

@rvesse I confirm all is good from my side.

[rvesse]

@gsmet FYI I have pushed out a 2.10.0-SNAPSHOT build already that makes the jakarta-inject and airline-backcompat-javaxinject dependencies optional so you won't automatically pick them up transitively nor need explicit exclusions

[gsmet]

@rvesse cool, thanks!