flowlens-py 0.1.5

A Python tracing engine for visual logic auditing.

FlowLens-py 🔍

FlowLens-py is a powerful audit and process tracking library for Python that generates a professional visual Audit Timeline of your code execution.

Developed by: Hans Clisman Saldias Mura Email: [e-mail]

🚀 Installation

Install the library directly from PyPI:

pip install flowlens-py
🛠️ Quick Start (v0.1.5+)
To correctly capture processes and generate the automatic visual report, use the following structure in your Python script:

Python
from flowlens import lens

# 1. (Optional) Use the decorator for detailed performance metrics
@lens.track_stats
def calculate_sum(a, b):
    return a + b

if __name__ == "__main__":
    # 2. Start the audit engine (Activates sys.settrace)
    lens.start()

    # 3. Run your business logic
    print("--- Starting Process ---")
    result = calculate_sum(15, 25)
    print(f"Result: {result}")

    # 4. Stop tracking and automatically open the HTML report
    lens.stop()

    
📊 Key Features
Audit Timeline: Generates a professional dark-themed flowlens_report.html file.

Data Capture: Automatically records input arguments and generated return data.

Intent Detection: Automatically classifies processes as "INTERNAL PROCESS" or "DATA OUTPUT" based on function naming.

Performance Metrics: Measures exact execution time in milliseconds (ms) for every block.

📄 Credits
This software is a technical auditing tool created to improve data flow visibility in Python applications.

Author: Hans Clisman Saldias Mura
Copyright: © 2026