Skip to content

Commit 3ccf68c

Browse files
committed
fix(analyzer): scope hierarchy qualnames, JSON export path resolution & CWD-independent translations (bugsweep 2026-10-30)
1 parent 335a349 commit 3ccf68c

4 files changed

Lines changed: 194 additions & 14 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,22 @@ Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.1.0/).
55

66
## [Unreleased]
77

8+
### Bugsweep: Scope-Hierarchie, Multi-Local Kollision & Exportpfad-Resilienz (2026-10-30)
9+
- **ImportScopeAnalyzer Scope-Hierarchie & Multi-Local Kollisionsauflösung (`MethodenAnalyser3.py`)**:
10+
- `_assign_imports` verwendet nun qualifizierte Scope-Pfade (`qual_scope = ".".join(name for _, name in self.scope_stack)`) anstelle des reinen Funktionsnamens.
11+
- Verhindert Scope-Kollisionen gleichnamiger Methoden in unterschiedlichen Klassen (z.B. `Worker1.run` vs. `Worker2.run`) oder geschachtelter Funktionen.
12+
- Lokale Imports in unterschiedlichen Klassen/Methoden werden nun zuverlässig als `multi_local` erkannt und nicht fälschlich in einem Scope zusammengeführt.
13+
- **CLI & JSON Exportpfad-Resilienz (`MethodenAnalyser3.py`)**:
14+
- `_resolve_json_export_path` implementiert: Verzeichnisse und Pfade mit abschließendem Schrägstrich (`/` oder `\`) werden automatisch um `DEFAULT_JSON_REPORT_NAME` (`methodenanalyser-report-v1.json`) ergänzt.
15+
- Verhindert `PermissionError: [WinError 5] Zugriff verweigert` beim Export in existierende Zielordner.
16+
- `_write_cli_json_if_requested` prüft Pfadkollisionen und schützt Quelldateien zuverlässig vor dem Überschreiben.
17+
- **CWD-unabhängige Übersetzungsprüfung (`manage_translations.py`)**:
18+
- `manage_translations.py` lokalisiert `locales/translations.json` nun relativ zu `APP_DIR` anstatt zum aktuellen Arbeitsverzeichnis (`CWD`).
19+
- Ermöglicht fehlerfreie Ausführung von `manage_translations.py --check` und `--stats` aus beliebigen Pfaden.
20+
- **Automatisierte Regressionstests (`tests/test_bugsweep_scope_hierarchy_and_export_resilience_20261030.py`)**:
21+
- 6 neue hermetische Regressionstests für Multi-Class-Scope-Kollisionen, getrennte Imports in unterschiedlichen Methoden, geschachtelte Hilfsfunktionen, Directory- und Slash-Exportpfade sowie CWD-unabhängigen CLI-Lauf.
22+
23+
824
### Repository-Hygiene, CI-Matrix-Härtung & PEP 621 Metadaten (Pfad A, 2026-10-29)
925
- **CI-Matrix-Härtung (`.github/workflows/tests.yml`)**:
1026
- Vervollständigung der CI-Matrix auf allen drei Zielplattformen (`windows-2025-vs2026`, `ubuntu-latest`, `macos-26`) um Python 3.10 und 3.12 (gehärtete 12-fach Matrix über Python 3.10, 3.11, 3.12 und 3.13).

‎MethodenAnalyser3.py‎

Lines changed: 23 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -394,15 +394,16 @@ def visit_AsyncFunctionDef(self, node: ast.AsyncFunctionDef) -> None:
394394
self.scope_stack.pop()
395395

396396
def _assign_imports(self, names: set[str]) -> None:
397-
"""Ordnet Imports dem aktuellen Scope zu."""
397+
"""Ordnet Imports dem aktuellen Scope zu (qualifizierter Pfad gegen Kollisionen)."""
398398
if not self.scope_stack:
399399
self.top_level |= names
400400
else:
401-
scope_type, scope_name = self.scope_stack[-1]
401+
scope_type, _ = self.scope_stack[-1]
402+
qual_scope = ".".join(name for _, name in self.scope_stack)
402403
if scope_type == "class":
403-
self.class_level[scope_name] |= names
404+
self.class_level[qual_scope] |= names
404405
elif scope_type == "func":
405-
self.method_level[scope_name] |= names
406+
self.method_level[qual_scope] |= names
406407

407408

408409
class CodeAnalyzer(ast.NodeVisitor):
@@ -2083,10 +2084,22 @@ def _safe_relpath(p: str) -> str:
20832084
return report
20842085

20852086

2087+
def _resolve_json_export_path(output_path: str) -> str:
2088+
"""
2089+
Löst einen Exportpfad robust auf: Verzeichnisse und Pfade mit Slash
2090+
werden automatisch mit DEFAULT_JSON_REPORT_NAME ergänzt.
2091+
"""
2092+
clean = output_path.strip()
2093+
if clean.endswith(("/", "\\")) or (os.path.exists(clean) and os.path.isdir(clean)):
2094+
return os.path.join(clean, DEFAULT_JSON_REPORT_NAME)
2095+
return clean
2096+
2097+
20862098
def write_json_report(report: dict[str, Any], output_path: str) -> str:
20872099
"""Veröffentlicht einen vollständigen JSON-Report per atomarem Dateitausch."""
2100+
resolved_path = _resolve_json_export_path(output_path)
20882101
data = (json.dumps(report, indent=2, ensure_ascii=False) + "\n").encode("utf-8")
2089-
return _write_report_bytes(data, output_path)
2102+
return _write_report_bytes(data, resolved_path)
20902103

20912104

20922105
def _write_report_bytes(
@@ -2822,16 +2835,17 @@ def _write_cli_json_if_requested(
28222835
if not output_path:
28232836
return True
28242837
try:
2825-
target = os.path.normcase(os.path.realpath(output_path))
2838+
resolved_path = _resolve_json_export_path(output_path)
2839+
target = os.path.normcase(os.path.realpath(resolved_path))
28262840
for source in protected_paths or []:
28272841
same_path = target == os.path.normcase(os.path.realpath(source))
28282842
same_file = (
2829-
os.path.exists(output_path) and os.path.exists(source)
2830-
and os.path.samefile(output_path, source)
2843+
os.path.exists(resolved_path) and os.path.exists(source)
2844+
and os.path.samefile(resolved_path, source)
28312845
)
28322846
if same_path or same_file:
28332847
raise ValueError("JSON-Ausgabe darf keine analysierte Quelldatei ersetzen.")
2834-
written_path = write_json_report(report, output_path)
2848+
written_path = write_json_report(report, resolved_path)
28352849
except Exception as exc: # noqa: BLE001 -- CLI boundary reports export failures and returns a failure result
28362850
print(f"[FEHLER] {_t('cli_json_export_failed')}: {exc}", file=sys.stderr)
28372851
return False

‎manage_translations.py‎

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
import re
1717
import sys
1818

19+
APP_DIR = os.path.dirname(os.path.abspath(__file__))
1920
TRANSLATION_FILE = os.path.join("locales", "translations.json")
2021
SUPPORTED_LANGUAGES = ["de", "en", "es", "zh", "ja", "ru"]
2122

@@ -63,8 +64,10 @@ def find_german_strings(source_dir):
6364
return german_strings
6465

6566

66-
def check_translations(source_dir="."):
67+
def check_translations(source_dir=None):
6768
"""Prüft ob alle Übersetzungen für alle 6 Sprachen vollständig vorhanden sind."""
69+
if source_dir is None:
70+
source_dir = APP_DIR
6871
trans_file = os.path.join(source_dir, TRANSLATION_FILE)
6972
if not os.path.exists(trans_file):
7073
print(f"[!] Datei nicht gefunden: {trans_file}")
@@ -104,8 +107,10 @@ def check_translations(source_dir="."):
104107
return True
105108

106109

107-
def show_stats(source_dir="."):
110+
def show_stats(source_dir=None):
108111
"""Zeigt Statistiken über die Übersetzungen an."""
112+
if source_dir is None:
113+
source_dir = APP_DIR
109114
trans_file = os.path.join(source_dir, TRANSLATION_FILE)
110115
if not os.path.exists(trans_file):
111116
print(f"[!] Datei nicht gefunden: {trans_file}")
@@ -130,7 +135,9 @@ def show_stats(source_dir="."):
130135
print(f" {lang.upper()}: {count}/{total} ({pct:.1f}%)")
131136

132137

133-
def manage_translations(source_dir="."):
138+
def manage_translations(source_dir=None):
139+
if source_dir is None:
140+
source_dir = APP_DIR
134141
trans_file = os.path.join(source_dir, TRANSLATION_FILE)
135142

136143
if os.path.exists(trans_file):
@@ -172,12 +179,12 @@ def manage_translations(source_dir="."):
172179
if __name__ == "__main__":
173180
parser = argparse.ArgumentParser(description="Verwalte und prüfe Übersetzungen für MethodenAnalyser.")
174181
parser.add_argument("pos_dir", nargs="?", default=None, help="Projektverzeichnis (optional)")
175-
parser.add_argument("--dir", dest="source_dir", default=".", help="Projektverzeichnis")
182+
parser.add_argument("--dir", dest="source_dir", default=None, help="Projektverzeichnis")
176183
parser.add_argument("--check", action="store_true", help="Vollständigkeit der 6 Sprachen prüfen und Exit-Code setzen")
177184
parser.add_argument("--stats", action="store_true", help="Übersetzungs-Statistiken anzeigen")
178185
args = parser.parse_args()
179186

180-
target_dir = args.pos_dir if args.pos_dir else args.source_dir
187+
target_dir = args.pos_dir if args.pos_dir else (args.source_dir if args.source_dir else APP_DIR)
181188

182189
if args.check:
183190
ok = check_translations(target_dir)
Lines changed: 143 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,143 @@
1+
"""
2+
Regressionstests: Bugsweep 2026-10-30 — Scope-Hierarchie, Multi-Local Kollision & Exportpfad-Resilienz.
3+
"""
4+
5+
from __future__ import annotations
6+
7+
import os
8+
import subprocess
9+
import sys
10+
import tempfile
11+
from pathlib import Path
12+
13+
ROOT = Path(__file__).resolve().parents[1]
14+
if str(ROOT) not in sys.path:
15+
sys.path.insert(0, str(ROOT))
16+
17+
import MethodenAnalyser3 as m3
18+
19+
20+
def test_multi_local_distinct_classes_same_method_name():
21+
"""
22+
Methoden mit demselben Namen in unterschiedlichen Klassen (z.B. Worker1.run und Worker2.run)
23+
dürfen nicht im selben Scope-Schlüssel kollidieren.
24+
Wenn math in beiden lokal importiert wird, MUSS math in multi_local erkannt werden.
25+
"""
26+
code = """
27+
class Worker1:
28+
def run(self):
29+
import math
30+
return math.sqrt(4)
31+
32+
class Worker2:
33+
def run(self):
34+
import math
35+
return math.ceil(5.5)
36+
"""
37+
result = m3.analyze_source(code, "test_multi_class.py")
38+
multi_local = result.import_scopes.get("multi_local", [])
39+
assert "math" in multi_local, (
40+
f"math wurde nicht in multi_local erkannt (Kollision auf 'run'): {result.import_scopes}"
41+
)
42+
43+
44+
def test_distinct_methods_in_different_classes_do_not_mix_imports():
45+
"""
46+
Wenn Worker1.run 'json' und Worker2.run 'sqlite3' importiert, dürfen diese
47+
nicht in einem gemeinsamen Methoden-Scope vermengt werden.
48+
"""
49+
code = """
50+
class Worker1:
51+
def run(self):
52+
import json
53+
return json.dumps({})
54+
55+
class Worker2:
56+
def run(self):
57+
import sqlite3
58+
return sqlite3.connect(":memory:")
59+
"""
60+
result = m3.analyze_source(code, "test_distinct_imports.py")
61+
multi_local = result.import_scopes.get("multi_local", [])
62+
assert "json" not in multi_local
63+
assert "sqlite3" not in multi_local
64+
65+
66+
def test_nested_function_scopes_qualified_names():
67+
"""
68+
Geschachtelte Funktionen mit gleichem Namen in verschiedenen Funktionen
69+
(outer1.helper vs outer2.helper) werden als getrennte Scopes geführt.
70+
"""
71+
code = """
72+
def outer1():
73+
def helper():
74+
import re
75+
return re.compile(r"abc")
76+
return helper()
77+
78+
def outer2():
79+
def helper():
80+
import re
81+
return re.compile(r"xyz")
82+
return helper()
83+
"""
84+
result = m3.analyze_source(code, "test_nested_helper.py")
85+
multi_local = result.import_scopes.get("multi_local", [])
86+
assert "re" in multi_local, (
87+
f"re wurde nicht in multi_local für geschachtelte helper() erkannt: {result.import_scopes}"
88+
)
89+
90+
91+
def test_write_json_report_to_existing_directory_resolves_default_filename():
92+
"""
93+
Wenn write_json_report ein existierendes Verzeichnis als Ziel erhält,
94+
darf kein PermissionError ausgelöst werden; der Report muss als
95+
<dir>/methodenanalyser-report-v1.json gespeichert werden.
96+
"""
97+
with tempfile.TemporaryDirectory() as td:
98+
dir_target = os.path.join(td, "export_dir")
99+
os.makedirs(dir_target, exist_ok=True)
100+
report_data = {
101+
"schema_version": m3.JSON_SCHEMA_VERSION,
102+
"tool_version": m3.TOOL_VERSION,
103+
"source_kind": "snippet",
104+
"summary": {},
105+
}
106+
written = m3.write_json_report(report_data, dir_target)
107+
assert os.path.isfile(written)
108+
assert os.path.basename(written) == m3.DEFAULT_JSON_REPORT_NAME
109+
assert Path(written).parent.resolve() == Path(dir_target).resolve()
110+
111+
112+
def test_write_json_report_trailing_slash_creates_directory():
113+
"""
114+
Ein Pfad mit abschließendem Schrägstrich (z.B. 'sub/reports/') signalisiert
115+
ein Verzeichnisziel und muss zu <path>/methodenanalyser-report-v1.json aufgelöst werden.
116+
"""
117+
with tempfile.TemporaryDirectory() as td:
118+
slash_target = os.path.join(td, "sub_reports") + "/"
119+
report_data = {
120+
"schema_version": m3.JSON_SCHEMA_VERSION,
121+
"tool_version": m3.TOOL_VERSION,
122+
"source_kind": "snippet",
123+
"summary": {},
124+
}
125+
written = m3.write_json_report(report_data, slash_target)
126+
assert os.path.isfile(written)
127+
assert os.path.basename(written) == m3.DEFAULT_JSON_REPORT_NAME
128+
129+
130+
def test_manage_translations_check_outside_repo_cwd():
131+
"""
132+
manage_translations.py --check muss auch bei Ausführung aus einem fremden
133+
Arbeitsverzeichnis (CWD) ohne Fehler die translations.json finden und 0 zurückgeben.
134+
"""
135+
manage_py = ROOT / "manage_translations.py"
136+
with tempfile.TemporaryDirectory() as foreign_cwd:
137+
res = subprocess.run(
138+
[sys.executable, str(manage_py), "--check"],
139+
cwd=foreign_cwd,
140+
capture_output=True,
141+
text=True,
142+
)
143+
assert res.returncode == 0, f"Fehler bei fremdem CWD: {res.stdout}\n{res.stderr}"

0 commit comments

Comments
 (0)