atdd 0.4.6__py3-none-any.whl → 0.4.7__py3-none-any.whl

atdd/tester/validators/test_train_frontend_python.py

@@ -0,0 +1,282 @@
+"""
+Tester validators: Train frontend Python (Streamlit) convention validation.
+
+Train First-Class Spec v0.6 Section 8: Frontend Python Conventions
+
+Validates:
+- SPEC-TRAIN-VAL-0029: Frontend Python code paths
+- SPEC-TRAIN-VAL-0030: Frontend Python test paths
+
+Frontend Python (Streamlit) should follow:
+- Code paths: python/streamlit/ or python/apps/
+- Test paths: python/tests/streamlit/test_<train_id>[_<slug>].py
+"""
+
+import pytest
+import re
+from pathlib import Path
+from typing import Dict, List, Tuple
+
+import atdd
+from atdd.coach.utils.repo import find_repo_root
+from atdd.coach.utils.train_spec_phase import (
+    TrainSpecPhase,
+    should_enforce,
+    emit_phase_warning
+)
+
+
+# Path constants
+REPO_ROOT = find_repo_root()
+PYTHON_DIR = REPO_ROOT / "python"
+STREAMLIT_DIR = PYTHON_DIR / "streamlit"
+APPS_DIR = PYTHON_DIR / "apps"
+STREAMLIT_TESTS_DIR = PYTHON_DIR / "tests" / "streamlit"
+
+# Package resources
+ATDD_PKG_DIR = Path(atdd.__file__).resolve().parent
+
+
+def _get_trains_with_frontend_python() -> List[str]:
+    """
+    Get train IDs that expect frontend_python implementation.
+
+    Returns:
+        List of train_id strings
+    """
+    import yaml
+
+    train_ids = []
+    trains_registry_path = REPO_ROOT / "plan" / "_trains.yaml"
+
+    if not trains_registry_path.exists():
+        return train_ids
+
+    with open(trains_registry_path) as f:
+        data = yaml.safe_load(f)
+
+    trains_dir = REPO_ROOT / "plan" / "_trains"
+
+    for theme_key, categories in data.get("trains", {}).items():
+        if isinstance(categories, dict):
+            for category_key, trains_list in categories.items():
+                if isinstance(trains_list, list):
+                    for train in trains_list:
+                        train_id = train.get("train_id")
+                        if not train_id:
+                            continue
+
+                        # Check expectations in registry
+                        expectations = train.get("expectations", {})
+                        if expectations.get("frontend_python"):
+                            train_ids.append(train_id)
+                            continue
+
+                        # Check YAML file for expectations
+                        train_file = trains_dir / f"{train_id}.yaml"
+                        if train_file.exists():
+                            try:
+                                with open(train_file) as tf:
+                                    train_data = yaml.safe_load(tf)
+                                yaml_expectations = train_data.get("expectations", {})
+                                if yaml_expectations.get("frontend_python"):
+                                    train_ids.append(train_id)
+                            except Exception:
+                                pass
+
+    return train_ids
+
+
+def _find_frontend_python_code_files() -> List[Path]:
+    """
+    Find all frontend Python code files.
+
+    Returns:
+        List of paths to .py files in streamlit/ or apps/ directories
+    """
+    files = []
+
+    for search_dir in [STREAMLIT_DIR, APPS_DIR]:
+        if search_dir.exists():
+            for py_file in search_dir.rglob("*.py"):
+                if not py_file.name.startswith("_"):
+                    files.append(py_file)
+
+    return files
+
+
+def _find_frontend_python_test_files() -> List[Tuple[Path, str]]:
+    """
+    Find all frontend Python test files.
+
+    Returns:
+        List of (path, train_id_from_filename) tuples
+    """
+    tests = []
+
+    if not STREAMLIT_TESTS_DIR.exists():
+        return tests
+
+    # Pattern: test_<train_id>*.py
+    for test_file in STREAMLIT_TESTS_DIR.glob("test_*.py"):
+        filename = test_file.stem
+        match = re.match(r"test_(\d{4}-[a-z0-9-]+)", filename)
+        if match:
+            train_id = match.group(1)
+            tests.append((test_file, train_id))
+
+    return tests
+
+
+def _check_train_code_references(train_id: str) -> List[Path]:
+    """
+    Find code files that reference a specific train.
+
+    Returns:
+        List of paths that contain train_id reference
+    """
+    matching_files = []
+
+    for search_dir in [STREAMLIT_DIR, APPS_DIR]:
+        if not search_dir.exists():
+            continue
+
+        for py_file in search_dir.rglob("*.py"):
+            try:
+                with open(py_file, 'r', encoding='utf-8') as f:
+                    content = f.read()
+
+                # Check for train_id in file
+                if train_id in content:
+                    matching_files.append(py_file)
+
+            except Exception:
+                pass
+
+    return matching_files
+
+
+# ============================================================================
+# FRONTEND PYTHON VALIDATORS
+# ============================================================================
+
+
+@pytest.mark.platform
+def test_frontend_python_code_paths():
+    """
+    SPEC-TRAIN-VAL-0029: Frontend Python code in allowed paths
+
+    Given: Trains expecting frontend_python implementation
+    When: Checking code locations
+    Then: Code is in python/streamlit/ or python/apps/
+
+    Section 8: Frontend Python Code Paths
+    """
+    trains_with_frontend_python = _get_trains_with_frontend_python()
+
+    if not trains_with_frontend_python:
+        pytest.skip("No trains expecting frontend_python implementation")
+
+    code_files = _find_frontend_python_code_files()
+
+    if not code_files:
+        if should_enforce(TrainSpecPhase.FULL_ENFORCEMENT):
+            pytest.fail(
+                f"Trains expect frontend_python but no code found in python/streamlit/ or python/apps/:\n"
+                f"  Trains: {trains_with_frontend_python}"
+            )
+        else:
+            emit_phase_warning(
+                "SPEC-TRAIN-VAL-0029",
+                f"{len(trains_with_frontend_python)} trains expect frontend_python but no code found",
+                TrainSpecPhase.FULL_ENFORCEMENT
+            )
+        return
+
+    # Check that trains with expectations have corresponding code
+    missing_code = []
+    for train_id in trains_with_frontend_python:
+        refs = _check_train_code_references(train_id)
+        if not refs:
+            missing_code.append(f"{train_id}: no code references found")
+
+    if missing_code:
+        if should_enforce(TrainSpecPhase.FULL_ENFORCEMENT):
+            pytest.fail(
+                f"Trains missing frontend_python code:\n  " + "\n  ".join(missing_code) +
+                "\n\nExpected code in: python/streamlit/ or python/apps/"
+            )
+        else:
+            for missing in missing_code:
+                emit_phase_warning(
+                    "SPEC-TRAIN-VAL-0029",
+                    missing,
+                    TrainSpecPhase.FULL_ENFORCEMENT
+                )
+
+
+@pytest.mark.platform
+def test_frontend_python_test_paths():
+    """
+    SPEC-TRAIN-VAL-0030: Frontend Python tests in correct location
+
+    Given: Frontend Python test files
+    When: Checking test paths
+    Then: Path follows python/tests/streamlit/test_<train_id>[_<slug>].py
+
+    Section 8: Frontend Python Test Paths
+    """
+    trains_with_frontend_python = _get_trains_with_frontend_python()
+
+    if not trains_with_frontend_python:
+        pytest.skip("No trains expecting frontend_python implementation")
+
+    test_files = _find_frontend_python_test_files()
+
+    # Check that tests exist for trains that expect frontend_python
+    train_ids_with_tests = {train_id for _, train_id in test_files}
+
+    missing_tests = []
+    for train_id in trains_with_frontend_python:
+        if train_id not in train_ids_with_tests:
+            missing_tests.append(
+                f"{train_id}: missing test at python/tests/streamlit/test_{train_id}.py"
+            )
+
+    if missing_tests:
+        if should_enforce(TrainSpecPhase.FULL_ENFORCEMENT):
+            pytest.fail(
+                f"Trains missing frontend_python tests:\n  " + "\n  ".join(missing_tests) +
+                "\n\nExpected: python/tests/streamlit/test_<train_id>[_<slug>].py"
+            )
+        else:
+            for missing in missing_tests:
+                emit_phase_warning(
+                    "SPEC-TRAIN-VAL-0030",
+                    missing,
+                    TrainSpecPhase.FULL_ENFORCEMENT
+                )
+
+    # Validate existing test file naming
+    invalid_tests = []
+    all_train_ids = set(trains_with_frontend_python)
+
+    for test_path, train_id in test_files:
+        if train_id not in all_train_ids:
+            rel_path = test_path.relative_to(REPO_ROOT)
+            invalid_tests.append(
+                f"{rel_path}: train_id '{train_id}' not in trains expecting frontend_python"
+            )
+
+    if invalid_tests:
+        if should_enforce(TrainSpecPhase.FULL_ENFORCEMENT):
+            pytest.fail(
+                f"Frontend Python test path issues:\n  " + "\n  ".join(invalid_tests)
+            )
+        else:
+            for invalid in invalid_tests:
+                emit_phase_warning(
+                    "SPEC-TRAIN-VAL-0030",
+                    invalid,
+                    TrainSpecPhase.FULL_ENFORCEMENT
+                )

