apexcodexpy 0.3.2__tar.gz → 0.4.1__tar.gz

{apexcodexpy-0.3.2 → apexcodexpy-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: apexcodexpy
-Version: 0.3.2
+Version: 0.4.1
 Summary: The Non-Destructive Configuration Steward for Python Projects.
 License-File: LICENSE
 Author: Apex Dev

{apexcodexpy-0.3.2 → apexcodexpy-0.4.1}/codex/infra/pyproject.py

@@ -68,8 +68,6 @@ STANDARDS = {
 
 @dataclass(frozen=True)
 class PyProjectToml:
-    dry_run: bool = False
-
     _result: ProgramResult = field(init=False, default=ProgramResult(name="PyProject"))
 
     NAME = "pyproject.toml"
@@ -82,17 +80,12 @@ class PyProjectToml:
             return self._result.fail(message=f"{self.NAME} not found.")
 
         document = tomlkit.parse(pyproject.read_text(encoding="utf-8"))
-
-        # Create a copy for comparison if dry-run
         original = tomlkit.dumps(document)
         deep_merge(STANDARDS, document)
         modified = tomlkit.dumps(document)
 
         if original == modified:
-            return self._result.success(message=f"{self.NAME} is already up to date.\n")
-
-        if self.dry_run:
-            return self._result.success(message=f"Changes to apply:\n{modified}")
+            return self._result.success(message="Already up to date.\n")
 
         pyproject.write_text(modified, encoding="utf-8", newline="\n")
 

{apexcodexpy-0.3.2 → apexcodexpy-0.4.1}/codex/infra/service.py

@@ -4,16 +4,11 @@ from dataclasses import dataclass
 from pathlib import Path
 from time import time
 
-from codex.infra.dependabot import DependabotYaml
-from codex.infra.program import (
-    Command,
-    Executable,
-    MultiProgram,
-    Program,
-)
+from codex.infra.program import Command, Executable, MultiProgram, Program
 from codex.infra.pyproject import PyProjectToml
 from codex.infra.result import TaskResult
 from codex.infra.tools import MyPy, Pip, Poetry, PoetryRun, Pytest, Ruff
+from codex.infra.workflows import CheckCodeWorkflow, DependabotWorkflow
 
 
 @dataclass(frozen=True)
@@ -30,8 +25,8 @@ class Codex:
 
         return self
 
-    def sync(self, dry_run: bool = False) -> TaskResult:
-        return self.tools.sync(dry_run=dry_run).execute()
+    def sync(self) -> TaskResult:
+        return self.tools.sync().execute()
 
     def lock(self) -> TaskResult:
         return self.tools.lock().execute()
@@ -102,11 +97,12 @@ class CiCodex:
 class CodexTools:
     target: Path
 
-    def sync(self, dry_run: bool = False) -> Executable:
+    def sync(self) -> Executable:
         return (
             MultiProgram()
-            .attach(PyProjectToml(dry_run=dry_run).sync(self.target))
-            .attach(DependabotYaml(dry_run=dry_run).sync(self.target))
+            .attach(PyProjectToml().sync(self.target))
+            .attach(DependabotWorkflow().sync(self.target))
+            .attach(CheckCodeWorkflow().sync(self.target))
         )
 
     def lock(self) -> Executable:

{apexcodexpy-0.3.2 → apexcodexpy-0.4.1}/codex/infra/typer/root.py

@@ -19,15 +19,10 @@ def _(
         "-p",
         help="Target directory.",
     ),
-    dry_run: bool = typer.Option(
-        False,
-        "--dry-run",
-        help="Show changes without applying them.",
-    ),
 ) -> None:
     (
         Codex.target(Path(path))
-        .sync(dry_run=dry_run)
+        .sync()
         .report(using=DefaultReporter())
         .exit(using=typer.Exit)
     )

apexcodexpy-0.4.1/codex/infra/workflows.py

@@ -0,0 +1,175 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from collections.abc import Mapping
+from dataclasses import dataclass
+from datetime import UTC, datetime
+from functools import cached_property
+from pathlib import Path
+from typing import Any
+
+import yaml
+from yaml import MappingNode
+
+from codex.infra.program import Executable
+from codex.infra.result import ProgramResult
+
+
+@dataclass(frozen=True, kw_only=True)
+class YamlWorkflow(ABC):
+    name: str
+    path: Path
+
+    @property
+    @abstractmethod
+    def standards(self) -> Mapping[Any, Any]:
+        pass
+
+    def sync(self, target: Path) -> Executable:
+        path = target / self.path
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_text(
+            "# Auto Generated\n"
+            "# By: Apex Codex\n"
+            f"# At: {self._utcnow()}\n"
+            "# Do not edit this file manually!\n\n"
+            + yaml.dump(
+                self.standards,
+                Dumper=CustomDumper,
+                sort_keys=False,
+                default_flow_style=False,
+            ).replace("'on':", "on:"),
+            encoding="utf-8",
+            newline="\n",
+        )
+
+        return self.success()
+
+    def _utcnow(self) -> str:
+        return datetime.now(tz=UTC).replace(microsecond=0).isoformat(sep=" ")
+
+    def success(self) -> ProgramResult:
+        return ProgramResult(name=self.name).success(
+            message=f"{self.name} workflow succeeded.\n"
+        )
+
+
+class CustomDumper(yaml.Dumper):
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
+        self.custom_anchors = iter(["checkout", "setup-python"])
+        super().__init__(*args, **kwargs)
+
+    def increase_indent(self, flow: bool = False, indentless: bool = False) -> None:
+        _ = indentless
+
+        return super().increase_indent(flow, False)
+
+    def generate_anchor(self, node: MappingNode) -> str:
+        """Override PyYAML's default 'id001' generation logic."""
+        try:
+            return next(self.custom_anchors)
+        except StopIteration:
+            return super().generate_anchor(node)  # type: ignore
+
+
+@dataclass(frozen=True, kw_only=True)
+class CheckCodeWorkflow(YamlWorkflow):
+    name: str = "CheckCode"
+    path: Path = Path(".github") / "workflows" / "check_code.yml"
+
+    python_version: float | int = 3.13
+    checkout_version: str = "v6"
+    setup_python_version: str = "v6"
+
+    @property
+    def standards(self) -> Mapping[str, Any]:
+        return {
+            "name": "Validate Python Code",
+            "on": {"pull_request": {"branches": ["main"]}},
+            "permissions": {"contents": "read"},
+            "jobs": self._jobs(
+                lint="codex lint --ci",
+                test_unit="codex test unit --ci",
+                test_integration="codex test integration --ci",
+                test_behaviour="codex test behaviour --ci",
+            ),
+        }
+
+    def _jobs(self, **commands: str) -> dict[str, Any]:
+        return {
+            name.replace("_", "-"): {
+                "runs-on": "ubuntu-latest",
+                "steps": [
+                    self._checkout,
+                    self._setup,
+                    {
+                        "name": name.capitalize().replace("_", " "),
+                        "run": value,
+                    },
+                ],
+            }
+            for name, value in commands.items()
+        }
+
+    @cached_property
+    def _checkout(self) -> dict[str, str]:
+        return {"uses": f"actions/checkout@{self.checkout_version}"}
+
+    @cached_property
+    def _setup(self) -> dict[str, Any]:
+        return {
+            "name": "Set up Python",
+            "uses": "actions/setup-python@v6",
+            "with": {
+                "python-version": self.python_version,
+                "pip-install": "apexcodexpy",
+            },
+        }
+
+
+@dataclass(frozen=True, kw_only=True)
+class DependabotWorkflow(YamlWorkflow):
+    name: str = "Dependabot"
+    path: Path = Path(".github") / "dependabot.yml"
+
+    @property
+    def standards(self) -> Mapping[str, Any]:
+        return {
+            "version": 2,
+            "updates": [
+                self._pip_config(),
+                self._gh_actions_config(),
+            ],
+        }
+
+    @staticmethod
+    def _pip_config() -> dict[str, Any]:
+        return {
+            "package-ecosystem": "pip",
+            "directory": "/",
+            "schedule": {
+                "interval": "weekly",
+                "day": "thursday",
+            },
+            "groups": {
+                "python": {
+                    "patterns": ["*"],
+                }
+            },
+        }
+
+    @staticmethod
+    def _gh_actions_config() -> dict[str, Any]:
+        return {
+            "package-ecosystem": "github-actions",
+            "directory": "/",
+            "schedule": {
+                "interval": "weekly",
+                "day": "thursday",
+            },
+            "groups": {
+                "gh-actions": {
+                    "patterns": ["*"],
+                }
+            },
+        }

{apexcodexpy-0.3.2 → apexcodexpy-0.4.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "apexcodexpy"
-version = "0.3.2"
+version = "0.4.1"
 description = "The Non-Destructive Configuration Steward for Python Projects."
 readme = "README.md"
 authors = [

apexcodexpy-0.3.2/codex/infra/dependabot.py

@@ -1,95 +0,0 @@
-from __future__ import annotations
-
-import json
-from dataclasses import dataclass, field
-from pathlib import Path
-from typing import Any
-
-import yaml
-
-from codex.infra.program import Executable
-from codex.infra.result import ProgramResult
-
-
-def _pip_config() -> dict[str, Any]:
-    return {
-        "package-ecosystem": "pip",
-        "directory": "/",
-        "schedule": {
-            "interval": "weekly",
-            "day": "thursday",
-        },
-        "groups": {
-            "python": {
-                "patterns": ["*"],
-            }
-        },
-    }
-
-
-def _gh_actions_config() -> dict[str, Any]:
-    return {
-        "package-ecosystem": "github-actions",
-        "directory": "/",
-        "schedule": {
-            "interval": "weekly",
-            "day": "thursday",
-        },
-        "groups": {
-            "gh-actions": {
-                "patterns": ["*"],
-            }
-        },
-    }
-
-
-STANDARDS = {
-    "version": 2,
-    "updates": [
-        _pip_config(),
-        _gh_actions_config(),
-    ],
-}
-
-
-@dataclass(frozen=True)
-class DependabotYaml:
-    dry_run: bool = False
-
-    _result: ProgramResult = field(init=False, default=ProgramResult(name="DependaBot"))
-
-    NAME = "dependabot.yml"
-
-    def sync(self, target: Path) -> Executable:
-        dependabot = self.yaml_on(target)
-        dependabot.parent.mkdir(parents=True, exist_ok=True)
-
-        return self._sync(dependabot)
-
-    def _sync(self, dependabot: Path) -> Executable:
-        if self.dry_run:
-            dumped = json.dumps(STANDARDS, indent=2)
-            return self._result.success(message=f"Changes to apply:\n{dumped}")
-
-        with dependabot.open(mode="w", encoding="utf-8", newline="\n") as stream:
-            yaml.dump(
-                STANDARDS,
-                stream,
-                Dumper=IndentDumper,
-                sort_keys=False,
-                default_flow_style=False,
-            )
-
-        return self._result.success(message=f"{self.NAME} synchronized successfully.\n")
-
-    def yaml_on(self, path: Path) -> Path:
-        return path / ".github" / self.NAME
-
-
-class IndentDumper(yaml.Dumper):
-    """Custom dumper to force indentation for list items."""
-
-    def increase_indent(self, flow: bool = False, indentless: bool = False) -> None:
-        _ = indentless
-
-        return super().increase_indent(flow, False)