* under the License.
 */
package org.apache.maven.toolchain;

import org.apache.maven.execution.MavenSession;

/**
 * Component for use by the <code>maven-toolchains-plugin</code> only.
 * It provides API: <ol>
 * <li>to retrieve every toolchains available in user settings,</li>
 * <li>to store chosen toolchain into build context for later use by toolchain-aware plugins.</li>
 * </ol>
 *
 * @since 2.0.9

     * @return the toolchain selected by <code>maven-toolchains-plugin</code>
     */
    Toolchain getToolchainFromBuildContext(String type, MavenSession context);

    /**
     * Select all toolchains available in user settings matching the type and requirements,
     * independently from <code>maven-toolchains-plugin</code>.
     *
     * @param session the Maven session, must not be {@code null}

 * under the License.
 */
package org.apache.maven.toolchain.java;

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.Map.Entry;
import java.util.Properties;

import org.apache.maven.toolchain.MisconfiguredToolchainException;
import org.apache.maven.toolchain.RequirementMatcher;
import org.apache.maven.toolchain.RequirementMatcherFactory;

 * under the License.
 */
package org.apache.maven.toolchain;

import java.util.Map;

import org.apache.maven.toolchain.model.ToolchainModel;

/**
 * a private contract between the toolchains plugin and the components.
 *
 * @deprecated Use {@link org.apache.maven.api.Toolchain} instead.
 */
@Deprecated(since = "4.0.0")
public interface ToolchainPrivate extends Toolchain {

    /**

 * specific language governing permissions and limitations
 * under the License.
 */
package org.apache.maven.toolchain;

import org.apache.maven.toolchain.model.ToolchainModel;

/**
 * Internal toolchain factory, to prepare toolchains instances.
 *
 * @since 2.0.9
 * @deprecated Use {@link org.apache.maven.api.services.ToolchainFactory} instead.
 */
@Deprecated(since = "4.0.0")

 * under the License.
 */
package org.apache.maven.toolchain;

import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;
import java.util.Objects;
import java.util.Properties;

import org.apache.maven.toolchain.model.ToolchainModel;
import org.slf4j.Logger;

/**
 * Default abstract toolchain implementation, to be used as base class for any toolchain implementation
 * to avoid rewriting usual code.
 *

        org.apache.maven.api.Toolchain rareToolchain = mock(org.apache.maven.api.Toolchain.class);
        when(toolchainFactoryRareType.createToolchain(any())).thenReturn(rareToolchain);

        List<Toolchain> toolchains = toolchainManager.getToolchains(session, "rare", null);

        assertEquals(1, toolchains.size());
    }

    @Test
    void testModelsAndFactory() {

              <include>org.apache.maven.toolchain.building</include>
              <include>org.apache.maven.toolchain.io</include>
              <include>org.apache.maven.toolchain.io.xpp3</include>
              <include>org.apache.maven.toolchain.merge</include>
            </includes>
            <excludes>

# Use the old Apple toolchain for MacOS builds.
common:macos --config=clang_local
common:macos --config=apple-toolchain

# Use cc toolchains from apple_support for Apple builds (ios, macos, etc).
# https://github.com/bazelbuild/apple_support/tree/master?tab=readme-ov-file#bazel-6-setup
common:apple-toolchain --apple_crosstool_top=@local_config_apple_cc//:toolchain

 * under the License.
 */
package org.apache.maven.toolchain.java;

import org.apache.maven.toolchain.Toolchain;

/**
 * JDK toolchain interface.
 *
 * @since 2.0.9, renamed from JavaToolChain in 3.2.4
 * @deprecated Use {@link org.apache.maven.api.JavaToolchain} instead.
 */
@Deprecated(since = "4.0.0")