*
 * @since 5.4
 */
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.FIELD})
public @interface ReplacedBy {
    /**
     * The Java Bean-style name of the replacement property.
     * <p>
     *     If the property has been replaced with a method named {@code getFooBar()}, then this should be {@code fooBar}.
     * </p>

    }

    def "detects transitive cycles early"() {
        replacements.module("o:o").replacedBy("o:x")
        //a->b->c->a
        replacements.module("o:a").replacedBy("o:b")
        replacements.module("o:b").replacedBy("o:c")
        when: replacements.module("o:c").replacedBy("o:a")

        then:
        def ex = thrown(InvalidUserDataException)

        }
        elements.put(target, candidates);
        if (replacedBy != null) {
            targetToSource.put(replacedBy, target);
            if (elements.containsKey(replacedBy)) {
                //1) we've seen the replacement, register new conflict and return
                return registerConflict(target, replacedBy);
            }
        }

        Collection<K> replacementSource = targetToSource.get(target);

        expect:
        container.conflicts.size() == 1
        container.popConflict().toString() == "a,b,c:3"
    }

    def "allows registering multiple elements with the same replacedBy before the replacedBy"() {
        container.newElement("a", [1], "c")
        container.newElement("b", [2], "c")
        container.newElement("c", [3], null)

        expect:
        container.conflicts.size() == 1

     * Subsequent invocations of this method replace the previous 'replacedBy' value.
     *
     * For information and examples please see {@link org.gradle.api.artifacts.dsl.ComponentMetadataHandler}.
     *
     * @param moduleNotation a String like 'com.google.guava:guava', an instance of {@link org.gradle.api.artifacts.ModuleVersionIdentifier}, null is not permitted
     */
    void replacedBy(Object moduleNotation);

    /**

 *         // in case both libraries appear in the same dependency tree.
 *         module("com.google.collections:google-collections") {
 *             replacedBy("com.google.guava:guava")
 *         }
 *     }
 * }
 * </pre>
 *
 * @since 2.2
 */
public interface ComponentModuleMetadataHandler {
    /**
     * Enables configuring component module metadata.

        return new ComponentModuleMetadataDetails() {

            @Override
            public void replacedBy(Object moduleNotation) {
                replacedBy(moduleNotation, null);
            }

            @Override
            public void replacedBy(final Object targetModule, @Nullable String reason) {
                ModuleIdentifier target = parser.parseNotation(targetModule);

plugins {
    id 'java'
}

repositories {
    mavenCentral()
}

// tag::module_replacement_declaration[]
dependencies {
    modules {
        module("com.google.collections:google-collections") {
            replacedBy("com.google.guava:guava", "google-collections is now part of Guava")
        }
    }
}

import org.gradle.api.internal.tasks.properties.annotations.OutputFilesPropertyAnnotationHandler;
import org.gradle.api.internal.tasks.properties.annotations.UntrackedTaskTypeAnnotationHandler;
import org.gradle.api.model.ReplacedBy;
import org.gradle.api.provider.Property;
import org.gradle.api.services.ServiceReference;
import org.gradle.api.tasks.CacheableTask;
import org.gradle.api.tasks.Classpath;
import org.gradle.api.tasks.CompileClasspath;

 * limitations under the License.
 */
package org.gradle.process;

import org.gradle.api.Incubating;
import org.gradle.api.file.FileCollection;
import org.gradle.api.jvm.ModularitySpec;
import org.gradle.api.model.ReplacedBy;
import org.gradle.api.provider.ListProperty;
import org.gradle.api.provider.Property;
import org.gradle.api.tasks.Classpath;
import org.gradle.api.tasks.Input;
import org.gradle.api.tasks.Internal;