====
include::sample[dir="snippets/providers/property/kotlin",files="build.gradle.kts[tags=set-prop]"]
include::sample[dir="snippets/providers/property/groovy",files="build.gradle[tags=set-prop]"]
====

Properties:

* Properties with these types are configurable.
* `Property` extends the `Provider` interface.

    /**
     * Sets the value of the property to the elements of the given iterable, and replaces any existing value. This property will query the elements of the iterable each time the value of this property is queried.
     *
     * <p>This method can also be used to discard the value of the property, by passing {@code null} as the value.
     * The convention for this property, if any, will be used to provide the value instead.
     *

                * property(a, literal(33)) -> ShadowedProperty(underlayProperty=property(a, literal(3)), overlayProperty=property(a, literal(33)))
                    - literal(33) -> FromOverlay(documentNode=property(a, literal(33)))
                * property(b, literal(6)) -> FromOverlay(documentNode=property(b, literal(6)))
                    - literal(6) -> FromOverlay(documentNode=property(b, literal(6)))

Method <org.gradle.api.plugins.antlr.AntlrTask.getMaxHeapSize()> does not have raw return type assignable to org.gradle.api.provider.Property in (AntlrTask.java:0)
Method <org.gradle.api.plugins.antlr.AntlrTask.getOutputDirectory()> does not have raw return type assignable to org.gradle.api.provider.Property in (AntlrTask.java:0)

    }

    public AbstractBuildOption(String property, V... commandLineOptionConfiguration) {
        this(property, null, commandLineOptionConfiguration != null ? Arrays.asList(commandLineOptionConfiguration) : Collections.<V>emptyList());
    }

    private AbstractBuildOption(String property, String deprecatedProperty, List<V> commandLineOptionConfigurations) {
        this.property = property;
        this.deprecatedProperty = deprecatedProperty;

        "System.properties['some.property']"                   | _
        "System.getProperties().get('some.property')"          | _
        "getProperties().get('some.property')"                 | _
        "System.getProperty('some.property')"                  | _
        "getProperty('some.property')"                         | _
        "System.getProperty('some.property', 'default.value')" | _
        "getProperty('some.property', 'default.value')"        | _

        "System.getProperties().get(\"some.property\")"            | _
        "System.getProperty(\"some.property\")"                    | _
        "System.getProperty(\"some.property\", \"default.value\")" | _
        "System.setProperty(\"some.property\", \"new.value\")"     | _
        "System.clearProperty(\"some.property\")"                  | _
    }

    def "setProperties is instrumented in Java"() {

        when:
        configurationCacheRun("-Dsome.property.1=1", "-Dsome.property.2=2", "print")

        then:
        configurationCache.assertStateStored()
        outputContains("Configuration: some.property.1 = 0")
        outputContains("Configuration: some.property.2 = 2")

        when:
        configurationCacheRun("-Dsome.property.1=-1", "-Dsome.property.2=2", "print")

        then:

    /**
     * Adds an element to the property value.
     *
     * <p>The given provider will be queried when the value of this property is queried.
     *
     * <p>
     * When invoked on a property with no value, this method first sets the value
     * of the property to its current convention value, if set, or an empty collection.
     * </p>
     * <p>Even if the given provider has no value, after this method is invoked,

        "${Property.name}<String>"            | "objects.property(String); v.set('abc')"              | "objects.property(String); v.set('123')"                     | "Type 'SomeTask': property 'v' of mutable type 'org.gradle.api.provider.Property' is writable. Properties of type 'org.gradle.api.provider.Property' are already mutable. Possible solution: Remove the 'setV' method. ${learnAt("validation_problems",...