refactron 0.1.0b1__tar.gz

refactron-0.1.0b1/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Om Sherikar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

refactron-0.1.0b1/MANIFEST.in

@@ -0,0 +1,10 @@
+include README.md
+include LICENSE
+include requirements.txt
+include requirements-dev.txt
+recursive-include refactron *.py
+recursive-include tests *.py
+recursive-include examples *.py
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]
+

refactron-0.1.0b1/PKG-INFO

@@ -0,0 +1,234 @@
+Metadata-Version: 2.4
+Name: refactron
+Version: 0.1.0b1
+Summary: The Intelligent Code Refactoring Transformer - Analyze, refactor, and optimize Python code with AI-powered suggestions
+Author-email: Om Sherikar <omsherikar@example.com>
+License: MIT
+Keywords: refactoring,code-quality,static-analysis,code-optimization,technical-debt,code-review,security-analysis
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: libcst>=1.1.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: radon>=6.0.0
+Requires-Dist: astroid>=3.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Dynamic: license-file
+
+# 🤖 Refactron
+
+**The Intelligent Code Refactoring Transformer**
+
+Refactron is a powerful Python library designed to eliminate technical debt, modernize legacy code, and automate code refactoring with intelligence and safety.
+
+[![Tests](https://img.shields.io/badge/tests-98%20passed-brightgreen)]()
+[![Coverage](https://img.shields.io/badge/coverage-90%25-brightgreen)]()
+[![Python](https://img.shields.io/badge/python-3.8%2B-blue)]()
+[![Version](https://img.shields.io/badge/version-0.1.0--beta-blue)]()
+[![Status](https://img.shields.io/badge/status-beta-yellow)]()
+
+## ✨ Features
+
+### 🔍 **Comprehensive Analysis**
+- **Security Scanning** - Detect `eval()`, `exec()`, SQL injection, shell injection, hardcoded secrets
+- **Code Smells** - Find magic numbers, long functions, too many parameters, deep nesting
+- **Complexity Metrics** - Cyclomatic complexity, maintainability index
+- **Type Hints** - Identify missing or incomplete type annotations
+- **Dead Code** - Detect unused functions, variables, and unreachable code
+- **Dependencies** - Find circular imports, wildcard imports, deprecated modules
+
+### 🔧 **Intelligent Refactoring**
+- **Extract Constants** - Replace magic numbers with named constants
+- **Reduce Parameters** - Convert parameter lists into configuration objects
+- **Simplify Conditionals** - Transform nested `if` statements into guard clauses
+- **Add Docstrings** - Generate contextual documentation automatically
+- **Before/After Previews** - See exactly what will change
+- **Risk Scoring** - Know how safe each refactoring is (0.0 = perfectly safe, 1.0 = high risk)
+
+### 📊 **Rich Reporting**
+- Multiple formats: Text, JSON, HTML
+- Detailed issue categorization
+- Technical debt quantification
+- Export for CI/CD integration
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+pip install refactron
+```
+
+### Basic Usage
+
+```python
+from refactron import Refactron
+
+# Initialize Refactron
+refactron = Refactron()
+
+# Analyze your code
+analysis = refactron.analyze("path/to/your/code.py")
+print(analysis.report())
+
+# Apply refactoring
+result = refactron.refactor("path/to/your/code.py", preview=True)
+result.show_diff()
+result.apply()
+```
+
+### CLI Usage
+
+```bash
+# Initialize configuration
+refactron init
+
+# Analyze a file or directory
+refactron analyze myproject/ --detailed
+
+# Generate a report
+refactron report myproject/ --format json -o report.json
+
+# Preview refactoring suggestions
+refactron refactor myfile.py --preview
+
+# Filter specific refactoring types
+refactron refactor myfile.py --preview -t extract_constant -t add_docstring
+```
+
+**Example Output:**
+```
+🔍 Refactron Analysis
+
+     Analysis Summary     
+┏━━━━━━━━━━━━━━━━┳━━━━━━━┓
+┃ Metric         ┃ Value ┃
+┡━━━━━━━━━━━━━━━━╇━━━━━━━┩
+│ Files Analyzed │     3 │
+│ Total Issues   │    50 │
+│ 🔴 Critical    │     3 │
+│ ❌ Errors      │     0 │
+│ ⚡ Warnings    │     8 │
+│ ℹ️  Info        │    39 │
+└────────────────┴───────┘
+
+⚠️  Found 3 critical issue(s) that need immediate attention!
+```
+
+## 🎯 What Makes Refactron Different?
+
+Unlike traditional linters and formatters, Refactron:
+
+- **Holistic Approach**: Combines analysis, refactoring, and optimization in one tool
+- **Context-Aware**: Understands code semantics, not just syntax
+- **Safe by Default**: Preview changes, risk scoring, and rollback support
+- **Intelligent**: Learn from patterns and suggest contextual improvements
+- **Business-Focused**: Quantify technical debt in actionable metrics
+
+## 💡 Real-World Examples
+
+We've included practical examples in the `examples/` directory:
+
+- **`flask_api_example.py`** - Common Flask API issues (security, code smells)
+- **`data_science_example.py`** - Data science workflow improvements
+- **`cli_tool_example.py`** - CLI application best practices
+
+Try them out:
+```bash
+# Analyze the Flask example
+refactron analyze examples/flask_api_example.py --detailed
+
+# Get refactoring suggestions
+refactron refactor examples/flask_api_example.py --preview
+```
+
+See `examples/DEMO_USAGE.md` for detailed walkthroughs!
+
+## 📚 Documentation
+
+- [Getting Started (Dev)](GETTING_STARTED_DEV.md) - Development setup
+- [Architecture](ARCHITECTURE.md) - Technical design
+- [Case Study](CASE_STUDY.md) - Real-world testing results
+- [Project Status](PROJECT_STATUS.md) - Complete feature matrix
+
+## 🛠️ Development Status
+
+> **⚠️ Beta Release**: Refactron v0.1.0-beta is production-ready but still evolving. We welcome feedback and contributions!
+
+**Current Metrics:**
+- ✅ **98 tests passing** (100% success rate)
+- ✅ **90% code coverage**
+- ✅ **0 critical issues** in production code
+- ✅ Real-world validated on 5,800+ lines
+
+### Roadmap
+
+**Phase 1: Foundation** ✅ **COMPLETE**
+- [x] Core architecture & CLI
+- [x] Configuration system
+- [x] Basic analyzers (complexity, code smells)
+- [x] Refactoring suggestions with risk scoring
+- [x] Before/after code previews
+
+**Phase 2: Advanced Analysis** ✅ **COMPLETE**
+- [x] Security vulnerability scanning
+- [x] Dependency analysis
+- [x] Dead code detection
+- [x] Type hint analysis
+- [x] Comprehensive test suite (87 tests, 89% coverage)
+
+**Phase 3: Intelligence & Automation** 🚧 **NEXT**
+- [ ] AI-powered pattern recognition
+- [ ] Auto-fix capabilities
+- [ ] Multi-file refactoring
+- [ ] Custom rule engine
+- [ ] Performance profiling
+
+**Phase 4: Integration & Scale** 📋 **PLANNED**
+- [ ] IDE plugins (VS Code, PyCharm)
+- [ ] CI/CD integration (GitHub Actions, GitLab CI)
+- [ ] Team collaboration features
+- [ ] Historical trend analysis
+
+## 🤝 Contributing
+
+We welcome contributions! Please see:
+- [Contributing Guide](CONTRIBUTING.md) - How to contribute
+- [Code of Conduct](CODE_OF_CONDUCT.md) - Community guidelines
+- [Getting Started (Dev)](GETTING_STARTED_DEV.md) - Development setup
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+Built with ❤️ using:
+- [LibCST](https://github.com/Instagram/LibCST) - Concrete syntax tree parser
+- [Radon](https://github.com/rubik/radon) - Complexity metrics
+- [Astroid](https://github.com/PyCQA/astroid) - AST analysis
+- [Rich](https://github.com/Textualize/rich) - Beautiful terminal output
+
+---
+
+**Star ⭐ this repo if you find it helpful!**
+

refactron-0.1.0b1/README.md

@@ -0,0 +1,198 @@
+# 🤖 Refactron
+
+**The Intelligent Code Refactoring Transformer**
+
+Refactron is a powerful Python library designed to eliminate technical debt, modernize legacy code, and automate code refactoring with intelligence and safety.
+
+[![Tests](https://img.shields.io/badge/tests-98%20passed-brightgreen)]()
+[![Coverage](https://img.shields.io/badge/coverage-90%25-brightgreen)]()
+[![Python](https://img.shields.io/badge/python-3.8%2B-blue)]()
+[![Version](https://img.shields.io/badge/version-0.1.0--beta-blue)]()
+[![Status](https://img.shields.io/badge/status-beta-yellow)]()
+
+## ✨ Features
+
+### 🔍 **Comprehensive Analysis**
+- **Security Scanning** - Detect `eval()`, `exec()`, SQL injection, shell injection, hardcoded secrets
+- **Code Smells** - Find magic numbers, long functions, too many parameters, deep nesting
+- **Complexity Metrics** - Cyclomatic complexity, maintainability index
+- **Type Hints** - Identify missing or incomplete type annotations
+- **Dead Code** - Detect unused functions, variables, and unreachable code
+- **Dependencies** - Find circular imports, wildcard imports, deprecated modules
+
+### 🔧 **Intelligent Refactoring**
+- **Extract Constants** - Replace magic numbers with named constants
+- **Reduce Parameters** - Convert parameter lists into configuration objects
+- **Simplify Conditionals** - Transform nested `if` statements into guard clauses
+- **Add Docstrings** - Generate contextual documentation automatically
+- **Before/After Previews** - See exactly what will change
+- **Risk Scoring** - Know how safe each refactoring is (0.0 = perfectly safe, 1.0 = high risk)
+
+### 📊 **Rich Reporting**
+- Multiple formats: Text, JSON, HTML
+- Detailed issue categorization
+- Technical debt quantification
+- Export for CI/CD integration
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+pip install refactron
+```
+
+### Basic Usage
+
+```python
+from refactron import Refactron
+
+# Initialize Refactron
+refactron = Refactron()
+
+# Analyze your code
+analysis = refactron.analyze("path/to/your/code.py")
+print(analysis.report())
+
+# Apply refactoring
+result = refactron.refactor("path/to/your/code.py", preview=True)
+result.show_diff()
+result.apply()
+```
+
+### CLI Usage
+
+```bash
+# Initialize configuration
+refactron init
+
+# Analyze a file or directory
+refactron analyze myproject/ --detailed
+
+# Generate a report
+refactron report myproject/ --format json -o report.json
+
+# Preview refactoring suggestions
+refactron refactor myfile.py --preview
+
+# Filter specific refactoring types
+refactron refactor myfile.py --preview -t extract_constant -t add_docstring
+```
+
+**Example Output:**
+```
+🔍 Refactron Analysis
+
+     Analysis Summary     
+┏━━━━━━━━━━━━━━━━┳━━━━━━━┓
+┃ Metric         ┃ Value ┃
+┡━━━━━━━━━━━━━━━━╇━━━━━━━┩
+│ Files Analyzed │     3 │
+│ Total Issues   │    50 │
+│ 🔴 Critical    │     3 │
+│ ❌ Errors      │     0 │
+│ ⚡ Warnings    │     8 │
+│ ℹ️  Info        │    39 │
+└────────────────┴───────┘
+
+⚠️  Found 3 critical issue(s) that need immediate attention!
+```
+
+## 🎯 What Makes Refactron Different?
+
+Unlike traditional linters and formatters, Refactron:
+
+- **Holistic Approach**: Combines analysis, refactoring, and optimization in one tool
+- **Context-Aware**: Understands code semantics, not just syntax
+- **Safe by Default**: Preview changes, risk scoring, and rollback support
+- **Intelligent**: Learn from patterns and suggest contextual improvements
+- **Business-Focused**: Quantify technical debt in actionable metrics
+
+## 💡 Real-World Examples
+
+We've included practical examples in the `examples/` directory:
+
+- **`flask_api_example.py`** - Common Flask API issues (security, code smells)
+- **`data_science_example.py`** - Data science workflow improvements
+- **`cli_tool_example.py`** - CLI application best practices
+
+Try them out:
+```bash
+# Analyze the Flask example
+refactron analyze examples/flask_api_example.py --detailed
+
+# Get refactoring suggestions
+refactron refactor examples/flask_api_example.py --preview
+```
+
+See `examples/DEMO_USAGE.md` for detailed walkthroughs!
+
+## 📚 Documentation
+
+- [Getting Started (Dev)](GETTING_STARTED_DEV.md) - Development setup
+- [Architecture](ARCHITECTURE.md) - Technical design
+- [Case Study](CASE_STUDY.md) - Real-world testing results
+- [Project Status](PROJECT_STATUS.md) - Complete feature matrix
+
+## 🛠️ Development Status
+
+> **⚠️ Beta Release**: Refactron v0.1.0-beta is production-ready but still evolving. We welcome feedback and contributions!
+
+**Current Metrics:**
+- ✅ **98 tests passing** (100% success rate)
+- ✅ **90% code coverage**
+- ✅ **0 critical issues** in production code
+- ✅ Real-world validated on 5,800+ lines
+
+### Roadmap
+
+**Phase 1: Foundation** ✅ **COMPLETE**
+- [x] Core architecture & CLI
+- [x] Configuration system
+- [x] Basic analyzers (complexity, code smells)
+- [x] Refactoring suggestions with risk scoring
+- [x] Before/after code previews
+
+**Phase 2: Advanced Analysis** ✅ **COMPLETE**
+- [x] Security vulnerability scanning
+- [x] Dependency analysis
+- [x] Dead code detection
+- [x] Type hint analysis
+- [x] Comprehensive test suite (87 tests, 89% coverage)
+
+**Phase 3: Intelligence & Automation** 🚧 **NEXT**
+- [ ] AI-powered pattern recognition
+- [ ] Auto-fix capabilities
+- [ ] Multi-file refactoring
+- [ ] Custom rule engine
+- [ ] Performance profiling
+
+**Phase 4: Integration & Scale** 📋 **PLANNED**
+- [ ] IDE plugins (VS Code, PyCharm)
+- [ ] CI/CD integration (GitHub Actions, GitLab CI)
+- [ ] Team collaboration features
+- [ ] Historical trend analysis
+
+## 🤝 Contributing
+
+We welcome contributions! Please see:
+- [Contributing Guide](CONTRIBUTING.md) - How to contribute
+- [Code of Conduct](CODE_OF_CONDUCT.md) - Community guidelines
+- [Getting Started (Dev)](GETTING_STARTED_DEV.md) - Development setup
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+Built with ❤️ using:
+- [LibCST](https://github.com/Instagram/LibCST) - Concrete syntax tree parser
+- [Radon](https://github.com/rubik/radon) - Complexity metrics
+- [Astroid](https://github.com/PyCQA/astroid) - AST analysis
+- [Rich](https://github.com/Textualize/rich) - Beautiful terminal output
+
+---
+
+**Star ⭐ this repo if you find it helpful!**
+

refactron-0.1.0b1/examples/bad_code_example.py

@@ -0,0 +1,101 @@
+"""
+Example of code with various issues that Refactron can detect.
+
+This file intentionally contains code smells, complexity issues,
+and other problems for demonstration purposes.
+"""
+
+
+# Issue: Too many parameters
+def calculate_total(price, tax, discount, shipping, handling_fee, insurance):
+    result = price + tax - discount + shipping + handling_fee + insurance
+    return result
+
+
+# Issue: High complexity and deep nesting
+def process_order(order_type, amount, customer_type, location, season):
+    if order_type == "online":
+        if amount > 100:
+            if customer_type == "premium":
+                if location == "domestic":
+                    if season == "holiday":
+                        return amount * 0.7
+                    else:
+                        return amount * 0.8
+                else:
+                    return amount * 0.85
+            else:
+                return amount * 0.9
+        else:
+            return amount
+    else:
+        return amount * 1.05
+
+
+# Issue: Magic numbers
+def calculate_discount(price):
+    if price > 1000:
+        return price * 0.15
+    elif price > 500:
+        return price * 0.10
+    elif price > 100:
+        return price * 0.05
+    return 0
+
+
+# Issue: No docstring
+def mystery_function(x, y):
+    z = x * 42 + y * 3.14159
+    return z
+
+
+# Issue: Very long function
+def do_everything(data):
+    result = []
+    for item in data:
+        if item > 0:
+            temp = item * 2
+            result.append(temp)
+    
+    filtered = []
+    for item in result:
+        if item > 10:
+            filtered.append(item)
+    
+    sorted_data = sorted(filtered)
+    
+    final = []
+    for item in sorted_data:
+        if item % 2 == 0:
+            final.append(item * 3)
+        else:
+            final.append(item * 2)
+    
+    return final
+
+
+class DataProcessor:
+    def process(self, a, b, c, d, e, f):
+        return a + b + c + d + e + f
+    
+    def transform(self, data):
+        if data:
+            if isinstance(data, list):
+                if len(data) > 0:
+                    if data[0] > 0:
+                        return [x * 2 for x in data]
+        return data
+
+
+# Duplicate-looking functions
+def send_email1(recipient, subject, body):
+    print(f"Sending to {recipient}: {subject}")
+
+
+def send_email2(recipient, subject, body):
+    print(f"Sending to {recipient}: {subject}")
+
+
+def send_email3(recipient, subject, body):
+    print(f"Sending to {recipient}: {subject}")
+