sayou-visualizer 0.0.3__py3-none-any.whl

sayou/visualizer/core/exceptions.py

@@ -0,0 +1,5 @@
+from sayou.core.exceptions import SayouCoreError
+
+
+class VisualizerError(SayouCoreError):
+    pass

sayou/visualizer/core/schemas.py

@@ -0,0 +1,17 @@
+from dataclasses import dataclass, field
+from typing import Any, Dict, Optional
+
+
+@dataclass
+class VisualizationTask:
+    data: Any
+    data_type: str
+    meta: Dict[str, Any] = field(default_factory=dict)
+    recommended_renderer: Optional[str] = None
+
+
+@dataclass
+class VisualizationResult:
+    success: bool
+    output_path: Optional[str] = None
+    error: Optional[str] = None

sayou/visualizer/interfaces/base_renderer.py

@@ -0,0 +1,24 @@
+from abc import abstractmethod
+
+from sayou.core.base_component import BaseComponent
+
+from ..core.schemas import VisualizationResult, VisualizationTask
+
+
+class BaseRenderer(BaseComponent):
+    component_name = "BaseRenderer"
+
+    def render(
+        self, task: VisualizationTask, output_path: str, **kwargs
+    ) -> VisualizationResult:
+        self._log(f"[{self.component_name}] Rendering to {output_path}...")
+        try:
+            return self._do_render(task, output_path, **kwargs)
+        except Exception as e:
+            return VisualizationResult(success=False, error=str(e))
+
+    @abstractmethod
+    def _do_render(
+        self, task: VisualizationTask, output_path: str, **kwargs
+    ) -> VisualizationResult:
+        raise NotImplementedError

sayou/visualizer/pipeline.py

@@ -0,0 +1,68 @@
+from sayou.core.base_component import BaseComponent
+
+from .renderer.pyvis_renderer import PyVisRenderer
+from .tracer.graph_tracer import GraphTracer
+from .tracer.rich_tracer import RichConsoleTracer
+from .tracer.websocket_tracer import WebSocketTracer
+
+
+class VisualizerPipeline(BaseComponent):
+    """
+    The main facade for Sayou Visualization.
+
+    It manages the internal Tracer (recording events) and Renderer (drawing graphs),
+    providing a simple interface for the user.
+    """
+
+    component_name = "VisualizerPipeline"
+
+    def __init__(self):
+        super().__init__()
+        self._graph_tracer = None
+        self._rich_tracer = None
+        self._ws_tracer = None
+        self._renderer = None
+
+    def attach_to(self, target_pipeline: BaseComponent, mode: str = "report", **kwargs):
+        """
+        Connects this visualizer to a target pipeline (Connector, Refinery, etc.).
+        """
+        if mode == "report":
+            self._graph_tracer = GraphTracer()
+            target_pipeline.add_callback(self._graph_tracer)
+            self._log("Attached GraphTracer for HTML reporting.")
+
+        elif mode == "live":
+            self._rich_tracer = RichConsoleTracer()
+            target_pipeline.add_callback(self._rich_tracer)
+            self._log("Attached RichConsoleTracer for live monitoring.")
+
+        elif mode == "websocket":
+            url = kwargs.get("url")
+            if not url:
+                raise ValueError("WebSocket mode requires a 'url' parameter.")
+
+            self._ws_tracer = WebSocketTracer(server_url=url)
+            target_pipeline.add_callback(self._ws_tracer)
+            self._log(f"Attached WebSocketTracer to {url}")
+
+    def report(self, output_path: str = "report.html", **kwargs):
+        if self._graph_tracer.graph.number_of_nodes() == 0:
+            self._log("No events recorded. The graph is empty.", level="warning")
+            return
+
+        self._log(
+            f"Generating report with {self._graph_tracer.graph.number_of_nodes()} nodes..."
+        )
+        self._renderer = PyVisRenderer()
+        self._renderer.render(self._graph_tracer.graph, output_path, **kwargs)
+
+    def save_live_log(self, output_path="live_status.html"):
+        if self._rich_tracer:
+            self._rich_tracer.save_html(output_path)
+            self._log(f"Live log saved to: {output_path}")
+        else:
+            self._log(
+                "RichTracer is not active. Use attach_to(..., mode='live')",
+                level="warning",
+            )

