oracletrace 0.1.0__tar.gz

oracletrace-0.1.0/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: oracletrace
+Version: 0.1.0
+Summary: Simple logic path tracer
+Author: Kayk Caputo, André Gustavo
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: rich
+
+# OracleTrace
+
+**OracleTrace** is a simple logic path tracer for Python applications. It visualizes the execution flow of your code, helping you understand function calls and performance bottlenecks.
+
+## Installation
+
+```bash
+pip install oracletrace
+```
+
+## Usage
+
+Run `oracletrace` on your Python script:
+
+```bash
+oracletrace your_script.py
+```
+
+Or run it as a module:
+
+```bash
+python -m oracletrace.cli your_script.py
+```
+
+## Features
+
+- **Logic Flow Visualization**: See a tree structure of function calls.
+- **Performance Metrics**: View execution time and call counts for each function.
+- **Clean Output**: Filters out internal Python calls for better readability.
+
+## Requirements
+
+- Python >= 3.10
+- [rich](https://github.com/Textualize/rich)

oracletrace-0.1.0/README.md

@@ -0,0 +1,34 @@
+# OracleTrace
+
+**OracleTrace** is a simple logic path tracer for Python applications. It visualizes the execution flow of your code, helping you understand function calls and performance bottlenecks.
+
+## Installation
+
+```bash
+pip install oracletrace
+```
+
+## Usage
+
+Run `oracletrace` on your Python script:
+
+```bash
+oracletrace your_script.py
+```
+
+Or run it as a module:
+
+```bash
+python -m oracletrace.cli your_script.py
+```
+
+## Features
+
+- **Logic Flow Visualization**: See a tree structure of function calls.
+- **Performance Metrics**: View execution time and call counts for each function.
+- **Clean Output**: Filters out internal Python calls for better readability.
+
+## Requirements
+
+- Python >= 3.10
+- [rich](https://github.com/Textualize/rich)

oracletrace-0.1.0/oracletrace/__init__.py

@@ -0,0 +1,3 @@
+from .tracer import start_trace, stop_trace, show_results
+
+__all__ = ["start_trace", "stop_trace", "show_results"]

oracletrace-0.1.0/oracletrace/cli.py

@@ -0,0 +1,31 @@
+import sys
+import os
+import runpy
+from .tracer import start_trace, stop_trace, show_results
+
+def main():
+    if len(sys.argv) < 2:
+        print("Usage: oracletrace <file.py>")
+        return 1
+
+    target = sys.argv[1]
+
+    if not isinstance(target, str) or not os.path.exists(target):
+        print(f"Target not found: {target}")
+        return 1
+
+    target = os.path.abspath(target)
+    root = os.getcwd()
+    target_dir = os.path.dirname(target)
+    sys.path.insert(0, target_dir)
+
+
+    start_trace(root)
+    runpy.run_path(target, run_name="__main__")
+    stop_trace()
+    show_results()
+
+    return 0
+
+if __name__ == "__main__":
+    sys.exit(main())

oracletrace-0.1.0/oracletrace/tracer.py

@@ -0,0 +1,107 @@
+import sys
+import os
+import time
+from collections import defaultdict
+from rich.tree import Tree
+from rich import print
+
+_enabled = False
+_root_path = ""
+_call_stack = []  
+_func_calls = defaultdict(int)
+_func_time = defaultdict(float)
+_call_map = defaultdict(lambda: defaultdict(int))
+
+def _is_user_code(filename):
+    if not filename.startswith(_root_path):
+        return False
+    if "site-packages" in filename or "dist-packages" in filename:
+        return False
+    return True
+
+def _get_key(frame):
+    co_filename = frame.f_code.co_filename
+    if co_filename.startswith("<"):
+        return None
+    filename = os.path.abspath(co_filename)
+    if not _is_user_code(filename):
+        return None
+    rel_path = os.path.relpath(filename, _root_path)
+    return f"{rel_path}:{frame.f_code.co_name}"
+
+def _trace(frame, event, arg):
+    if not _enabled:
+        return
+    
+    if event == "call":
+        key = _get_key(frame)
+        if not key:
+            return
+        
+        caller = _call_stack[-1][1] if _call_stack else "<module>"
+        _call_map[caller][key] += 1
+        _func_calls[key] += 1
+        _call_stack.append((id(frame), key, time.perf_counter()))
+        
+    elif event == "return":
+        if not _call_stack:
+            return
+        
+        if id(frame) == _call_stack[-1][0]:
+            _, key, start = _call_stack.pop()
+            _func_time[key] += time.perf_counter() - start
+        else:
+            fid = id(frame)
+            found = False
+            for i in range(len(_call_stack) - 1, -1, -1):
+                if _call_stack[i][0] == fid:
+                    found = True
+                    break
+            
+            if found:
+                while _call_stack:
+                    top_fid, key, start = _call_stack.pop()
+                    _func_time[key] += time.perf_counter() - start
+                    if top_fid == fid:
+                        break
+
+def start_trace(root_dir):
+    global _enabled, _root_path, _call_stack, _func_calls, _func_time, _call_map
+    _root_path = os.path.abspath(root_dir)
+    _call_stack = []
+    _func_calls = defaultdict(int)
+    _func_time = defaultdict(float)
+    _call_map = defaultdict(lambda: defaultdict(int))
+    _enabled = True
+    sys.setprofile(_trace)
+
+def stop_trace():
+    global _enabled
+    _enabled = False
+    sys.setprofile(None)
+
+def show_results():
+    if not _func_calls:
+        print("[yellow]No calls traced.[/]")
+        return
+
+    print("\n[bold green]Logic Flow:[/]")
+    
+    tree = Tree("[bold yellow]<module>[/]")
+    
+    def add_nodes(parent_node, parent_key, current_path):
+        children = _call_map.get(parent_key, {})
+        sorted_children = sorted(children.items(), key=lambda x: _func_time[x[0]], reverse=True)
+        
+        for child_key, count in sorted_children:
+            total_time = _func_time[child_key]
+            if child_key in current_path:
+                parent_node.add(f"[red]↻ {child_key}[/] ({count}x)")
+                continue
+                
+            node_text = f"{child_key} [dim]({count}x, {total_time:.4f}s)[/]"
+            child_node = parent_node.add(node_text)
+            add_nodes(child_node, child_key, current_path | {child_key})
+
+    add_nodes(tree, "<module>", {"<module>"})
+    print(tree)

oracletrace-0.1.0/oracletrace.egg-info/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: oracletrace
+Version: 0.1.0
+Summary: Simple logic path tracer
+Author: Kayk Caputo, André Gustavo
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: rich
+
+# OracleTrace
+
+**OracleTrace** is a simple logic path tracer for Python applications. It visualizes the execution flow of your code, helping you understand function calls and performance bottlenecks.
+
+## Installation
+
+```bash
+pip install oracletrace
+```
+
+## Usage
+
+Run `oracletrace` on your Python script:
+
+```bash
+oracletrace your_script.py
+```
+
+Or run it as a module:
+
+```bash
+python -m oracletrace.cli your_script.py
+```
+
+## Features
+
+- **Logic Flow Visualization**: See a tree structure of function calls.
+- **Performance Metrics**: View execution time and call counts for each function.
+- **Clean Output**: Filters out internal Python calls for better readability.
+
+## Requirements
+
+- Python >= 3.10
+- [rich](https://github.com/Textualize/rich)

oracletrace-0.1.0/oracletrace.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+oracletrace/__init__.py
+oracletrace/cli.py
+oracletrace/tracer.py
+oracletrace.egg-info/PKG-INFO
+oracletrace.egg-info/SOURCES.txt
+oracletrace.egg-info/dependency_links.txt
+oracletrace.egg-info/entry_points.txt
+oracletrace.egg-info/requires.txt
+oracletrace.egg-info/top_level.txt

oracletrace-0.1.0/oracletrace.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

oracletrace-0.1.0/oracletrace.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+oracletrace = oracletrace.cli:main

oracletrace-0.1.0/oracletrace.egg-info/requires.txt

@@ -0,0 +1 @@
+rich

oracletrace-0.1.0/oracletrace.egg-info/top_level.txt

@@ -0,0 +1 @@
+oracletrace

oracletrace-0.1.0/pyproject.toml

@@ -0,0 +1,15 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "oracletrace"
+version = "0.1.0"
+description = "Simple logic path tracer"
+authors = [{ name = "Kayk Caputo" }, { name = "André Gustavo" }]
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = ["rich"]
+
+[project.scripts]
+oracletrace = "oracletrace.cli:main"

oracletrace-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+