forge-mvc-workflow 1.0.0b6__tar.gz

forge_mvc_workflow-1.0.0b6/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: forge-mvc-workflow
+Version: 1.0.0b6
+Summary: Forge workflow — statuts et transitions applicatives.
+Author: Roger Cauchon
+License-Expression: LicenseRef-Forge-Proprietary
+Project-URL: Homepage, https://github.com/caucrogeGit/Forge
+Project-URL: Repository, https://github.com/caucrogeGit/Forge
+Project-URL: Documentation, https://caucrogegit.github.io/Forge/
+Keywords: python,mvc,forge,workflow,statuts
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: forge-mvc<2,>=1.0.0b5
+Requires-Dist: markupsafe>=2.0
+
+# forge-mvc-workflow
+
+Module workflow pour Forge — statuts et transitions applicatives.
+
+Extrait du core Forge depuis la version 2.6.0 (ADR-004).
+
+## Installation
+
+```bash
+pip install forge-mvc-workflow
+# ou en mode developpement
+pip install -e packages/forge-mvc-workflow/
+```
+
+## Usage
+
+```python
+from forge_mvc_workflow import (
+    WorkflowStatus,
+    WorkflowTransition,
+    make_status,
+    make_transition,
+    validate_statuses,
+    validate_transitions,
+    can_transition,
+    get_available_transitions,
+    make_workflow_jinja_helpers,
+)
+
+# Definir des statuts
+statuses = validate_statuses([
+    make_status("brouillon", label="Brouillon", color="gray"),
+    make_status("confirme", label="Confirme", color="green"),
+    make_status("annule", label="Annule", color="red"),
+])
+
+# Definir des transitions autorisees
+transitions = validate_transitions([
+    make_transition("brouillon", "confirme"),
+    make_transition("brouillon", "annule"),
+    make_transition("confirme", "annule"),
+], statuses=statuses)
+
+# Verifier une transition
+if can_transition(transitions, "brouillon", "confirme"):
+    ...
+
+# Obtenir les transitions disponibles depuis un statut
+available = get_available_transitions(transitions, "brouillon")
+```
+
+## Helpers Jinja2
+
+```python
+env.globals.update(make_workflow_jinja_helpers())
+```
+
+Dans un template :
+
+```jinja2
+{{ workflow_status_badge(reservation.status) }}
+{{ workflow_status_label(reservation.status) }}
+```
+
+## Cas d'usage
+
+- Statut d'une reservation (brouillon → confirmee → terminee → annulee)
+- Statut d'un document (redaction → validation → publie)
+- Statut d'une commande (panier → payee → expediee → livree)
+
+## API publique
+
+- `WorkflowStatus` — dataclass statut (name, label, color)
+- `WorkflowTransition` — dataclass transition (from_status, to_status)
+- `make_status(name, label, color)` — constructeur valide
+- `make_transition(from_status, to_status)` — constructeur valide
+- `validate_statuses(list)` — valide une liste de statuts
+- `validate_transitions(list, statuses)` — valide les transitions par rapport aux statuts
+- `can_transition(transitions, from_name, to_name)` — teste une transition
+- `get_available_transitions(transitions, from_name)` — liste les transitions disponibles
+- `make_workflow_jinja_helpers()` — dict de helpers Jinja2

forge_mvc_workflow-1.0.0b6/README.md

