Metadata-Version: 2.4
Name: docker-kit
Version: 0.2.0
Summary: A toolkit for common Docker tasks
Project-URL: Homepage, https://github.com/andre-c-andersen/docker-kit
Project-URL: Repository, https://github.com/andre-c-andersen/docker-kit
Project-URL: Issues, https://github.com/andre-c-andersen/docker-kit/issues
Author: Andre C. Andersen
License: MIT
License-File: LICENSE
Keywords: cli,containers,docker,toolkit
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.12
Requires-Dist: typer>=0.9.0
Description-Content-Type: text/markdown

# docker-kit

A toolkit for common Docker tasks.

## Installation

```bash
uvx docker-kit --help
```

Or install globally:

```bash
uv tool install docker-kit
```

## Commands

### remove-orphans

Remove stopped containers with hex suffixes (orphaned compose containers).

```bash
# Dry run (default) - shows what would be deleted
uvx docker-kit remove-orphans

# Actually delete the containers
uvx docker-kit remove-orphans --apply
uvx docker-kit remove-orphans -a

# Also remove anonymous volumes
uvx docker-kit remove-orphans --apply --volumes
uvx docker-kit remove-orphans -av

# Custom hex suffix lengths (default: 12)
uvx docker-kit remove-orphans --hex-lens 12,64
```

### nuke-kids

Shorthand for `remove-orphans --apply --volumes`.

```bash
uvx docker-kit nuke-kids
```

## Development

```bash
# Install dependencies
uv sync

# Run linting
uv run ruff format .
uv run ruff check .

# Run type checking
uv run pyright

# Run tests
uv run pytest -v
```

## License

MIT
