Yet another Gradle update issue: 7.4 deprecated FileTrees using @SkipWhenEmpty

[reta]

Gradle 7.4 (release notes [1]) deprecated @SkipWhenEmpty [2], builds (with strict deprecation check) fail with:

> Task <project>:forbiddenApisTest NO-SOURCE
Relying on FileTrees for ignoring empty directories when using @SkipWhenEmpty has been deprecated. This is scheduled to be removed in Gradle 8.0. Annotate the property classFiles with @IgnoreEmptyDirectories or remove @SkipWhenEmpty. Consult the upgrading guide for further information: https://docs.gradle.org/7.4/userguide/upgrading_version_7.html#empty_directories_file_tree

[1] https://docs.gradle.org/7.4/release-notes.html
[2] https://docs.gradle.org/current/userguide/upgrading_version_7.html#empty_directories_file_tree

[uschindler]

We rely on "no files available", so we need to add the additional annotation also mentioned. Problem may be the minimum gradle version that does not have the annotation :-(

This is not urgent, but I will find a solution before the next release (coming with Java 18). For now ignore the warning.

[uschindler]

Hi,
the @SkipWhenEmpty is not deprecated (see https://docs.gradle.org/7.4/javadoc/org/gradle/api/tasks/SkipWhenEmpty.html), it is only when used alone. You need to add @IgnoreEmptyDirectories then it is "correct use". But unfortunately this new annotation only exists since Gradle 6.8, so we can't add it for backwards compatibility: https://docs.gradle.org/7.4/javadoc/org/gradle/api/tasks/IgnoreEmptyDirectories.html

Sorry this can't be fixed easily. Please ignore the warning for now and fix it later. Disable with strict deprecation check, sorry for this!

[reta]

Thanks a lot for quick reply @uschindler !

[uschindler]

I think the only way to fix this for forbiddenapis while maintaining backwards compatibility with earlier versions (before Gradle 6.8, Minimum is 3.4), is to remove the annotation and exit in the executeTask method if the FileTree is empty (like @reta did in a first version of the PR opensearch-project/OpenSearch#2078). Unfortunately this causes Gradle to no longer print "NO-SOURCE" behind task name. I am also not sure if this slows additionally.

[reta]

@uschindler thank you for the update, the "NO-SOURCE" indeed won't be there, using lifecycle() logger could compensate that a bit (but this is not the same certainly) with a message.

I am also not sure if this slows additionally.

I would suspect it may be slower since more evaluations may potentially be run before the the task is skipped manually. There is a hacky way to make it work with annotation (but I don't even want to suggest it for widely used plugin like forbidden-apis). Looks like manual check is the price to pay for wider compatibility.

[uschindler]

There is a hacky way to make it work with annotation

which one? 🤔

[reta]

There is a hacky way to make it work with annotation

which one? 🤔

There are 2 hacks to try (but I have not explored these routes):

• add annotation at runtime (hardcore reflection / bytecode manipulation) [1]
• shade the @IgnoreEmptyDirectories by adding the same package + class to the plugin (to compensate < Gradle 6.8) - not sure it will work, depends on how Gradle does the checks

[1] https://stackoverflow.com/questions/1635108/adding-java-annotations-at-runtime

[uschindler]

Hi,

There are 2 hacks to try (but I have not explored these routes):

• add annotation at runtime (hardcore reflection / bytecode manipulation) [1]

OK, this is not a good idea :-)

• shade the @IgnoreEmptyDirectories by adding the same package + class to the plugin (to compensate < Gradle 6.8) - not sure it will work, depends on how Gradle does the checks

This may work, but that's not a good idea, and it is much more complex than adding an if-statement in the execute method.

I was hoping that like with Inputs, you can add them in the configuration phase. For inputs you can add the annotation, but on the other hand you can also add them using task.inputs. I was hoping you can maybe configure that setting. As the configuration phase of the plugin is handled by Groovy code (not compiled), this is the way how to make it compatible with different Gradle versions (see TASK_AVOIDANCE_AVAILABLE in https://github.com/policeman-tools/forbidden-apis/blob/main/src/main/resources/de/thetaphi/forbiddenapis/gradle/plugin-init.groovy).

[uschindler]

I will check at weekend and implement some workaround.

This is why I hate Gradle's development model: They change their APIs and workflows all the time and then have no idea how to help to maintain plugins for various versions. It is OK to do this and also remove deprecated stuff in the next major version, but Gradle releases a new major version like every half a year!

[reta]

I will check at weekend and implement some workaround.

This is why I hate Gradle's development model: They change their APIs and workflows all the time and then have no idea how to help to maintain plugins for various versions. It is OK to do this and also remove deprecated stuff in the next major version, but Gradle releases a new major version like every half a year!

I agree with you, the upgrade from 6.x to 7.x wiped out a week of my life but I really expected the update from 7.3.3 to 7.4 to be a no-brainer but ... :-\

[uschindler]

Hi,
there might be an elegant solution: I can make the ForbiddenApis task extend SourceTask, which has everything needed:

• PatternFilterable (so it applies patterns like the current task, so I can remove most of the code. I just need to set the "default pattern **/*.class
• the getSource() method has the rquired annotations. As those are inherited there's nothing to be done. The task-specific public FileTree getClassFiles() can go away and the execute only calls getSource().

P.S.: I am about to relase v3.3 with JDK 18 support and the other cool features added recently.