Metadata-Version: 2.1
Name: doco-cli
Version: 0.1.3
Summary: 
Home-page: https://github.com/bibermann/doco-cli
License: GPL-3.0-only
Keywords: docker,rsync
Author: Fabian Sandoval Saldias
Author-email: fabianvss@gmail.com
Requires-Python: >=3.9.2,<4.0.0
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: PyYAML (>=6.0,<7.0)
Requires-Dist: pydantic (>=1.10.2,<2.0.0)
Requires-Dist: python-dotenv (>=0.21.0,<0.22.0)
Requires-Dist: rich (>=12.6.0,<13.0.0)
Requires-Dist: typer[all] (>=0.6.1,<0.7.0)
Project-URL: Repository, https://github.com/bibermann/doco-cli
Description-Content-Type: text/markdown

# Doco CLI

**doco** (**do**cker **co**mpose tool) is a command line tool for working with _docker compose_ projects
(pretty-printing status, creating backups using rsync, batch commands and more).

Example calls:

- `doco s *`: Print pretty status of all _docker compose_ projects in the current directory.
- `doco s . -aa`: Print most detailled status of a _docker compose_ project (including variables and volumes).
- `doco r .`: Equivalent of `docker compose down --remove-orphans && docker compose up --build -d`.
- `doco backups create . --dry-run`: See what would be done to create a backup of a _docker compose_ project.

To explore all possibilities, run `doco -h` or see  [docs/doco-help.md](docs/doco-help.md).

## Installation

```bash
pipx install doco-cli
doco --install-completion
```

Or install from source, see [docs/installation.md](docs/installation.md).

## Configuration

To create a backup, you need to create a `doco.config.json` file.

See [docs/configuration.md](docs/configuration.md).

## Development

To start developing, see [docs/development.md](docs/development.md).

