Update Modules/_docstrings.py

Modules/_docstrings.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import inspect
+import re
 from typing import Any, Annotated, get_args, get_origin, get_type_hints
 
 
@@ -16,9 +17,45 @@ def _typename(tp: Any) -> str:
         return str(tp)
 
 
+def _parse_string_annotation(annot_str: str) -> tuple[str | None, str | None]:
+    """
+    Parse a string annotation like "Annotated[Optional[str], 'description']"
+    and extract the base type name and the description metadata.
+    
+    Returns (base_type_name, description) or (None, None) if parsing fails.
+    """
+    if not isinstance(annot_str, str):
+        return None, None
+    
+    # Match Annotated[..., 'description'] or Annotated[..., "description"]
+    # Pattern: Annotated[<base_type>, '<description>'] or with double quotes
+    match = re.match(
+        r"^Annotated\[(.+?),\s*['\"](.+?)['\"]\s*\]$",
+        annot_str.strip(),
+        re.DOTALL,
+    )
+    if match:
+        base_type_str = match.group(1).strip()
+        description = match.group(2)
+        # Simplify Optional[X] -> just the base type for display
+        opt_match = re.match(r"^Optional\[(.+)\]$", base_type_str)
+        if opt_match:
+            base_type_str = opt_match.group(1).strip()
+        return base_type_str, description
+    
+    return None, None
+
+
 def _extract_base_and_meta(annotation: Any) -> tuple[Any, str | None]:
     """Given an annotation, return (base_type, first string metadata) if Annotated, else (annotation, None)."""
     try:
+        # Handle string annotations from PEP 563 (__future__.annotations)
+        if isinstance(annotation, str):
+            base_str, meta = _parse_string_annotation(annotation)
+            if meta:
+                return base_str or annotation, meta
+            return annotation, None
+        
         if get_origin(annotation) is Annotated:
             args = get_args(annotation)
             base = args[0] if args else annotation