atdd 0.2.1__py3-none-any.whl

atdd/tester/utils/filename.py

@@ -0,0 +1,300 @@
+"""
+Test filename generation from acceptance URNs.
+
+Provides utilities to generate test filenames following language-specific
+conventions from acceptance URN format.
+
+URN Format: acc:{wagon}:{WMBT}-{HARNESS}-{NNN}[-{slug}]
+Example: acc:maintain-ux:C004-E2E-019-user-connection
+
+Spec: SPEC-TESTER-CONV-0068 through SPEC-TESTER-CONV-0076
+URN: utils:tester:filename
+"""
+
+import re
+from typing import Dict, Optional
+
+
+# URN pattern for acceptance criteria
+# Format: acc:{wagon}:{WMBT}-{HARNESS}-{NNN}[-{slug}]
+# - wagon: lowercase with hyphens (a-z0-9-)
+# - WMBT: Step code + 3-digit sequence (e.g., C004, E019)
+# - HARNESS: Uppercase code (UNIT, HTTP, E2E, etc.)
+# - NNN: 3-digit zero-padded sequence (001-999)
+# - slug: Optional kebab-case descriptor
+URN_PATTERN = r'^acc:([a-z][a-z0-9-]*):([DLPCEMYRK][0-9]{3})-([A-Z0-9]+)-([0-9]{3})(?:-([a-z0-9-]+))?$'
+
+
+def parse_acceptance_urn(urn: str) -> Dict[str, Optional[str]]:
+    """
+    Parse acceptance URN into components.
+
+    Args:
+        urn: Acceptance URN in format acc:{wagon}:{WMBT}-{HARNESS}-{NNN}[-{slug}]
+
+    Returns:
+        Dictionary with keys: wagon, WMBT, HARNESS, NNN, slug
+
+    Raises:
+        ValueError: If URN format is invalid
+
+    Example:
+        >>> parse_acceptance_urn("acc:maintain-ux:C004-E2E-019-user-connection")
+        {
+            'wagon': 'maintain-ux',
+            'WMBT': 'C004',
+            'HARNESS': 'E2E',
+            'NNN': '019',
+            'slug': 'user-connection'
+        }
+    """
+    match = re.match(URN_PATTERN, urn)
+    if not match:
+        raise ValueError(f"Invalid acceptance URN: {urn}")
+
+    wagon, WMBT, HARNESS, NNN, slug = match.groups()
+
+    return {
+        'wagon': wagon,
+        'WMBT': WMBT,
+        'HARNESS': HARNESS,
+        'NNN': NNN,
+        'slug': slug  # None if not present
+    }
+
+
+def kebab_to_snake(slug: Optional[str]) -> str:
+    """
+    Convert kebab-case to snake_case.
+
+    Args:
+        slug: Kebab-case string (e.g., "user-connection")
+
+    Returns:
+        Snake_case string (e.g., "user_connection")
+
+    Example:
+        >>> kebab_to_snake("user-connection")
+        'user_connection'
+    """
+    if not slug:
+        return ""
+    return slug.replace('-', '_')
+
+
+def kebab_to_pascal(slug: Optional[str]) -> str:
+    """
+    Convert kebab-case to PascalCase.
+
+    Args:
+        slug: Kebab-case string (e.g., "user-connection")
+
+    Returns:
+        PascalCase string (e.g., "UserConnection")
+
+    Example:
+        >>> kebab_to_pascal("user-connection")
+        'UserConnection'
+    """
+    if not slug:
+        return ""
+    return ''.join(part.capitalize() for part in slug.split('-'))
+
+
+def dart_filename(urn: str) -> str:
+    """
+    Generate Dart test filename from acceptance URN.
+
+    Pattern: {WMBT}_{HARNESS}_{NNN}[_{slug_snake}]_test.dart
+    - WMBT and HARNESS remain uppercase
+    - Underscore separators
+    - Slug converted to snake_case
+
+    Args:
+        urn: Acceptance URN
+
+    Returns:
+        Dart test filename
+
+    Example:
+        >>> dart_filename("acc:maintain-ux:C004-E2E-019-user-connection")
+        'C004_E2E_019_user_connection_test.dart'
+    """
+    parts = parse_acceptance_urn(urn)
+    slug_part = f"_{kebab_to_snake(parts['slug'])}" if parts['slug'] else ""
+    return f"{parts['WMBT']}_{parts['HARNESS']}_{parts['NNN']}{slug_part}_test.dart"
+
+
+def typescript_filename(urn: str) -> str:
+    """
+    Generate TypeScript test filename from acceptance URN.
+
+    Pattern: {wmbt_lower}-{harness_lower}-{nnn}[-{slug-kebab}].test.ts
+    - All components lowercase
+    - Hyphen separators
+    - Slug preserved in kebab-case
+
+    Args:
+        urn: Acceptance URN
+
+    Returns:
+        TypeScript test filename
+
+    Example:
+        >>> typescript_filename("acc:maintain-ux:C004-E2E-019-user-connection")
+        'c004-e2e-019-user-connection.test.ts'
+    """
+    parts = parse_acceptance_urn(urn)
+    slug_part = f"-{parts['slug']}" if parts['slug'] else ""
+    return f"{parts['WMBT'].lower()}-{parts['HARNESS'].lower()}-{parts['NNN']}{slug_part}.test.ts"
+
+
+def typescript_preact_filename(urn: str, tsx: Optional[bool] = None) -> str:
+    """
+    Generate Preact TypeScript test filename from acceptance URN.
+
+    Pattern: {WMBT}_{HARNESS}_{NNN}[_{slug_snake}].test.ts[x]
+    - WMBT and HARNESS remain uppercase
+    - Underscore separators
+    - Slug converted to snake_case
+    - .test.tsx reserved for widget/component tests
+
+    Args:
+        urn: Acceptance URN
+        tsx: Force .test.tsx if True, .test.ts if False. Defaults to None
+             which uses HARNESS == WIDGET to decide.
+
+    Returns:
+        Preact TypeScript test filename
+    """
+    parts = parse_acceptance_urn(urn)
+    slug_part = f"_{kebab_to_snake(parts['slug'])}" if parts['slug'] else ""
+    use_tsx = tsx if tsx is not None else parts['HARNESS'] == "WIDGET"
+    suffix = ".test.tsx" if use_tsx else ".test.ts"
+    return f"{parts['WMBT']}_{parts['HARNESS']}_{parts['NNN']}{slug_part}{suffix}"
+
+
+def python_filename(urn: str) -> str:
+    """
+    Generate Python test filename from acceptance URN.
+
+    Pattern: test_{wmbt_lower}_{harness_lower}_{nnn}[_{slug_snake}].py
+    - Prefix "test_" required by pytest
+    - All components lowercase
+    - Underscore separators
+    - Slug converted to snake_case
+
+    Args:
+        urn: Acceptance URN
+
+    Returns:
+        Python test filename
+
+    Example:
+        >>> python_filename("acc:maintain-ux:C004-E2E-019-user-connection")
+        'test_c004_e2e_019_user_connection.py'
+    """
+    parts = parse_acceptance_urn(urn)
+    slug_part = f"_{kebab_to_snake(parts['slug'])}" if parts['slug'] else ""
+    return f"test_{parts['WMBT'].lower()}_{parts['HARNESS'].lower()}_{parts['NNN']}{slug_part}.py"
+
+
+def go_filename(urn: str) -> str:
+    """
+    Generate Go test filename from acceptance URN.
+
+    Pattern: {wmbt_lower}_{harness_lower}_{nnn}[_{slug_snake}]_test.go
+    - All components lowercase
+    - Underscore separators
+    - Slug converted to snake_case
+
+    Args:
+        urn: Acceptance URN
+
+    Returns:
+        Go test filename
+
+    Example:
+        >>> go_filename("acc:maintain-ux:C004-E2E-019-user-connection")
+        'c004_e2e_019_user_connection_test.go'
+    """
+    parts = parse_acceptance_urn(urn)
+    slug_part = f"_{kebab_to_snake(parts['slug'])}" if parts['slug'] else ""
+    return f"{parts['WMBT'].lower()}_{parts['HARNESS'].lower()}_{parts['NNN']}{slug_part}_test.go"
+
+
+def java_classname(urn: str) -> str:
+    """
+    Generate Java/Kotlin test classname from acceptance URN.
+
+    Pattern: {WMBT}{HARNESS}{NNN}{SlugPascal}Test
+    - WMBT and HARNESS uppercase
+    - Slug converted to PascalCase
+    - No separators
+    - Suffix "Test"
+
+    Args:
+        urn: Acceptance URN
+
+    Returns:
+        Java/Kotlin test classname
+
+    Example:
+        >>> java_classname("acc:maintain-ux:C004-E2E-019-user-connection")
+        'C004E2E019UserConnectionTest'
+    """
+    parts = parse_acceptance_urn(urn)
+    slug_part = kebab_to_pascal(parts['slug']) if parts['slug'] else ""
+    return f"{parts['WMBT']}{parts['HARNESS']}{parts['NNN']}{slug_part}Test"
+
+
+def generate_test_filename(urn: str, language: str) -> str:
+    """
+    Generate test filename for specified language from acceptance URN.
+
+    Unified interface that routes to language-specific generators.
+
+    Args:
+        urn: Acceptance URN
+        language: Target language (dart, typescript, typescript_preact, python, go, java, kotlin)
+
+    Returns:
+        Test filename for specified language
+
+    Raises:
+        ValueError: If language is not supported
+
+    Example:
+        >>> generate_test_filename("acc:maintain-ux:C004-E2E-019", "python")
+        'test_c004_e2e_019.py'
+    """
+    generators = {
+        'dart': dart_filename,
+        'typescript': typescript_filename,
+        'typescript_preact': typescript_preact_filename,
+        'python': python_filename,
+        'go': go_filename,
+        'java': lambda urn: java_classname(urn) + ".java",
+        'kotlin': lambda urn: java_classname(urn) + ".kt",
+    }
+
+    if language not in generators:
+        raise ValueError(f"Unsupported language: {language}")
+
+    return generators[language](urn)
+
+
+# Export all public functions
+__all__ = [
+    'URN_PATTERN',
+    'parse_acceptance_urn',
+    'kebab_to_snake',
+    'kebab_to_pascal',
+    'dart_filename',
+    'typescript_filename',
+    'typescript_preact_filename',
+    'python_filename',
+    'go_filename',
+    'java_classname',
+    'generate_test_filename',
+]

