Metadata-Version: 2.1
Name: conda-app
Version: 0.4.2
Summary: Install applications with conda
Keywords: conda,packaging
Author: Pierre Augier
License: BSD
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Project-URL: Homepage, https://foss.heptapod.net/fluiddyn/conda-app/
Requires-Python: >=3.10
Requires-Dist: click
Description-Content-Type: text/markdown

# Conda-app

[![PyPI][pypi-badge]][pypi-link]
[![Github Actions Unix][GH-badge-unix]][GH-link-unix]
[![Github Actions Windows][GH-badge-windows]][GH-link-windows]
[![Heptapod CI][Heptapod-badge]][Heptapod-link]

## Install isolated applications using conda

`conda-app` is a tiny `conda` extension (actually a commandline tool using
`conda` or `mamba`) to install applications in isolated environments. Like
[pipx](https://github.com/pypa/pipx) but with conda environments.

The main advantages are:

- very simple **cross-platform** installation commands for Windows, macOS and
  Linux (and different shells, as bash, fish and zsh).

- the applications are installed in **isolated** environments.

- commands provided by the applications are **available system-wide**, i.e. even
  when the associated conda environment is not activated.

- Installation from the `conda-forge` channel so there is **no need for
compilation**.

### Installation of conda-app

```bash
pip install conda-app
```

### Example of Mercurial

Mercurial and common extensions (`hg-git` and `hg-evolve`) can be installed with:

```bash
conda-app install mercurial
```

Then, in **a new terminal** (on Windows, the "Conda Prompt"), the Mercurial
command `hg` should be available so one can try `hg version -v`.

This should also work:

```raw
$ conda-app list
Installed applications:
 ['mercurial', 'spyder', 'pandoc']

$ conda-app uninstall pandoc
...
```

[pypi-badge]: https://img.shields.io/pypi/v/conda-app.svg
[pypi-link]: https://pypi.python.org/pypi/conda-app/
[GH-badge-unix]: https://github.com/fluiddyn/conda-app/actions/workflows/unix.yml/badge.svg?branch=branch/default
[GH-link-unix]: https://github.com/fluiddyn/conda-app/actions/workflows/unix.yml
[GH-badge-windows]: https://github.com/fluiddyn/conda-app/actions/workflows/windows.yml/badge.svg?branch=branch/default
[GH-link-windows]: https://github.com/fluiddyn/conda-app/actions/workflows/windows.yml
[Heptapod-badge]: https://foss.heptapod.net/fluiddyn/conda-app/badges/branch/default/pipeline.svg
[Heptapod-link]: https://foss.heptapod.net/fluiddyn/conda-app/-/pipelines
