dockseed 0.1.0__tar.gz

dockseed-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dockseed Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dockseed-0.1.0/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: dockseed
+Version: 0.1.0
+Summary: Inspect Python projects and generate deterministic, best-practice Dockerfiles automatically.
+License-Expression: MIT
+License-File: LICENSE
+Keywords: docker,dockerfile,containers,python,devtools,cli
+Author: Dockseed Contributors
+Requires-Python: >=3.10,<3.15
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Typing :: Typed
+Requires-Dist: tomli (>=2.0.0) ; python_version < "3.11"
+Description-Content-Type: text/markdown
+
+# Dockseed
+
+**Dockseed** is a deterministic Python developer tool that inspects an existing Python project and generates a project-specific, best-practice `Dockerfile` and `.dockerignore` automatically.
+
+## Key Features
+
+- **Evidence-Based Detection:** Inspects `pyproject.toml`, `requirements.txt`, `Pipfile`, `.python-version`, `.tool-versions`, and `runtime.txt` to resolve compatible Python versions (`3.10`–`3.14`).
+- **Modern Package Manager Support:** Automatically configures layer-cached dependency installation for `pip`, `uv`, `Poetry`, `PDM`, `Hatch`, and `Pipenv`.
+- **Safe AST Static Analysis:** Discovers application entry points (`FastAPI`, `Flask`, `Django`, `Streamlit`, `Gradio`, `Celery`, CLI scripts, and standalone scripts) using Python's built-in `ast` module—never importing or executing project code.
+- **Native System Dependency Heuristics:** Detects packages requiring C extensions or shared libraries (`psycopg2`, `mysqlclient`, `opencv-python`, `pyaudio`, `git+https`, etc.) and injects clean `apt-get` layers.
+- **Secure & Production-Minded Defaults:** Generates single-stage `python:3.x-slim` images running as an unprivileged `appuser`, using JSON exec-form `CMD` arrays for proper `SIGTERM` signal handling, and excluding `.env` secrets and virtual environments.
+- **CI/CD & Headless Ready:** Deterministic output, explicit CLI override flags, and strict exit codes.
+
+---
+
+## Installation
+
+~~~bash
+pip install dockseed
+~~~
+
+Or run directly with `uvx` or `pipx`:
+
+~~~bash
+uvx dockseed scan
+~~~
+
+---
+
+## CLI Usage
+
+### 1. Analyze a Project (`dockseed scan`)
+
+Inspect a project without modifying any files:
+
+~~~bash
+dockseed scan
+dockseed scan ./my-project
+dockseed scan --format json
+~~~
+
+### 2. Generate Configuration (`dockseed init`)
+
+Generate a `Dockerfile` and `.dockerignore`:
+
+~~~bash
+dockseed init
+dockseed init --dry-run
+dockseed init --yes
+dockseed init --overwrite
+dockseed init --no-comments
+~~~
+
+Bypass ambiguity prompts in CI/CD pipelines using explicit override flags:
+
+~~~bash
+dockseed init --yes \
+  --python 3.12 \
+  --package-manager uv \
+  --entrypoint "app.main:app" \
+  --port 8000
+~~~
+
+### 3. Validate Configuration (`dockseed check`)
+
+Validate an existing `Dockerfile` and `.dockerignore` statically, or perform an opt-in container build check:
+
+~~~bash
+dockseed check
+dockseed check --build
+dockseed check --build --runtime podman
+~~~
+
+---
+
+## Python API
+
+Dockseed's scanning, generation, and validation engine can be used directly from Python:
+
+~~~python
+from pathlib import Path
+from dockseed import (
+    scan_project,
+    generate_dockerfile,
+    generate_dockerignore,
+    validate_dockerfile,
+)
+
+model = scan_project(Path("."))
+dockerfile = generate_dockerfile(model, include_comments=True)
+dockerignore = generate_dockerignore(model)
+
+report = validate_dockerfile(dockerfile.content, model, dockerignore.content)
+if report.is_valid:
+    print(dockerfile.content)
+~~~
+
+---
+
+## Exit Codes
+
+| Exit Code | Constant | Meaning |
+| :--- | :--- | :--- |
+| `0` | `SUCCESS` | Operation succeeded. |
+| `1` | `GENERAL_ERROR` | Unexpected runtime or I/O error. |
+| `2` | `VALIDATION_FAILED` | Static/build validation failed, or containerization blocker detected. |
+| `3` | `AMBIGUITY_UNRESOLVED` | Unresolved critical ambiguity in non-interactive (`--yes` or non-TTY) mode. |
+| `4` | `OVERWRITE_BLOCKED` | Target `Dockerfile` already exists and `--overwrite` was not passed. |
+
+---
+
+## License
+
+MIT
+

