devcouncil 0.3.0 → 0.4.0

package/src/devcouncil/codeintel/resolution/frameworks/di.py

@@ -0,0 +1,56 @@
+"""Dependency-injection matcher families."""
+
+from __future__ import annotations
+
+from collections.abc import Iterator
+
+from devcouncil.codeintel.resolution.frameworks.base import (
+    FrameworkSpec,
+    ProviderMatch,
+    compile_pattern,
+)
+
+DI_SPECS = (
+    FrameworkSpec("python-di", "dependency-injection", compile_pattern(
+        r"\b(?:Depends|Inject)\s*\(\s*(?P<target>[A-Za-z_$][\w$.:]*)"
+    )),
+    FrameworkSpec("jvm-di", "dependency-injection", compile_pattern(
+        r"\b(?:Autowired|Provides|Binds|Singleton)\s*\(\s*"
+        r"(?P<target>[A-Za-z_$][\w$.:]*)"
+    )),
+    FrameworkSpec("dotnet-di", "dependency-injection", compile_pattern(
+        r"\b(?:AddSingleton|AddScoped|AddTransient)(?:<(?P<generic>[^>]+)>)?"
+        r"\s*\(\s*(?:new\s+)?(?P<target>[A-Za-z_$][\w$.:]*)?"
+    )),
+    FrameworkSpec("container-di", "dependency-injection", compile_pattern(
+        r"\b(?:bind|singleton|factory)\s*\(\s*(?P<target>[A-Za-z_$][\w$.:]*)"
+    )),
+    FrameworkSpec("wire-di", "dependency-injection", compile_pattern(
+        r"\bwire\.Build\s*\(\s*(?P<target>[A-Za-z_$][\w$.:]*)"
+    )),
+    FrameworkSpec("fx-di", "dependency-injection", compile_pattern(
+        r"\bfx\.Provide\s*\(\s*(?P<target>[A-Za-z_$][\w$.:]*)"
+    )),
+)
+
+
+def iter_provider_matches(line: str) -> Iterator[ProviderMatch]:
+    for spec in DI_SPECS:
+        for match in spec.pattern.finditer(line):
+            groups = match.groupdict()
+            generic_types = [
+                value.strip()
+                for value in (groups.get("generic") or "").split(",")
+                if value.strip()
+            ]
+            target = (
+                generic_types[-1]
+                if generic_types
+                else groups.get("target") or ""
+            )
+            if target:
+                yield ProviderMatch(
+                    framework=spec.name,
+                    target_expression=target,
+                    start=match.start(),
+                )

package/src/devcouncil/codeintel/resolution/frameworks/events.py

@@ -0,0 +1,45 @@
+"""Event-framework matchers with explicit registration operations."""
+
+from __future__ import annotations
+
+from collections.abc import Iterator
+
+from devcouncil.codeintel.resolution.frameworks.base import (
+    EventMatch,
+    FrameworkSpec,
+    compile_pattern,
+)
+
+EVENT_SPECS = (
+    FrameworkSpec("node-event-emitter", "event", compile_pattern(
+        r"\.(?P<operation>emit)\(\s*['\"](?P<event>[^'\"]+)['\"]"
+    )),
+    FrameworkSpec("react-native-event-emitter", "event", compile_pattern(
+        r"\.(?P<operation>sendEventWithName|sendEvent)"
+        r"\(\s*['\"](?P<event>[^'\"]+)['\"]"
+    )),
+    FrameworkSpec("node-event-listener", "event", compile_pattern(
+        r"\.(?P<operation>on|once)\(\s*['\"](?P<event>[^'\"]+)['\"]"
+        r"\s*,\s*(?P<callback>[A-Za-z_$][\w$]*)"
+    )),
+    FrameworkSpec("dom-event-listener", "event", compile_pattern(
+        r"\.(?P<operation>addListener|addEventListener)"
+        r"\(\s*['\"](?P<event>[^'\"]+)['\"]"
+        r"\s*,\s*(?P<callback>[A-Za-z_$][\w$]*)"
+    )),
+    FrameworkSpec("watchdog-observer", "event", compile_pattern(
+        r"\.(?P<operation>schedule)\(\s*(?P<callback>[A-Za-z_$][\w$]*)"
+    )),
+)
+
+
+def iter_event_matches(line: str) -> Iterator[EventMatch]:
+    for spec in EVENT_SPECS:
+        for match in spec.pattern.finditer(line):
+            groups = match.groupdict()
+            yield EventMatch(
+                operation=(groups.get("operation") or "").lower(),
+                event=groups.get("event") or spec.name,
+                callback_expression=groups.get("callback") or "",
+                start=match.start(),
+            )

package/src/devcouncil/codeintel/resolution/frameworks/routes.py

