wexample-wex-addon-dev-python 0.1.0__tar.gz → 0.2.0__tar.gz

{wexample_wex_addon_dev_python-0.1.0 → wexample_wex_addon_dev_python-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-wex-addon-dev-python
-Version: 0.1.0
+Version: 0.2.0
 Summary: Python dev addon for wex
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -16,7 +16,7 @@ Requires-Dist: networkx
 Requires-Dist: pylint
 Requires-Dist: pyright
 Requires-Dist: wexample-filestate-python>=0.1.0
-Requires-Dist: wexample-wex-addon-app>=1.0.0
+Requires-Dist: wexample-wex-addon-app>=1.2.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -24,7 +24,7 @@ Description-Content-Type: text/markdown
 
 # wex_addon_dev_python
 
-Version: 0.1.0
+Version: 0.2.0
 
 Python dev addon for wex
 
@@ -110,7 +110,7 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 - pylint: 
 - pyright: 
 - wexample-filestate-python: >=0.1.0
-- wexample-wex-addon-app: >=1.0.0
+- wexample-wex-addon-app: >=1.2.0
 
 ## Versioning & Compatibility Policy
 

{wexample_wex_addon_dev_python-0.1.0 → wexample_wex_addon_dev_python-0.2.0}/README.md

@@ -1,6 +1,6 @@
 # wex_addon_dev_python
 
-Version: 0.1.0
+Version: 0.2.0
 
 Python dev addon for wex
 
@@ -86,7 +86,7 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 - pylint: 
 - pyright: 
 - wexample-filestate-python: >=0.1.0
-- wexample-wex-addon-app: >=1.0.0
+- wexample-wex-addon-app: >=1.2.0
 
 ## Versioning & Compatibility Policy
 

{wexample_wex_addon_dev_python-0.1.0 → wexample_wex_addon_dev_python-0.2.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-wex-addon-dev-python"
-version = "0.1.0"
+version = "0.2.0"
 description = "Python dev addon for wex"
 authors = [
     { name = "weeger", email = "contact@wexample.com" },
@@ -25,7 +25,7 @@ dependencies = [
     "pylint",
     "pyright",
     "wexample-filestate-python>=0.1.0",
-    "wexample-wex-addon-app>=1.0.0",
+    "wexample-wex-addon-app>=1.2.0",
 ]
 
 [project.readme]

wexample_wex_addon_dev_python-0.2.0/src/wexample_wex_addon_dev_python/resources/docker/Dockerfile.python-profiling

@@ -0,0 +1,11 @@
+FROM python:3.12-slim
+
+RUN pip install --no-cache-dir pytest pytest-benchmark
+
+# The container runs as the host user (arbitrary UID/GID via docker run --user).
+# Set HOME to /tmp so pip and other tools have a writable directory.
+ENV HOME=/tmp
+
+WORKDIR /app
+
+CMD ["tail", "-f", "/dev/null"]

wexample_wex_addon_dev_python-0.2.0/src/wexample_wex_addon_dev_python/workdir/mixin/with_profiling_python_workdir_mixin.py

@@ -0,0 +1,93 @@
+from __future__ import annotations
+
+from wexample_wex_addon_app.workdir.mixin.abstract_profiling_workdir_mixin import (
+    AbstractProfilingWorkdirMixin,
+)
+
+
+class WithProfilingPythonWorkdirMixin(AbstractProfilingWorkdirMixin):
+    """Mixin that adds pytest-benchmark profiling capability to a Python workdir.
+
+    Runs benchmarks in the workdir's local venv so that local (unpublished)
+    dependencies are available — no Docker required.
+
+    Requires the workdir to have benchmark tests written with pytest-benchmark:
+        def test_my_function(benchmark):
+            benchmark(my_function, ...)
+    """
+
+    _BENCH_OUTPUT_FILENAME = ".wex_bench.json"
+
+    def run_profiling(self) -> dict:
+        import json
+        import subprocess
+
+        bench_output_path = self.get_path() / self._BENCH_OUTPUT_FILENAME
+        python = self._get_profiling_python()
+
+        bench_result = subprocess.run(
+            [
+                str(python),
+                "-m",
+                "pytest",
+                self.get_benchmark_dir(),
+                "--benchmark-only",
+                f"--benchmark-json={bench_output_path}",
+                "-q",
+            ],
+            capture_output=True,
+            text=True,
+            cwd=str(self.get_path()),
+        )
+
+        if not bench_output_path.exists():
+            return {
+                "error": (
+                    "No benchmark output produced.\n"
+                    f"pytest stdout:\n{bench_result.stdout}\n"
+                    f"pytest stderr:\n{bench_result.stderr}"
+                )
+            }
+
+        try:
+            content = bench_output_path.read_text().strip()
+            if not content:
+                return {
+                    "error": (
+                        "No benchmark tests found. Add tests using pytest-benchmark:\n"
+                        "  def test_my_function(benchmark):\n"
+                        "      benchmark(my_function, ...)"
+                    )
+                }
+            raw = json.loads(content)
+        finally:
+            bench_output_path.unlink(missing_ok=True)
+
+        return self._parse_profiling_output(raw)
+
+    def _get_profiling_python(self) -> Path:
+        import sys
+        from pathlib import Path
+
+        return Path(sys.executable)
+
+    def _parse_profiling_output(self, raw: dict) -> dict:
+        entries = []
+        for bench in raw.get("benchmarks", []):
+            stats = bench.get("stats", {})
+            entries.append(
+                {
+                    "name": bench.get("name"),
+                    "min_ms": round(stats.get("min", 0) * 1000, 3),
+                    "mean_ms": round(stats.get("mean", 0) * 1000, 3),
+                    "median_ms": round(stats.get("median", 0) * 1000, 3),
+                    "max_ms": round(stats.get("max", 0) * 1000, 3),
+                    "rounds": stats.get("rounds", 0),
+                }
+            )
+
+        return {
+            "language": "python",
+            "tool": "pytest-benchmark",
+            "entries": entries,
+        }

{wexample_wex_addon_dev_python-0.1.0 → wexample_wex_addon_dev_python-0.2.0}/src/wexample_wex_addon_dev_python/workdir/python_workdir.py

@@ -25,6 +25,9 @@ from wexample_wex_addon_dev_python.const.python import (
     PYTHON_PYTEST_COV_REPORT_DIR,
 )
 from wexample_wex_addon_dev_python.file.python_app_iml_file import PythonAppImlFile
+from wexample_wex_addon_dev_python.workdir.mixin.with_profiling_python_workdir_mixin import (
+    WithProfilingPythonWorkdirMixin,
+)
 
 if TYPE_CHECKING:
     from wexample_config.const.types import DictConfig
@@ -44,7 +47,7 @@ if TYPE_CHECKING:
     )
 
 
-class PythonWorkdir(CodeBaseWorkdir):
+class PythonWorkdir(WithProfilingPythonWorkdirMixin, CodeBaseWorkdir):
     def app_install(self, env: str | None = None, force: bool = False) -> Path:
         from wexample_wex_addon_app.helpers.python import (
             python_ensure_pip_or_fail,