atdd/tester/validators/cleanup_duplicate_headers.py

@@ -0,0 +1,116 @@
+#!/usr/bin/env python3
+"""
+Script to clean up duplicate header comments.
+
+Some files have duplicate headers after the automated fix - this removes the old headers
+and keeps only the new standardized ones.
+"""
+
+import re
+from pathlib import Path
+
+
+REPO_ROOT = Path(__file__).resolve().parents[4]
+PYTHON_DIR = REPO_ROOT / "python"
+
+
+def clean_duplicate_headers(content: str) -> tuple[str, bool]:
+    """
+    Remove duplicate header comments, keeping only the first URN header.
+
+    Returns:
+        (cleaned_content, was_changed)
+    """
+    lines = content.split('\n')
+    new_lines = []
+    found_first_urn = False
+    skip_mode = False
+    skip_count = 0
+
+    for i, line in enumerate(lines):
+        # Check if this is a URN header
+        if re.match(r'^#\s*URN:', line, re.IGNORECASE):
+            if not found_first_urn:
+                # This is the first URN header - keep it
+                found_first_urn = True
+                new_lines.append(line)
+            else:
+                # This is a duplicate URN header - start skipping
+                skip_mode = True
+                skip_count = 1  # Skip this line
+                continue
+
+        # If in skip mode, skip header-like lines after duplicate URN
+        if skip_mode:
+            # Check if this looks like a header comment
+            if line.startswith('#') and not line.strip().startswith('# urn:'):
+                skip_count += 1
+                continue
+            else:
+                # End of duplicate header block
+                skip_mode = False
+
+        new_lines.append(line)
+
+    cleaned = '\n'.join(new_lines)
+    was_changed = skip_count > 0
+
+    return cleaned, was_changed
+
+
+def find_test_files() -> list:
+    """Find all Python test files."""
+    if not PYTHON_DIR.exists():
+        return []
+
+    test_files = []
+    for py_file in PYTHON_DIR.rglob("test_*.py"):
+        if '__pycache__' in str(py_file) or 'conftest' in py_file.name:
+            continue
+        test_files.append(py_file)
+
+    return test_files
+
+
+def main():
+    """Clean up duplicate headers in all test files."""
+    test_files = find_test_files()
+
+    if not test_files:
+        print("No test files found")
+        return
+
+    print(f"Checking {len(test_files)} test files for duplicate headers")
+    print("=" * 80)
+
+    cleaned_count = 0
+
+    for test_file in sorted(test_files):
+        try:
+            with open(test_file, 'r', encoding='utf-8') as f:
+                original_content = f.read()
+        except Exception as e:
+            print(f"❌ {test_file.relative_to(REPO_ROOT)}")
+            print(f"   ERROR: Could not read: {e}")
+            continue
+
+        cleaned_content, was_changed = clean_duplicate_headers(original_content)
+
+        if was_changed:
+            try:
+                with open(test_file, 'w', encoding='utf-8') as f:
+                    f.write(cleaned_content)
+                rel_path = test_file.relative_to(REPO_ROOT)
+                print(f"✅ {rel_path}")
+                print(f"   Removed duplicate header comments")
+                cleaned_count += 1
+            except Exception as e:
+                print(f"❌ {test_file.relative_to(REPO_ROOT)}")
+                print(f"   ERROR: Could not write: {e}")
+
+    print("=" * 80)
+    print(f"Cleaned {cleaned_count} files")
+
+
+if __name__ == "__main__":
+    main()

