py-flow-mapper 0.1.0b0.dev0

Python project analyzer and visualization tool

PyFlowMapper

A simple Python tool that analyzes your code and shows how functions connect and pass data between each other.

What It Does

• Reads Python files without running them
• Finds which functions call which other functions
• Tracks how data flows from one function to another
• Creates easy-to-understand diagrams
• Works with Python 3.12+

Quick Install

# Clone and install
git clone https://github.com/ArunKoundinya/py-flow-mapper.git
cd py-flow-mapper
pip install -e .

# Or install directly
pip install py-flow-mapper  # Coming soon!

How to Use

Analyze Your Project

pyflow analyze /path/to/your/project

This creates a project_meta.json file with all the analysis results.

Create Diagrams

pyflow diagram /path/to/your/project/project_meta.json

See Project Structure

pyflow structure /path/to/your/project

Shows a clean tree view of your project folders and files.

What You Get

Metadata File (project_meta.json)

Contains:

• List of all functions and where they are
• Which functions call which others
• How data moves between functions
• All imports and dependencies

Three Types of Diagrams

• Simple Flow Graph - Basic function connections
• Detailed Flow Graph - Shows modules and data flow [ Recommended ]
• Call Graph - Just function calls

Requirements

• Python 3.12 or higher

Common Commands

Command	What it does
pyflow analyze /path/to/project	Analyze a project
pyflow diagram /path/to/project/project_meta.json	Make diagrams
pyflow structure /path/to/project	Show folder structure
pyflow --help	Get help
pyflow --version	Check version

Features

✅ Works with any Python 3.12+ project
✅ No need to run your code
✅ Creates visual diagrams
✅ Shows data flow between functions
✅ Handles imports correctly
✅ Excludes virtual environments automatically

Tips

• Start with a small project to see how it works
• Use --entry-point if your main file isn't main.py
• View diagrams in VS Code or GitHub for best results
• The tool ignores venv/, .venv/, and other common exclude folders