Advisor Refactor et outil d'automatisation de l'analyse - Code intelligent Amazon Q CLI Tool

DEV - 11/05
Ceci est une soumission pour le développeur Amazon Q "Quack the Code" Challenge: écrasant la commande ...

Ceci est une soumission pour le développeur Amazon Q "Quack the Code" Challenge: écraser la ligne de commande

Ce que j'ai construit

J'ai construit RefactorAdvisor parce que je me suis souvent retrouvé dépassé de revoir les anciens projets Python 🧠💻 - le type où les fonctions étendent des centaines de lignes, les importations s'accumulent et la clarté s'estompe. Comme de nombreux développeurs, je voulais nettoyer les choses, mais je n'ai pas toujours eu le temps (ou la patience) pour les critiques manuelles profondes. Les liners traditionnels se sentaient trop peu profonds, et je voulais quelque chose de plus intelligent. C’est à ce moment-là que j’ai découvert Amazon Q 🤖 - un outil qui pourrait comprendre le contexte et suggérer des améliorations significatives. J'ai donc créé RefactorAdvisor: un outil CLI qui parcourt votre projet 📁, divise les fichiers longs en morceaux gérables ✂️, les envoie à Amazon Q pour analyse et renvoie des conseils de refactorisation exploitables 🛠️. Que vous souhaitiez simplement des informations rapides ou un rapport complet de Markdown 📄, cela aide à ramener l'ordre à votre code - un morceau à la fois.

Caractéristiques clés de RefactorAdvisor

  1. 🗂️SMART Project Traversal 🔍 Recursivement scanne un répertoire de projet spécifié

📄 Identifie tous les fichiers source .py pour l'analyse

$ python refactor_advisor.py ---path ./my_project
Entrez le mode de sortie en mode plein écran
  1. ✂️ Chasse des fichiers volumineux 🧩 casse des fichiers volumineux en ~ 100 morceaux de ligne (réglable via CLI)

🔄 maintient l'analyse cohérente avec les limites d'entrée d'Amazon Q

$ python refactor_advisor.py ---path ./app --chunk-size 80
Entrez le mode de sortie en mode plein écran
  1. 🤖 Amazon Q Intégration 📤 Envoie chaque morceau à Amazon Q CLI via le sous-processus

🧠 demande Q à:

Résumer le morceau

Identifier les odeurs de code

Suggérer des refactorisations basées sur:

  • SEC
  • SOLIDE
  • Lisibilité
  • Performance

⚠️ nécessite AWS CLI et Amazon Q La configuration utilise AWS Q ou Amazon-Q sous le capot

  1. 📊 Organisation de sortie 🎨 affiche les commentaires dans le terminal avec:

✅ résumés sectionnés

🎯 Faits saillants à code couleur

📝 Écrit éventuellement des rapports dans Markdown par fichier:

Exemple: analyse / utils_refactor_report.md

$ python refactor_advisor.py ---pa...
[Courte citation de 8% de l'article original]