atdd/tester/validators/cleanup_duplicate_headers_v2.py

@@ -0,0 +1,135 @@
+#!/usr/bin/env python3
+"""
+Script to clean up duplicate header comments - Version 2.
+
+This version removes ALL old header-style comments after the first URN,
+keeping only the new standardized header at the top.
+"""
+
+import re
+from pathlib import Path
+
+
+REPO_ROOT = Path(__file__).resolve().parents[4]
+PYTHON_DIR = REPO_ROOT / "python"
+
+
+def clean_file_content(content: str) -> tuple[str, bool]:
+    """
+    Clean up file by removing duplicate/old headers.
+
+    Strategy:
+    1. Find first URN line (this is our canonical header start)
+    2. After canonical header block ends, remove any old URN/header lines
+    3. Keep the module docstring and code
+
+    Returns:
+        (cleaned_content, was_changed)
+    """
+    lines = content.split('\n')
+
+    # Find first URN line index
+    first_urn_idx = None
+    for i, line in enumerate(lines):
+        if re.match(r'^#\s*URN:', line, re.IGNORECASE):
+            first_urn_idx = i
+            break
+
+    if first_urn_idx is None:
+        # No URN found, return as-is
+        return content, False
+
+    # Find end of first header block (after first URN)
+    header_end_idx = first_urn_idx
+    for i in range(first_urn_idx + 1, len(lines)):
+        line = lines[i]
+        # Continue while we see header comments or empty lines
+        if line.startswith('#') or line.strip() == '':
+            header_end_idx = i
+        else:
+            break
+
+    # Now scan for and remove duplicate header lines after header_end_idx
+    clean_lines = lines[:header_end_idx + 1]
+    was_changed = False
+
+    for i in range(header_end_idx + 1, len(lines)):
+        line = lines[i]
+
+        # Skip duplicate URN lines (any case)
+        if re.match(r'^#\s*[uU][rR][nN]:', line):
+            was_changed = True
+            continue
+
+        # Skip duplicate Runtime/Rationale lines after first header
+        if re.match(r'^#\s*Runtime:', line):
+            was_changed = True
+            continue
+
+        if re.match(r'^#\s*Rationale:', line):
+            was_changed = True
+            continue
+
+        # Keep everything else
+        clean_lines.append(line)
+
+    cleaned = '\n'.join(clean_lines)
+    return cleaned, was_changed
+
+
+def find_test_files() -> list:
+    """Find all Python test files."""
+    if not PYTHON_DIR.exists():
+        return []
+
+    test_files = []
+    for py_file in PYTHON_DIR.rglob("test_*.py"):
+        if '__pycache__' in str(py_file) or 'conftest' in py_file.name:
+            continue
+        test_files.append(py_file)
+
+    return test_files
+
+
+def main():
+    """Clean up duplicate headers in all test files."""
+    test_files = find_test_files()
+
+    if not test_files:
+        print("No test files found")
+        return
+
+    print(f"Checking {len(test_files)} test files for duplicate headers")
+    print("=" * 80)
+
+    cleaned_count = 0
+
+    for test_file in sorted(test_files):
+        try:
+            with open(test_file, 'r', encoding='utf-8') as f:
+                original_content = f.read()
+        except Exception as e:
+            print(f"❌ {test_file.relative_to(REPO_ROOT)}")
+            print(f"   ERROR: Could not read: {e}")
+            continue
+
+        cleaned_content, was_changed = clean_file_content(original_content)
+
+        if was_changed:
+            try:
+                with open(test_file, 'w', encoding='utf-8') as f:
+                    f.write(cleaned_content)
+                rel_path = test_file.relative_to(REPO_ROOT)
+                print(f"✅ {rel_path}")
+                print(f"   Removed duplicate header comments")
+                cleaned_count += 1
+            except Exception as e:
+                print(f"❌ {test_file.relative_to(REPO_ROOT)}")
+                print(f"   ERROR: Could not write: {e}")
+
+    print("=" * 80)
+    print(f"Cleaned {cleaned_count} files")
+
+
+if __name__ == "__main__":
+    main()

atdd/tester/validators/conftest.py

@@ -0,0 +1,5 @@
+"""
+Shared fixtures for tester tests.
+"""
+# Import all shared fixtures from coach via absolute import
+from atdd.coach.validators.shared_fixtures import *