mcp-zen-of-languages: Instructions file for GitHub Copilot

Python 3.12+ Syntax Updates Summary

Changes Made

All files have been updated to use modern Python 3.12+ type hint syntax with | instead of Optional from typing.

✅ Updated Files

1. analyzer_refactored_base.py
2. analyzer_refactored_python.py
3. analyzer_refactored_extensions.py
4. rules_adapter_corrected.py

Syntax Changes

Before (Python 3.9 style):

from typing import Optional

def parse_code(self, code: str) -> Optional[ParserResult]:
    pass

def analyze(
    self,
    code: str,
    path: Optional[str] = None,
    other_files: Optional[dict[str, str]] = None,
) -> AnalysisResult:
    pass

class Config(BaseModel):
    max_nesting_depth: Optional[int] = None

After (Python 3.12+ style):

from __future__ import annotations  # Added when needed

def parse_code(self, code: str) -> ParserResult | None:
    pass

def analyze(
    self,
    code: str,
    path: str | None = None,
    other_files: dict[str, str] | None = None,
) -> AnalysisResult:
    pass

class Config(BaseModel):
    max_nesting_depth: int | None = None

Key Benefits

1. ✅ More Pythonic - Aligns with PEP 604 (Python 3.10+)
2. ✅ Cleaner syntax - No need to import Optional
3. ✅ Consistent - Matches the list[], dict[] syntax already used
4. ✅ Modern - Uses latest Python type hint features
5. ✅ Readable - str | None is more intuitive than Optional[str]

Examples Throughout Codebase

AnalysisContext (Pydantic Model):

class AnalysisContext(BaseModel):
    code: str
    path: str | None = None
    language: str
    ast_tree: ParserResult | None = None
    cyclomatic_summary: CyclomaticSummary | None = None
    maintainability_index: float | None = None
    dependency_analysis: object | None = None
    other_files: dict[str, str] | None = None
    repository_imports: dict[str, list[str]] | None = None

BaseAnalyzer Methods:

def __init__(self, config: AnalyzerConfig | None = None):
    ...

def parse_code(self, code: str) -> ParserResult | None:
    ...

def compute_metrics(
    self, code: str, ast_tree: ParserResult | None
) -> tuple[CyclomaticSummary | None, float | None, int]:
    ...