############################
# MICROMAMBA INITIAL SETUP #
############################

## Shell Initialization

To get started with Micromamba, first we need to initialize our shell in order
to create environments. We could just use:

$ eval "$(micromamba shell hook --shell bash)"

However, to automate this process, just copy and paste the following line to
your shell's profile config file:

test -f /usr/etc/profile.d/micromamba.sh && . /usr/etc/profile.d/micromamba.sh

NOTE: If you use Bash, put that line in either ~/.profile, ~/.bash_profile, or
even ~/.bashrc - if it's the only shell RC file you have, under your home
directory, and you're not willing to create any of the others.

NOTE: And if you use Zsh, there's ~/.zprofile, and ~/.zshrc. In case you don't
have a zprofile, either create it or just use zshrc.

## Optional Base Environment

Before going ahead and using micromamba - but this can be done at any point in
the future, really - we must decide whether we want the full-fledged Mamba. If
so, the base environment must be activated:

$ micromamba activate base

Then we install Mamba with:

$ micromamba install mamba

NOTE: The base environment is supposed to have only Mamba and Conda, according
to:

    https://mamba.readthedocs.io/en/latest/user_guide/troubleshooting.html

## Creating New Environments

With or without the previous step, we can create new environments according to
our needs:

$ micromamba create -n my_new_env foo-package bar-package
$ micromamba activate my_new_env

## Final Notes

The package provides a generic /var/lib/conda/.mambarc system wide RC file. But
other RC files can be used to override configuration/make additions, according
to our needs. For more information, visit:

    https://mamba.readthedocs.io/en/latest/user_guide/configuration.html

A reference mambarc can be found under /usr/share/doc/packages/micromamba/,
where it's explained what every option does, and the values they can have.

You can also get the latest version of a mambarc, which is the same as condarc,
after installing Mamba - installing Mamba should install Conda as well -, with:

$ micromamba activate
$ python -c 'import conda.cli.main_config; \
             print(conda.cli.main_config.describe_all_parameters())' \
      > mambarc

For general documentation, you can visit https://mamba.readthedocs.io and
https://conda.io.

Enjoy and have fun!
