api / org.gradle.caching / BuildCacheServiceFactory / Describer

Describer

@Incubating interface Describer

Builder-style object that allows build cache service factories to describe the cache service.

The description is for human consumption. It may be logged and displayed by tooling.

Since
4.0

Functions

config

abstract fun config(name: String, value: String): Describer

Sets a configuration param of the cache being used.

e.g. config("location", "https://some/cache").

Values may be logged. Secrets (e.g. passwords) should not be declared with this method.

Implementations should describe their config where possible.

Subsequent calls to this method with the same name argument will replace the previously supplied value argument.

Subsequent calls to this method with different name arguments will append values.

type

abstract fun type(type: String): Describer

Sets the description of the type of cache being used.

The value should not include particulars about the cache; only a human friendly description of the kind of cache. For example, instead of "HTTP @ https://some/cache" it should be just "HTTP". Particular configuration should be set via #config(String, String).

BuildCacheServiceFactory implementations should always return the same value for the same cache “type”. All implementations should call this method.

Values should be lowercase, except where using an acronym (e.g. HTTP).

Subsequent calls to this method replace the previously set value.