Anaconda Client

This is a command line client that provides an interface to anaconda.org.

Quickstart:

First, create an account on anaconda.org, if you may still don't have one.

Then, install anaconda-client into your conda environment:

conda install anaconda-client

Log into your account:

anaconda login

Test your login wit the whoami command:

anaconda whoami

For a complete tutorial on building and uploading Conda packages to anaconda.org visit the documentation page.

For channel notices (conda user-facing messages), see doc/channel_notices.md.

Local development

Setup conda environment:

make init

Activate development environment:

conda activate anaconda_client

Run anaconda-client commands:

python -m binstar_client.scripts.cli --version

Setup conda environment for testing telemetry:

• By default this uses an editable install of anaconda-opentelemetry
  • Assumes that project root is adjacent to this one
• If you don't have the repo cloned it will not work. Removing it from the environment-tel.yml file will use the a package version from conda defaults that satisfies the dependency of anaconda-cli-base
• You may also want an editable install of anaconda-cli-base since it is the source of telemetry export, in which case just add that to the environment-tel.yml file, remove the environment, and run make init-tel again

make init-tel

Activate it:

conda activate ./tel-env

Pre-commit Setup in Local

Pre-commit also runs in the GitHub workflow on pull requests. Installing it locally is recommended so you catch formatting and lint issues before pushing, and avoid back-and-forth commits when CI auto-fixes files. Set this up from the development environment (./env, Python 3.11) — some hooks require Python ≥ 3.10.

conda activate ./env        # Need not run if anaconda-client env is already activated
pip install pre-commit
pre-commit install          # wire git hooks to this env's Python
pre-commit install-hooks    # download hook environments

After pre-commit install, hooks run automatically on each git commit — you do not need to run anything extra before pushing. Optionally, make pre-commit runs all hooks across the entire repo (useful before opening a PR). If commits still fail with a Python 3.9 error, the git hook was likely installed from a different environment (for example base Miniconda). Re-install from ./env:

conda activate ./env    # Need not run if anaconda-client env is already activated
pre-commit clean
pre-commit install
pre-commit install-hooks

and run git commit to commit all changes.