@@ -0,0 +1,81 @@
+# forge-mvc-workflow
+
+Module workflow pour Forge — statuts et transitions applicatives.
+
+Extrait du core Forge depuis la version 2.6.0 (ADR-004).
+
+## Installation
+
+```bash
+pip install forge-mvc-workflow
+# ou en mode developpement
+pip install -e packages/forge-mvc-workflow/
+```
+
+## Usage
+
+```python
+from forge_mvc_workflow import (
+    WorkflowStatus,
+    WorkflowTransition,
+    make_status,
+    make_transition,
+    validate_statuses,
+    validate_transitions,
+    can_transition,
+    get_available_transitions,
+    make_workflow_jinja_helpers,
+)
+
+# Definir des statuts
+statuses = validate_statuses([
+    make_status("brouillon", label="Brouillon", color="gray"),
+    make_status("confirme", label="Confirme", color="green"),
+    make_status("annule", label="Annule", color="red"),
+])
+
+# Definir des transitions autorisees
+transitions = validate_transitions([
+    make_transition("brouillon", "confirme"),
+    make_transition("brouillon", "annule"),
+    make_transition("confirme", "annule"),
+], statuses=statuses)
+
+# Verifier une transition
+if can_transition(transitions, "brouillon", "confirme"):
+    ...
+
+# Obtenir les transitions disponibles depuis un statut
+available = get_available_transitions(transitions, "brouillon")
+```
+
+## Helpers Jinja2
+
+```python
+env.globals.update(make_workflow_jinja_helpers())
+```
+
+Dans un template :
+
+```jinja2
+{{ workflow_status_badge(reservation.status) }}
+{{ workflow_status_label(reservation.status) }}
+```
+
+## Cas d'usage
+
+- Statut d'une reservation (brouillon → confirmee → terminee → annulee)
+- Statut d'un document (redaction → validation → publie)
+- Statut d'une commande (panier → payee → expediee → livree)
+
+## API publique
+
+- `WorkflowStatus` — dataclass statut (name, label, color)
+- `WorkflowTransition` — dataclass transition (from_status, to_status)
+- `make_status(name, label, color)` — constructeur valide
+- `make_transition(from_status, to_status)` — constructeur valide
+- `validate_statuses(list)` — valide une liste de statuts
+- `validate_transitions(list, statuses)` — valide les transitions par rapport aux statuts
+- `can_transition(transitions, from_name, to_name)` — teste une transition
+- `get_available_transitions(transitions, from_name)` — liste les transitions disponibles
+- `make_workflow_jinja_helpers()` — dict de helpers Jinja2

forge_mvc_workflow-1.0.0b6/forge_mvc_workflow/__init__.py

@@ -0,0 +1,54 @@
+"""Forge workflow — statuts et transitions applicatives.
+
+Module officiel Forge livre separement depuis Forge 2.6.0 (ADR-004).
+"""
+
+from __future__ import annotations
+
+from forge_mvc_workflow.jinja import (
+    make_workflow_jinja_helpers,
+    workflow_status_badge,
+    workflow_status_badge_class,
+    workflow_status_color,
+    workflow_status_label,
+)
+from forge_mvc_workflow.status import (
+    WorkflowStatus,
+    WorkflowStatusError,
+    find_status,
+    make_status,
+    normalize_status_name,
+    validate_status_name,
+    validate_statuses,
+)
+from forge_mvc_workflow.transitions import (
+    WorkflowTransition,
+    WorkflowTransitionError,
+    can_transition,
+    get_available_transitions,
+    make_transition,
+    validate_transitions,
+)
+
+__version__ = "1.0.0b6"
+
+__all__ = [
+    "WorkflowStatus",
+    "WorkflowStatusError",
+    "find_status",
+    "make_status",
+    "normalize_status_name",
+    "validate_status_name",
+    "validate_statuses",
+    "WorkflowTransition",
+    "WorkflowTransitionError",
+    "can_transition",
+    "get_available_transitions",
+    "make_transition",
+    "validate_transitions",
+    "make_workflow_jinja_helpers",
+    "workflow_status_badge",
+    "workflow_status_badge_class",
+    "workflow_status_color",
+    "workflow_status_label",
+]

forge_mvc_workflow-1.0.0b6/forge_mvc_workflow/jinja.py

