@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);

 * library. For more information on Sources and Sinks as well as other features of this package, see
 * <a href="https://github.com/google/guava/wiki/IOExplained">I/O Explained</a> on the Guava wiki.
 *
 * @author Chris Nokleberg
 */
@CheckReturnValue
@ParametersAreNonnullByDefault
package com.google.common.io;

import com.google.errorprone.annotations.CheckReturnValue;

    }

    def "is unavailable when no language tools can be found and building any language"() {
        def compilerMissing = Stub(CommandLineToolSearchResult) {
            isAvailable() >> false
            explain(_) >> { DiagnosticsVisitor visitor -> visitor.node("c compiler not found") }
        }

        given:
        platform.operatingSystem >> dummyOs
        platform.architecture >> dummyArch

        and:

    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");
        }
    }

You can also replace much of Gradle’s logging with your own by registering various event listeners.
One example of a <<logging.adoc#sec:changing_what_gradle_logs,custom event logger is explained in the logging documentation>>.
You can also <<logging.adoc#sec:external_tools,control logging from external tools>>, making them more verbose to debug their execution.

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