dockseed-0.1.0/README.md

@@ -0,0 +1,114 @@
+# Dockseed
+
+**Dockseed** is a deterministic Python developer tool that inspects an existing Python project and generates a project-specific, best-practice `Dockerfile` and `.dockerignore` automatically.
+
+## Key Features
+
+- **Evidence-Based Detection:** Inspects `pyproject.toml`, `requirements.txt`, `Pipfile`, `.python-version`, `.tool-versions`, and `runtime.txt` to resolve compatible Python versions (`3.10`–`3.14`).
+- **Modern Package Manager Support:** Automatically configures layer-cached dependency installation for `pip`, `uv`, `Poetry`, `PDM`, `Hatch`, and `Pipenv`.
+- **Safe AST Static Analysis:** Discovers application entry points (`FastAPI`, `Flask`, `Django`, `Streamlit`, `Gradio`, `Celery`, CLI scripts, and standalone scripts) using Python's built-in `ast` module—never importing or executing project code.
+- **Native System Dependency Heuristics:** Detects packages requiring C extensions or shared libraries (`psycopg2`, `mysqlclient`, `opencv-python`, `pyaudio`, `git+https`, etc.) and injects clean `apt-get` layers.
+- **Secure & Production-Minded Defaults:** Generates single-stage `python:3.x-slim` images running as an unprivileged `appuser`, using JSON exec-form `CMD` arrays for proper `SIGTERM` signal handling, and excluding `.env` secrets and virtual environments.
+- **CI/CD & Headless Ready:** Deterministic output, explicit CLI override flags, and strict exit codes.
+
+---
+
+## Installation
+
+~~~bash
+pip install dockseed
+~~~
+
+Or run directly with `uvx` or `pipx`:
+
+~~~bash
+uvx dockseed scan
+~~~
+
+---
+
+## CLI Usage
+
+### 1. Analyze a Project (`dockseed scan`)
+
+Inspect a project without modifying any files:
+
+~~~bash
+dockseed scan
+dockseed scan ./my-project
+dockseed scan --format json
+~~~
+
+### 2. Generate Configuration (`dockseed init`)
+
+Generate a `Dockerfile` and `.dockerignore`:
+
+~~~bash
+dockseed init
+dockseed init --dry-run
+dockseed init --yes
+dockseed init --overwrite
+dockseed init --no-comments
+~~~
+
+Bypass ambiguity prompts in CI/CD pipelines using explicit override flags:
+
+~~~bash
+dockseed init --yes \
+  --python 3.12 \
+  --package-manager uv \
+  --entrypoint "app.main:app" \
+  --port 8000
+~~~
+
+### 3. Validate Configuration (`dockseed check`)
+
+Validate an existing `Dockerfile` and `.dockerignore` statically, or perform an opt-in container build check:
+
+~~~bash
+dockseed check
+dockseed check --build
+dockseed check --build --runtime podman
+~~~
+
+---
+
+## Python API
+
+Dockseed's scanning, generation, and validation engine can be used directly from Python:
+
+~~~python
+from pathlib import Path
+from dockseed import (
+    scan_project,
+    generate_dockerfile,
+    generate_dockerignore,
+    validate_dockerfile,
+)
+
+model = scan_project(Path("."))
+dockerfile = generate_dockerfile(model, include_comments=True)
+dockerignore = generate_dockerignore(model)
+
+report = validate_dockerfile(dockerfile.content, model, dockerignore.content)
+if report.is_valid:
+    print(dockerfile.content)
+~~~
+
+---
+
+## Exit Codes
+
+| Exit Code | Constant | Meaning |
+| :--- | :--- | :--- |
+| `0` | `SUCCESS` | Operation succeeded. |
+| `1` | `GENERAL_ERROR` | Unexpected runtime or I/O error. |
+| `2` | `VALIDATION_FAILED` | Static/build validation failed, or containerization blocker detected. |
+| `3` | `AMBIGUITY_UNRESOLVED` | Unresolved critical ambiguity in non-interactive (`--yes` or non-TTY) mode. |
+| `4` | `OVERWRITE_BLOCKED` | Target `Dockerfile` already exists and `--overwrite` was not passed. |
+
+---
+
+## License
+
+MIT

