Comandi Serpl

Comandi TUI completi di Serpl per operazioni di ricerca e sostituzione in tutto il progetto.

Installazione

Comando	Descrizione
cargo install serpl	Installa tramite Cargo (Rust)
brew install serpl	Installa tramite Homebrew (macOS)
nix-env -i serpl	Installa tramite Nix
pacman -S serpl	Installa su Arch Linux
Scarica da GitHub Releases	Binari precompilati disponibili
serpl --version	Mostra la versione di Serpl

Utilizzo di Base

Comando	Descrizione
serpl	Avvia Serpl nella directory corrente
serpl --search-text "oldFunc"	Avvia con il termine di ricerca precompilato
serpl --replace-text "newFunc"	Avvia con la sostituzione precompilata
serpl --search-path ./src	Ricerca in una directory specifica
serpl --hidden	Includi i file nascosti nella ricerca
serpl --ignore-case	Ricerca case-insensitive

Tasti di Navigazione

Scorciatoia	Descrizione
j	Sposta giù nell’elenco dei risultati
k	Sposta su nell’elenco dei risultati
g	Salta al primo risultato
G	Salta all’ultimo risultato
/	Ricerca all’interno dell’elenco dei risultati
Enter	Seleziona/conferma l’azione
Escape	Annulla/torna indietro
q	Esci da Serpl

Cambio di Modalità

Scorciatoia	Descrizione
Tab	Passa tra i campi di ricerca e sostituzione
Ctrl + N	Passa tra la modalità di ricerca e sostituzione
Ctrl + B	Apri la finestra di dialogo della guida
Ctrl + C	Esci dall’applicazione

Operazioni di Ricerca

Scorciatoia	Descrizione
Digita nel campo di ricerca	Ricerca in tempo reale in tutti i file
Ctrl + N	Attiva la modalità di ricerca
Modalità case-sensitive	Trova la corrispondenza esatta del caso
Modalità case-insensitive	Ignora le differenze di caso
Modalità Regex	Usa espressioni regolari
Modalità AST Grep	Ricerca di codice strutturale

Operazioni di Sostituzione

Scorciatoia	Descrizione
Ctrl + O	Elabora la sostituzione per TUTTI i file
d	Elimina il file selezionato o la riga dai risultati
Sostituzione semplice	Sostituisci tutte le occorrenze direttamente
Sostituzione conservando il caso	Mantieni il modello di maiuscole/minuscole originale
Sostituzione AST Grep	Sostituzione del codice consapevole della sintassi

Modalità di Sostituzione

Modalità	Descrizione
Simple	Sostituzione del testo diretto
Preserve Case	Corrisponde al modello di maiuscole/minuscole del testo originale
AST Grep	Sostituzione consapevole dell’albero della sintassi

Modalità di Ricerca

Modalità	Descrizione
Fixed String	Corrispondenza di testo letterale
Regex	Corrispondenza di espressioni regolari
AST Grep	Corrispondenza di modelli di codice strutturale

Operazioni su File

Scorciatoia	Descrizione
d	Rimuovi il file/riga dai risultati (salta)
Ctrl + O	Applica le sostituzioni a tutti i file rimanenti
Rivedi le modifiche per file	Visualizza l’anteprima prima di applicare
L’annullamento non è disponibile	Le modifiche sono permanenti—usa Git

Configurazione

Impostazione	Descrizione
~/.config/serpl/config.json	Posizione del file di configurazione
Keybinding personalizzati	Sostituisci le scorciatoie predefinite
Modalità di ricerca predefinita	Imposta la modalità di ricerca preferita
Modalità di sostituzione predefinita	Imposta la modalità di sostituzione preferita
Filtri di modello di file	Configura quali file includere
Modelli di ignoranza	Configura quali file escludere

Configurazione di Esempio

{
  "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"
}

Flussi di Lavoro Comuni

Flusso di Lavoro	Descrizione
Rinomina variabile	Ricerca il nome precedente → Sostituisci con il nuovo nome
Aggiorna i percorsi di importazione	Ricerca il vecchio percorso → Sostituisci con il nuovo percorso
Migra le chiamate API	Ricerca deprecato → Sostituisci con la nuova API
Correggi i refusi in tutto il progetto	Ricerca l’errore di ortografia → Sostituisci con il testo corretto
Aggiorna i valori di configurazione	Ricerca il vecchio valore → Sostituisci con il nuovo valore

Integrazione con Git

Flusso di Lavoro	Descrizione
git diff dopo serpl	Rivedi tutte le modifiche apportate
git stash prima di serpl	Salva il lavoro corrente prima
git checkout -- . per annullare	Ripristina tutte le modifiche se necessario
Lavora in un ramo	Isola i cambiamenti di ricerca e sostituzione
git add -p dopo serpl	Gestisci selettivamente i cambiamenti

Confronto con Alternative

Caratteristica	Serpl	sed	VS Code
Anteprima interattiva	Sì	No	Sì
Interfaccia TUI	Sì	No	GUI
Conserva il caso	Sì	Manuale	Sì
AST Grep	Sì	No	Estensione
Funziona su SSH	Sì	Sì	No
Supporto Regex	Sì	Sì	Sì

Suggerimenti e Best Practice

Suggerimento	Descrizione
Usa sempre Git	Esegui il commit prima di eseguire le sostituzioni
Visualizza in anteprima prima di applicare	Rivedi ogni modifica nell’interfaccia TUI
Usa AST Grep per il codice	La corrispondenza strutturale evita i falsi positivi
Usa conserva il caso	Mantiene camelCase, PascalCase, ecc.
Rimuovi i falsi positivi	Usa d per saltare i match indesiderati
Ricerca percorsi specifici	Usa --search-path per restringere l’ambito
Controlla i file nascosti	Usa il flag --hidden quando necessario