Metadata-Version: 2.4
Name: compchem-cctop
Version: 0.1.4
Summary: A minimal terminal dashboard for computational chemistry output files.
Author: cctop contributors
License-Expression: MIT
Keywords: computational-chemistry,orca,cli,tui
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
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
Classifier: Topic :: Scientific/Engineering :: Chemistry
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == "dev"
Dynamic: license-file

# cctop

`cctop` is a minimal terminal dashboard for computational chemistry output folders.

![cctop demo terminal output](assets/cctop.png)

- ORCA output parsing.
- Directory scan.
- Single-file inspect.
- CSV/JSON export.
- Basic terminal UI when run in a real terminal.
- No recommendations or automatic fix suggestions.

## Usage

```bash
cctop .
cctop path/to/orca.out
cctop export .
cctop export . --format json
```

When stdout is not attached to a terminal, `cctop` prints a plain text summary instead of opening the TUI.

Try the demo data:

```bash
cctop testing/demo_orca_project
```

## Install

From PyPI:

```bash
pipx install compchem-cctop
```

or:

```bash
python -m pip install compchem-cctop
```

For a local checkout:

```bash
python -m pip install -e .
```

For an isolated command-line install:

```bash
pipx install .
```

## Development

```bash
python -m pip install -e ".[dev]"
python -m cctop .
python -m unittest
```

Build release artifacts:

```bash
python -m build
```
