Python: AST-based analysis

import ast

Track: Import statements vs actual usage

Skip: Dynamic imports (importlib, __import__)

// Module analysis

// Track: import/require vs references

// Skip: Dynamic imports, lazy loading

Unused Functions/Classes

• Define: All declared functions/classes

• Reference: Direct calls, inheritance, callbacks

• Preserve: Entry points, framework hooks, event handlers

Dynamic Usage Safety

Never remove if patterns detected:

Framework Preservation Rules

Python

• Django: Models, migrations, admin registrations

• Flask: Routes, blueprints, app factories

• FastAPI: Endpoints, dependencies

JavaScript

• React: Components, hooks, context providers

• Vue: Components, directives, mixins

• Angular: Decorators, services, modules

Java

• Spring: Beans, controllers, repositories

• JPA: Entities, repositories

Execution Process

1. Backup Creation

backup_dir="./unused_code_backup_$(date +%Y%m%d_%H%M%S)"

cp -r . "$backup_dir" 2>/dev/null || mkdir -p "$backup_dir" && rsync -a . "$backup_dir"

2. Language-Specific Analysis

Python

find . -name "*.py" -type f | while read file; do

python -m ast "$file" 2>/dev/null || echo "Syntax check: $file"

done

JavaScript/TypeScript

npx depcheck # For npm packages

npx ts-unused-exports tsconfig.json # For TypeScript

3. Safe Removal Strategy

def remove_unused_element(file_path, element):

"""Remove with validation"""

# 1. Create temp file with change

# 2. Validate syntax

# 3. Run tests if available

# 4. Apply or rollback

if syntax_valid and tests_pass:

apply_change()

return "✓ Removed"

else:

rollback()

return "✗ Preserved (safety)"

4. Validation Commands

Python

python -m py_compile file.py

python -m pytest

JavaScript

npx eslint file.js

npm test

Java

javac -Xlint file.java

mvn test

Entry Point Patterns

Always preserve:

Report Format

For each operation provide:

• Files analyzed: Count and types

• Unused detected: Imports, functions, classes

• Safely removed: With validation status

• Preserved: Reason for keeping

• Impact metrics: Lines removed, size reduction

Safety Guidelines

✅ Do:

• Run tests after each removal

• Preserve framework patterns

• Check string references in templates

• Validate syntax continuously

• Create comprehensive backups

❌ Don't:

• Remove without understanding purpose

• Batch remove without testing

• Ignore dynamic usage patterns

• Skip configuration files

• Remove from migrations

Usage Example

Quick scan

echo "Scanning for unused code..."

grep -r "import\|require\|include" --include=".py" --include=".js"

Detailed analysis with safety

python -c "

import ast, os

for root, _, files in os.walk('.'):

for f in files:

if f.endswith('.py'):

# AST analysis for Python files

pass

"

Validation before applying

npm test && echo "✓ Safe to proceed"