Skip to content

Latest commit

 

History

History
62 lines (44 loc) · 2.34 KB

README.md

File metadata and controls

62 lines (44 loc) · 2.34 KB
Raw

Conda Module for Nushell

A simple module for activating and deactivating Conda environments.

Prerequisites

Installation

Put nu_conda.nu into the module folder of your nushell configuration workspace.

Usage

use nu_conda.nu         # activate module
nu_conda activate py36  # activate a Conda environment, e.g. py36
nu_conda deactivate     # deactivate the activated Conda environment
nu_conda list           # list available environments, same as `$env.CONDA_ENVS`

How It Works

This module re-implements the activation and deactivation functionalities of the conda.nu module while providing a better performance, but not fully replacing it.

This module adds paths of a target Conda environment to PATH/Path while activating the environment, and recover the original PATH/Path while deactivating an environment. Several environment variables are exported:

  • CONDA_BASE_PATH: The original PATH/Path before any activation/deactivation.
  • CONDA_ROOT: Root directory of Conda installation.
  • CONDA_ENVS: Available Conda environments for activation.
  • CONDA_CURR: Current activated Conda environments.

FAQ

Q: How better is the performance?
A: Activating a Conda environment costs ~20ms while conda.nu costs ~1500ms on a PC with Windows 10 Enterprise OS and Intel i7-8700 3.20GHz CPU.

Q: How to show the current Conda environment in the prompt?
A: This module does not automatically change the prompt when a Conda environment is activated, but an environment variable $env.CONDA_CURR is set to the name of the current Conda environment which can be used to customize the prompt.

Q: Does it support Mamba/Micromamba?
A: As Mamba's documentation said, mamba is drop-in replacement for conda, and micromamba seems to be another thing. This module only uses results of conda/mamba info --envs --json. Therefore, I would say Mamba is (partially?) supported but I'm not sure about Micromamba.

Q: How does it choose between Conda and Mamba?
A: This module prefers calling mamba than conda, but it should be very easy to change the preference by modifying the source code.

Q: Completions?
A: PRs are welcomed.