Extract caching logic into a separate gradle-actions-caching component (#885)

With this change, the caching functionality of `setup-gradle` and
`dependency-submission` is now provided by `gradle-actions-caching`, a
closed-source library distributed under our [Terms of
Use](https://gradle.com/legal/terms-of-use/). The rest of the action
implementation remains open source.

Using `setup-gradle` or `dependency-submission` with caching enabled
involves loading and using the `gradle-actions-caching` component,
requiring acceptance of the [Terms of
Use](https://gradle.com/legal/terms-of-use/). There are no functional
changes to caching provided by these actions: all workflows will
continue to function as before.

The non-caching aspects of action implementation remain open source. By
running these actions with caching disabled they can be used without
ever loading `gradle-actions-caching` or accepting the license terms.

Supporting the caching infrastructure in this project requires a
substantial engineering investment by Gradle Technologies, which we can
sustain thanks to Develocity, our commercial offering. Caching
technologies are a core part of the Develocity offering, and the caching
in `setup-gradle` fits squarely in that space.

This licensing change lets us continue to build advanced capabilities
that go beyond what we would offer as open source. Proper
production-ready Configuration Cache support will be the first
capability. Improving build performance for self-hosted runners will
follow.

We may introduce functionality restrictions in future updates. However,
caching functionality will remain free for public repositories.
We have a long-standing commitment to open source, as maintainers of
Gradle Build Tool, and by [sponsoring the open source
community](https://gradle.com/oss-sponsored-by-develocity/) with free
Develocity licenses. Public repositories are primarily used by open
source projects, and we remain committed to supporting them.

- Implementation of caching logic to save and restore Gradle User Home
content has been removed, replaced by the `gradle-actions-caching`
component.
- The `@actions/caching` library is still used to cache Gradle
distributions that are downloaded and provisioned by `setup-gradle`.
This PR updates to the latest version of `@actions/caching`, and removes
the patch that is no longer required.
- License notices are now displayed in documentation, logs and the
generated Job Summary.

sources/src/configuration.ts

@@ -132,42 +132,23 @@ export class CacheConfig {
         return getBooleanInput('gradle-home-cache-strict-match')
     }
 
-    isCacheCleanupEnabled(): boolean {
-        if (this.isCacheReadOnly()) {
-            return false
-        }
-        const cleanupOption = this.getCacheCleanupOption()
-        return cleanupOption === CacheCleanupOption.Always || cleanupOption === CacheCleanupOption.OnSuccess
-    }
-
-    shouldPerformCacheCleanup(hasFailure: boolean): boolean {
-        const cleanupOption = this.getCacheCleanupOption()
-        if (cleanupOption === CacheCleanupOption.Always) {
-            return true
-        }
-        if (cleanupOption === CacheCleanupOption.OnSuccess) {
-            return !hasFailure
-        }
-        return false
-    }
-
-    private getCacheCleanupOption(): CacheCleanupOption {
+    getCacheCleanupOption(): string {
         const legacyVal = getOptionalBooleanInput('gradle-home-cache-cleanup')
         if (legacyVal !== undefined) {
             deprecator.recordDeprecation(
                 'The `gradle-home-cache-cleanup` input parameter has been replaced by `cache-cleanup`'
             )
-            return legacyVal ? CacheCleanupOption.Always : CacheCleanupOption.Never
+            return legacyVal ? CacheCleanupOption.Always.toString() : CacheCleanupOption.Never.toString()
         }
 
         const val = core.getInput('cache-cleanup')
         switch (val.toLowerCase().trim()) {
             case 'always':
-                return CacheCleanupOption.Always
+                return CacheCleanupOption.Always.toString()
             case 'on-success':
-                return CacheCleanupOption.OnSuccess
+                return CacheCleanupOption.OnSuccess.toString()
             case 'never':
-                return CacheCleanupOption.Never
+                return CacheCleanupOption.Never.toString()
         }
         throw TypeError(
             `The value '${val}' is not valid for cache-cleanup. Valid values are: [never, always, on-success].`