types#

Definition of specific return types for use when defining a conda plugin hook.

Each type corresponds to the plugin hook for which it is used.

Classes#

CondaSubcommand

Return type to use when defining a conda subcommand plugin hook.

CondaVirtualPackage

Return type to use when defining a conda virtual package plugin hook.

CondaSolver

Return type to use when defining a conda solver plugin hook.

CondaPreCommand

Return type to use when defining a conda pre-command plugin hook.

CondaPostCommand

Return type to use when defining a conda post-command plugin hook.

ChannelNameMixin

Class mixin to make all plugin implementations compatible, e.g. when they

ChannelAuthBase

Base class that we require all plugin implementations to use to be compatible.

CondaAuthHandler

Return type to use when the defining the conda auth handlers hook.

CondaHealthCheck

Return type to use when defining conda health checks plugin hook.

CondaPreSolve

Return type to use when defining a conda pre-solve plugin hook.

CondaPostSolve

Return type to use when defining a conda post-solve plugin hook.

CondaSetting

Return type to use when defining a conda setting plugin hook.

class CondaSubcommand#

Return type to use when defining a conda subcommand plugin hook.

For details on how this is used, see conda_subcommands().

Parameters:
  • name -- Subcommand name (e.g., conda my-subcommand-name).

  • summary -- Subcommand summary, will be shown in conda --help.

  • action -- Callable that will be run when the subcommand is invoked.

  • configure_parser -- Callable that will be run when the subcommand parser is initialized.

name: str#
summary: str#
action: Callable[[argparse.Namespace | tuple[str]], int | None]#
configure_parser: Callable[[argparse.ArgumentParser], None] | None#
class CondaVirtualPackage#

Bases: NamedTuple

Return type to use when defining a conda virtual package plugin hook.

For details on how this is used, see conda_virtual_packages().

Parameters:
  • name -- Virtual package name (e.g., my_custom_os).

  • version -- Virtual package version (e.g., 1.2.3).

  • build -- Virtual package build string (e.g., x86_64).

name: str#
version: str | None#
build: str | None#
to_virtual_package() conda.models.records.PackageRecord#
class CondaSolver#

Bases: NamedTuple

Return type to use when defining a conda solver plugin hook.

For details on how this is used, see conda_solvers().

Parameters:
  • name -- Solver name (e.g., custom-solver).

  • backend -- Type that will be instantiated as the solver backend.

name: str#
backend: type[conda.core.solve.Solver]#
class CondaPreCommand#

Bases: NamedTuple

Return type to use when defining a conda pre-command plugin hook.

For details on how this is used, see conda_pre_commands().

Parameters:
  • name -- Pre-command name (e.g., custom_plugin_pre_commands).

  • action -- Callable which contains the code to be run.

  • run_for -- Represents the command(s) this will be run on (e.g. install or create).

name: str#
action: Callable[[str], None]#
run_for: set[str]#
class CondaPostCommand#

Bases: NamedTuple

Return type to use when defining a conda post-command plugin hook.

For details on how this is used, see conda_post_commands().

Parameters:
  • name -- Post-command name (e.g., custom_plugin_post_commands).

  • action -- Callable which contains the code to be run.

  • run_for -- Represents the command(s) this will be run on (e.g. install or create).

name: str#
action: Callable[[str], None]#
run_for: set[str]#
class ChannelNameMixin(channel_name: str, *args, **kwargs)#

Class mixin to make all plugin implementations compatible, e.g. when they use an existing (e.g. 3rd party) requests authentication handler.

Please use the concrete ChannelAuthBase in case you're creating an own implementation.

class ChannelAuthBase(channel_name: str, *args, **kwargs)#

Bases: ChannelNameMixin, requests.auth.AuthBase

Base class that we require all plugin implementations to use to be compatible.

Authentication is tightly coupled with individual channels. Therefore, an additional channel_name property must be set on the requests.auth.AuthBase based class.

class CondaAuthHandler#

Bases: NamedTuple

Return type to use when the defining the conda auth handlers hook.

Parameters:
  • name -- Name (e.g., basic-auth). This name should be unique and only one may be registered at a time.

  • handler -- Type that will be used as the authentication handler during network requests.

name: str#
handler: type[ChannelAuthBase]#
class CondaHealthCheck#

Bases: NamedTuple

Return type to use when defining conda health checks plugin hook.

name: str#
action: Callable[[str, bool], None]#
class CondaPreSolve#

Return type to use when defining a conda pre-solve plugin hook.

For details on how this is used, see conda_pre_solves().

Parameters:
  • name -- Pre-solve name (e.g., custom_plugin_pre_solve).

  • action -- Callable which contains the code to be run.

name: str#
action: Callable[[frozenset[conda.models.match_spec.MatchSpec], frozenset[conda.models.match_spec.MatchSpec]], None]#
class CondaPostSolve#

Return type to use when defining a conda post-solve plugin hook.

For details on how this is used, see conda_post_solves().

Parameters:
  • name -- Post-solve name (e.g., custom_plugin_post_solve).

  • action -- Callable which contains the code to be run.

name: str#
action: Callable[[str, tuple[conda.models.records.PackageRecord, Ellipsis], tuple[conda.models.records.PackageRecord, Ellipsis]], None]#
class CondaSetting#

Return type to use when defining a conda setting plugin hook.

For details on how this is used, see conda_settings().

Parameters:
  • name -- name of the setting (e.g., config_param)

  • description -- description of the setting that should be targeted towards users of the plugin

  • parameter -- Parameter instance containing the setting definition

  • aliases -- alternative names of the setting

name: str#
description: str#
parameter: conda.common.configuration.Parameter#
aliases: tuple[str, Ellipsis]#