{atdd-0.4.6.dist-info → atdd-0.4.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atdd
-Version: 0.4.6
+Version: 0.4.7
 Summary: ATDD Platform - Acceptance Test Driven Development toolkit
 License: MIT
 Requires-Python: >=3.10

{atdd-0.4.6.dist-info → atdd-0.4.7.dist-info}/RECORD

@@ -12,9 +12,9 @@ atdd/coach/commands/gate.py,sha256=_V2GypqoGixTs_kLWxFF3HgEt-Wi2r6Iv0YL75yWrWo,5
 atdd/coach/commands/infer_governance_status.py,sha256=MlLnx8SrJAOQq2rfuxLZMmyNylCQ-OYx4tSi_iFdhRA,4504
 atdd/coach/commands/initializer.py,sha256=wuvzj7QwA11ilNjRZU6Bx2bLQXITdBHJxR9_mZK7xjA,6503
 atdd/coach/commands/interface.py,sha256=FwBrJpWkfSL9n4n0HT_EC-alseXgU0bweKD4TImyHN0,40483
-atdd/coach/commands/inventory.py,sha256=qU42MnkXt1JSBh5GU7pPSKmCO27Zfga7XwMT19RquJE,20969
+atdd/coach/commands/inventory.py,sha256=7Znpx2mFh3rQXEguUzIaBage3B5m1L_K2esYyd3pfLY,24764
 atdd/coach/commands/migration.py,sha256=wRxU7emvvHqWt1MvXKkNTkPBjp0sU9g8F5Uy5yV2YfI,8177
-atdd/coach/commands/registry.py,sha256=zE_Djgo4QKaDnp9JiPAh0D9wIv5Ed1yTmMEy31ipJkY,66736
+atdd/coach/commands/registry.py,sha256=9iWW34CCJAr36v91863u8TDdlGQJdLpYYBGb1ojtS1Q,71546
 atdd/coach/commands/session.py,sha256=MhuWXd5TR6bB3w0t8vANeZx3L476qwLT6EUQMwg-wQA,14268
 atdd/coach/commands/sync.py,sha256=SLNzhcc6IuzMofMbkH9wM9rBSk5tPfcWPKXn9TaSZ-Y,13782
 atdd/coach/commands/test_interface.py,sha256=a7ut2Hhk0PnQ5LfJZkoQwfkfkVuB5OHA4QBwOS0-jcg,16870
@@ -30,16 +30,19 @@ atdd/coach/schemas/manifest.schema.json,sha256=WO13-YF_FgH1awh96khCtk-112b6XSC24
 atdd/coach/templates/ATDD.md,sha256=MLbrVbCETJre4c05d5FXGuf6W95Hz9E0jpE4RI9r4cg,13237
 atdd/coach/templates/SESSION-TEMPLATE.md,sha256=cGT_0x5KLbPHOCiuM8evLGpWKIlR-aggqxiBtbjSJoo,9478
 atdd/coach/utils/__init__.py,sha256=7Jbo-heJEKSAn6I0s35z_2S4R8qGZ48PL6a2IntcNYg,148
+atdd/coach/utils/config.py,sha256=6XXaaeVfjTrJwdaR0IZ6Kf1-1ZHhaCVLO5pNx_A2el4,3320
 atdd/coach/utils/repo.py,sha256=0kiF5WpVTen0nO14u5T0RflznZhgGco2i9CwKobOh38,3757
+atdd/coach/utils/train_spec_phase.py,sha256=Mk8CiMoO6jb-VGttHgI20KIG26r9cjSz4gDfk01q1M0,3025
 atdd/coach/utils/graph/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atdd/coach/utils/graph/urn.py,sha256=O2AHIB_CmmMUvXzyejc_oFReNW_rOcw7m4qaqSYcnNQ,33558
 atdd/coach/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-atdd/coach/validators/shared_fixtures.py,sha256=tdqAb4675P-oOCL08mvSCG9XpmwMCjL9iSq1W5U7-wk,12558
+atdd/coach/validators/shared_fixtures.py,sha256=AUb-387kEc584umEzG_TnzEzcHkYignrobkgrRcQOso,14518
 atdd/coach/validators/test_enrich_wagon_registry.py,sha256=WeTwYJqoNY6mEYc-QAvQo7YVagSOjaNKxB6Q6dpWqIM,6561
 atdd/coach/validators/test_registry.py,sha256=ffN70yA_1xxL3R8gdpGbY2M8dQXyuajIZhBZ-ylNiNs,17845
 atdd/coach/validators/test_release_versioning.py,sha256=B40DfbtrSGguPc537zXmjT75hhySfocWLzJWqOKZQcU,5678
 atdd/coach/validators/test_session_validation.py,sha256=0VszXtFwRTO04b5CxDPO3klk0VfiqlpdbNpshjMn-qU,39079
 atdd/coach/validators/test_traceability.py,sha256=qTyobt41VBiCr6xRN2C7BPtGYvk_2poVQIe814Blt8E,15977
+atdd/coach/validators/test_train_registry.py,sha256=YDnmC1MP4TfAMZzyldh0hfHMo7LY27DZ2GXmhQx7vds,6021
 atdd/coach/validators/test_update_feature_paths.py,sha256=zOKVDgEIpncSJwDh_shyyou5Pu-Ai7Z_XgF8zAbQVTA,4528
 atdd/coach/validators/test_validate_contract_consumers.py,sha256=b01yam_GwAERF6YaFmUV6Bd7SNMWQkUKBfNVvplbEcU,12613
 atdd/coder/__init__.py,sha256=Rmi5S7Pzx7qsRe5MC66GduNGmkssWWnElkVvvNHFDgU,45
@@ -84,7 +87,7 @@ atdd/coder/validators/test_presentation_convention.py,sha256=ceAtg_sTEJiPkHVfnwB
 atdd/coder/validators/test_python_architecture.py,sha256=USnSujKVu7_BC2ij-pTSHyiFi4iBMBemIPR7oXYQ3B4,25243
 atdd/coder/validators/test_quality_metrics.py,sha256=vLWPfL0x9sfCvKXO4uECW61RnJTsjbmuEUjCsBcUmuA,12551
 atdd/coder/validators/test_station_master_pattern.py,sha256=biYwXAftpXdhIhDjn2RrVTdEdvTWPW5ddm2gQubJBXQ,9280
-atdd/coder/validators/test_train_infrastructure.py,sha256=e9oyWjGR7YoEQZPza8xHzLHN-wrqiJTbNc9Y0BLlGLw,16201
+atdd/coder/validators/test_train_infrastructure.py,sha256=CXOSn_CPk3wJhEVNYztSdiV_ecIgnJkulD-xWivregE,24424
 atdd/coder/validators/test_train_urns.py,sha256=TvSNHbvG8SAtAPaS2K8mMgzE8GbJtrTaF4iEgkJEIIk,10099
 atdd/coder/validators/test_typescript_architecture.py,sha256=gi76IwlqX_MpWsr8CXWH7v16KAoud-1OY92iuN-0BpU,22176
 atdd/coder/validators/test_usecase_structure.py,sha256=nAeqmLWRCstXT8fDuxqk6iVcH4TLHjTvlaGDpanD9sM,14077
@@ -105,7 +108,7 @@ atdd/planner/schemas/acceptance.schema.json,sha256=3mQV067ipiYsTcXkDll4zWJBYdOkB
 atdd/planner/schemas/appendix.schema.json,sha256=aMqKIwHAgEoO49v8O8isyP1S3oTNCCEeIX3gNmge3TY,2885
 atdd/planner/schemas/component.schema.json,sha256=B-RgVUmG02T8j0jL1FjAPhVSIGiditJ0UsILNxYXElQ,3891
 atdd/planner/schemas/feature.schema.json,sha256=wZAIzroUv74iAS2tzIDPhWu2EIDMSRtzsMj5mAfLVdY,7228
-atdd/planner/schemas/train.schema.json,sha256=pk5-AjqH6kerfPVOGhCF5Fe5k797s3xxrRJBrN0nb2k,5750
+atdd/planner/schemas/train.schema.json,sha256=YU58Pc_EuhwUR0tuwyXWOQBeKei0TsB4wkRLNcyE0Ig,9877
 atdd/planner/schemas/wagon.schema.json,sha256=Vy9QCd7aN9yUS5hTPv0XiZ_vw4MEWeDfvCW7jr9Dn6o,11699
 atdd/planner/schemas/wmbt.schema.json,sha256=KU_D6r0kQTJod-XHQT5QiiHcUUPJrLgg3aPeZdrRBUU,2298
 atdd/planner/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -115,7 +118,7 @@ atdd/planner/validators/test_plan_cross_refs.py,sha256=kxlq1uZ2u4mn3r8wHJjXVJsB8
 atdd/planner/validators/test_plan_uniqueness.py,sha256=rlC5khAoBkgpTZJdyHi1JbDUj14v1JiGBFv2iV_AP_Y,7735
 atdd/planner/validators/test_plan_urn_resolution.py,sha256=GoxFiRjOfp69FUmIyKGnsGgpYalOz3qfp6qjyCkga44,9440
 atdd/planner/validators/test_plan_wagons.py,sha256=l4jbHf9Kg-Fy8Gz5O8BO7PDQKbbeLN0uctoErPK_YKI,7357
-atdd/planner/validators/test_train_validation.py,sha256=KsAMxtuyipHse02x91k4rLWUxRiHW29sYBWZ6KNbfJ4,16870
+atdd/planner/validators/test_train_validation.py,sha256=7vlu3P8PenWgZhZCf9kO0UTM-k1n37Ds_jUvrJa-Np0,39264
 atdd/planner/validators/test_wagon_urn_chain.py,sha256=KY_0vrj6CoiQJ80WbqfCGCYbup13cVssaxbNO0eVf74,26697
 atdd/planner/validators/test_wmbt_consistency.py,sha256=jdfu4xWEozzBGwplKDXxuDQNLBDxB_AC96NHLkyHqQ8,10875
 atdd/planner/validators/test_wmbt_vocabulary.py,sha256=PCivTzV7ntlZBa-PVzpBwEiKqLumsEZXfj1r2xl9usM,18803
@@ -180,11 +183,14 @@ atdd/tester/validators/test_red_layer_validation.py,sha256=otqohLMayIK4nPPF2fl-O
 atdd/tester/validators/test_red_python_layer_structure.py,sha256=5p6mTieijO7MpZGuVODYm9acKkMJ1XeMYDZ3gxPGW0k,3467
 atdd/tester/validators/test_red_supabase_layer_structure.py,sha256=zbUjsMWSJE1MPnLQx6Hk2lvMgNmMVUKq8a0rwKnp7Lo,3836
 atdd/tester/validators/test_telemetry_structure.py,sha256=uU5frZnxSlOn60iHyqhe7Pg9b0wrOV7N14D4S6Aw6TE,22626
+atdd/tester/validators/test_train_backend_e2e.py,sha256=Yx75JMjUgf86XTqeuc0k8yT41XuIquo05h2ce3lNb2w,10950
+atdd/tester/validators/test_train_frontend_e2e.py,sha256=fpfUwTbAWzuqxbVKoaFw-ab4e3puK-uLC-ahf1jYgk8,8469
+atdd/tester/validators/test_train_frontend_python.py,sha256=KK2U3oNFWLyBK7YHC0fU7shR05k93gVcO762AI8Q3pw,9018
 atdd/tester/validators/test_typescript_test_naming.py,sha256=E-TyGv_GVlTfsbyuxrtv9sOWSZS_QcpH6rrJFbWoeeU,11280
 atdd/tester/validators/test_typescript_test_structure.py,sha256=eV89SD1RaKtchBZupqhnJmaruoROosf3LwB4Fwe4UJI,2612
-atdd-0.4.6.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-atdd-0.4.6.dist-info/METADATA,sha256=krXgWDxwrC0W-HkHgBtc0GoE0aXyJWqhHGPpjm3G4T8,8716
-atdd-0.4.6.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-atdd-0.4.6.dist-info/entry_points.txt,sha256=-C3yrA1WQQfN3iuGmSzPapA5cKVBEYU5Q1HUffSJTbY,38
-atdd-0.4.6.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
-atdd-0.4.6.dist-info/RECORD,,
+atdd-0.4.7.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+atdd-0.4.7.dist-info/METADATA,sha256=9kcgwnLFKtRapPjpY7J9n1UBjq8kOmS27bqdvr0_iek,8716
+atdd-0.4.7.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+atdd-0.4.7.dist-info/entry_points.txt,sha256=-C3yrA1WQQfN3iuGmSzPapA5cKVBEYU5Q1HUffSJTbY,38
+atdd-0.4.7.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
+atdd-0.4.7.dist-info/RECORD,,