Metadata-Version: 2.4
Name: flowlens-py
Version: 0.1.5
Summary: A Python tracing engine for visual logic auditing.
Author-email: Hans Saldias <dev.hans.saldias@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/Hans-developer/flowlens.git
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENCE
Dynamic: license-file

# 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: [dev.hans.saldias@gmail.com](mailto:dev.hans.saldias@gmail.com)

## 🚀 Installation

Install the library directly from PyPI:
```bash
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
