Metadata-Version: 2.4
Name: idefix_cli
Version: 6.0.3
Summary: A command line utility belt for Idefix
Author: C.M.T. Robert
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Classifier: Programming Language :: Python :: 3
Classifier: Typing :: Typed
License-File: LICENSE
Requires-Dist: exceptiongroup>=1.0.0 ; python_full_version < '3.11'
Requires-Dist: inifix>=5.1.0
Requires-Dist: packaging>=21.0
Requires-Dist: termcolor>=2.3.0
Requires-Dist: typing-extensions>=4.1.0;python_version < '3.11'
Project-URL: Homepage, https://github.com/neutrinoceros/idefix_cli

[![PyPI](https://img.shields.io/pypi/v/idefix_cli.svg?logo=pypi&logoColor=white&label=PyPI)](https://pypi.org/project/idefix-cli/)
[![Documentation Status](https://readthedocs.org/projects/idefix-cli/badge/?version=latest)](https://idefix-cli.readthedocs.io/en/latest/?badge=latest)
[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/neutrinoceros/idefix_cli/main.svg)](https://results.pre-commit.ci/badge/github/neutrinoceros/idefix_cli/main.svg)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json)](https://github.com/charliermarsh/ruff)

# `idefix_cli`

`idefix_cli` is a command line utility belt for [Idefix](https://github.com/idefix-code/idefix).

It defines a `idfx` command familly. The builtin command set (`idfx conf`, `idfx run`,
...) can be extended to include arbitrary helper scripts.


## Installation

`idefix_cli` is distributed via the Python Packaging Index (PyPI).

It is recommended to install this tool at the system level, but still in isolation,
using for instance [`uv`](https://docs.astral.sh/uv/) as
```shell
$ uv tool install idefix-cli
```
or [`pipx`](https://pipxproject.github.io/pipx/)
```shell
$ pipx install idefix-cli
```

Otherwise, the most portable way to install the latest stable version is
```shell
$ python -m pip install --user idefix_cli
```

Note that most `idfx` commands explicitly require that the env variable `$IDEFIX_DIR` be
set at runtime.

## Get help

Get a complete description of available commands with
```shell
$ idfx --help
```
Likewise, get help for each command therein as, for instance
```shell
$ idfx run --help
```

For more, read [the documentation !](https://idefix-cli.readthedocs.io/en/latest/?badge=latest)

