https://github.com/teismar/coco
CoCo: Your Container Companion — A helpful CLI for Docker tasks
https://github.com/teismar/coco
cli docker docker-compose mit-license pypi typer-cli
Last synced: 17 days ago
JSON representation
CoCo: Your Container Companion — A helpful CLI for Docker tasks
- Host: GitHub
- URL: https://github.com/teismar/coco
- Owner: teismar
- License: mit
- Created: 2025-02-15T22:30:08.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-16T10:33:20.000Z (about 1 year ago)
- Last Synced: 2025-09-01T03:47:22.788Z (6 months ago)
- Topics: cli, docker, docker-compose, mit-license, pypi, typer-cli
- Language: Python
- Homepage: https://pypi.org/project/coco-docker/
- Size: 18.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CoCo: Your Container Companion
CoCo is a simple, open-source CLI tool that helps you manage Docker Compose tasks with ease. Whether you need to extract Docker image names from a Compose file or pull Docker images concurrently while viewing live status updates, CoCo has you covered.
## Features
- **Extract Images:**
Parse a Docker Compose file (YAML) to extract the Docker image names from your services and save them to a file.
- **Concurrent Image Pulls:**
Pull Docker images concurrently with a live, updating overview.
## Installation
### PyPI
```bash
pip install coco-docker
```
### From Source
**Prerequisites:**
- Python 3.12 or higher
- Poetry
```bash
git clone https://github.com/teismar/coco
cd coco
```
Install the dependencies:
```bash
poetry install
```
Install the package:
```bash
poetry build
pipx install dist/coco_cli-0.1.0-py3-none-any.whl
```
## Usage
### Extract Images
The `extract-images` command extracts Docker image names from a Docker Compose file and saves them to a file. This also supports nested Compose files, so using the `include` directive is no problem.
```bash
coco extract docker-compose.yml images.txt
```
### Pull Images
The `pull-images` command pulls Docker images concurrently and displays a live status overview. The images to pull are read from a file, which can be generated using the `extract-images` command.
```bash
coco pull-images images.txt
```
## Contributing
Contributions are welcome! Please feel free to open issues or pull requests if you have suggestions or improvements.