import java.util.ArrayList;
import java.util.List;

/**
 * This static util class can be used to build a human-readable description of the usage a role or configuration allows.
 */
public abstract class UsageDescriber {
    public static final String DEFAULT_CUSTOM_ROLE_NAME = "Custom Role";

    private static final String CONSUMABLE = "Consumable - this configuration can be selected by another project as a dependency";

        ConfigurationRoles.LEGACY                       || [UsageDescriber.CONSUMABLE, UsageDescriber.RESOLVABLE, UsageDescriber.DECLARABLE_AGAINST]
        ConfigurationRoles.CONSUMABLE                   || [UsageDescriber.CONSUMABLE]
        ConfigurationRoles.RESOLVABLE                   || [UsageDescriber.RESOLVABLE]
        ConfigurationRoles.RESOLVABLE_DEPENDENCY_SCOPE  || [UsageDescriber.RESOLVABLE, UsageDescriber.DECLARABLE_AGAINST]

class UsageDescriberSpec extends Specification {
    def "can describe usage for role"() {
        given:
        def role = ConfigurationRolesForMigration.RESOLVABLE_DEPENDENCY_SCOPE_TO_RESOLVABLE

        expect:
        UsageDescriber.describeRole(role) == "\tResolvable - this configuration can be resolved by this project to a set of files\n" +

        String currentUsageDesc = UsageDescriber.describeCurrentUsage(conf);
        return String.format("Configuration %s already exists with permitted usage(s):\n" +
            "%s\n", getConfigurationName(), currentUsageDesc);
    }

    private String getUsageExpectationMessage() {
        String expectedUsageDesc = UsageDescriber.describeRole(getRole());

    boolean isDeclarationAgainstDeprecated();

    /**
     * Obtains a human-readable summary of the usage allowed by the given role.
     */
    default String describeUsage() {
        return UsageDescriber.describeRole(this);
    }

    /**
     * Checks that the current allowed usage of a configuration is the same as that specified by this role.
     *
     * Does not check deprecation status.
     *

        if (configuration instanceof DefaultConfiguration) {
            reply.append("  role='").append(configuration.roleAtCreation).append("'")
            String roleDesc = UsageDescriber.describeUsage(configuration.isCanBeConsumed(), configuration.isCanBeResolved(), configuration.isCanBeDeclared(),

import org.gradle.api.internal.artifacts.configurations.ConfigurationRoles;
import org.gradle.api.internal.artifacts.configurations.RoleBasedConfigurationContainerInternal;
import org.gradle.api.internal.artifacts.configurations.UsageDescriber;
import org.gradle.api.internal.file.FileTreeInternal;
import org.gradle.api.internal.plugins.DslObject;
import org.gradle.api.internal.tasks.DefaultSourceSetOutput;
import org.gradle.api.internal.tasks.JvmConstants;

                "%s\n" +
                "This method is only meant to be called on configurations which allow the %susage(s): '%s'.";
            String currentUsageDesc = UsageDescriber.describeCurrentUsage(this);
            String properUsageDesc = ProperMethodUsage.summarizeProperUsage(properUsages);