HasMavenAncestry recipe

[DidierLoiseau]

What's changed?

Provides a recipe to check if a pom file has a specific artifact as ancestry – to be used as a precondition for other recipes.

What's your motivation?

We needed to check the parent before performing some cleanup. Might as well contribute this generic recipe 😏

This could also be used to conditionally perform some upgrades, e.g. only perform Spring Boot 3 migration if we are not already in Spring Boot 3 (see also openrewrite/rewrite-spring#361) – although you would also need to check the imported poms in this case.

Anything in particular you'd like reviewers to focus on?

I also took the opportunity to document Semver.validate(), although the documentation is mostly copied from existing recipes and may need some clarification.

The recipe does not support a versionPattern – I’m not sure how to handle it when version isn’t provided, which could be useful for example if someone wanted to check if any ancestry is a snapshot or release candidate.

Have you considered any alternatives or workarounds?

There does not seem to be many recipes to use as predicates on pom files…

Checklist

• I've added unit tests to cover both positive and negative cases
• I've read and applied the recipe conventions and best practices
• I've used the IntelliJ IDEA auto-formatter on affected files