pyforge-deploy 0.1.7__tar.gz

pyforge_deploy-0.1.7/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2026 Ertan Tunç Türk
+
+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.

pyforge_deploy-0.1.7/MANIFEST.in

@@ -0,0 +1,21 @@
+# Include documentation files in source distribution
+include LICENSE
+include README.md
+include pyproject.toml
+include requirements-dev.txt
+
+# Include scripts
+include scripts/setup.py
+
+
+# Include Jinja2 templates
+include src/pyforge_deploy/templates/*
+
+# Include type stubs marker
+include src/pyforge_deploy/py.typed
+
+# Exclude development/test artifacts
+prune .github
+global-exclude __pycache__
+global-exclude *.py[cod]
+global-exclude *.egg-info

pyforge_deploy-0.1.7/PKG-INFO

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: pyforge-deploy
+Version: 0.1.7
+Summary: Lightweight automation tool designed to streamline the transition from development to distribution.
+Author-email: Ertan Tunç Türk <ertantuncturk61@gmail.com>
+Maintainer-email: Ertan Tunç Türk <ertantuncturk61@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ertanturk/pyforge-deploy
+Project-URL: Repository, https://github.com/ertanturk/pyforge-deploy
+Project-URL: Documentation, https://github.com/ertanturk/pyforge-deploy#readme
+Project-URL: Issues, https://github.com/ertanturk/pyforge-deploy/issues
+Keywords: python,docker,pypi,cli,devops,automation,workflow,packaging
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: toml
+Requires-Dist: jinja2
+Requires-Dist: packaging
+Requires-Dist: python-dotenv
+Requires-Dist: build
+Requires-Dist: twine
+Provides-Extra: dev
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: bandit; extra == "dev"
+Requires-Dist: pip-audit; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: coverage; extra == "dev"
+Requires-Dist: types-toml; extra == "dev"
+Dynamic: license-file
+
+# pyforge-deploy
+
+> **Note:** This is a personal/educational project. It is not intended to compete with established
+> tools
+
+[![PyPI version](https://img.shields.io/pypi/v/pyforge-deploy.svg)](https://pypi.org/project/pyforge-deploy/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+
+> **pyforge-deploy** is a lightweight automation CLI for Python projects, streamlining the transition from development to distribution. It automates Docker image creation, version management, and PyPI publishing with a simple, intelligent interface.
+
+---
+
+## Features
+
+* **Docker Integration:** Generates a project-specific Dockerfile from a Jinja2 template and detects the required Python version and dependencies.
+* **Version Management:** Increments the project version (patch, minor, major) and verifies the new version is greater than the latest release on PyPI.
+* **PyPI Deployment:** Builds source and wheel distributions and uploads them to PyPI or TestPyPI using token authentication.
+* **Dependency Detection:** Scans for dependencies using pyproject.toml, requirements.txt, or import analysis.
+* **CLI Commands:** Provides commands for building, deploying, and inspecting the project.
+
+---
+
+## Installation
+
+Available on PyPI: https://pypi.org/project/pyforge-deploy/.
+
+```bash
+pip install pyforge-deploy
+```
+
+> **Note:** Docker must be installed and running for Docker-related features.
+
+---
+
+## Usage
+
+Get a list of all available commands and options:
+
+```bash
+pyforge-deploy --help
+```
+
+### Common Commands
+
+- **Build a Docker Image:**
+
+  ```bash
+  pyforge-deploy docker-build --entry-point src/pyforge_deploy/cli.py --image-tag my-app:1.0.0
+  ```
+
+- **Deploy to PyPI (Test):**
+
+  ```bash
+  pyforge-deploy deploy-pypi --test --bump patch
+  ```
+
+- **Deploy a Specific Version:**
+
+  ```bash
+  pyforge-deploy deploy-pypi --version 2.1.0
+  ```
+
+- **Show Detected Dependencies:**
+
+  ```bash
+  pyforge-deploy show-deps
+  ```
+
+- **Show Project Version:**
+
+  ```bash
+  pyforge-deploy show-version
+  ```
+
+---
+
+## Configuration
+
+For PyPI publishing, provide an API token. Create a `.env` file in your project root:
+
+```
+PYPI_TOKEN=pypi-your-token-here
+```
+
+Or export `PYPI_TOKEN` as an environment variable in your shell or CI/CD system.
+
+---
+
+## How It Works
+
+- **Version Engine:** Resolves project version from `pyproject.toml`, `__about__.py`, or `.version_cache`. Fetches latest PyPI version to avoid conflicts, writes final version to `src/<package_name>/__about__.py`.
+- **Docker Builder:** Detects dependencies and Python version, renders `Dockerfile.j2`, and builds the image.
+- **PyPI Distributor:** Cleans build artifacts, runs `python -m build`, uploads distributions with `twine`.
+
+---
+
+## Testing
+
+Run the full test suite with:
+
+```bash
+pytest
+```
+
+Unit tests cover the CLI and builder components, located in the `tests/` directory.
+
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details..

pyforge_deploy-0.1.7/README.md

@@ -0,0 +1,111 @@
+# pyforge-deploy
+
+> **Note:** This is a personal/educational project. It is not intended to compete with established
+> tools
+
+[![PyPI version](https://img.shields.io/pypi/v/pyforge-deploy.svg)](https://pypi.org/project/pyforge-deploy/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+
+> **pyforge-deploy** is a lightweight automation CLI for Python projects, streamlining the transition from development to distribution. It automates Docker image creation, version management, and PyPI publishing with a simple, intelligent interface.
+
+---
+
+## Features
+
+* **Docker Integration:** Generates a project-specific Dockerfile from a Jinja2 template and detects the required Python version and dependencies.
+* **Version Management:** Increments the project version (patch, minor, major) and verifies the new version is greater than the latest release on PyPI.
+* **PyPI Deployment:** Builds source and wheel distributions and uploads them to PyPI or TestPyPI using token authentication.
+* **Dependency Detection:** Scans for dependencies using pyproject.toml, requirements.txt, or import analysis.
+* **CLI Commands:** Provides commands for building, deploying, and inspecting the project.
+
+---
+
+## Installation
+
+Available on PyPI: https://pypi.org/project/pyforge-deploy/.
+
+```bash
+pip install pyforge-deploy
+```
+
+> **Note:** Docker must be installed and running for Docker-related features.
+
+---
+
+## Usage
+
+Get a list of all available commands and options:
+
+```bash
+pyforge-deploy --help
+```
+
+### Common Commands
+
+- **Build a Docker Image:**
+
+  ```bash
+  pyforge-deploy docker-build --entry-point src/pyforge_deploy/cli.py --image-tag my-app:1.0.0
+  ```
+
+- **Deploy to PyPI (Test):**
+
+  ```bash
+  pyforge-deploy deploy-pypi --test --bump patch
+  ```
+
+- **Deploy a Specific Version:**
+
+  ```bash
+  pyforge-deploy deploy-pypi --version 2.1.0
+  ```
+
+- **Show Detected Dependencies:**
+
+  ```bash
+  pyforge-deploy show-deps
+  ```
+
+- **Show Project Version:**
+
+  ```bash
+  pyforge-deploy show-version
+  ```
+
+---
+
+## Configuration
+
+For PyPI publishing, provide an API token. Create a `.env` file in your project root:
+
+```
+PYPI_TOKEN=pypi-your-token-here
+```
+
+Or export `PYPI_TOKEN` as an environment variable in your shell or CI/CD system.
+
+---
+
+## How It Works
+
+- **Version Engine:** Resolves project version from `pyproject.toml`, `__about__.py`, or `.version_cache`. Fetches latest PyPI version to avoid conflicts, writes final version to `src/<package_name>/__about__.py`.
+- **Docker Builder:** Detects dependencies and Python version, renders `Dockerfile.j2`, and builds the image.
+- **PyPI Distributor:** Cleans build artifacts, runs `python -m build`, uploads distributions with `twine`.
+
+---
+
+## Testing
+
+Run the full test suite with:
+
+```bash
+pytest
+```
+
+Unit tests cover the CLI and builder components, located in the `tests/` directory.
+
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details..

pyforge_deploy-0.1.7/pyproject.toml

@@ -0,0 +1,107 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pyforge-deploy"
+dynamic = ["version"]
+description = "Lightweight automation tool designed to streamline the transition from development to distribution."
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+dependencies = [
+    "toml",
+    "jinja2",
+    "packaging",
+    "python-dotenv",
+    "build",
+    "twine"
+]
+keywords = [
+  "python",
+  "docker",
+  "pypi",
+  "cli",
+  "devops",
+  "automation",
+  "workflow",
+  "packaging",
+]
+
+authors = [
+    { name = "Ertan Tunç Türk", email = "ertantuncturk61@gmail.com" },
+]
+
+maintainers = [
+    { name = "Ertan Tunç Türk", email = "ertantuncturk61@gmail.com" },
+]
+
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Education",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Typing :: Typed",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Testing",
+    "Topic :: Software Development :: Build Tools",
+]
+
+[tool.setuptools.dynamic]
+version = {attr = "pyforge_deploy.__about__.__version__"}
+
+[project.optional-dependencies]
+dev = [
+    "ruff",
+    "mypy",
+    "pytest",
+    "pytest-cov",
+    "bandit",
+    "pip-audit",
+    "pre-commit",
+    "coverage",
+    "types-toml"
+]
+
+[project.urls]
+Homepage = "https://github.com/ertanturk/pyforge-deploy"
+Repository = "https://github.com/ertanturk/pyforge-deploy"
+Documentation = "https://github.com/ertanturk/pyforge-deploy#readme"
+Issues = "https://github.com/ertanturk/pyforge-deploy/issues"
+
+[project.scripts]
+pyforge-deploy = "pyforge_deploy.cli:main"
+
+[tool.ruff]
+line-length = 88
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP"]
+ignore = []
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+ignore_missing_imports = true
+warn_unused_configs = true
+
+[tool.pytest.ini_options]
+addopts = "-v --tb=short"
+testpaths = ["tests"]
+minversion = "7.0"
+
+[tool.coverage.run]
+branch = true
+source = ["."]
+omit = ["tests/*", ".venv/*"]
+
+[tool.coverage.report]
+show_missing = true
+fail_under = 70
+
+[tool.bandit]
+exclude_dirs = ["tests", ".venv"]
+skips = ["B101"]

pyforge_deploy-0.1.7/requirements-dev.txt

@@ -0,0 +1,15 @@
+toml
+jinja2
+packaging
+python-dotenv
+build
+twine
+ruff
+mypy
+pytest
+pytest-cov
+bandit
+pip-audit
+pre-commit
+coverage
+types-toml

pyforge_deploy-0.1.7/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pyforge_deploy-0.1.7/src/pyforge_deploy/__about__.py

@@ -0,0 +1 @@
+__version__ = "0.1.7"

pyforge_deploy-0.1.7/src/pyforge_deploy/builders/docker.py

@@ -0,0 +1,170 @@
+# nosec B404: subprocess usage is safe, no shell=True, command is a list
+import subprocess  # nosec
+import sys as _sys
+from pathlib import Path
+from typing import Any
+
+from jinja2 import Environment, FileSystemLoader, select_autoescape
+
+from pyforge_deploy.colors import color_text, is_ci_environment
+
+from .docker_engine import detect_dependencies, get_python_version
+
+_sys.modules.setdefault("src.pyforge_deploy.builders.docker", _sys.modules[__name__])
+
+
+class DockerBuilder:
+    """Main class responsible for rendering the Dockerfile template
+    and building the Docker image.
+    """
+
+    def __init__(
+        self,
+        entry_point: str | None = None,
+        image_tag: str | None = None,
+        verbose: bool = False,
+    ) -> None:
+        self.base_dir: Path = Path.cwd()
+        self.verbose: bool = verbose
+        if (
+            entry_point is not None
+            and not entry_point.replace("_", "").replace("-", "").isalnum()
+        ):
+            raise ValueError(
+                color_text(
+                    "Error: entry_point must be alphanumeric, underscore, or hyphen.",
+                    "red",
+                )
+            )
+        self.entry_point: str | None = entry_point
+        # Validate image_tag for Docker safety
+        valid_chars = "-./_:"
+        sanitized_tag = image_tag if image_tag else ""
+        for char in valid_chars:
+            sanitized_tag = sanitized_tag.replace(char, "")
+
+        if image_tag is not None and not sanitized_tag.isalnum():
+            raise ValueError(
+                color_text(
+                    "Error: image_tag must be alphanumeric or contain safe characters (- . / _ :).",  # noqa: E501
+                    "red",
+                )
+            )
+        self.image_tag: str = image_tag or self.base_dir.name.lower().replace(" ", "-")
+        self.dockerfile_path: Path = self.base_dir / "Dockerfile"
+        self.req_docker_path: Path = self.base_dir / "requirements-docker.txt"
+
+    def _generate_docker_requirements(self, final_list: list[str]) -> None:
+        """Writes the detected dependencies to requirements-docker.txt."""
+        try:
+            with open(self.req_docker_path, "w", encoding="utf-8") as f:
+                f.write("# Auto-generated by pyforge-deploy AST/Venv scan\n")
+                if final_list:
+                    for pkg in final_list:
+                        f.write(f"{pkg}\n")
+
+            if self.verbose or is_ci_environment():
+                print(color_text("\n--- Detected Docker Requirements ---", "blue"))
+                if final_list:
+                    for pkg in final_list:
+                        print(f" -> {pkg}")
+                else:
+                    print(" (No external dependencies needed!)")
+                print(color_text("------------------------------------\n", "blue"))
+
+        except Exception as err:
+            raise RuntimeError(
+                color_text(
+                    f"Error: Failed to write requirements-docker.txt: {err}", "red"
+                )
+            ) from err
+
+    def render_template(self) -> None:
+        """Renders the Dockerfile template based on detected dependencies."""
+        python_version: str = get_python_version()
+
+        try:
+            report: dict[str, Any] = detect_dependencies(str(self.base_dir))
+            self._generate_docker_requirements(report.get("final_list", []))
+        except Exception:
+            report = {
+                "has_pyproject": False,
+                "requirement_files": [],
+                "final_list": [],
+                "detected_imports": [],
+                "dev_tools": [],
+            }
+            self._generate_docker_requirements([])
+
+        current_module_dir: Path = Path(__file__).parent
+        templates_dir: Path = current_module_dir.parent / "templates"
+
+        if not templates_dir.exists():
+            raise FileNotFoundError(
+                color_text(
+                    f"Error: Templates directory not found at {templates_dir}", "red"
+                )
+            )
+
+        env: Environment = Environment(
+            loader=FileSystemLoader(str(templates_dir)),
+            autoescape=select_autoescape(["j2", "html", "xml"]),
+        )
+
+        try:
+            template = env.get_template("Dockerfile.j2")
+            rendered_content: str = template.render(
+                python_version=python_version,
+                report=report,
+                entry_point=self.entry_point,
+            )
+        except Exception as err:
+            raise RuntimeError(
+                color_text(f"Error: Failed to render Dockerfile template: {err}", "red")
+            ) from err
+
+        try:
+            with open(self.dockerfile_path, "w", encoding="utf-8") as f:
+                f.write(rendered_content)
+        except Exception as err:
+            raise RuntimeError(
+                color_text(f"Error: Failed to write Dockerfile: {err}", "red")
+            ) from err
+
+    def build_image(self) -> None:
+        """Builds the Docker image using the rendered Dockerfile."""
+        print(
+            color_text(f"Building Docker image with tag: '{self.image_tag}'...", "blue")
+        )
+
+        cmd: list[str] = ["docker", "build", "-t", self.image_tag, "."]  # nosec B603: no user input, safe
+
+        try:
+            subprocess.run(cmd, check=True, cwd=str(self.base_dir))  # nosec B603
+            print(
+                color_text(
+                    f"Docker image '{self.image_tag}' built successfully!", "green"
+                )
+            )
+
+            if self.req_docker_path.exists():
+                self.req_docker_path.unlink()
+
+        except subprocess.CalledProcessError as err:
+            print(color_text(f"Error: Docker build failed: {err}", "red"))
+            raise RuntimeError(
+                color_text("Docker build process failed. Check the logs above.", "red")
+            ) from err
+        except FileNotFoundError as err:
+            print(color_text(f"Error: Docker executable not found: {err}", "red"))
+            raise RuntimeError(
+                color_text(
+                    "Docker executable not found. Please ensure Docker is installed and available in your PATH.",  # noqa: E501
+                    "red",
+                )
+            ) from err
+
+    def deploy(self) -> None:
+        """Main method to render Dockerfile and build the image."""
+        self.render_template()
+        self.build_image()