codeui-python 0.1.0__py3-none-any.whl

codeui/report/markdown_emitter.py

@@ -0,0 +1,33 @@
+"""Markdown defect report emitter."""
+from typing import Any
+from codeui.core.graph import Graph
+
+class MarkdownEmitter:
+    """Emits human-readable Markdown defect summary reports.
+    Example:
+        >>> g = Graph()
+        >>> emitter = MarkdownEmitter()
+        >>> report = emitter.emit(g)
+        >>> '# codeui Defect Report' in report
+        True
+    """
+    def emit(self, graph: Graph) -> str:
+        """Convert graph findings to formatted Markdown document.
+        Example:
+            >>> g = Graph()
+            >>> emitter = MarkdownEmitter()
+            >>> isinstance(emitter.emit(g), str)
+            True
+        """
+        lines = [
+            "# codeui Defect Report",
+            "",
+            f"Total Files Analyzed: {len(graph.get_all_files())}",
+            f"Total Defect Findings: {len(graph.get_findings())}",
+            "",
+            "| Rule ID | Severity | File | Message | Fix Hint |",
+            "| --- | --- | --- | --- | --- |",
+        ]
+        for f in graph.get_findings():
+            lines.append(f"| {f.rule_id} | {f.severity} | `{f.location.file_id}:{f.location.start_line}` | {f.message} | {f.fix_hint or '-'} |")
+        return "\n".join(lines)

codeui/report/sarif_emitter.py

@@ -0,0 +1,56 @@
+"""SARIF 2.1.0 format report emitter."""
+import json
+from typing import Any, Dict
+from codeui.core.graph import Graph
+
+class SARIFEmitter:
+    """Emits OASIS SARIF v2.1.0 standard report format for CI integrations.
+    Example:
+        >>> g = Graph()
+        >>> emitter = SARIFEmitter()
+        >>> sarif = emitter.emit(g)
+        >>> '$schema' in sarif
+        True
+    """
+    def emit(self, graph: Graph) -> str:
+        """Convert graph findings into SARIF v2.1.0 JSON string.
+        Example:
+            >>> g = Graph()
+            >>> emitter = SARIFEmitter()
+            >>> isinstance(emitter.emit(g), str)
+            True
+        """
+        results = []
+        for f in graph.get_findings():
+            level = "error" if str(f.severity) == "error" else ("warning" if str(f.severity) == "warning" else "note")
+            results.append({
+                "ruleId": f.rule_id,
+                "level": level,
+                "message": {"text": f.message},
+                "locations": [{
+                    "physicalLocation": {
+                        "artifactLocation": {"uri": f.location.file_id},
+                        "region": {
+                            "startLine": f.location.start_line,
+                            "startColumn": f.location.start_col + 1,
+                            "endLine": f.location.end_line,
+                            "endColumn": f.location.end_col + 1,
+                        },
+                    }
+                }],
+            })
+        payload = {
+            "$schema": "https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json",
+            "version": "2.1.0",
+            "runs": [{
+                "tool": {
+                    "driver": {
+                        "name": "codeui",
+                        "version": "0.1.0",
+                        "informationUri": "https://codeui.dev",
+                    }
+                },
+                "results": results,
+            }],
+        }
+        return json.dumps(payload, sort_keys=True, indent=2)

codeui/server/__init__.py

@@ -0,0 +1 @@
+"""Localhost HTTP server package for codeui visualizer and API."""