sayou/visualizer/renderer/pyvis_renderer.py

@@ -0,0 +1,80 @@
+from pyvis.network import Network
+from sayou.core.base_component import BaseComponent
+
+
+class PyVisRenderer(BaseComponent):
+    component_name = "PyVisRenderer"
+
+    def render(self, graph, output_path="pipeline_report.html"):
+        net = Network(
+            height="100vh",
+            width="100%",
+            bgcolor="#1e1e1e",
+            font_color="#c7c7c7",
+            directed=True,
+        )
+        net.from_nx(graph)
+
+        net.set_options(
+            """
+        var options = {
+            "nodes": {
+                "borderWidth": 0,
+                "borderWidthSelected": 2,
+                "shadow": {
+                    "enabled": true,
+                    "color": "rgba(0,0,0,0.5)",
+                    "size": 10,
+                    "x": 5,
+                    "y": 5
+                },
+                "font": {
+                    "face": "Roboto, Helvetica, Arial",
+                    "size": 14,
+                    "color": "#ffffff",
+                    "strokeWidth": 0,
+                    "strokeColor": "#ffffff"
+                }
+            },F
+            "edges": {
+                "color": {
+                    "color": "#505050",
+                    "highlight": "#ffffff",
+                    "hover": "#ffffff",
+                    "opacity": 0.5
+                },
+                "arrows": {
+                    "to": { "enabled": true, "scaleFactor": 0.5 }
+                },
+                "smooth": {
+                    "type": "continuous",
+                    "roundness": 0.5
+                }
+            },
+            "physics": {
+                "forceAtlas2Based": {
+                    "gravitationalConstant": -80,
+                    "centralGravity": 0.005,
+                    "springLength": 150,
+                    "springConstant": 0.18,
+                    "damping": 0.9
+                },
+                "maxVelocity": 40,
+                "minVelocity": 0.75,
+                "solver": "forceAtlas2Based",
+                "stabilization": {
+                    "enabled": true,
+                    "iterations": 1000,
+                    "updateInterval": 25
+                }
+            },
+            "interaction": {
+                "hover": true,
+                "tooltipDelay": 200
+            }
+        }
+        """
+        )
+
+        net.save_graph(output_path)
+        self._log(f"Visualization saved to: {output_path}")

sayou/visualizer/tracer/graph_tracer.py

@@ -0,0 +1,94 @@
+import networkx as nx
+from sayou.core.callbacks import BaseCallback
+
+
+class GraphTracer(BaseCallback):
+    def __init__(self):
+        self.graph = nx.DiGraph()
+        self.graph.add_node(
+            "Root",
+            label="Sayou Pipeline",
+            color="#ffffff",
+            shape="dot",
+            size=25,
+            font={"size": 20, "color": "black"},
+        )
+
+    def on_start(self, component_name, input_data, **kwargs):
+        try:
+            comp_node = f"Comp:{component_name}"
+
+            color = "#a5b1c2"
+            size = 15
+
+            if "ConnectorPipeline" in component_name:
+                color = "#ffffff"
+                size = 20
+            elif "Generator" in component_name:
+                color = "#00d2d3"
+                size = 15
+            elif "Fetcher" in component_name:
+                color = "#ff9f43"
+                size = 15
+
+            if not self.graph.has_node(comp_node):
+                self.graph.add_node(
+                    comp_node, label=component_name, shape="dot", color=color, size=size
+                )
+
+                if "Pipeline" in component_name:
+                    self.graph.add_edge("Root", comp_node)
+                else:
+                    parent = "Comp:ConnectorPipeline"
+                    if not self.graph.has_node(parent):
+                        parent = "Root"
+                    self.graph.add_edge(parent, comp_node)
+
+            data_id = self._get_data_id(input_data)
+            if data_id:
+                label_text = str(data_id)
+                if len(label_text) > 25:
+                    label_text = label_text[:22] + "..."
+
+                node_id = f"Data:{data_id}"
+                if not self.graph.has_node(node_id):
+                    self.graph.add_node(
+                        node_id,
+                        label=label_text,
+                        title=str(data_id),
+                        shape="dot",
+                        size=8,
+                        color={"background": "#57606f", "border": "#57606f"},
+                    )
+
+                self.graph.add_edge(comp_node, node_id)
+
+        except Exception as e:
+            print(f"!!! TRACER ERROR: {e}")
+
+    def on_finish(self, component_name, result_data, success, **kwargs):
+        try:
+            data_id = self._get_data_id_from_result(result_data)
+            if data_id:
+                node_id = f"Data:{data_id}"
+                if self.graph.has_node(node_id):
+                    color = "#54a0ff" if success else "#ff6b6b"
+                    self.graph.nodes[node_id]["color"] = color
+                    self.graph.nodes[node_id]["size"] = 10
+        except Exception as e:
+            print(f"!!! TRACER ERROR in on_finish: {e}")
+            pass
+
+    def _get_data_id(self, data):
+        if isinstance(data, dict):
+            return data.get("source") or data.get("uri")
+        if hasattr(data, "uri"):
+            return data.uri
+        if hasattr(data, "source"):
+            return data.source
+        return None
+
+    def _get_data_id_from_result(self, data):
+        if hasattr(data, "task") and hasattr(data.task, "uri"):
+            return data.task.uri
+        return None

