docker-opt 0.2.0

Python-first Dockerfile optimizer CLI

docker-opt

Python-first Dockerfile optimizer CLI. It analyzes Dockerfiles, flags size/security/caching issues, outputs JSON for CI, generates a safe optimized Python template, and creates a .dockerignore.

Install

pip install docker-opt

Usage

# Analyze
docker-opt analyze -f Dockerfile

# JSON output
docker-opt analyze -f Dockerfile --json

# CI: minimal output + fail on MEDIUM and HIGH
docker-opt analyze -f Dockerfile --ci --fail-on MEDIUM

# Generate optimized template
docker-opt fix -f Dockerfile --stdout

# Write optimized template to file
docker-opt fix -f Dockerfile -o Dockerfile.optimized

# Generate .dockerignore
docker-opt dockerignore --type python
docker-opt dockerignore --type python --out .dockerignore

CI Exit Codes

• Exit code is non-zero if any finding severity is >= --fail-on.
• In --ci mode, output is reduced to a single summary line (unless --json).

Build and Publish

Local build (sdist/wheel + exe)

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

Publish to PyPI

.\scripts\publish.ps1           # TestPyPI
.\scripts\publish.ps1 -Target prod

Release Workflow (GitHub Actions)

• Tag a release: vX.Y.Z
• CI runs tests on Windows and Ubuntu.
• Release workflow builds sdist/wheel, Windows exe, creates a GitHub Release, and uploads artifacts.
• PyPI publishing uses trusted publishing if configured; otherwise use TWINE secrets.

Samples

• samples/python-fastapi/ includes a minimal FastAPI app with Dockerfile and .dockerignore.

Notes

Each finding includes severity and an impact band (SECURITY, SIZE, CACHE, REPRODUCIBILITY, PERFORMANCE, MAINTAINABILITY, FUNCTIONAL, OBSERVABILITY, RELIABILITY).

Support / Donate

This project is free and open; donations help maintenance.

If docker-opt helps you, consider supporting its development:

https://buymeacoffee.com/sathsara2000

Donation URL override

You can override the donation URL with an environment variable:

$env:DOCKER_OPT_DONATION_URL = "https://example.com/your-donation-link"
docker-opt donate

Stripe Payment Link (one-time)

If you want to use Stripe for one-time donations:

1. Sign in to Stripe and open the Dashboard.
2. Go to Payments > Payment Links.
3. Click New, choose One-time, and set the amount and description.
4. Create the link and copy its URL.
5. Set it as DOCKER_OPT_DONATION_URL or replace the link above.