dockseed-0.1.0/pyproject.toml

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["poetry-core>=1.9.0"]
+build-backend = "poetry.core.masonry.api"
+
+[project]
+name = "dockseed"
+version = "0.1.0"
+description = "Inspect Python projects and generate deterministic, best-practice Dockerfiles automatically."
+readme = "README.md"
+requires-python = ">=3.10,<3.15"
+license = "MIT"
+authors = [
+    { name = "Dockseed Contributors" }
+]
+keywords = ["docker", "dockerfile", "containers", "python", "devtools", "cli"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Build Tools",
+    "Typing :: Typed",
+]
+dependencies = [
+    "tomli (>=2.0.0) ; python_version < '3.11'",
+]
+
+[project.scripts]
+dockseed = "dockseed.cli:main"
+
+[tool.poetry]
+packages = [{ include = "dockseed", from = "src" }]
+include = ["src/dockseed/py.typed"]
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.0.0"
+pytest-cov = "^5.0.0"
+ruff = "^0.6.0"
+mypy = "^1.11.0"
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP", "SIM", "RUF"]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+mypy_path = "src"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = [
+    "integration: marks tests that require an external container runtime (docker/podman/nerdctl)",
+]
+addopts = "-ra -q"

dockseed-0.1.0/src/dockseed/__init__.py

@@ -0,0 +1,47 @@
+"""Dockseed — Automated, deterministic Dockerfile generator for Python projects."""
+
+from dockseed.exceptions import (
+    AmbiguityError,
+    DockseedError,
+    OverwriteBlockedError,
+    ValidationError,
+)
+from dockseed.generators import generate_dockerfile, generate_dockerignore
+from dockseed.inference import format_scan_report, scan_project
+from dockseed.models import (
+    CLIOverrides,
+    ConfidenceLevel,
+    Detection,
+    Evidence,
+    ExitCode,
+    Framework,
+    GenerationResult,
+    PackageManager,
+    ProjectModel,
+)
+from dockseed.validators import ValidationReport, validate_dockerfile
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "__version__",
+    "AmbiguityError",
+    "CLIOverrides",
+    "ConfidenceLevel",
+    "Detection",
+    "DockseedError",
+    "Evidence",
+    "ExitCode",
+    "Framework",
+    "GenerationResult",
+    "OverwriteBlockedError",
+    "PackageManager",
+    "ProjectModel",
+    "ValidationError",
+    "ValidationReport",
+    "format_scan_report",
+    "generate_dockerfile",
+    "generate_dockerignore",
+    "scan_project",
+    "validate_dockerfile",
+]

dockseed-0.1.0/src/dockseed/__main__.py

@@ -0,0 +1,8 @@
+"""Allow running dockseed via `python -m dockseed`."""
+
+import sys
+
+from dockseed.cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())