Fil de Jeffrey Emanuel (@doodlestein)

Voici le texte brut : ### ast-grep vs ripgrep (guide rapide) **Utilisez `ast-grep` lorsque la structure est importante.** Il analyse le code et fait correspondre les nœuds AST, de sorte que les résultats ignorent les commentaires/chaînes de caractères, comprennent la syntaxe et peuvent **réécrire le code en toute sécurité**. * Refactorisations/modifications du code : renommer les API, modifier les formulaires d’importation, réécrire les points d’appel ou les types de variables. * Contrôles de politique : appliquer des modèles à l’ensemble d’un dépôt (`scan` avec des règles + `test`). * Éditeur/automatisation : mode LSP ; sortie `--json` pour les outils. **Utilisez `ripgrep` lorsque le texte suffit.** C'est la méthode la plus rapide pour rechercher des chaînes littérales/expressions régulières dans différents fichiers. * Reconnaissance : recherche de chaînes de caractères, de tâches à faire, de lignes de journalisation, de valeurs de configuration ou de ressources non liées au code. * Préfiltrage : réduire la sélection des fichiers candidats avant une passe précise. **Règle générale** * Privilégiez l'exactitude à la vitesse, sinon vous **appliquerez des modifications** → commencez par `ast-grep`. * Besoin de vitesse brute ou vous ne faites que **chasser du texte** → commencez par `rg`. * On combine souvent : `rg` pour sélectionner les fichiers, puis `ast-grep` pour les faire correspondre/modifier avec précision. **Extraits** Recherche de code structuré (ignore les commentaires/chaînes de caractères) : ```bash ast-grep run -l TypeScript -p 'import $X from "$P"' ``` Codemod (seules les véritables déclarations `var` deviennent `let`) : ```bash ast-grep run -l JavaScript -p 'var $A = $B' -r 'let $A = $B' -U ``` Recherche textuelle rapide : ```bash rg -n 'console\.log\(' -t js ``` Alliez vitesse et précision : ```bash rg -l -t ts 'useQuery\(' | xargs ast-grep run -l TypeScript -p 'useQuery($A)' -r 'useSuspenseQuery($A)' -U ``` **Modèle mental** * Unité de correspondance : `ast-grep` = nœud ; `rg` = ligne. * Faux positifs : `ast-grep` faible ; `rg` dépend de votre expression régulière. * Réécritures : `ast-grep` de première classe ; `rg` nécessite sed/awk ad hoc et risque des modifications collatérales.