Strumenti di testo e di uso quotidiano · Text Toolkit
Perché uno strumento di ricerca e sostituzione deve sopravvivere a una regex digitata a metà
· Perché è importante
trova e sostituisci espressioni regolari modifica del testo
La digitazione di un modello è incrementale, quindi una parentesi di apertura solitaria è uno stato normale; questo post sostiene che proteggere la compilazione, lasciare il testo intatto e offrire l'annullamento sono caratteristiche di correttezza, non di lucidatura.
Lo strumento che ha ripulito gli schemi in caso di squilibrio: come la semplice pressione di un tasto può distruggere un'ora di pulizia
Una casella di ricerca e sostituzione spesso contiene lavoro che richiede molto più tempo per essere assemblato rispetto al modello di ricerca accanto. Se un'espressione incompleta può passare attraverso l'interfaccia, cancellare l'editor o lasciare il suo stato incerto, lo strumento ha reso l'immissione del modello più pericolosa dell'attività di pulizia che avrebbe dovuto semplificare.
Il repository non documenta un incidente specifico in cui ToolAcre ha cancellato un'ora di lavoro, quindi quella storia non può essere presentata come un fatto. Il requisito difendibile è comunque più forte: il testo dell'utente deve rimanere invariato ogni volta che la compilazione del pattern fallisce, indipendentemente dalla quantità di testo presente o dal tempo impiegato per la preparazione.
Il fallimento distruttivo che uno strumento di ricerca e sostituzione deve prevenire
Le espressioni regolari di solito non vengono immesse con una sequenza perfetta di tasti. Una persona digita una parentesi di apertura prima di quella di chiusura oppure inizia una classe di caratteri con una parentesi di apertura prima di aggiungerne i membri. In questi momenti, il campo contiene un modello sintatticamente incompleto anche se il processo di modifica procede normalmente.
Trattare quello stato temporaneo come un comportamento utente eccezionale produce un editor fragile. La risposta utile è un feedback locale immediato: mostrare che il modello corrente non può essere compilato, preservare ogni altro campo e lasciare che la successiva pressione del tasto lo ripari. Un errore di espressione regolare non valida dovrebbe descrivere la bozza attuale, non interrompere il flusso di lavoro.
I modelli incompleti sono normali durante la scrittura di un'espressione regolare
ToolAcre instrada ogni ricerca fornita dall'utente tramite `compilePattern`. Le ricerche letterali innanzitutto sfuggono ai metacaratteri delle espressioni regolari, mentre la modalità Regex utilizza direttamente l'origine fornita. La compilazione avviene all'interno di un blocco `try` e l'errore restituisce un modello null più una stringa di errore invece di consentire all'eccezione JavaScript di fuoriuscire nell'interfaccia.
Questo risultato controlla il percorso di sostituzione. Quando la compilazione segnala un errore, `findReplace` restituisce il testo originale, zero sostituzioni e l'errore. Non tenta una ricerca parziale o una riscrittura. La guardia protegge quindi sia la stabilità dell'interfaccia che l'integrità dei dati: nessun modello valido significa nessuna mutazione dei contenuti dell'editor.
Segnalare cosa è successo: perché un conteggio delle sostituzioni dopo ogni esecuzione è il controllo di integrità più veloce
Una sostituzione riuscita può comunque essere logicamente sbagliata. Un'espressione ampia può corrispondere a più date del previsto, mentre un'opzione di maiuscole e minuscole o il limite di una parola intera possono ridurre l'insieme a zero. ToolAcre conta le corrispondenze prima di chiamare la sostituzione della stringa standard e restituisce quel numero con il testo riscritto, rendendo visibile l'ambito dopo ogni esecuzione.
Il conteggio è un rapido controllo di integrità piuttosto che una prova che ogni partita fosse desiderabile. Se erano previsti dodici record e il risultato dice 1 o 1,200, interrompere e ispezionare il modello prima di copiare l'output. Un numero preciso trasforma il vago sospetto in una ragione concreta per annullare e rivedere la perquisizione.
Annulla come rete di sicurezza: ogni trasformazione è reversibile, con un limite documentato di cinquanta operazioni
La sicurezza della compilazione impedisce ai modelli non validi di modificare il testo, ma i modelli validi possono comunque esprimere l'intenzione sbagliata. Annulla copre quella seconda categoria. Text Toolkit registra le trasformazioni in modo che una sostituzione completata possa essere annullata dopo che il conteggio dei risultati o l'output rivelano che la ricerca era troppo ampia, troppo ristretta o raggruppata in modo errato.
Il limite della cronologia documentata è di cinquanta operazioni, quindi l'annullamento è un buffer di lavoro anziché un controllo di versione permanente. Usalo per sperimentare a piccoli passi, ma non trattarlo come un archivio. Per il materiale importante, conservare l'originale separatamente e copiare il risultato finale solo dopo aver esaminato sia il testo che il conteggio delle sostituzioni.
Esempio funzionante: creazione di un modello di riformattazione della data carattere per carattere e visualizzazione dell'errore che appare e scompare senza perdere il testo
Valuta la possibilità di modificare le date da `2024-01-02` a `02/01/2024`. Abilita Regex e inizia con una parentesi di apertura. In quell'istante il motore del browser segnala un'espressione non valida, ToolAcre fa emergere il messaggio e il testo rimane intatto. Aggiungi `\d{4}` e la parentesi di chiusura e il primo anno acquisito diventa valido.
Continua finché la ricerca non risulta `(\d{4})-(\d{2})-(\d{2})`, quindi utilizza `$3/$2/$1` come sostituzione. Le tre acquisizioni riordinano anno, mese e giorno senza riscrivere ogni riga. Esegui Sostituisci tutto, confronta il conteggio riportato con le righe previste e annulla immediatamente se corrisponde anche testo numerico non correlato.
Ciò che questo non copre: problemi di prestazioni regex come il backtracking catastrofico su input enormi
La protezione della compilazione risolve gli errori di sintassi, non il tempo di esecuzione delle espressioni valide. Un modello può essere compilato con successo ma tornare indietro pesantemente su un input particolare. Poiché la sostituzione viene eseguita sul thread principale, un'espressione patologica applicata a un documento di grandi dimensioni può comunque far sì che la scheda del browser non risponda anche se non è stata generata alcuna eccezione.
Lo strumento esegue inoltre Sostituisci tutto anziché scorrere le corrispondenze singolarmente e non visualizza in anteprima le corrispondenze evidenziate prima della mutazione. Tali limiti rendono importanti i dati di test ristretti e il conteggio delle sostituzioni. Convalidare un'espressione non familiare su un piccolo campione rappresentativo prima di applicarla all'unica copia di un documento di grandi dimensioni.
Il punto è che Text Toolkit tratta i pattern non validi come informazioni, non come errori, così puoi sperimentare in tutta sicurezza
Un modello incompleto è un'informazione sullo stato di modifica, non la prova che l'utente ha fallito. ToolAcre mantiene questa distinzione nei valori restituiti: la compilazione può segnalare un errore senza generare eccezioni, la sostituzione può segnalare zero modifiche senza toccare l'origine e un'operazione riuscita può segnalare esattamente quante corrispondenze ha riscritto.
Quel design supporta la sperimentazione senza fingere che le espressioni regolari siano innocue. Conserva l'input in caso di errore di compilazione, controlla i conteggi dopo il successo e usa l'annullamento quando un modello valido era concettualmente sbagliato. Insieme, questi comportamenti rendono la ricerca e la sostituzione abbastanza prevedibili per gli utenti regex occasionali che necessitano di feedback più che di punizione per un'espressione digitata a metà.