sourcecode 0.17.0__py3-none-any.whl → 0.19.0__py3-none-any.whl

sourcecode/__init__.py

@@ -1,3 +1,3 @@
 """sourcecode — Genera mapas de contexto estructurado para agentes IA."""
 
-__version__ = "0.17.0"
+__version__ = "0.19.0"

sourcecode/cli.py

@@ -260,6 +260,14 @@ def main(
     file_tree = filter_sensitive_files(raw_tree)
     detector = ProjectDetector(build_default_detectors())
     workspace_analysis = WorkspaceAnalyzer().analyze(target, manifests)
+
+    # --compact implicitly enables lightweight analysis passes so that
+    # dependency_summary, env_summary and code_notes_summary are never null.
+    if compact:
+        dependencies = True
+        env_map = True
+        code_notes = True
+
     dependency_analyzer = DependencyAnalyzer() if dependencies else None
     graph_analyzer = GraphAnalyzer() if graph_modules else None
     parsed_graph_edges = (

sourcecode/dependency_analyzer.py

@@ -47,6 +47,7 @@ class DependencyAnalyzer:
         ecosystems: set[str] = set()
         sources: set[str] = set()
         limitations: list[str] = []
+        all_dependencies: list[DependencyRecord] = []
         for summary in summaries:
             result.total_count += summary.total_count
             result.direct_count += summary.direct_count
@@ -56,9 +57,11 @@ class DependencyAnalyzer:
             for limitation in summary.limitations:
                 if limitation not in limitations:
                     limitations.append(limitation)
+            all_dependencies.extend(summary.dependencies)
         result.ecosystems = sorted(ecosystems)
         result.sources = sorted(sources)
         result.limitations = limitations
+        result.dependencies = all_dependencies
         return result
 
     def _build_summary(
@@ -80,6 +83,7 @@ class DependencyAnalyzer:
             ecosystems=ecosystems,
             sources=sources,
             limitations=unique_limitations,
+            dependencies=list(records),
         )
 
     def _dedupe(self, records: Iterable[DependencyRecord]) -> list[DependencyRecord]:

sourcecode/detectors/java.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import re
 from pathlib import Path
 from xml.etree import ElementTree
 
@@ -13,6 +14,14 @@ from sourcecode.detectors.parsers import read_text_lines, unique_strings
 from sourcecode.schema import FrameworkDetection
 from sourcecode.tree_utils import flatten_file_tree
 
+_MAX_FILE_SIZE = 256 * 1024  # 256 KB
+_MAX_JAVA_ENTRY_SCAN = 200
+_MAX_ANNOTATION_ENTRY_POINTS = 20
+
+_REST_CONTROLLER_RE = re.compile(r'@(?:Rest)?Controller\b')
+_WEB_FILTER_RE = re.compile(r'@WebFilter\b')
+_FILTER_BEAN_RE = re.compile(r'FilterRegistrationBean\b')
+
 
 class JavaDetector(AbstractDetector):
     name = "java"
@@ -67,15 +76,103 @@ class JavaDetector(AbstractDetector):
         return frameworks
 
     def _collect_entry_points(self, context: DetectionContext) -> list[EntryPoint]:
-        candidates = [
-            path
-            for path in flatten_file_tree(context.file_tree)
-            if path.endswith(("Application.java", "Main.java"))
+        all_paths = flatten_file_tree(context.file_tree)
+        all_java = [p for p in all_paths if p.endswith(".java")]
+
+        # 1. @SpringBootApplication entry: Application.java / Main.java by name
+        app_candidates = [
+            p for p in all_java
+            if p.endswith(("Application.java", "Main.java"))
         ]
-        return [
-            EntryPoint(path=path, stack="java", kind="application", source="manifest")
-            for path in unique_strings(candidates)
+        entry_points: list[EntryPoint] = [
+            EntryPoint(path=p, stack="java", kind="application", source="manifest")
+            for p in unique_strings(app_candidates)
+        ]
+
+        # 2. Annotation-based scan: @RestController, @WebFilter, FilterRegistrationBean
+        scan_candidates = [
+            p for p in all_java
+            if "/test/" not in p and "/tests/" not in p
+        ][:_MAX_JAVA_ENTRY_SCAN]
+
+        annotation_eps: list[EntryPoint] = []
+        for rel_path in scan_candidates:
+            if len(annotation_eps) >= _MAX_ANNOTATION_ENTRY_POINTS:
+                break
+            abs_path = context.root / rel_path
+            annotation_eps.extend(self._scan_java_file_for_entry_points(abs_path, rel_path))
+        entry_points.extend(annotation_eps)
+
+        # 3. web.xml servlet/filter declarations
+        web_xml_paths = [
+            p for p in all_paths
+            if p.endswith("web.xml") and "WEB-INF" in p
         ]
+        for rel_path in web_xml_paths[:1]:
+            abs_path = context.root / rel_path
+            entry_points.extend(self._parse_web_xml(abs_path, rel_path))
+
+        # Deduplicate by (path, kind)
+        seen: set[tuple[str, str]] = set()
+        unique_eps: list[EntryPoint] = []
+        for ep in entry_points:
+            key = (ep.path, ep.kind)
+            if key not in seen:
+                seen.add(key)
+                unique_eps.append(ep)
+        return unique_eps
+
+    def _scan_java_file_for_entry_points(self, abs_path: Path, rel_path: str) -> list[EntryPoint]:
+        try:
+            if abs_path.stat().st_size > _MAX_FILE_SIZE:
+                return []
+            content = abs_path.read_text(encoding="utf-8", errors="replace")
+        except OSError:
+            return []
+
+        # Quick pre-filter before running regexes
+        if "Controller" not in content and "Filter" not in content:
+            return []
+
+        if _REST_CONTROLLER_RE.search(content):
+            return [EntryPoint(
+                path=rel_path, stack="java", kind="http_handler",
+                source="annotation", confidence="high",
+            )]
+        if _WEB_FILTER_RE.search(content):
+            return [EntryPoint(
+                path=rel_path, stack="java", kind="filter",
+                source="annotation", confidence="high",
+            )]
+        if _FILTER_BEAN_RE.search(content):
+            return [EntryPoint(
+                path=rel_path, stack="java", kind="filter",
+                source="annotation", confidence="medium",
+            )]
+        return []
+
+    def _parse_web_xml(self, abs_path: Path, rel_path: str) -> list[EntryPoint]:
+        try:
+            tree = ElementTree.parse(abs_path)
+        except (OSError, ElementTree.ParseError):
+            return []
+
+        root = tree.getroot()
+        ns_match = re.match(r"\{[^}]+\}", root.tag)
+        ns = ns_match.group(0) if ns_match else ""
+
+        results: list[EntryPoint] = []
+        if root.findall(f".//{ns}servlet-class"):
+            results.append(EntryPoint(
+                path=rel_path, stack="java", kind="servlet",
+                source="xml_config", confidence="high",
+            ))
+        if root.findall(f".//{ns}filter-class"):
+            results.append(EntryPoint(
+                path=rel_path, stack="java", kind="filter",
+                source="xml_config", confidence="high",
+            ))
+        return results
 
     def _dedupe_frameworks(self, frameworks: list[FrameworkDetection]) -> list[FrameworkDetection]:
         seen: set[str] = set()

sourcecode/env_analyzer.py

@@ -25,6 +25,12 @@ _ENV_EXAMPLE_NAMES = {
     "example.env", "sample.env",
 }
 
+# Spring Boot application.properties / application.yml and their profile variants
+_SPRING_CONF_BASE = {"application.properties", "application.yml", "application.yaml"}
+_SPRING_CONF_PROFILE_RE = re.compile(r'^application-[a-z0-9_-]+\.(properties|ya?ml)$', re.IGNORECASE)
+# Matches ${ENV_VAR} or ${ENV_VAR:default} where ENV_VAR is UPPER_SNAKE_CASE
+_SPRING_ENV_REF_RE = re.compile(r'\$\{([A-Z][A-Z0-9_]*)(?::[^}]*)?\}')
+
 # (pattern_id, compiled_regex)
 # Grupos de captura: group(1)=key, group(2)=default si existe
 _PATTERNS: list[tuple[str, re.Pattern]] = [
@@ -55,6 +61,9 @@ _PATTERNS: list[tuple[str, re.Pattern]] = [
     ("java_getenv", re.compile(
         r"""System\.getenv\(\s*["']([A-Z][A-Z0-9_]*)["']\s*\)"""
     )),
+    ("java_spring_value", re.compile(
+        r"""@Value\(\s*["']\$\{([A-Z][A-Z0-9_]*)(?::[^}]*)?\}["']\s*\)"""
+    )),
     ("php_getenv", re.compile(
         r"""getenv\(\s*["']([A-Z][A-Z0-9_]*)["']\s*\)"""
     )),
@@ -188,6 +197,23 @@ def _parse_env_example(
     return results
 
 
+def _parse_spring_config(
+    path: Path,
+    rel_path: str,
+    findings: dict,
+) -> None:
+    """Parse application.properties / application.yml looking for ${ENV_VAR} refs."""
+    try:
+        content = path.read_text(encoding="utf-8", errors="replace")
+    except OSError:
+        return
+
+    for m in _SPRING_ENV_REF_RE.finditer(content):
+        key = m.group(1)
+        line_num = content.count("\n", 0, m.start()) + 1
+        findings[key].append((f"{rel_path}:{line_num}", None))
+
+
 class EnvAnalyzer:
     """Extrae el mapa de variables de entorno del proyecto."""
 
@@ -298,11 +324,16 @@ class EnvAnalyzer:
                 self._walk(root, entry, findings, example_entries, example_files_found, limitations)
             elif entry.is_file():
                 rel = entry.relative_to(root).as_posix()
+                name_lower = name.lower()
                 # .env.example and similar
                 if name in _ENV_EXAMPLE_NAMES:
                     example_files_found.append(rel)
                     example_entries.extend(_parse_env_example(entry, rel))
                     continue
+                # Spring Boot application.properties / application.yml (incl. profiles)
+                if name_lower in _SPRING_CONF_BASE or _SPRING_CONF_PROFILE_RE.match(name_lower):
+                    _parse_spring_config(entry, rel, findings)
+                    continue
                 # Source code files
                 suffix = entry.suffix.lower()
                 if suffix in _CODE_EXTENSIONS:

sourcecode/schema.py

@@ -96,6 +96,7 @@ class DependencySummary:
     ecosystems: list[str] = field(default_factory=list)
     sources: list[str] = field(default_factory=list)
     limitations: list[str] = field(default_factory=list)
+    dependencies: list["DependencyRecord"] = field(default_factory=list)
 
 
 @dataclass

sourcecode/serializer.py

@@ -74,6 +74,7 @@ def compact_view(sm: SourceMap) -> dict[str, Any]:
     dep_summary_dict: Any = None
     if sm.dependency_summary is not None and sm.dependency_summary.requested:
         dep_summary_dict = asdict(sm.dependency_summary)
+        dep_summary_dict.pop("dependencies", None)
 
     env_summary_dict: Any = None
     if sm.env_summary is not None and sm.env_summary.requested:

{sourcecode-0.17.0.dist-info → sourcecode-0.19.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 0.17.0
+Version: 0.19.0
 Summary: Genera un mapa de contexto estructurado de proyectos de software para agentes IA
 License: MIT
 Requires-Python: >=3.9

{sourcecode-0.17.0.dist-info → sourcecode-0.19.0.dist-info}/RECORD

@@ -1,22 +1,22 @@
-sourcecode/__init__.py,sha256=kGV-7biOu1jEQzo70FiCy-DkYFbItVMEkqxy37z-zJ8,100
+sourcecode/__init__.py,sha256=K3oF2tC36Se4IiYU6MvNhrg4EoK_jaLeik_nUWPID4Y,100
 sourcecode/architecture_analyzer.py,sha256=zxgqeqn2FhIUDn06X-whjGKiXbrHFkRlzZcr2zKd0Gw,16874
 sourcecode/architecture_summary.py,sha256=r9IciS9z-7h8xpiME7DKBLhLV36xzXtSzbZ1cRDWklo,11709
 sourcecode/classifier.py,sha256=fcp2wIq198wq3Rsh_bDmZIK_W5UI6FEL5oqm1RrQfpA,6846
-sourcecode/cli.py,sha256=_ihMuJjjwTr50M77kMafOVX0kY9hqrdvl8NUQ_h0cbc,25178
+sourcecode/cli.py,sha256=pB0NmyaH-gCrHCFlNxYSMfuArM6nitv6PyrMLkYKKRs,25429
 sourcecode/code_notes_analyzer.py,sha256=rRd8bFYV0krjlxxQV0wenwE9K7pVpUQSR7KvSvUQKw4,9226
 sourcecode/coverage_parser.py,sha256=q0LeZJaX1bnntLu-ImksdBsMlpsVmk_iUfSaB4eaJGo,19702
-sourcecode/dependency_analyzer.py,sha256=9BEAyLoBAS2R0twYkprJj_e0c83pzz9QPMRWKfinNn4,40948
+sourcecode/dependency_analyzer.py,sha256=KITti0XLHK3RvZGqAUseWnlFLXGFyv5FqvSK5R6PB1g,41147
 sourcecode/doc_analyzer.py,sha256=Ec3orx6vBKsh5cNM3-F4y2Got2KuKx8w3dErwtdtM-A,19891
-sourcecode/env_analyzer.py,sha256=_UTkAzHNxDgJVpSMviWcn9e2V5o-SAV_oF6xsLHDxfI,12206
+sourcecode/env_analyzer.py,sha256=JZxBOuIxnM0xw0IaJFL6LiPJBErL848L3XoTOHGBqZI,13554
 sourcecode/git_analyzer.py,sha256=S9PGt8RDasBQYQUsZh9-H_KWVlPvzwR4jgM7TKN9ZCk,7643
 sourcecode/graph_analyzer.py,sha256=cxl7Xb88aGxIVOCsatZJAE1CtgXGzIbJfqytV-9kkFs,45172
 sourcecode/metrics_analyzer.py,sha256=4uh11v-Q0gdrN87BOxuFWUym3N3AOkOuy21K5N8peB8,20126
 sourcecode/prepare_context.py,sha256=X43dEPe2cb7uMwlpQwVJMe0rQIZ0juaJ7H3F37sPbNc,5371
 sourcecode/redactor.py,sha256=xuGcadGEHaPw4qZXlMDvzMCsr4VOkdp3oBQptHyJk8c,2884
 sourcecode/scanner.py,sha256=Ga4jDRAOhkcwlRmlE2ko6cE39qKy0aI4iE1lGBWmAlk,6410
-sourcecode/schema.py,sha256=93IrVRLAbzksVfFzr6_FhFSPpKJVwgVoTBcov-jTVo8,15669
+sourcecode/schema.py,sha256=dnNdnQxJtBv0PRVWi6-xnpr16dj6IsUGbso9PeeEolA,15743
 sourcecode/semantic_analyzer.py,sha256=SRQSGJzEi4ZsGvb7U3qvnRiKHabz4hvIzCqiG92x9K8,79349
-sourcecode/serializer.py,sha256=IMU4lmr0FTDSTocws47abpJL01HH1cBK2UMGSUv00yo,13404
+sourcecode/serializer.py,sha256=edOfD25lUKkZ0gIjFcjqWmY4yHSnOKvudzNisvW_RYg,13456
 sourcecode/summarizer.py,sha256=2Yz5xJ1bhtJLlrUpKcd74wijypRRo9GJmGT8u971EW0,11572
 sourcecode/tree_utils.py,sha256=xla45Whq24j6U9kEgTztJXkMpmOEDieAulKxP3nl89s,935
 sourcecode/workspace.py,sha256=fQlVoNx8S-fSHpKoJ0JBvEHCFkxszH0KZVJed1i3TRk,6845
@@ -27,7 +27,7 @@ sourcecode/detectors/dotnet.py,sha256=UC-74VW850r3admcl36R-rl3M0-nBFXw8ph5e9RSas
 sourcecode/detectors/elixir.py,sha256=jCpvt5Yi6jvplc80ovRtWh17q-11ZGo9qX7o8b57TJE,1713
 sourcecode/detectors/go.py,sha256=KehAyvC3H_s8zwwqFM0bAbztQbbUBDjpNbGvM2kQlk8,1836
 sourcecode/detectors/heuristic.py,sha256=GvniuNzeCOzmKyY5Sd88_bmBnVrJE5O9cbs4NoEPBKY,1891
-sourcecode/detectors/java.py,sha256=xKM8n9UHZ4Dpc9tRL42wUBEIFmbFn8NRMhUVm8CTrjU,3513
+sourcecode/detectors/java.py,sha256=qFVpMy5mu490ENhutO1LV2Gidms4ZZUfNX5Qv5Qxh2I,7188
 sourcecode/detectors/jvm_ext.py,sha256=EgHJ5W8EE-ZTN9V607mVzohyKgZE8Mc2jCi-DF8RAZU,2616
 sourcecode/detectors/nodejs.py,sha256=cCK50aY7RERQUQ7FK2UmqVTVFAW3VksDxN6rYADtsC0,4498
 sourcecode/detectors/parsers.py,sha256=ugPg8yNUf0Ai1gA7Fnn6wAkYGFjTxRodSP3IeViYJJ4,2290
@@ -39,7 +39,7 @@ sourcecode/detectors/rust.py,sha256=V23NO6Y8NsrhrUlGC2feUEcNK63hf3gc1y3jI4tes1Q,
 sourcecode/detectors/systems.py,sha256=nYaKbGDFu0EOXFcd_1doWFT3tTUdkbxc2DjHUF5TcqQ,1627
 sourcecode/detectors/terraform.py,sha256=cxORPR_zVLOJpHlh4e9JnFpkQsn_UnqMMom5yG65hZ4,1693
 sourcecode/detectors/tooling.py,sha256=hIvop80No22pqyGVJ32NKliSdjkHRePQkIRroqG01bY,1875
-sourcecode-0.17.0.dist-info/METADATA,sha256=sbwLpqrcDu_SkhDmPOqsq5YIT4wPn8V00GF1DRRohoI,25900
-sourcecode-0.17.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-0.17.0.dist-info/entry_points.txt,sha256=voDtdlGU2-jR3wCZpQoOls_0eUKaDVCKIfajGHFDATs,50
-sourcecode-0.17.0.dist-info/RECORD,,
+sourcecode-0.19.0.dist-info/METADATA,sha256=cv1q6sPPTkTruEdpHr8JioUXmXuSec5dPAhAw9NXoW8,25900
+sourcecode-0.19.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-0.19.0.dist-info/entry_points.txt,sha256=voDtdlGU2-jR3wCZpQoOls_0eUKaDVCKIfajGHFDATs,50
+sourcecode-0.19.0.dist-info/RECORD,,