release: v0.19.3

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.19.3] - 2026-06-26
+
+### Refactor
+
+- Make molecule weights configurable via pyproject.toml
+
 ## [0.19.2] - 2026-06-26
 
 ### Bug Fixes

README.md

@@ -16,12 +16,12 @@ quality badges.
 
 [![CI](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions/workflows/ci.yml/badge.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
 [![License: GPL-3.0](https://img.shields.io/badge/license-GPL--3.0-blue)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/src/branch/master/LICENSE)
-[![Coverage](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/0ab8d43a57cbaf69c93d28df9e2ac5630da4148a/coverage.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Coverage](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/a45dd92c1fdec2a80c5af7d2f47c6325057bb3ca/coverage.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Tests](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/0ab8d43a57cbaf69c93d28df9e2ac5630da4148a/tests.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Tests](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/a45dd92c1fdec2a80c5af7d2f47c6325057bb3ca/tests.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Docs](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/0ab8d43a57cbaf69c93d28df9e2ac5630da4148a/docs.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/wiki)
+[![Docs](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/a45dd92c1fdec2a80c5af7d2f47c6325057bb3ca/docs.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/wiki)
-[![Code Quality](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/0ab8d43a57cbaf69c93d28df9e2ac5630da4148a/quality.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Code Quality](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/a45dd92c1fdec2a80c5af7d2f47c6325057bb3ca/quality.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Version](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/0ab8d43a57cbaf69c93d28df9e2ac5630da4148a/version.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/releases)
+[![Version](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/a45dd92c1fdec2a80c5af7d2f47c6325057bb3ca/version.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/releases)
-[![Python](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/0ab8d43a57cbaf69c93d28df9e2ac5630da4148a/python.svg)](https://www.python.org/downloads/)
+[![Python](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/a45dd92c1fdec2a80c5af7d2f47c6325057bb3ca/python.svg)](https://www.python.org/downloads/)
 
 ## Why devx?
 

docs/index.md

@@ -12,12 +12,12 @@ project to be reusable across all oblachno-oss repositories.
 
 [![CI](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions/workflows/ci.yml/badge.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
 [![License: GPL-3.0](https://img.shields.io/badge/license-GPL--3.0-blue)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/src/branch/master/LICENSE)
-[![Coverage](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/0ab8d43a57cbaf69c93d28df9e2ac5630da4148a/coverage.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Coverage](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/a45dd92c1fdec2a80c5af7d2f47c6325057bb3ca/coverage.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Tests](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/0ab8d43a57cbaf69c93d28df9e2ac5630da4148a/tests.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Tests](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/a45dd92c1fdec2a80c5af7d2f47c6325057bb3ca/tests.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Docs](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/0ab8d43a57cbaf69c93d28df9e2ac5630da4148a/docs.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/wiki)
+[![Docs](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/a45dd92c1fdec2a80c5af7d2f47c6325057bb3ca/docs.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/wiki)
-[![Code Quality](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/0ab8d43a57cbaf69c93d28df9e2ac5630da4148a/quality.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Code Quality](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/a45dd92c1fdec2a80c5af7d2f47c6325057bb3ca/quality.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Version](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/0ab8d43a57cbaf69c93d28df9e2ac5630da4148a/version.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/releases)
+[![Version](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/a45dd92c1fdec2a80c5af7d2f47c6325057bb3ca/version.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/releases)
-[![Python](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/0ab8d43a57cbaf69c93d28df9e2ac5630da4148a/python.svg)](https://www.python.org/downloads/)
+[![Python](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/a45dd92c1fdec2a80c5af7d2f47c6325057bb3ca/python.svg)](https://www.python.org/downloads/)
 
 ## Overview
 

src/devx/__init__.py

@@ -1,3 +1,3 @@
 """devx — reusable development and CI/CD tools for oblachno-oss projects."""
 
-__version__ = "0.19.2"
+__version__ = "0.19.3"

src/devx/molecule/distribute_molecule.py

@@ -19,6 +19,7 @@ Usage:
 
 from __future__ import annotations
 
+import tomllib
 from dataclasses import dataclass
 from pathlib import Path
 
@@ -132,70 +133,75 @@ def build_multi_role_pairs(
     return [MultiRoleTestPair(r, s, p) for r, s in role_scenarios for p in platforms]
 
 
-# Heuristic weights for known heavy molecule scenarios.
+# --- Molecule weight configuration ---
-# These are estimated from CI run times — scenarios that pull large Docker
-# images or run complex Ansible playbooks take longer.
 #
-# Weights are calibrated from actual CI execution times (converge→destroy):
+# Weights are loaded from ``[tool.devx.molecule.weights]`` in
-#   nextcloud:           ~7.7m  → 15
+# ``pyproject.toml``.  Each project (infra, grm, …) contributes its own
-#   restore/default:     ~5.7m  → 11
+# weights calibrated from actual CI execution times.
-#   customer-apps:       ~5.5m  → 11
-#   zitadel/default:     ~5.0m  → 10
-#   docker_base/default: ~3.9m  →  8
-#   app_hardening/default: ~1.9m → 4
-#   app_container/default: ~1.8m → 3
-#   postgres-upgrade:    ~1.7m  →  3
-#   observability/default: ~1.7m → 3
-#   storage/default:     ~1.5m  →  3
-#   storage/object-storage: ~1.0m → 2
-#   vaultwarden:         ~0.7m  →  2
-#   simple-app:          ~0.7m  →  2
 #
-# Role-specific weights take priority over scenario-name weights.
+# Two key formats are supported:
-# The (role, scenario) tuple is checked first, then the scenario name
+#   - ``"scenario" = weight`` — applies to any role with that scenario name
-# alone, then the default weight.
+#   - ``"role/scenario" = weight`` — role-specific (takes priority)
-_ROLE_SCENARIO_WEIGHTS: dict[tuple[str, str], int] = {
+#
-    ("app_container", "nextcloud"): 15,
+# Example pyproject.toml::
-    ("app_container", "customer-apps"): 11,
+#
-    ("app_container", "vaultwarden"): 2,
+#   [tool.devx.molecule.weights]
-    ("app_container", "simple-app"): 2,
+#   "nextcloud" = 15
-    ("app_container", "postgres-upgrade"): 3,
+#   "app_container/customer-apps" = 11
-    ("app_container", "default"): 3,
+#   "restore/default" = 11
-    ("restore", "default"): 11,
+#   "default" = 3
-    ("zitadel", "default"): 10,
+#
-    ("docker_base", "default"): 8,
+# If no configuration is found, a generic default weight is used for all
-    ("observability", "default"): 3,
+# scenarios (producing a round-robin distribution).
-    ("app_hardening", "default"): 4,
-    ("storage", "default"): 3,
-    ("storage", "object-storage"): 2,
-}
 
-# Fallback weights by scenario name only (for single-role projects or
-# scenarios not in the role-specific table).
-_SCENARIO_WEIGHTS: dict[str, int] = {
-    "nextcloud": 15,
-    "customer-apps": 11,
-    "restore": 11,
-    "zitadel": 10,
-    "docker-base": 8,
-    "postgresql": 3,
-    "postgres-upgrade": 3,
-    "gitea": 8,
-    "redis": 5,
-    "backup": 5,
-    "vaultwarden": 2,
-    "simple-app": 2,
-    "object-storage": 2,
-    "default": 3,
-    "binary": 2,
-}
 _DEFAULT_SCENARIO_WEIGHT = 3
 
 
+def _load_molecule_weights(pyproject_path: str = "pyproject.toml") -> tuple[dict[str, int], dict[tuple[str, str], int]]:
+    """Load molecule weights from ``[tool.devx.molecule.weights]`` in pyproject.toml.
+
+    Returns a tuple of ``(scenario_weights, role_scenario_weights)``:
+    - ``scenario_weights``: maps scenario name → weight (applies to any role)
+    - ``role_scenario_weights``: maps (role, scenario) → weight (role-specific)
+    """
+    path = Path(pyproject_path)
+    if not path.exists():
+        return {}, {}
+    try:
+        with open(path, "rb") as f:  # noqa: PTH123
+            data = tomllib.load(f)
+    except (tomllib.TOMLDecodeError, OSError):
+        return {}, {}
+
+    weights_raw = data.get("tool", {}).get("devx", {}).get("molecule", {}).get("weights", {})
+    if not isinstance(weights_raw, dict):
+        return {}, {}
+
+    scenario_weights: dict[str, int] = {}
+    role_scenario_weights: dict[tuple[str, str], int] = {}
+
+    for key, value in weights_raw.items():
+        if not isinstance(value, int):
+            continue
+        if "/" in key:
+            role, scenario = key.split("/", 1)
+            role_scenario_weights[(role.lower(), scenario.lower())] = value
+        else:
+            scenario_weights[key.lower()] = value
+
+    return scenario_weights, role_scenario_weights
+
+
+# Load weights once at import time (like devx.config and classify_changes)
+_SCENARIO_WEIGHTS, _ROLE_SCENARIO_WEIGHTS = _load_molecule_weights()
+
+
 def _scenario_weight(scenario: str, role: str | None = None) -> int:
     """Estimate a weight for a scenario based on its name and optionally its role.
 
-    Role-specific weights take priority over scenario-name-only weights.
+    Role-specific weights (``"role/scenario"``) take priority over
+    scenario-name-only weights (``"scenario"``).  Falls back to the
+    default weight if no configuration matches.
     """
     s = scenario.lower()
     if role is not None:

tests/unit/test_distribute_molecule.py

@@ -13,6 +13,7 @@ from devx.molecule.distribute_molecule import (
     PLATFORMS,
     MultiRoleTestPair,
     TestPair,
+    _load_molecule_weights,
     _lpt_distribute,
     _scenario_weight,
     build_multi_role_pairs,
@@ -482,42 +483,90 @@ class TestCliMultiRole:
 
 
 class TestScenarioWeight:
-    def test_known_heavy_scenario(self) -> None:
+    def test_default_weight_no_config(self, tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
-        assert _scenario_weight("nextcloud") == 15
+        """Without pyproject.toml, all scenarios get the default weight."""
-        assert _scenario_weight("gitea") == 8
+        monkeypatch.chdir(tmp_path)
-
+        scenario_w, role_w = _load_molecule_weights()
-    def test_known_light_scenario(self) -> None:
+        assert scenario_w == {}
-        assert _scenario_weight("binary") == 2
+        assert role_w == {}
-
-    def test_default_weight(self) -> None:
         assert _scenario_weight("unknown-scenario") == 3
 
-    def test_case_insensitive(self) -> None:
+    def test_load_weights_from_pyproject(self, tmp_path: Path) -> None:
-        assert _scenario_weight("NextCloud") == 15
+        """Weights are loaded from [tool.devx.molecule.weights] in pyproject.toml."""
-        assert _scenario_weight("GITEA") == 8
+        pyproject = tmp_path / "pyproject.toml"
+        pyproject.write_text(
+            "[tool.devx.molecule.weights]\n"
+            '"nextcloud" = 15\n'
+            '"default" = 3\n'
+            '"binary" = 2\n'
+            '"app_container/customer-apps" = 11\n'
+            '"restore/default" = 11\n'
+        )
+        scenario_w, role_w = _load_molecule_weights(str(pyproject))
+        assert scenario_w == {"nextcloud": 15, "default": 3, "binary": 2}
+        assert role_w == {("app_container", "customer-apps"): 11, ("restore", "default"): 11}
 
-    def test_substring_match(self) -> None:
+    def test_role_specific_takes_priority(self, tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
-        assert _scenario_weight("nextcloud-with-redis") == 15
+        """Role-specific weights take priority over scenario-name-only weights."""
-        assert _scenario_weight("custom-gitea-setup") == 8
+        pyproject = tmp_path / "pyproject.toml"
-
+        pyproject.write_text(
-    def test_role_specific_weight(self) -> None:
+            '[tool.devx.molecule.weights]\n"default" = 3\n"docker_base/default" = 8\n"restore/default" = 11\n'
-        """Role+scenario pairs take priority over scenario-name-only weights."""
+        )
-        assert _scenario_weight("default", "restore") == 11
+        scenario_w, role_w = _load_molecule_weights(str(pyproject))
-        assert _scenario_weight("default", "zitadel") == 10
+        monkeypatch.setattr("devx.molecule.distribute_molecule._SCENARIO_WEIGHTS", scenario_w)
+        monkeypatch.setattr("devx.molecule.distribute_molecule._ROLE_SCENARIO_WEIGHTS", role_w)
         assert _scenario_weight("default", "docker_base") == 8
-        assert _scenario_weight("default", "app_hardening") == 4
+        assert _scenario_weight("default", "restore") == 11
         assert _scenario_weight("default", "app_container") == 3
-        assert _scenario_weight("default", "storage") == 3
-        assert _scenario_weight("default", "observability") == 3
 
-    def test_role_specific_overrides_scenario_name(self) -> None:
+    def test_case_insensitive(self, tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
-        """vaultwarden has a scenario-name weight of 2, but role-specific is also 2."""
+        """Weight keys are matched case-insensitively."""
-        assert _scenario_weight("vaultwarden", "app_container") == 2
+        pyproject = tmp_path / "pyproject.toml"
-        assert _scenario_weight("vaultwarden") == 2
+        pyproject.write_text('[tool.devx.molecule.weights]\n"nextcloud" = 15\n')
+        scenario_w, role_w = _load_molecule_weights(str(pyproject))
+        monkeypatch.setattr("devx.molecule.distribute_molecule._SCENARIO_WEIGHTS", scenario_w)
+        monkeypatch.setattr("devx.molecule.distribute_molecule._ROLE_SCENARIO_WEIGHTS", role_w)
+        assert _scenario_weight("NextCloud") == 15
+        assert _scenario_weight("NEXTCLOUD") == 15
 
-    def test_customer_apps_weight(self) -> None:
+    def test_substring_match(self, tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
-        assert _scenario_weight("customer-apps", "app_container") == 11
+        """Scenario-name weights use substring matching."""
-        assert _scenario_weight("customer-apps") == 11
+        pyproject = tmp_path / "pyproject.toml"
+        pyproject.write_text('[tool.devx.molecule.weights]\n"nextcloud" = 15\n')
+        scenario_w, role_w = _load_molecule_weights(str(pyproject))
+        monkeypatch.setattr("devx.molecule.distribute_molecule._SCENARIO_WEIGHTS", scenario_w)
+        monkeypatch.setattr("devx.molecule.distribute_molecule._ROLE_SCENARIO_WEIGHTS", role_w)
+        assert _scenario_weight("nextcloud-with-redis") == 15
+
+    def test_no_pyproject_returns_empty(self, tmp_path: Path) -> None:
+        """Missing pyproject.toml returns empty weight dicts."""
+        scenario_w, role_w = _load_molecule_weights(str(tmp_path / "nonexistent.toml"))
+        assert scenario_w == {}
+        assert role_w == {}
+
+    def test_invalid_weights_ignored(self, tmp_path: Path) -> None:
+        """Non-integer weight values are silently ignored."""
+        pyproject = tmp_path / "pyproject.toml"
+        pyproject.write_text('[tool.devx.molecule.weights]\n"good" = 5\n"bad" = "not an int"\n')
+        scenario_w, role_w = _load_molecule_weights(str(pyproject))
+        assert scenario_w == {"good": 5}
+        assert role_w == {}
+
+    def test_malformed_toml_returns_empty(self, tmp_path: Path) -> None:
+        """Malformed TOML returns empty weight dicts."""
+        pyproject = tmp_path / "pyproject.toml"
+        pyproject.write_text("this is not valid toml = = =")
+        scenario_w, role_w = _load_molecule_weights(str(pyproject))
+        assert scenario_w == {}
+        assert role_w == {}
+
+    def test_non_dict_weights_returns_empty(self, tmp_path: Path) -> None:
+        """If [tool.devx.molecule.weights] is not a table, returns empty dicts."""
+        pyproject = tmp_path / "pyproject.toml"
+        pyproject.write_text('[tool.devx.molecule]\nweights = "not a table"\n')
+        scenario_w, role_w = _load_molecule_weights(str(pyproject))
+        assert scenario_w == {}
+        assert role_w == {}
 
 
 class TestLptDistribute: