id       = "conda"
name     = "conda"
homepage = "https://docs.conda.io/projects/conda/en/stable/user-guide/configuration/use-condarc.html"
description = "Package, dependency and environment management for any language."
# conda's round logo mark, from the project's own documentation assets —
# conda.org only serves the wide wordmark, which reads badly at icon size.
icon     = "https://raw.githubusercontent.com/conda/conda/main/docs/source/_static/img/logo-element.svg"
executables   = ["conda"]

[dotfiles]

# https://docs.conda.io/projects/conda/en/stable/user-guide/configuration/use-condarc.html
# — ".condarc … is automatically created in your home directory the first time
# you run the conda config command", and "The .condarc file is just a YAML
# file". The same file name is used on Windows, under the user profile.
paths = ["~/.condarc"]

exclude = []

# conda itself writes no credential file; anaconda.org tokens are the business
# of anaconda-client, which keeps them elsewhere.
secret = []

# https://docs.conda.io/projects/conda/en/stable/user-guide/configuration/settings.html
# — envs_dirs "Specify directories in which environments are located" and
# pkgs_dirs "Specify directories in which packages are located", both lists of
# absolute filesystem paths ("/opt/anaconda/envs", "/opt/anaconda/pkgs"). Where
# a machine keeps its environments is a fact about that machine; the channels
# and solver settings around them are the preference worth carrying. The
# directories are the user's own layout — often a second volume — and have to
# be recreated by hand, so they are kept: backup.
[[dotfiles.machine_lines]]
file   = "~/.condarc"
format = "yaml"
match  = { key_path = ["envs_dirs", "pkgs_dirs"] }
scope  = "backup"

[commands]
format = 1
label = "Conda"
description = "Install packages into, or create, a conda environment."
quality = "ai-draft"
base = "fig:conda"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = true }

[[commands.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/conda.ts"
license = "MIT"

[[commands.subcommand]]
path = ["install"]
label = "Install packages"
description = "Install packages into a named or prefixed environment. Solver tuning and index-cache options are left out."

[[commands.subcommand.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/conda.ts"
license = "MIT"

[[commands.subcommand.field]]
id = "packages"
label = "Packages"
type = "string"
position = 0
multiple = true
sources = ["fig"]

[[commands.subcommand.field]]
id = "name"
label = "Environment name"
type = "string"
option = ["--name", "-n"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "prefix"
label = "Environment path"
type = "path"
option = ["--prefix", "-p"]
path = { kind = "directory", role = "input", must_exist = false }
sources = ["fig"]

[[commands.subcommand.field]]
id = "channel"
label = "Channels"
type = "string"
option = ["--channel", "-c"]
multiple = true
suggestions = [{ value = "conda-forge", label = "conda-forge" }]
sources = ["fig"]

[[commands.subcommand.field]]
id = "file"
label = "Requirements file"
type = "path"
option = ["--file"]
path = { kind = "file", role = "input", must_exist = true }
sources = ["fig"]

[[commands.subcommand.field]]
id = "dry_run"
label = "Dry run"
type = "boolean"
option = ["--dry-run", "-d"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "yes"
label = "Do not ask for confirmation"
type = "boolean"
option = ["--yes", "-y"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "no_deps"
label = "Skip dependencies"
description = "Can lead to broken environments."
type = "boolean"
option = ["--no-deps"]
sources = ["fig"]

[[commands.subcommand.task]]
id = "install"
label = "Install into an environment"
fields = ["packages", "name", "channel", "dry_run", "yes"]
required = ["packages"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["packages", "name", "prefix", "channel", "file"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["dry_run", "yes", "no_deps"]

[[commands.subcommand]]
path = ["create"]
label = "Create an environment"
description = "Create a new environment from a list of packages. Solver tuning options are left out."

[[commands.subcommand.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/conda.ts"
license = "MIT"

[[commands.subcommand.field]]
id = "packages"
label = "Packages"
type = "string"
position = 0
multiple = true
sources = ["fig"]

[[commands.subcommand.field]]
id = "name"
label = "Environment name"
type = "string"
option = ["--name", "-n"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "prefix"
label = "Environment path"
type = "path"
option = ["--prefix", "-p"]
path = { kind = "directory", role = "output", must_exist = false }
sources = ["fig"]

[[commands.subcommand.field]]
id = "channel"
label = "Channels"
type = "string"
option = ["--channel", "-c"]
multiple = true
suggestions = [{ value = "conda-forge", label = "conda-forge" }]
sources = ["fig"]

[[commands.subcommand.field]]
id = "file"
label = "Requirements file"
type = "path"
option = ["--file"]
path = { kind = "file", role = "input", must_exist = true }
sources = ["fig"]

[[commands.subcommand.field]]
id = "clone"
label = "Clone environment"
description = "Path to (or name of) an existing local environment."
type = "string"
option = ["--clone"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "dry_run"
label = "Dry run"
type = "boolean"
option = ["--dry-run", "-d"]
sources = ["fig"]

[[commands.subcommand.field]]
id = "yes"
label = "Do not ask for confirmation"
type = "boolean"
option = ["--yes", "-y"]
sources = ["fig"]

[[commands.subcommand.task]]
id = "create"
label = "Create a named environment"
fields = ["name", "packages", "channel", "yes"]
required = ["name"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["name", "packages", "prefix", "channel", "file", "clone"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["dry_run", "yes"]