sayou/visualizer/tracer/rich_tracer.py

@@ -0,0 +1,65 @@
+from rich.console import Console
+from rich.live import Live
+from rich.panel import Panel
+from rich.spinner import Spinner
+from rich.tree import Tree
+from sayou.core.callbacks import BaseCallback
+
+
+class RichConsoleTracer(BaseCallback):
+    def __init__(self):
+        self.root_tree = Tree("🚀 [bold white]Pipeline Started[/]")
+        self.comp_branches = {}
+        self.live = Live(self.render_panel(), refresh_per_second=4)
+        self.record_console = Console(record=True)
+
+    def render_panel(self):
+        return Panel(
+            self.root_tree, title="Sayou Fabric - Live Status", border_style="blue"
+        )
+
+    def on_start(self, component_name, input_data, **kwargs):
+        if not self.live.is_started:
+            self.live.start()
+
+        if component_name not in self.comp_branches:
+            if "ConnectorPipeline" in component_name:
+                branch = self.root_tree
+            else:
+                icon = "💎" if "Generator" in component_name else "⚡"
+                branch = self.root_tree.add(f"{icon} [bold cyan]{component_name}[/]")
+
+            self.comp_branches[component_name] = branch
+
+        branch = self.comp_branches[component_name]
+        data_id = self._get_simple_id(input_data)
+
+        if data_id:
+            branch.add(f"[yellow]Processing:[/] {data_id}")
+            self.live.refresh()
+
+    def on_finish(self, component_name, result_data, success, **kwargs):
+        # 완료 시점 처리 (여기서는 단순화를 위해 색상 변경 등은 생략하고 로그처럼 쌓이게 둠)
+        # 고도화 시: Tree의 마지막 노드를 찾아서 아이콘을 ✅로 변경 가능
+        pass
+
+    def on_error(self, component_name, error, **kwargs):
+        branch = self.comp_branches.get(component_name, self.root_tree)
+        branch.add(f"❌ [bold red]Error:[/] {str(error)}")
+        self.live.refresh()
+
+    def stop(self):
+        self.root_tree.add("✅ [bold green]Finished[/]")
+        self.live.stop()
+
+    def _get_simple_id(self, data):
+        if isinstance(data, dict):
+            return data.get("source")
+        if hasattr(data, "uri"):
+            return data.uri
+        return None
+
+    def save_html(self, filename="live_log.html"):
+        self.record_console.print(self.render_panel())
+        self.record_console.save_html(filename)
+        self.record_console.save_svg(filename.replace(".html", ".svg"))

sayou/visualizer/tracer/websocket_tracer.py

