@ServiceScope({Scope.Global.class, Scope.Project.class})
public interface PropertyHost {
    PropertyHost NO_OP = producer -> null;

    /**
     * Returns null if the host allows reads of its state, or a string that explains why reads are not allowed.
     */
    @Nullable
    String beforeRead(@Nullable ModelObject producer);

    }

    def "is not available when visual studio installation cannot be located"() {
        when:
        visualStudioLookup.available >> false
        visualStudioLookup.explain(_) >> { DiagnosticsVisitor visitor -> visitor.node("vs install not found anywhere") }
        windowsSdkLookup.available >> false
		ucrtLookup.available >> false

        and:

 */

package org.gradle.platform.base.internal;

import org.gradle.internal.logging.text.DiagnosticsVisitor;

public interface BinaryBuildAbility {
    boolean isBuildable();
    void explain(DiagnosticsVisitor visitor);

import org.gradle.internal.logging.text.DiagnosticsVisitor;

public interface ToolSearchResult {
    boolean isAvailable();

    /**
     * Writes some diagnostics about why the tool is not available.
     */
    void explain(DiagnosticsVisitor visitor);

    public FixedBuildAbility(boolean buildable) {
        this.buildable = buildable;
    }

    @Override
    public boolean isBuildable() {
        return buildable;
    }

    @Override
    public void explain(DiagnosticsVisitor visitor) {
        if (!buildable) {
            visitor.node("Disabled by user");
        }
    }

public abstract class IncompatibleArtifactVariantsFailureDescriber extends AbstractResolutionFailureDescriber<IncompatibleResolutionFailure> {
    private static final String NO_MATCHING_VARIANTS_PREFIX = "No matching variant errors are explained in more detail at ";
    private static final String NO_MATCHING_VARIANTS_SECTION = "sub:variant-no-match";

    @Override

# go bug help is an error (bug takes no arguments)
! go bug help
stderr 'bug takes no arguments'

# go help mod shows mod subcommands
go help mod
stdout 'go mod <command>'
stdout tidy

# go help mod tidy explains tidy
go help mod tidy
stdout 'usage: go mod tidy'

# go mod help tidy does too
go mod help tidy
stdout 'usage: go mod tidy'

# go mod --help doesn't print help but at least suggests it.
! go mod --help

    }

    @Override
    public T getComponent() {
        return component;
    }

    @Override
    public boolean isAvailable() {
        return true;
    }

    @Override
    public void explain(DiagnosticsVisitor visitor) {
    }

 */
public abstract class AmbiguousArtifactVariantsFailureDescriber extends AbstractResolutionFailureDescriber<AmbiguousResolutionFailure> {
    private static final String AMBIGUOUS_VARIANTS_PREFIX = "Ambiguity errors are explained in more detail at ";
    private static final String AMBIGUOUS_VARIANTS_SECTION = "sub:variant-ambiguity";

    @Override

public abstract class InvalidMultipleVariantsFailureDescriber extends AbstractResolutionFailureDescriber<IncompatibleMultipleNodeSelectionFailure> {
    private static final String INCOMPATIBLE_VARIANTS_PREFIX = "Incompatible variant errors are explained in more detail at ";
    private static final String INCOMPATIBLE_VARIANTS_SECTION = "sub:variant-incompatible";

    @Override