@@ -0,0 +1,70 @@
+"""Helpers Jinja d'affichage de statuts workflow pour Forge."""
+
+from __future__ import annotations
+
+from markupsafe import Markup, escape
+
+from .status import WorkflowStatus
+
+
+_BASE = "inline-flex items-center rounded-full px-2 py-1 text-xs font-medium"
+
+_BADGE_CLASSES: dict[str, str] = {
+    "gray":   f"{_BASE} bg-gray-100 text-gray-700",
+    "blue":   f"{_BASE} bg-blue-100 text-blue-700",
+    "green":  f"{_BASE} bg-green-100 text-green-700",
+    "yellow": f"{_BASE} bg-yellow-100 text-yellow-700",
+    "red":    f"{_BASE} bg-red-100 text-red-700",
+    "purple": f"{_BASE} bg-purple-100 text-purple-700",
+}
+
+_DEFAULT_COLOR = "gray"
+
+
+def workflow_status_label(status: WorkflowStatus | str | None) -> str:
+    """Return the display label for a status.
+
+    Accepts a WorkflowStatus, a plain string, or None.
+    Falls back to the name if label is empty, or to an empty string for None.
+    """
+    if isinstance(status, WorkflowStatus):
+        return status.label or status.name
+    if status is None:
+        return ""
+    return str(status)
+
+
+def workflow_status_color(status: WorkflowStatus | str | None) -> str:
+    """Return the color string for a status, defaulting to 'gray'."""
+    if isinstance(status, WorkflowStatus):
+        return status.color or _DEFAULT_COLOR
+    return _DEFAULT_COLOR
+
+
+def workflow_status_badge_class(status: WorkflowStatus | str | None) -> str:
+    """Return Tailwind CSS classes for a status badge.
+
+    Unmapped colors fall back to the gray palette.
+    """
+    color = workflow_status_color(status)
+    return _BADGE_CLASSES.get(color, _BADGE_CLASSES[_DEFAULT_COLOR])
+
+
+def workflow_status_badge(status: WorkflowStatus | str | None) -> Markup:
+    """Return a safe HTML <span> badge for a status.
+
+    Marked as Markup so Jinja2 does not double-escape it.
+    """
+    label = workflow_status_label(status)
+    classes = workflow_status_badge_class(status)
+    return Markup(f'<span class="{classes}">{escape(label)}</span>')
+
+
+def make_workflow_jinja_helpers() -> dict[str, object]:
+    """Return a dict of workflow helpers ready for injection into a Jinja2 env."""
+    return {
+        "workflow_status_label": workflow_status_label,
+        "workflow_status_color": workflow_status_color,
+        "workflow_status_badge_class": workflow_status_badge_class,
+        "workflow_status_badge": workflow_status_badge,
+    }

forge_mvc_workflow-1.0.0b6/forge_mvc_workflow/status.py

@@ -0,0 +1,114 @@
+"""Statuts génériques de workflow pour Forge."""
+
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass
+
+
+_VALID_NAME_RE = re.compile(r"^[a-z][a-z0-9_]*$")
+_SAFE_NORMALIZE_RE = re.compile(r"[\s\-]+")
+_UNSAFE_CHARS_RE = re.compile(r"[^a-z0-9_\s\-]")
+
+
+class WorkflowStatusError(ValueError):
+    pass
+
+
+@dataclass
+class WorkflowStatus:
+    name: str
+    label: str = ""
+    color: str = ""
+    is_initial: bool = False
+    is_final: bool = False
+
+    def __post_init__(self) -> None:
+        self.name = validate_status_name(self.name)
+        if not self.label:
+            self.label = self.name
+
+
+def normalize_status_name(value: str) -> str:
+    """Convert a raw string to a valid snake_case status name.
+
+    Only spaces and hyphens are converted to underscores. Any other
+    non-alphanumeric character causes a WorkflowStatusError.
+    """
+    if not isinstance(value, str):
+        raise WorkflowStatusError("Le nom de statut doit être une chaîne.")
+    lowered = value.strip().lower()
+    if _UNSAFE_CHARS_RE.search(lowered):
+        raise WorkflowStatusError(
+            f"Le nom de statut '{value}' contient des caractères non autorisés. "
+            "Utilisez uniquement des lettres, des chiffres, des espaces et des tirets."
+        )
+    normalized = _SAFE_NORMALIZE_RE.sub("_", lowered)
+    normalized = re.sub(r"_+", "_", normalized).strip("_")
+    return normalized
+
+
+def validate_status_name(value: str) -> str:
+    """Validate and return a normalized status name, or raise WorkflowStatusError."""
+    if not isinstance(value, str):
+        raise WorkflowStatusError("Le nom de statut doit être une chaîne.")
+    if not value or not value.strip():
+        raise WorkflowStatusError("Le nom de statut ne peut pas être vide.")
+    normalized = normalize_status_name(value)
+    if not normalized:
+        raise WorkflowStatusError(
+            f"Le nom de statut '{value}' est invalide après normalisation."
+        )
+    if not _VALID_NAME_RE.match(normalized):
+        raise WorkflowStatusError(
+            f"Le nom de statut '{value}' contient des caractères non autorisés. "
+            "Utilisez uniquement des lettres minuscules, des chiffres et des tirets bas."
+        )
+    return normalized
+
+
+def make_status(
+    name: str,
+    label: str = "",
+    color: str = "",
+    is_initial: bool = False,
+    is_final: bool = False,
+) -> WorkflowStatus:
+    """Create a WorkflowStatus with validated and normalized name."""
+    return WorkflowStatus(
+        name=name,
+        label=label,
+        color=color,
+        is_initial=is_initial,
+        is_final=is_final,
+    )
+
+
+def validate_statuses(statuses: list[WorkflowStatus]) -> list[WorkflowStatus]:
+    """Validate a list of statuses: no duplicates, at most one initial."""
+    seen_names: set[str] = set()
+    initial_count = 0
+    for status in statuses:
+        if status.name in seen_names:
+            raise WorkflowStatusError(
+                f"Statut en doublon : '{status.name}'."
+            )
+        seen_names.add(status.name)
+        if status.is_initial:
+            initial_count += 1
+    if initial_count > 1:
+        raise WorkflowStatusError(
+            f"{initial_count} statuts marqués comme initiaux. "
+            "Au plus un statut peut être initial."
+        )
+    return statuses
+
+
+def find_status(
+    statuses: list[WorkflowStatus], name: str
+) -> WorkflowStatus | None:
+    """Return the status with matching name, or None if not found."""
+    for status in statuses:
+        if status.name == name:
+            return status
+    return None

