`hookspec`#

Pluggy hook specifications ("hookspecs") to register conda plugins.

Each hookspec defined in CondaSpecs contains an example of how to use it.

Classes#

CondaSpecs

The conda plugin hookspecs, to be used by developers.

Attributes#

`spec_name`	Name used for organizing conda hook specifications
`_hookspec`	The conda plugin hook specifications, to be used by developers
`hookimpl`	Decorator used to mark plugin hook implementations

spec_name = 'conda'#: Name used for organizing conda hook specifications

_hookspec#: The conda plugin hook specifications, to be used by developers

hookimpl#: Decorator used to mark plugin hook implementations

class CondaSpecs#

The conda plugin hookspecs, to be used by developers.

conda_solvers() → collections.abc.Iterable[conda.plugins.types.CondaSolver]#

Example:

import logging

from conda import plugins
from conda.core import solve

log = logging.getLogger(__name__)


class VerboseSolver(solve.Solver):
    def solve_final_state(self, *args, **kwargs):
        log.info("My verbose solver!")
        return super().solve_final_state(*args, **kwargs)


@plugins.hookimpl
def conda_solvers():
    yield plugins.CondaSolver(
        name="verbose-classic",
        backend=VerboseSolver,
    )

Returns:: An iterable of solver entries.

conda_subcommands() → collections.abc.Iterable[conda.plugins.types.CondaSubcommand]#

Example:

from conda import plugins


def example_command(args):
    print("This is an example command!")


@plugins.hookimpl
def conda_subcommands():
    yield plugins.CondaSubcommand(
        name="example",
        summary="example command",
        action=example_command,
    )

Returns:: An iterable of subcommand entries.

conda_virtual_packages() → collections.abc.Iterable[conda.plugins.types.CondaVirtualPackage]#

Example:

from conda import plugins


@plugins.hookimpl
def conda_virtual_packages():
    yield plugins.CondaVirtualPackage(
        name="my_custom_os",
        version="1.2.3",
        build="x86_64",
    )

Returns:: An iterable of virtual package entries.

conda_pre_commands() → collections.abc.Iterable[conda.plugins.types.CondaPreCommand]#

Example:

from conda import plugins


def example_pre_command(command):
    print("pre-command action")


@plugins.hookimpl
def conda_pre_commands():
    yield plugins.CondaPreCommand(
        name="example-pre-command",
        action=example_pre_command,
        run_for={"install", "create"},
    )

conda_post_commands() → collections.abc.Iterable[conda.plugins.types.CondaPostCommand]#

Example:

from conda import plugins


def example_post_command(command):
    print("post-command action")


@plugins.hookimpl
def conda_post_commands():
    yield plugins.CondaPostCommand(
        name="example-post-command",
        action=example_post_command,
        run_for={"install", "create"},
    )

conda_auth_handlers() → collections.abc.Iterable[conda.plugins.types.CondaAuthHandler]#

This plugin hook allows attaching requests auth handler subclasses, e.g. when authenticating requests against individual channels hosted at HTTP/HTTPS services.

Example:

import os
from conda import plugins
from requests.auth import AuthBase


class EnvironmentHeaderAuth(AuthBase):
    def __init__(self, *args, **kwargs):
        self.username = os.environ["EXAMPLE_CONDA_AUTH_USERNAME"]
        self.password = os.environ["EXAMPLE_CONDA_AUTH_PASSWORD"]

    def __call__(self, request):
        request.headers["X-Username"] = self.username
        request.headers["X-Password"] = self.password
        return request


@plugins.hookimpl
def conda_auth_handlers():
    yield plugins.CondaAuthHandler(
        name="environment-header-auth",
        auth_handler=EnvironmentHeaderAuth,
    )

conda_health_checks() → collections.abc.Iterable[conda.plugins.types.CondaHealthCheck]#

This plugin hook allows you to add more "health checks" to conda doctor that you can write to diagnose problems in your conda environment. Check out the health checks already shipped with conda for inspiration.

Example:

from conda import plugins


def example_health_check(prefix: str, verbose: bool):
    print("This is an example health check!")


@plugins.hookimpl
def conda_health_checks():
    yield plugins.CondaHealthCheck(
        name="example-health-check",
        action=example_health_check,
    )

conda_pre_solves() → collections.abc.Iterable[conda.plugins.types.CondaPreSolve]#

Register pre-solve functions in conda that are used in the general solver API, before the solver processes the package specs in search of a solution.

Example:

from conda import plugins
from conda.models.match_spec import MatchSpec


def example_pre_solve(
    specs_to_add: frozenset[MatchSpec],
    specs_to_remove: frozenset[MatchSpec],
):
    print(f"Adding {len(specs_to_add)} packages")
    print(f"Removing {len(specs_to_remove)} packages")


@plugins.hookimpl
def conda_pre_solves():
    yield plugins.CondaPreSolve(
        name="example-pre-solve",
        action=example_pre_solve,
    )

conda_post_solves() → collections.abc.Iterable[conda.plugins.types.CondaPostSolve]#

Register post-solve functions in conda that are used in the general solver API, after the solver has provided the package records to add or remove from the conda environment.

Example:

from conda import plugins
from conda.models.records import PackageRecord


def example_post_solve(
    repodata_fn: str,
    unlink_precs: tuple[PackageRecord, ...],
    link_precs: tuple[PackageRecord, ...],
):
    print(f"Uninstalling {len(unlink_precs)} packages")
    print(f"Installing {len(link_precs)} packages")


@plugins.hookimpl
def conda_post_solves():
    yield plugins.CondaPostSolve(
        name="example-post-solve",
        action=example_post_solve,
    )

conda_settings() → collections.abc.Iterable[conda.plugins.types.CondaSetting]#

The example below defines a simple string type parameter

Example:

from conda import plugins
from conda.common.configuration import PrimitiveParameter, SequenceParameter


@plugins.hookimpl
def conda_settings():
    yield plugins.CondaSetting(
        name="example_option",
        description="This is an example option",
        parameter=PrimitiveParameter("default_value", element_type=str),
        aliases=("example_option_alias",),
    )

hookspec#

Classes#

Attributes#

`hookspec`#