Major release with comprehensive analysis, CLI, and framework integration features.

🎉 What’s New in v0.3.1

Major Features

1. Command-Line Interface (CLI)

Complete CLI for all CallFlow Tracer features without writing Python code.

10 Commands:

Usage:

callflow-tracer trace script.py -o output.html
callflow-tracer quality . -o quality_report.html
callflow-tracer predict history.json -o predictions.html

2. Code Quality Analysis

Comprehensive code quality metrics and analysis.

Features:

Classes:

Usage:

from callflow_tracer.code_quality import analyze_codebase
results = analyze_codebase("./src")

3. Predictive Analysis

Predict future performance issues and capacity limits.

Features:

Classes:

Usage:

from callflow_tracer.predictive_analysis import PerformancePredictor
predictor = PerformancePredictor("history.json")
predictions = predictor.predict_performance_issues(current_trace)

4. Code Churn Analysis

Analyze code changes and identify high-risk files.

Features:

Classes:

Usage:

from callflow_tracer.code_churn import generate_churn_report
report = generate_churn_report(".", days=90)

5. Framework Integrations

Automatic tracing for popular Python frameworks.

Supported Frameworks:

Usage:

from flask import Flask
from callflow_tracer.integrations.flask_integration import setup_flask_tracing

app = Flask(__name__)
setup_flask_tracing(app)
# All requests automatically traced

📊 Statistics

Code Metrics

Documentation

Module Breakdown

📚 Documentation

New Guides

  1. NEW_FEATURES_INDEX.md - Overview and index
  2. CLI_GUIDE.md - CLI commands and usage
  3. CODE_QUALITY_GUIDE.md - Quality analysis
  4. PREDICTIVE_ANALYSIS_GUIDE.md - Predictions
  5. CODE_CHURN_GUIDE.md - Churn analysis
  6. INTEGRATIONS_GUIDE.md - Framework integrations

Updated Guides

🚀 Getting Started

CLI Quick Start

# Install
pip install callflow-tracer

# Trace a script
callflow-tracer trace my_script.py -o trace.html

# Analyze code quality
callflow-tracer quality . -o quality.html

# Predict performance issues
callflow-tracer predict history.json -o predictions.html

# Analyze code churn
callflow-tracer churn . -o churn.html

Python API Quick Start

# Code Quality
from callflow_tracer.code_quality import analyze_codebase
results = analyze_codebase("./src")

# Predictive Analysis
from callflow_tracer.predictive_analysis import PerformancePredictor
predictor = PerformancePredictor("history.json")
predictions = predictor.predict_performance_issues(current_trace)

# Code Churn
from callflow_tracer.code_churn import generate_churn_report
report = generate_churn_report(".", days=90)

# Framework Integration
from callflow_tracer.integrations.flask_integration import setup_flask_tracing
setup_flask_tracing(app)

🔄 Migration Guide

From v0.2.5 to v0.3.1

No breaking changes! All existing code continues to work.

New Capabilities:

  1. Use CLI for analysis without Python code
  2. Add quality analysis to your workflow
  3. Predict performance issues
  4. Identify high-risk files
  5. Integrate with web frameworks

Recommended Actions:

  1. Read NEW_FEATURES_INDEX.md
  2. Try new CLI commands
  3. Integrate with your framework
  4. Add quality analysis to CI/CD

📋 Feature Comparison

v0.2.5 vs v0.3.1

Feature v0.2.5 v0.3.1
Function Tracing ✅ ✅
Call Graph Visualization ✅ ✅
Flamegraph ✅ ✅
Profiling ✅ ✅
Memory Leak Detection ✅ ✅
CLI ❌ ✅
Code Quality ❌ ✅
Predictive Analysis ❌ ✅
Code Churn ❌ ✅
Framework Integration ❌ ✅

🎯 Use Cases

1. Find Code Quality Issues

callflow-tracer quality ./src -o quality_report.html

2. Identify High-Risk Files

callflow-tracer churn . -o churn_report.html

3. Predict Performance Problems

callflow-tracer predict trace_history.json -o predictions.html

4. Trace Web Requests

from callflow_tracer.integrations.flask_integration import setup_flask_tracing
setup_flask_tracing(app)

5. Monitor Database Queries

from callflow_tracer.integrations.sqlalchemy_integration import setup_sqlalchemy_tracing
setup_sqlalchemy_tracing(engine)

🔧 Technical Details

Code Quality Metrics

Predictive Analysis

Code Churn

Framework Integration

📦 Dependencies

New Dependencies

Optional Dependencies

🐛 Known Issues

None at this time. All features tested and working.

🔮 Future Roadmap

v0.4.0 (Planned)

v0.5.0 (Planned)

📞 Support

Documentation

Community

📝 Changelog

v0.3.1 (2025-01-15)

Added

Improved

Fixed

🎓 Learning Resources

For Beginners

  1. Start with NEW_FEATURES_INDEX.md
  2. Try CLI commands
  3. Read CLI_GUIDE.md

For Intermediate Users

  1. Read CODE_QUALITY_GUIDE.md
  2. Read CODE_CHURN_GUIDE.md
  3. Use Python API

For Advanced Users

  1. Read PREDICTIVE_ANALYSIS_GUIDE.md
  2. Read INTEGRATIONS_GUIDE.md
  3. Combine multiple analyses

🚀 Next Steps

  1. Read the new documentation guides
  2. Try the CLI commands
  3. Explore the Python API
  4. Integrate with your framework
  5. Combine analyses for insights

Release Date: 2025-01-15 Version: 0.3.0 Status: Stable

Start with NEW_FEATURES_INDEX.md to explore all new features! 🎉