Metadata-Version: 2.1
Name: slutil
Version: 0.1.dev1
Summary: Command-line utility to view slurm jobs
Author-email: Eugene Prout <eugene.prout1@gmail.com>
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: click (==8.1.3)
Requires-Dist: colorama (==0.4.6)
Requires-Dist: markdown-it-py (==2.1.0)
Requires-Dist: mdurl (==0.1.2)
Requires-Dist: Pygments (==2.14.0)
Requires-Dist: rich (==13.3.1)

# slutil

A command line utility to view Slurm jobs.

```
Usage: slutil [OPTIONS] COMMAND [ARGS]...

Commands:
  report  Get status of multiple jobs
  status  Get status of a slurm job.
  submit  Submit a slurm job.
```

## submit

Add metadata to an `sbatch` command and store data in the database

**Must** be used to log jobs in the database.

```
Usage: slutil submit [OPTIONS] SBATCH_FILE DESCRIPTION

  Submit a slurm job.

  SBATCH_FILE is a path to the .sbatch file for the job

  DESCRIPTION is a text field describing the job

Options:
  --help  Show this message and exit.
```

## report

View list of recent jobs

- Count parameter specifies the number of jobs to be displayed. Defaults to 10.
- Truncated to screen width by default, `-v` to enable word-wrap.

```
Usage: slutil report [OPTIONS]

  Get status of multiple jobs

Options:
  -c, --count INTEGER
  -v, --verbose
  --help               Show this message and exit.
```

## status

Displays the data on a specific job

```
Usage: slutil status [OPTIONS] SLURM_ID

  Get status of a slurm job.

  SLURM_ID is the id of the job to check.

Options:
  --help  Show this message and exit.
```
