codestats-analyzer 1.0.0

Python code analysis tool with insights - like GitHub insights but local

📊 CodeStats

Python code analysis tool that gives you insights about your codebase - like GitHub insights but local!

🚀 Features

• 📁 Code Metrics: Lines, functions, classes count
• 🧠 Complexity Analysis: Detect long functions and nested loops
• 🔍 Code Smell Detection: Find unused imports, duplicate code patterns
• 💬 Comment Analysis: Check documentation coverage
• ⭐ Quality Score: Get a score from 0-10
• 💡 Smart Suggestions: Actionable improvement tips

📦 Installation

pip install codestats-analyzer

Or from GitHub:

pip install git+https://github.com/yourusername/codestats.git

💻 Usage

As a Python module:

from codestats import analyze

# Analyze a project
report = analyze("myproject")
print(report)

# Access specific metrics
print(f"Score: {report.score}/10")
print(f"Functions: {report.functions}")

From command line:

codestats .
codestats myproject/

📊 Example Output

📊 CodeStats Report
==================================================
📁 Total files: 25
🧠 Total lines: 3200
🐍 Python files: 18
💬 Comments: 450
⚡ Functions: 60
📦 Classes: 12
📊 Complexity: Medium
⭐ Code Score: 7.5 / 10

🔍 Code Smells Detected:
   • main.py: 2 long function(s)
   • utils.py: Low comment ratio (3.2%)

💡 Suggestions:
   • Break down 2 long function(s) into smaller ones
   • Add more comments in 5 file(s)
   • Code quality is good! Keep it up 🎉
==================================================

🎯 What It Checks

• ⚠ Long functions (>50 lines)
• 🔄 Nested loops
• 📝 Comment coverage
• 🗑️ Unused imports
• 📏 File size
• 🏗️ Code organization

🔥 Why CodeStats?

Unlike other tools, CodeStats focuses on:

• Simplicity: Easy to use, clear output
• Actionable: Specific suggestions, not just numbers
• Local: No need to push to GitHub
• Fast: Analyzes projects in seconds

📝 License

MIT