import java.io.InputStream;

/**
 * Provides access to the contents of a source independently of the backing store (e.g. file system, database, memory).
 *
 * @deprecated since 4.0.0, use {@link org.apache.maven.api.services} instead
 */
@Deprecated(since = "4.0.0")
public interface Source {

    /**
     * Gets a byte stream to the source contents. Closing the returned stream is the responsibility of the caller.
     *

 * @see org.apache.maven.api.services.ProjectBuilder#build(Session, Source)
 */
@Experimental
public interface Source {
    /**
     * Provides access to the file backing this source, if available.
     * Not all sources are backed by files - for example, in-memory sources
     * or database-backed sources will return null.
     *
     * @return the underlying {@code Path} if this source is file-backed,

Guillaume Nodet <******@****.***> 1729859506 +0200

public final class Sources {

    private Sources() {}

    /**
     * Creates a new source for the specified path.
     *
     * @param path the path to the file
     * @return a new Source instance
     * @throws NullPointerException if path is null
     */
    @Nonnull
    public static Source fromPath(@Nonnull Path path) {
        return new PathSource(requireNonNull(path, "path"));
    }

    /**

        Path path = Paths.get("/tmp");
        Source source = Sources.fromPath(path);

        assertNotNull(source);
        assertInstanceOf(Sources.PathSource.class, source);
        assertEquals(path.normalize(), source.getPath());
    }

    @Test
    void testBuildSource() {
        Path path = Paths.get("/tmp");
        ModelSource source = Sources.buildSource(path);

        assertNotNull(source);

    /**
     * Gets the installation settings source.
     *
     * @return the installation settings source or {@code null} if none
     */
    @Nonnull
    Optional<Source> getInstallationSettingsSource();

    /**
     * Gets the project settings source.
     *
     * @return the project settings source or {@code null} if none
     */
    @Nonnull
    Optional<Source> getProjectSettingsSource();

    /**

    /**
     * Gets the installation Toolchains source.
     *
     * @return the installation Toolchains source or {@code null} if none
     */
    @Nonnull
    Optional<Source> getInstallationToolchainsSource();

    /**
     * Gets the user Toolchains source.
     *
     * @return the user Toolchains source or {@code null} if none
     */
    @Nonnull
    Optional<Source> getUserToolchainsSource();

    @Nonnull

     * @throws RuntimeException If failed (and not due source not exists).
     */
    boolean get(@Nonnull URI relativeSource, @Nonnull Path target);

    /**
     * GETs the source URI content as byte array. The source MUST BE relative from the {@link RemoteRepository#getUrl()}
     * root.
     *
     * @return the byte array if operation succeeded, {@code null} if source does not exist.

        ModelSource source = Sources.resolvedSource(path, modelId);

        assertNotNull(source);
        assertEquals(modelId, source.getModelId(), "Resolved source should return the provided modelId");
        assertNull(source.getPath(), "Resolved sources should return null for getPath()");
        assertEquals(path.toString(), source.getLocation());
    }

    @Test

  echo 'already sourced a TFCI env file with "set -a; source <path>; set +a".'
  echo 'If you have not, you will see a lot of undefined variable errors.'
else
  FROM_ENV=$(mktemp)
  # "export -p" prints a list of environment values in a safe-to-source format,
  # e.g. `declare -x TFCI_BAZEL_COMMON_ARGS="list of args"` for bash.
  export -p | grep TFCI > "$FROM_ENV"

  # Source the default ci values