forge_mvc_workflow-1.0.0b6/forge_mvc_workflow/transitions.py

@@ -0,0 +1,87 @@
+"""Transitions génériques de workflow pour Forge."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from .status import WorkflowStatus, WorkflowStatusError, validate_status_name
+
+
+class WorkflowTransitionError(ValueError):
+    pass
+
+
+@dataclass(frozen=True)
+class WorkflowTransition:
+    from_status: str
+    to_status: str
+
+    def __post_init__(self) -> None:
+        try:
+            object.__setattr__(self, "from_status", validate_status_name(self.from_status))
+            object.__setattr__(self, "to_status", validate_status_name(self.to_status))
+        except WorkflowStatusError as exc:
+            raise WorkflowTransitionError(str(exc)) from exc
+        if self.from_status == self.to_status:
+            raise WorkflowTransitionError(
+                f"Une transition ne peut pas pointer vers le même statut : '{self.from_status}'."
+            )
+
+
+def make_transition(from_status: str, to_status: str) -> WorkflowTransition:
+    """Create a validated WorkflowTransition."""
+    return WorkflowTransition(from_status=from_status, to_status=to_status)
+
+
+def validate_transitions(
+    transitions: list[WorkflowTransition],
+    statuses: list[WorkflowStatus] | None = None,
+) -> list[WorkflowTransition]:
+    """Validate a list of transitions.
+
+    Checks:
+    - No duplicate (from_status, to_status) pairs.
+    - If statuses is provided, all referenced names must exist in that list.
+    """
+    seen: set[tuple[str, str]] = set()
+    for t in transitions:
+        key = (t.from_status, t.to_status)
+        if key in seen:
+            raise WorkflowTransitionError(
+                f"Transition en doublon : '{t.from_status}' → '{t.to_status}'."
+            )
+        seen.add(key)
+
+    if statuses is not None:
+        known = {s.name for s in statuses}
+        for t in transitions:
+            if t.from_status not in known:
+                raise WorkflowTransitionError(
+                    f"Statut source inconnu : '{t.from_status}'."
+                )
+            if t.to_status not in known:
+                raise WorkflowTransitionError(
+                    f"Statut cible inconnu : '{t.to_status}'."
+                )
+
+    return transitions
+
+
+def can_transition(
+    transitions: list[WorkflowTransition],
+    from_name: str,
+    to_name: str,
+) -> bool:
+    """Return True if a transition from from_name to to_name is defined."""
+    from_norm = validate_status_name(from_name)
+    to_norm = validate_status_name(to_name)
+    return any(t.from_status == from_norm and t.to_status == to_norm for t in transitions)
+
+
+def get_available_transitions(
+    transitions: list[WorkflowTransition],
+    from_name: str,
+) -> list[WorkflowTransition]:
+    """Return all transitions starting from from_name."""
+    from_norm = validate_status_name(from_name)
+    return [t for t in transitions if t.from_status == from_norm]

forge_mvc_workflow-1.0.0b6/forge_mvc_workflow.egg-info/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: forge-mvc-workflow
+Version: 1.0.0b6
+Summary: Forge workflow — statuts et transitions applicatives.
+Author: Roger Cauchon
+License-Expression: LicenseRef-Forge-Proprietary
+Project-URL: Homepage, https://github.com/caucrogeGit/Forge
+Project-URL: Repository, https://github.com/caucrogeGit/Forge
+Project-URL: Documentation, https://caucrogegit.github.io/Forge/
+Keywords: python,mvc,forge,workflow,statuts
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: forge-mvc<2,>=1.0.0b5
+Requires-Dist: markupsafe>=2.0
+
+# forge-mvc-workflow
+
+Module workflow pour Forge — statuts et transitions applicatives.
+
+Extrait du core Forge depuis la version 2.6.0 (ADR-004).
+
+## Installation
+
+```bash
+pip install forge-mvc-workflow
+# ou en mode developpement
+pip install -e packages/forge-mvc-workflow/
+```
+
+## Usage
+
+```python
+from forge_mvc_workflow import (
+    WorkflowStatus,
+    WorkflowTransition,
+    make_status,
+    make_transition,
+    validate_statuses,
+    validate_transitions,
+    can_transition,
+    get_available_transitions,
+    make_workflow_jinja_helpers,
+)
+
+# Definir des statuts
+statuses = validate_statuses([
+    make_status("brouillon", label="Brouillon", color="gray"),
+    make_status("confirme", label="Confirme", color="green"),
+    make_status("annule", label="Annule", color="red"),
+])
+
+# Definir des transitions autorisees
+transitions = validate_transitions([
+    make_transition("brouillon", "confirme"),
+    make_transition("brouillon", "annule"),
+    make_transition("confirme", "annule"),
+], statuses=statuses)
+
+# Verifier une transition
+if can_transition(transitions, "brouillon", "confirme"):
+    ...
+
+# Obtenir les transitions disponibles depuis un statut
+available = get_available_transitions(transitions, "brouillon")
+```
+
+## Helpers Jinja2
+
+```python
+env.globals.update(make_workflow_jinja_helpers())
+```
+
+Dans un template :
+
+```jinja2
+{{ workflow_status_badge(reservation.status) }}
+{{ workflow_status_label(reservation.status) }}
+```
+
+## Cas d'usage
+
+- Statut d'une reservation (brouillon → confirmee → terminee → annulee)
+- Statut d'un document (redaction → validation → publie)
+- Statut d'une commande (panier → payee → expediee → livree)
+
+## API publique
+
+- `WorkflowStatus` — dataclass statut (name, label, color)
+- `WorkflowTransition` — dataclass transition (from_status, to_status)
+- `make_status(name, label, color)` — constructeur valide
+- `make_transition(from_status, to_status)` — constructeur valide
+- `validate_statuses(list)` — valide une liste de statuts
+- `validate_transitions(list, statuses)` — valide les transitions par rapport aux statuts
+- `can_transition(transitions, from_name, to_name)` — teste une transition
+- `get_available_transitions(transitions, from_name)` — liste les transitions disponibles
+- `make_workflow_jinja_helpers()` — dict de helpers Jinja2

forge_mvc_workflow-1.0.0b6/forge_mvc_workflow.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+forge_mvc_workflow/__init__.py
+forge_mvc_workflow/jinja.py
+forge_mvc_workflow/status.py
+forge_mvc_workflow/transitions.py
+forge_mvc_workflow.egg-info/PKG-INFO
+forge_mvc_workflow.egg-info/SOURCES.txt
+forge_mvc_workflow.egg-info/dependency_links.txt
+forge_mvc_workflow.egg-info/requires.txt
+forge_mvc_workflow.egg-info/top_level.txt

forge_mvc_workflow-1.0.0b6/forge_mvc_workflow.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

forge_mvc_workflow-1.0.0b6/forge_mvc_workflow.egg-info/requires.txt

@@ -0,0 +1,2 @@
+forge-mvc<2,>=1.0.0b5
+markupsafe>=2.0

forge_mvc_workflow-1.0.0b6/forge_mvc_workflow.egg-info/top_level.txt

@@ -0,0 +1 @@
+forge_mvc_workflow

forge_mvc_workflow-1.0.0b6/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "forge-mvc-workflow"
+version = "1.0.0b6"
+description = "Forge workflow — statuts et transitions applicatives."
+readme = { file = "README.md", content-type = "text/markdown" }
+requires-python = ">=3.12"
+authors = [
+    { name = "Roger Cauchon" },
+]
+license = "LicenseRef-Forge-Proprietary"
+keywords = ["python", "mvc", "forge", "workflow", "statuts"]
+dependencies = [
+    "forge-mvc>=1.0.0b5,<2",
+    "markupsafe>=2.0",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+
+[project.urls]
+Homepage = "https://github.com/caucrogeGit/Forge"
+Repository = "https://github.com/caucrogeGit/Forge"
+Documentation = "https://caucrogegit.github.io/Forge/"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["forge_mvc_workflow*"]

forge_mvc_workflow-1.0.0b6/setup.cfg

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