docker-opt 0.1.0

Python-first Dockerfile optimizer CLI

docker-opt

Python-first Dockerfile optimization advisor for DevOps teams. It analyzes a Dockerfile, flags risks and bloat, outputs JSON for CI, generates an optimized Python template, and suggests a .dockerignore.

Install

pip install docker-opt

Windows exe build

.\build.ps1
dist\docker-opt.exe --help

Usage

# Analyze
python -m docker_opt analyze -f Dockerfile

# JSON output
python -m docker_opt analyze -f Dockerfile --json

# CI: fail on MEDIUM and HIGH findings
python -m docker_opt analyze -f Dockerfile --ci --fail-on MEDIUM

# Generate an optimized template
python -m docker_opt fix -f Dockerfile --stdout

# Suggest .dockerignore
python -m docker_opt dockerignore --type python

Scoring

Each finding includes severity and an impactBand to help triage (e.g., SECURITY, SIZE, CACHE, REPRODUCIBILITY).

Roadmap

PR comment bot integration for CI feedback.

Build & Publish to PyPI

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e ".[dev]"
pytest
python -m build
python -m twine check dist\*

Publish (TestPyPI by default):

setx TWINE_USERNAME "__token__"
setx TWINE_PASSWORD "pypi-***"
.\publish.ps1

Publish to PyPI:

.\publish.ps1 -Target prod