id       = "mamba"
name     = "Mamba"
homepage = "https://mamba.readthedocs.io"
description = "mamba is a reimplementation of the conda package manager in C++."
# The project's own logo, from its documentation site.
icon     = "https://mamba.readthedocs.io/en/latest/_static/logo.png"
executables   = ["mamba", "micromamba"]

[dotfiles]

# https://mamba.readthedocs.io/en/stable/user_guide/configuration.html lists
# the rc files mamba reads in precedence order; the per-user entries are
# "~/.condarc" and "~/.mambarc", and the page's worked example is literally
# `cat ~/.mambarc`. Only .mambarc is claimed here — ~/.condarc is conda's file
# and has its own entry — and the same name is used on Windows, under the user
# profile.
#
# Missing an extension, the file is YAML: "rc file: a file using YAML syntax".
paths = ["~/.mambarc"]

exclude = []

# mamba stores no token of its own; channel credentials live in the
# authentication file its docs point at separately.
secret = []

# https://docs.conda.io/projects/conda/en/stable/user-guide/configuration/settings.html,
# whose settings mamba shares: 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, and where a
# machine keeps its environments and package cache is a fact about that
# machine. The channels and solver settings beside them are the preference
# worth carrying. Both keys are written only when the user moves them, and
# where their environments live is the sort of thing they need back when
# rebuilding this box, so the values are kept for this device alone.
[[dotfiles.machine_lines]]
file   = "~/.mambarc"
format = "yaml"
match  = { key_path = ["envs_dirs", "pkgs_dirs"] }
scope  = "backup"

[commands]
format = 1
label = "Mamba"
description = "Create environments, install packages and list them. Pick a job below; other subcommands and solver tuning options are left out."
quality = "ai-draft"
base = "fig:mamba"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

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

[[commands.subcommand]]
path = ["create"]
label = "Create environment"

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

[[commands.subcommand.field]]
id = "specs"
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 = "channel"
label = "Channels"
type = "string"
option = ["--channel", "-c"]
multiple = true
sources = ["fig"]

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

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

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

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["name", "specs", "channel", "yes", "dry_run"]

[[commands.subcommand]]
path = ["install"]
label = "Install packages"

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

[[commands.subcommand.field]]
id = "specs"
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 = "channel"
label = "Channels"
type = "string"
option = ["--channel", "-c"]
multiple = true
sources = ["fig"]

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

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

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

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["name", "specs", "channel", "yes", "dry_run"]

[[commands.subcommand]]
path = ["list"]
label = "List packages"

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

[[commands.subcommand.field]]
id = "regex"
label = "Name regex"
type = "string"
position = 0
sources = ["fig"]

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

[[commands.subcommand.field]]
id = "json"
label = "JSON output"
type = "boolean"
option = ["--json"]
sources = ["fig"]

[[commands.subcommand.task]]
id = "list"
label = "List packages"
fields = ["name", "regex"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["regex", "name", "json"]