Refactron

The Intelligent Code Refactoring Transformer

Eliminate technical debt, modernize legacy code, and automate refactoring with AI-powered intelligence. Built for Python developers who care about code quality and maintainability.

📦 Install from PyPI ⭐ Star on GitHub

Advanced Analyzers

Smart Refactorers

81%

Test Coverage

135

Tests Passing

Features

Powerful Code Analysis & Refactoring

Comprehensive tools to analyze, refactor, and optimize your Python codebase with confidence

🔍

Comprehensive Analysis

Deep code inspection with 8 specialized analyzers covering all aspects of code quality

Security vulnerability scanning
Code smell detection
Complexity & maintainability metrics
Type hint analysis
Dead code detection
Dependency & import analysis

🔧

Intelligent Refactoring

AI-powered code transformations with before/after previews and safety risk scoring

Extract magic numbers to constants
Reduce function parameters
Simplify nested conditionals
Auto-generate docstrings
Extract complex methods
Risk scoring for each change

📊

Rich Reporting

Actionable insights with multiple output formats and detailed metrics

Beautiful terminal output
JSON & HTML export options
Before/after code previews
CI/CD integration support
Technical debt tracking
Trend analysis over time

Quick Start

Get Started in Seconds

Install Refactron and start analyzing your code immediately

Installation $

pip install refactron

Analyze Your Code $

# Analyze a file or directory
refactron analyze your_project/

# Get detailed report
refactron analyze your_file.py --detailed

Get Refactoring Suggestions $

# Preview refactorings (safe, doesn't modify files)
refactron refactor your_file.py --preview

# Apply specific refactoring types
refactron refactor your_file.py --types magic_number,reduce_params

Python API

from refactron import Refactron
from refactron.core.config import RefactronConfig

# Initialize with default or custom config
config = RefactronConfig.default()
refactron = Refactron(config)

# Analyze code
result = refactron.analyze("your_project/")
print(result.summary())

# Get refactoring suggestions
refactorings = refactron.refactor("your_file.py", preview=True)
print(refactorings.show_diff())

Use Cases

Built for Every Development Scenario

From legacy modernization to maintaining high-quality codebases

🏢

Enterprise Legacy Code

Modernize decades-old Python code with automated refactoring and security scanning

🚀

Startup MVPs

Clean up technical debt quickly as your codebase grows and evolves

👥

Team Onboarding

Help new developers understand code quality standards and patterns

🔄

CI/CD Integration

Automate code quality checks in your deployment pipeline

📚

Open Source Projects

Maintain consistent quality across contributions from multiple developers

🎓

Learning & Teaching

Teach Python best practices with automated feedback and suggestions