}

    /**
     * Gets the file of this source.
     *
     * @return The underlying file, never {@code null}.
     * @deprecated Use {@link #getPath()} instead.
     */
    @Deprecated
    public File getFile() {
        return path.toFile();
    }

    /**
     * Gets the file of this source.
     *
     * @return The underlying file, never {@code null}.
     * @since 4.0.0
     */
    public Path getPath() {

/**
 * A factory for {@link MessageBuilder}.
 *
 * @since 4.0.0
 */
@Experimental
public interface MessageBuilderFactory extends Service {
    /**
     * Checks if the underlying output does support styling or not.
     * @return whether color styling is supported or not
     */
    boolean isColorEnabled();

    /**
     * Returns the terminal width or <code>-1</code> if not supported.

        return url.openStream();
    }

    @Override
    public String getLocation() {
        return url.toString();
    }

    /**
     * Gets the URL of this source.
     *
     * @return The underlying URL, never {@code null}.
     */
    public URL getUrl() {
        return url;
    }

    @Override
    public String toString() {
        return getLocation();
    }

    @Override

class, passing the specified name as the single argument to its constructor. See the SimpleLog JavaDocs for detailed configuration information for this default implementation. Configuring the Underlying Logging System The basic principle is that the user is totally responsible for the configuration of the underlying logging system. Commons-logging should not change the existing configuration. Each individual Log implementation may support its own configuration properties. These will be documented in the...

                    || descriptor.getRequiredMavenVersion().trim().isEmpty();

            if (isBlankVersion) {
                // only take value from underlying POM if plugin descriptor has no explicit Maven requirement
                descriptor.setRequiredMavenVersion(artifact.getProperty("requiredMavenVersion", null));
            }

            return descriptor;

        super(shortMessage);
        this.source = source;
        this.longMessage = longMessage;
    }

    /**
     * Construct a new <code>MojoExecutionException</code> exception wrapping an underlying <code>Throwable</code>
     * and providing a <code>message</code>.
     */
    public MojoException(String message, Throwable cause) {
        super(message, cause);
    }

    /**

 */
@Experimental
public interface Source {

    /**
     * Provides access the file to be parsed, if this source is backed by a file.
     *
     * @return the underlying {@code Path}, or {@code null} if this source is not backed by a file
     */
    @Nullable
    Path getPath();

    /**
     * Creates a new byte stream to the source contents.

        }
    }

    @Override
    public void addResource(@Nonnull Project project, @Nonnull ProjectScope scope, @Nonnull Resource resource) {
        // TODO: we should not modify the underlying model here, but resources should be stored
        // TODO: in a separate field in the project, however, that could break v3 plugins
        MavenProject prj = getMavenProject(nonNull(project, "project"));

        */
    }

    @Test
    void testMojoConfigurationIsMergedCorrectly() throws Exception {}

    /**
     * The case where the user wants to specify an alternate version of the underlying tool. Common case
     * is in the Antlr plugin which comes bundled with a version of Antlr but the user often times needs
     * to use a specific version. We need to make sure the version that they specify takes precedence.

    }

    @Override
    public String getLocation() {
        return location;
    }

    /**
     * Gets the content of this source.
     *
     * @return The underlying character stream, never {@code null}.
     */
    public String getContent() {
        return content;
    }

    @Override
    public String toString() {
        return getLocation();
    }