@@ -0,0 +1,60 @@
+import json
+import queue
+import threading
+
+import websocket
+from sayou.core.callbacks import BaseCallback
+
+
+class WebSocketTracer(BaseCallback):
+
+    def __init__(self, server_url: str):
+        self.server_url = server_url
+        self.queue = queue.Queue()
+        self.running = True
+
+        self.worker_thread = threading.Thread(target=self._sender_loop, daemon=True)
+        self.worker_thread.start()
+
+    def on_start(self, component_name, input_data, **kwargs):
+        payload = {
+            "type": "START",
+            "component": component_name,
+            "data": self._serialize(input_data),
+        }
+        self.queue.put(payload)
+
+    def on_finish(self, component_name, result_data, success, **kwargs):
+        payload = {
+            "type": "FINISH",
+            "component": component_name,
+            "success": success,
+            "data": self._serialize(result_data),
+        }
+        self.queue.put(payload)
+
+    def _sender_loop(self):
+        ws = None
+        try:
+            ws = websocket.create_connection(self.server_url)
+
+            while self.running:
+                try:
+                    payload = self.queue.get(timeout=1.0)
+
+                    ws.send(json.dumps(payload))
+
+                except queue.Empty:
+                    continue
+        except Exception as e:
+            print(f"!!! WebSocket Connection Error: {e}")
+        finally:
+            if ws:
+                ws.close()
+
+    def _serialize(self, data):
+        if hasattr(data, "uri"):
+            return data.uri
+        if isinstance(data, dict):
+            return str(data)
+        return str(data)

sayou_visualizer-0.0.3.dist-info/METADATA

