codeinsight 1.0.1

Live time complexity and memory usage analysis for Python code

🔍 CodeInsight

A comprehensive toolkit for analyzing Python code complexity, quality, and performance metrics

✨ Overview

CodeInsight helps developers identify bottlenecks, complexity issues, and potential bugs in Python code. By providing detailed metrics and visualizations, it empowers teams to write cleaner, more maintainable, and more efficient code.

🚀 Installation

pip install codeinsight

🏁 Quick Start

Command Line Usage

# Basic analysis of a file
codeinsight example.py

# Analyze a directory with detailed reporting
codeinsight ./src --verbose

As a Python Library

# Import the analyze function
from codeinsight import analyze

# Analyze a file
result = analyze("example.py")
print(result)

# Or use the CodeInsight class directly for more control
from codeinsight import CodeInsight

with open("example.py", "r") as f:
    code = f.read()

analyzer = CodeInsight(code)
result = analyzer.get_analysis()
print(result)

🛠️ Features

Feature	Description
Complexity Analysis	Calculate cyclomatic complexity, cognitive complexity, and Halstead metrics
Performance Metrics	Estimate time and space complexity, track memory usage
Code Quality	Detect code smells, anti-patterns, and maintainability issues

Supported Analysis Types

• Structural Analysis: AST-based parsing for deep code understanding
• Complexity Metrics: Cyclomatic, cognitive, and Halstead complexity
• Performance Profiling: Execution time and memory usage estimation
• Pattern Detection: Identify common anti-patterns and code smells
• Documentation Coverage: Measure docstring completeness and quality

🔧 Requirements

• Python 3.6+
• click
• rich
• memory_profiler
• radon
• astor

👥 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

💖 Acknowledgements

• The Radon project for complexity metrics
• AST module from the Python standard library
• All our contributors