@@ -0,0 +1,88 @@
+"""Routing-framework matchers with no graph or liveness side effects."""
+
+from __future__ import annotations
+
+from collections.abc import Iterator
+
+from devcouncil.codeintel.resolution.frameworks.base import (
+    FrameworkSpec,
+    RouteMatch,
+    compile_pattern,
+)
+
+ROUTE_SPECS = (
+    FrameworkSpec("decorator", "routing", compile_pattern(
+        r"@(?:app|router|bp)\.(?P<verb>get|post|put|patch|delete|options|head)"
+        r"\(\s*['\"](?P<path>[^'\"]+)['\"](?P<handler>[^)]*)"
+    )),
+    FrameworkSpec("django", "routing", compile_pattern(
+        r"\b(?:path|re_path)\(\s*['\"](?P<path>[^'\"]+)['\"]"
+        r"\s*,\s*(?P<handler>[^,)]+)"
+    )),
+    FrameworkSpec("spring", "routing", compile_pattern(
+        r"@(?P<verb>Get|Post|Put|Patch|Delete|Request)Mapping"
+        r"\(\s*(?:value\s*=\s*)?['\"](?P<path>[^'\"]+)['\"](?P<handler>[^)]*)"
+    )),
+    FrameworkSpec("nest", "routing", compile_pattern(
+        r"@(?P<verb>Get|Post|Put|Patch|Delete|Options|Head|All)"
+        r"\(\s*['\"](?P<path>[^'\"]*)['\"]?(?P<handler>[^)]*)"
+    )),
+    FrameworkSpec("aspnet", "routing", compile_pattern(
+        r"\bMap(?P<verb>Get|Post|Put|Patch|Delete)"
+        r"\(\s*['\"](?P<path>[^'\"]+)['\"]\s*,?\s*(?P<handler>[^)]*)"
+    )),
+    FrameworkSpec("aspnet", "routing", compile_pattern(
+        r"\[Http(?P<verb>Get|Post|Put|Patch|Delete)"
+        r"\(\s*['\"](?P<path>[^'\"]*)['\"]?(?P<handler>[^)]*)"
+    )),
+    FrameworkSpec("laravel", "routing", compile_pattern(
+        r"\bRoute::(?P<verb>get|post|put|patch|delete|any)"
+        r"\(\s*['\"](?P<path>[^'\"]+)['\"]\s*,?\s*(?P<handler>.*)"
+    )),
+    FrameworkSpec("router", "routing", compile_pattern(
+        r"\b(?:app|router|r)\.(?P<verb>GET|POST|PUT|PATCH|DELETE|HandleFunc|route)"
+        r"\(\s*['\"](?P<path>[^'\"]+)['\"]\s*,?\s*(?P<handler>[^)]*)"
+    )),
+    FrameworkSpec("rails", "routing", compile_pattern(
+        r"^\s*(?P<verb>get|post|put|patch|delete)\s+['\"](?P<path>[^'\"]+)['\"]"
+        r"(?P<handler>.*)"
+    )),
+    FrameworkSpec("axum", "routing", compile_pattern(
+        r"\.route\(\s*['\"](?P<path>[^'\"]+)['\"]\s*,\s*"
+        r"(?P<verb>get|post|put|patch|delete)\s*\(\s*(?P<handler>[^)]*)"
+    )),
+    FrameworkSpec("play", "routing", compile_pattern(
+        r"^\s*(?P<verb>GET|POST|PUT|PATCH|DELETE)\s+(?P<path>/\S+)"
+        r"\s+(?P<handler>\S+)"
+    )),
+    FrameworkSpec("react-router", "routing", compile_pattern(
+        r"<Route\b[^>]*\bpath\s*=\s*['\"](?P<path>[^'\"]+)['\"]"
+        r"(?P<handler>[^>]*)"
+    )),
+    FrameworkSpec("vue-router", "routing", compile_pattern(
+        r"\{[^}\n]*\bpath\s*:\s*['\"](?P<path>/[^'\"]*)['\"]"
+        r"(?P<handler>[^}\n]*)"
+    )),
+    FrameworkSpec("drupal", "routing", compile_pattern(
+        r"^\s*path\s*:\s*['\"](?P<path>/[^'\"]*)['\"](?P<handler>.*)"
+    )),
+)
+
+COMPUTED_ROUTE_PATTERN = compile_pattern(
+    r"\b(?:app|router|bp|r)\.(?P<verb>get|post|put|patch|delete|route)"
+    r"\(\s*(?P<expr>[^,]+),\s*(?P<handler>[^)]*)"
+)
+
+
+def iter_route_matches(line: str) -> Iterator[RouteMatch]:
+    for spec in ROUTE_SPECS:
+        for match in spec.pattern.finditer(line):
+            groups = match.groupdict()
+            yield RouteMatch(
+                framework=spec.name,
+                verb=(groups.get("verb") or "ANY").upper(),
+                path=groups.get("path") or "",
+                handler_expression=(groups.get("handler") or "").strip(),
+                start=match.start(),
+                end=match.end(),
+            )