Commandes Serpl

Commandes complètes de l’interface utilisateur du terminal Serpl pour les opérations de recherche et de remplacement dans tout le projet.

Installation

Commande	Description
cargo install serpl	Installer via Cargo (Rust)
brew install serpl	Installer via Homebrew (macOS)
nix-env -i serpl	Installer via Nix
pacman -S serpl	Installer sur Arch Linux
Download from GitHub Releases	Binaires pré-compilés disponibles
serpl --version	Afficher la version de Serpl

Utilisation de Base

Commande	Description
serpl	Lancer Serpl dans le répertoire actuel
serpl --search-text "oldFunc"	Lancer avec le terme de recherche pré-rempli
serpl --replace-text "newFunc"	Lancer avec le remplacement pré-rempli
serpl --search-path ./src	Rechercher dans un répertoire spécifique
serpl --hidden	Inclure les fichiers cachés dans la recherche
serpl --ignore-case	Recherche insensible à la casse

Touches de Navigation

Raccourci	Description
j	Descendre dans la liste des résultats
k	Monter dans la liste des résultats
g	Sauter au premier résultat
G	Sauter au dernier résultat
/	Rechercher dans la liste des résultats
Enter	Sélectionner/confirmer l’action
Escape	Annuler/revenir
q	Quitter Serpl

Changement de Mode

Raccourci	Description
Tab	Basculer entre les champs de recherche et de remplacement
Ctrl + N	Basculer entre les modes de recherche et de remplacement
Ctrl + B	Ouvrir le dialogue d’aide
Ctrl + C	Quitter l’application

Opérations de Recherche

Raccourci	Description
Type in search field	Recherche en direct dans tous les fichiers
Ctrl + N	Basculer le mode de recherche
Case-sensitive mode	Correspondance exacte de la casse
Case-insensitive mode	Ignorer les différences de casse
Regex mode	Utiliser les expressions régulières
AST Grep mode	Recherche de code structurel

Opérations de Remplacement

Raccourci	Description
Ctrl + O	Traiter le remplacement pour TOUS les fichiers
d	Supprimer le fichier sélectionné ou la ligne des résultats
Simple replace	Remplacer toutes les occurrences directement
Preserve case replace	Maintenir le motif de casse original
AST Grep replace	Remplacement structurel du code

Modes de Remplacement

Mode	Description
Simple	Remplacement textuel direct
Preserve Case	Correspond au motif de casse du texte original
AST Grep	Remplacement conscient de l’arbre syntaxique

Modes de Recherche

Mode	Description
Fixed String	Correspondance textuelle littérale
Regex	Correspondance d’expression régulière
AST Grep	Correspondance structurelle du motif de code

Opérations sur les Fichiers

Raccourci	Description
d	Supprimer le fichier/la ligne des résultats (ignorer)
Ctrl + O	Appliquer les remplacements à tous les fichiers restants
Review changes per file	Voir l’aperçu avant application
Undo is not available	Les modifications sont permanentes—utilisez Git

Configuration

Paramètre	Description
~/.config/serpl/config.json	Emplacement du fichier de configuration
Custom key bindings	Remplacer les raccourcis par défaut
Search mode default	Définir le mode de recherche préféré
Replace mode default	Définir le mode de remplacement préféré
File pattern filters	Configurer les fichiers à inclure
Ignore patterns	Configurer les fichiers à exclure

Exemple de Configuration

{
  "key_bindings": {
    "quit": "q",
    "navigate_up": "k",
    "navigate_down": "j",
    "go_to_top": "g",
    "go_to_bottom": "G",
    "delete": "d",
    "process_replace": "Ctrl+o",
    "toggle_help": "Ctrl+b",
    "search_in_list": "/"
  },
  "search_mode": "fixed_string",
  "replace_mode": "simple"
}

Workflows Courants

Workflow	Description
Rename variable	Rechercher l’ancien nom → Remplacer par le nouveau nom
Update import paths	Rechercher l’ancien chemin → Remplacer par le nouveau
Migrate API calls	Rechercher obsolète → Remplacer par nouvelle API
Fix typos across project	Rechercher la faute → Remplacer par la correction
Update config values	Rechercher l’ancienne valeur → Remplacer par la nouvelle

Intégration avec Git

Workflow	Description
git diff after serpl	Examiner tous les changements apportés
git stash before serpl	Enregistrer le travail actuel d’abord
git checkout -- . to undo	Annuler tous les changements si nécessaire
Work in a branch	Isoler les modifications de recherche-remplacement
git add -p after serpl	Étape sélective des modifications

Comparaison avec les Alternatives

Fonctionnalité	Serpl	sed	VS Code
Interactive preview	Oui	Non	Oui
TUI interface	Oui	Non	GUI
Preserve case	Oui	Manuel	Oui
AST Grep	Oui	Non	Extension
Works over SSH	Oui	Oui	Non
Regex support	Oui	Oui	Oui

Conseils et Bonnes Pratiques

Conseil	Description
Always use Git	Valider avant d’exécuter les remplacements
Preview before applying	Examiner chaque modification dans l’interface
Use AST Grep for code	La correspondance structurelle évite les faux positifs
Use preserve case	Maintient camelCase, PascalCase, etc.
Remove false positives	Utiliser d pour ignorer les correspondances indésirables
Search specific paths	Utiliser --search-path pour réduire la portée
Check hidden files	Utiliser le flag --hidden si nécessaire