@@ -0,0 +1,294 @@
+Metadata-Version: 2.4
+Name: sayou-visualizer
+Version: 0.0.3
+Summary: Connector components for the Sayou Data Platform
+Project-URL: Homepage, https://www.sayouzone.com/
+Project-URL: Documentation, https://sayouzone.github.io/sayou-fabric/
+Project-URL: Repository, https://github.com/sayouzone/sayou-fabric
+Author-email: Sayouzone <contact@sayouzone.com>
+License:                                  Apache License
+                                   Version 2.0, January 2004
+                                http://www.apache.org/licenses/
+        
+           TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+        
+           1. Definitions.
+        
+              "License" shall mean the terms and conditions for use, reproduction,
+              and distribution as defined by Sections 1 through 9 of this document.
+        
+              "Licensor" shall mean the copyright owner or entity authorized by
+              the copyright owner that is granting the License.
+        
+              "Legal Entity" shall mean the union of the acting entity and all
+              other entities that control, are controlled by, or are under common
+              control with that entity. For the purposes of this definition,
+              "control" means (i) the power, direct or indirect, to cause the
+              direction or management of such entity, whether by contract or
+              otherwise, or (ii) ownership of fifty percent (50%) or more of the
+              outstanding shares, or (iii) beneficial ownership of such entity.
+        
+              "You" (or "Your") shall mean an individual or Legal Entity
+              exercising permissions granted by this License.
+        
+              "Source" form shall mean the preferred form for making modifications,
+              including but not limited to software source code, documentation
+              source, and configuration files.
+        
+              "Object" form shall mean any form resulting from mechanical
+              transformation or translation of a Source form, including but
+              not limited to compiled object code, generated documentation,
+              and conversions to other media types.
+        
+              "Work" shall mean the work of authorship, whether in Source or
+              Object form, made available under the License, as indicated by a
+              copyright notice that is included in or attached to the work
+              (an example is provided in the Appendix below).
+        
+              "Derivative Works" shall mean any work, whether in Source or Object
+              form, that is based on (or derived from) the Work and for which the
+              editorial revisions, annotations, elaborations, or other modifications
+              represent, as a whole, an original work of authorship. For the purposes
+              of this License, Derivative Works shall not include works that remain
+              separable from, or merely link (or bind by name) to the interfaces of,
+              the Work and Derivative Works thereof.
+        
+              "Contribution" shall mean any work of authorship, including
+              the original version of the Work and any modifications or additions
+              to that Work or Derivative Works thereof, that is intentionally
+              submitted to Licensor for inclusion in the Work by the copyright owner
+              or by an individual or Legal Entity authorized to submit on behalf of
+              the copyright owner. For the purposes of this definition, "submitted"
+              means any form of electronic, verbal, or written communication sent
+              to the Licensor or its representatives, including but not limited to
+              communication on electronic mailing lists, source code control systems,
+              and issue tracking systems that are managed by, or on behalf of, the
+              Licensor for the purpose of discussing and improving the Work, but
+              excluding communication that is conspicuously marked or otherwise
+              designated in writing by the copyright owner as "Not a Contribution."
+        
+              "Contributor" shall mean Licensor and any individual or Legal Entity
+              on behalf of whom a Contribution has been received by Licensor and
+              subsequently incorporated within the Work.
+        
+           2. Grant of Copyright License. Subject to the terms and conditions of
+              this License, each Contributor hereby grants to You a perpetual,
+              worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+              copyright license to reproduce, prepare Derivative Works of,
+              publicly display, publicly perform, sublicense, and distribute the
+              Work and such Derivative Works in Source or Object form.
+        
+           3. Grant of Patent License. Subject to the terms and conditions of
+              this License, each Contributor hereby grants to You a perpetual,
+              worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+              (except as stated in this section) patent license to make, have made,
+              use, offer to sell, sell, import, and otherwise transfer the Work,
+              where such license applies only to those patent claims licensable
+              by such Contributor that are necessarily infringed by their
+              Contribution(s) alone or by combination of their Contribution(s)
+              with the Work to which such Contribution(s) was submitted. If You
+              institute patent litigation against any entity (including a
+              cross-claim or counterclaim in a lawsuit) alleging that the Work
+              or a Contribution incorporated within the Work constitutes direct
+              or contributory patent infringement, then any patent licenses
+              granted to You under this License for that Work shall terminate
+              as of the date such litigation is filed.
+        
+           4. Redistribution. You may reproduce and distribute copies of the
+              Work or Derivative Works thereof in any medium, with or without
+              modifications, and in Source or Object form, provided that You
+              meet the following conditions:
+        
+              (a) You must give any other recipients of the Work or
+                  Derivative Works a copy of this License; and
+        
+              (b) You must cause any modified files to carry prominent notices
+                  stating that You changed the files; and
+        
+              (c) You must retain, in the Source form of any Derivative Works
+                  that You distribute, all copyright, patent, trademark, and
+                  attribution notices from the Source form of the Work,
+                  excluding those notices that do not pertain to any part of
+                  the Derivative Works; and
+        
+              (d) If the Work includes a "NOTICE" text file as part of its
+                  distribution, then any Derivative Works that You distribute must
+                  include a readable copy of the attribution notices contained
+                  within such NOTICE file, excluding those notices that do not
+                  pertain to any part of the Derivative Works, in at least one
+                  of the following places: within a NOTICE text file distributed
+                  as part of the Derivative Works; within the Source form or
+                  documentation, if provided along with the Derivative Works; or,
+                  within a display generated by the Derivative Works, if and
+                  wherever such third-party notices normally appear. The contents
+                  of the NOTICE file are for informational purposes only and
+                  do not modify the License. You may add Your own attribution
+                  notices within Derivative Works that You distribute, alongside
+                  or as an addendum to the NOTICE text from the Work, provided
+                  that such additional attribution notices cannot be construed
+                  as modifying the License.
+        
+              You may add Your own copyright statement to Your modifications and
+              may provide additional or different license terms and conditions
+              for use, reproduction, or distribution of Your modifications, or
+              for any such Derivative Works as a whole, provided Your use,
+              reproduction, and distribution of the Work otherwise complies with
+              the conditions stated in this License.
+        
+           5. Submission of Contributions. Unless You explicitly state otherwise,
+              any Contribution intentionally submitted for inclusion in the Work
+              by You to the Licensor shall be under the terms and conditions of
+              this License, without any additional terms or conditions.
+              Notwithstanding the above, nothing herein shall supersede or modify
+              the terms of any separate license agreement you may have executed
+              with Licensor regarding such Contributions.
+        
+           6. Trademarks. This License does not grant permission to use the trade
+              names, trademarks, service marks, or product names of the Licensor,
+              except as required for reasonable and customary use in describing the
+              origin of the Work and reproducing the content of the NOTICE file.
+        
+           7. Disclaimer of Warranty. Unless required by applicable law or
+              agreed to in writing, Licensor provides the Work (and each
+              Contributor provides its Contributions) on an "AS IS" BASIS,
+              WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+              implied, including, without limitation, any warranties or conditions
+              of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+              PARTICULAR PURPOSE. You are solely responsible for determining the
+              appropriateness of using or redistributing the Work and assume any
+              risks associated with Your exercise of permissions under this License.
+        
+           8. Limitation of Liability. In no event and under no legal theory,
+              whether in tort (including negligence), contract, or otherwise,
+              unless required by applicable law (such as deliberate and grossly
+              negligent acts) or agreed to in writing, shall any Contributor be
+              liable to You for damages, including any direct, indirect, special,
+              incidental, or consequential damages of any character arising as a
+              result of this License or out of the use or inability to use the
+              Work (including but not limited to damages for loss of goodwill,
+              work stoppage, computer failure or malfunction, or any and all
+              other commercial damages or losses), even if such Contributor
+              has been advised of the possibility of such damages.
+        
+           9. Accepting Warranty or Additional Liability. While redistributing
+              the Work or Derivative Works thereof, You may choose to offer,
+              and charge a fee for, acceptance of support, warranty, indemnity,
+              or other liability obligations and/or rights consistent with this
+              License. However, in accepting such obligations, You may act only
+              on Your own behalf and on Your sole responsibility, not on behalf
+              of any other Contributor, and only if You agree to indemnify,
+              defend, and hold each Contributor harmless for any liability
+              incurred by, or claims asserted against, such Contributor by reason
+              of your accepting any such warranty or additional liability.
+        
+           END OF TERMS AND CONDITIONS
+        
+           APPENDIX: How to apply the Apache License to your work.
+        
+              To apply the Apache License to your work, attach the following
+              boilerplate notice, with the fields enclosed by brackets "[]"
+              replaced with your own identifying information. (Don't include
+              the brackets!)  The text should be enclosed in the appropriate
+              comment syntax for the file format. We also recommend that a
+              file or class name and description of purpose be included on the
+              same "printed page" as the copyright notice for easier
+              identification within third-party archives.
+        
+           Copyright [yyyy] [name of copyright owner]
+        
+           Licensed under the Apache License, Version 2.0 (the "License");
+           you may not use this file except in compliance with the License.
+           You may obtain a copy of the License at
+        
+               http://www.apache.org/licenses/LICENSE-2.0
+        
+           Unless required by applicable law or agreed to in writing, software
+           distributed under the License is distributed on an "AS IS" BASIS,
+           WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+           See the License for the specific language governing permissions and
+           limitations under the License.
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.9
+Requires-Dist: networkx~=3.4.2
+Requires-Dist: pyvis~=0.3.2
+Requires-Dist: rich~=14.2.0
+Requires-Dist: sayou-core~=0.2.2
+Requires-Dist: websocket-client~=1.9.0
+Description-Content-Type: text/markdown
+
+# sayou-visualizer
+
+[![PyPI version](https://img.shields.io/pypi/v/sayou-visualizer.svg?color=blue)](https://pypi.org/project/sayou-visualizer/)
+[![License](https://img.shields.io/badge/License-Apache%202.0-red.svg)](https://www.apache.org/licenses/LICENSE-2.0)
+
+**The Interactive Observability Engine for Sayou Fabric.**
+
+`sayou-visualizer` provides a transparent layer to monitor and visualize the execution flow of Sayou components. By attaching to any pipeline, it transforms invisible execution logs into intuitive, interactive **HTML Knowledge Graphs**.
+
+It separates the logic of **Observation** (Tracer) from **Presentation** (Renderer), allowing you to debug complex pipelines and visualize data lineage without modifying your core logic.
+
+## 💡 Core Philosophy
+
+**"Trace the Process, Render the Insight."**
+
+Observability should not be an afterthought. We decouple the responsibility into two roles:
+
+1. **Tracer (Recorder)**: The "Camera". It silently observes events (`on_start`, `on_finish`) from the pipeline via the Callback system and builds an internal graph structure.
+
+2. **Renderer (Painter)**: The "Canvas". It takes the recorded graph and generates human-readable artifacts (e.g., Interactive HTML, Static Images).
+
+This separation enables a Non-intrusive Monitoring experience, where visualization is just a plug-and-play feature.
+
+## 📦 Installation
+
+```bash
+pip install sayou-visualizer
+```
+
+## ⚡ Quick Start
+
+The `VisualizerPipeline` acts as a facade, easily attaching to other pipelines to generate reports.
+
+```python
+from sayou.connector.pipeline import ConnectorPipeline
+from sayou.visualizer.pipeline import VisualizerPipeline
+
+def main():
+    connector = ConnectorPipeline()
+
+    viz = VisualizerPipeline()
+    viz.attach_to(connector)
+
+    print("🚀 Running Pipeline...")
+    iterator = connector.run("http://example.com")
+    for packet in iterator:
+        print(f"Processed: {packet.task.uri}")
+
+    print("🎨 Generating Report...")
+    viz.report("examples/pipeline_flow.html")
+
+if __name__ == "__main__":
+    main()
+```
+
+## 🔑 Key Concepts
+
+### Tracers
+* **`GraphTracer`**: Listens to pipeline events and constructs a `NetworkX` Directed Acyclic Graph (DAG) in real-time. It distinguishes between Components (Generator/Fetcher) and Data (Tasks).
+
+### Renderers
+* **`PyVisRenderer`**: Converts the internal graph into an interactive HTML file powered by `Vis.js`. Features physics-based layout and modern dark UI.
+* **`RichRenderer`** (_Planned_): Displays a tree-structure summary directly in the console using the `Rich` library.
+
+## 🤝 Contributing
+
+We welcome contributions for new Renderers (e.g., `MatplotlibRenderer`, `StreamlitRenderer`) or specialized Tracers for new components!
+
+## 📜 License
+
+Apache 2.0 License © 2025 Sayouzone

sayou_visualizer-0.0.3.dist-info/RECORD

@@ -0,0 +1,11 @@
+sayou/visualizer/pipeline.py,sha256=vEpI3MniDU3wokFEDScoVXl7xPiAAU1eHO-Mv5FlSNY,2517
+sayou/visualizer/core/exceptions.py,sha256=Mk5UtIfim7i9688c4qAKP7kB1GpLPM29t94HbQM9fhw,99
+sayou/visualizer/core/schemas.py,sha256=qn44BINevFZF_ALBhh20DS4GyMo5HV3UzqY4UTh_p3A,381
+sayou/visualizer/interfaces/base_renderer.py,sha256=orllTXlqM4-wDemOWbcZX8zF708KOdWFgoqZh8MeAzE,760
+sayou/visualizer/renderer/pyvis_renderer.py,sha256=5lDM27i5KXJXh8X6H4NDCGZYUJJPggQ8wjN2ut02mzQ,2409
+sayou/visualizer/tracer/graph_tracer.py,sha256=QYztzA8sbW5hPOEnLU_rqNo3nZWt_RijahMg8IKmF0U,3199
+sayou/visualizer/tracer/rich_tracer.py,sha256=ik7J1P7AMTN47lkjMLE7iTlRuksUpwSKluvWdpY6kdQ,2406
+sayou/visualizer/tracer/websocket_tracer.py,sha256=OZLg4jTfuxp6IwDacmAACKZ_0FirZFhyLysqh9QyrJA,1626
+sayou_visualizer-0.0.3.dist-info/METADATA,sha256=6VGBaS8G9K4Bf5uihM1ySOwRlqlEPHd75-Ip3Kx5EIA,16679
+sayou_visualizer-0.0.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+sayou_visualizer-0.0.3.dist-info/RECORD,,

sayou_visualizer-0.0.3.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any