IAnnotatedElementProvider to Access to ArgSpec/OptionSpec setter/getter field/method

[pvlasov]

This pull request introduces IAnnotatedElementProvider interface implemented by FieldBinding and MethodBinding.
This allows to access underlying fields/methods of parameters and options.

See also issue #2325.

[remkop]

Thank you for the PR!
I put some comments. Can you take a look?

[pvlasov]

Hello,

I've synced the fork and ran a local build - it was successful on Java 17, Windows 11. Please let me know if there is anything else I need to do.

[pvlasov]

I changed the switch which caused build failure to if-else in src/test/java/picocli/IAnnotatedElementProviderTest.java and ran builds with Java 8 and Java 17 on Windows.

My tests now pass on both Java 8 and Java 17, but the build (clean build) fails on groovy test (see below).

However, I cloned the main branch and its build also fails with the same message. So I think it is either my setup or something in the code which I did not touch.

Error message:

> Task :picocli-groovy:test FAILED

picocli.groovy.PicocliBaseScript2Test > testSubcommandMethodHelp FAILED
    java.lang.AssertionError at PicocliBaseScript2Test.groovy:432

68 tests completed, 1 failed, 2 skipped

[pvlasov]

Hello,

I've fixed the failing groovy test - please verify that the fix is OK. Builds are successful on Windows 11 with Java 8 and 17 and on Debian Linux with Java 17.

As I mentioned in my previous comment, the main branch build was also failing on the same groovy test in my environment. This change fixes the main branch build too.

As a side note, here is an example of this new functionality in action - generation of option and parameter documentation from annotated fields and methods:

• Demo
• Annotation

Sharing it in case it might be of interest for the picocli community. More detailed documentation will be published soon.

For those who might need this functionality sooner than the official release there are two options.

Use Nasdanika snapshots repository

Add

    <repositories>
        <repository>
            <id>nasdanika-snapshots</id>
            <url>https://maven.nasdanika.org/snapshots</url>
        </repository>
    </repositories> 

to your pom.xml and change picocli version in your dependencies to 4.7.7-SNAPSHOT

Build locally

• Download or clone Nasdanika picocli fork
• Add mavenLocal() line after line 13 in build.gradle
• gradlew.bat clean publishToMavenLocal
• Change picocli version in your dependencies to 4.7.7-SNAPSHOT