Metadata-Version: 2.4
Name: docker-prune-plan
Version: 0.1.3
Summary: Dry-run view of what docker system prune would delete
Author-email: Abdul Wahab <abdulwahabmangat@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/wahabmangat/docker-prune-plan
Project-URL: Repository, https://github.com/wahabmangat/docker-prune-plan
Project-URL: Issues, https://github.com/wahabmangat/docker-prune-plan/issues
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: docker>=7.0.0

# docker-prune-plan

[![PyPI version](https://badge.fury.io/py/docker-prune-plan.svg)](https://badge.fury.io/py/docker-prune-plan)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**See exactly what `docker system prune` is about to wipe before you hit the big red button and regret it.**

Dry-run view of what `docker system prune` would delete (containers, images, build cache, unused networks; volumes when requested with `--volumes`). Implemented as a Python CLI.

## Install

### Option 1: PyPI (Recommended)
The easiest way to install the latest stable version:

```bash
pip install docker-prune-plan
```
### Option 2: Github releases
Install the latest release directly:
```bash
pip install https://github.com/wahabmangat/docker-prune-plan/releases/download/v0.1.3/docker_prune_plan-0.1.3-py3-none-any.whl
```

After installation the command `docker-prune-plan` will be available on your PATH.

## Usage

```bash
# Default: system view (containers, images, build cache, networks)
docker-prune-plan

# See unused images too (even named ones)
docker-prune-plan --all

# Include volumes (matches docker system prune --volumes)
docker-prune-plan --volumes

# Limit to a specific object type
docker-prune-plan --type volume   # or image|container|network|build-cache

# JSON output
docker-prune-plan --json
```

Requires Docker to be installed and the daemon running. Totals use `docker system df`, so shared layers are not double-counted.
