RegexSmith

Perché RegexSmith

Funzionalità

• La scheda al passaggio del mouse su un pattern in C#: il pattern con i gruppi colorati, una riga per ogni parte in parole semplici, etichette dei gruppi colorate e uno stato — ✓ sicuro, ⚠ può bloccarsi o ✕ non valido.
• Sottolineature dei gruppi: una linea sottile del colore del gruppo sotto ogni gruppo di cattura, direttamente nel codice; i gruppi annidati stanno più in basso.
• Esempi ricavati dal pattern — due stringhe che corrispondono e una che non corrisponde — verificati dal vero motore di .NET.
• RX001: una sottolineatura ondulata sotto le ripetizioni che possono richiedere un tempo esponenziale, con correzioni in Ctrl+. e un’anteprima prima/dopo.
• Il Tester RegexSmith, ancorato accanto a Risultati ricerca: i tuoi esempi con aspettative ✓/✗, corrispondenze e gruppi evidenziati, una tabella dei gruppi e una scheda Sostituisci.
• Applica al codice: il pattern modificato torna nello stesso tipo di stringa letterale, con le sue opzioni, come un unico Annulla.
• Copia come unit test per xUnit, NUnit o MSTest — i tuoi esempi diventano casi di test.

La scheda al passaggio del mouse

Passa il mouse sulla stringa di un pattern e la normale descrizione comando di Visual Studio riceve una scheda di RegexSmith: cosa significa il pattern, cosa trova e se è sicuro.

Dove funziona

Nei file C#, sul pattern di:

• new Regex("…"), con o senza RegexOptions;
• i metodi statici Regex.IsMatch, Match, Matches, Replace, Split e Count;
• [GeneratedRegex("…")];
• [RegularExpression("…")] — la scheda indica allora Convalida: deve corrispondere l'intero valore;
• una const string nello stesso file usata da uno di questi.

Le stringhe normali, verbatim (@"…") e raw ("""…""") vengono lette come le legge il compilatore, quindi "\\d" e @"\d" sono lo stesso pattern.

Cosa mostra la scheda

Lo stato

«Sicuro» significa solo questo: .NET accetta il pattern e non può bloccarsi. Non significa che trovi ciò che intendi — a questo servono gli esempi e il tester.

Sottolineature dei gruppi

Ogni gruppo di cattura di un pattern riceve una linea sottile del suo colore direttamente nel codice — lo stesso colore della scheda. Un pattern lungo con cinque gruppi si legge a colpo d’occhio: quale parte è l’anno, quale l’id.

Un gruppo dentro un altro sta un po’ più in basso, così entrambe le linee restano visibili. I colori seguono quest’ordine: salmone, verde, blu, viola, ambra, verde acqua — e di nuovo.

Le sottolineature si possono disattivare nelle impostazioni: Sottolinea i gruppi di acquisizione.

Pattern che possono bloccarsi

Alcuni pattern richiedono un tempo esponenziale su una stringa lunga che quasi corrisponde — il classico modo in cui una regex blocca una richiesta web. RegexSmith li riconosce dalla loro forma e mette una sottolineatura ondulata di avviso sotto la ripetizione; passaci sopra con il mouse per conoscerne il motivo.

Cosa viene sottolineato (RX001)

• Ripetizione annidata: (a+)+, ([a-z0-9]+\.?)+ — una sequenza degli stessi caratteri può essere divisa tra la ripetizione interna e quella esterna in moltissimi modi.
• Ripetizione di alternative che corrispondono agli stessi caratteri: (\w|\d)+ — una cifra può essere presa da entrambi i rami, quindi ogni cifra raddoppia il lavoro.

Non all’interno di gruppi atomici o lookaround, e mai con RegexOptions.NonBacktracking — lì non può succedere.

Correzioni in Ctrl+.

Metti il cursore sulla sottolineatura ondulata e premi Ctrl+. — ogni correzione mostra un’anteprima: il pattern prima (barrato) e dopo.

RX001 si può disattivare nelle impostazioni (Suggerimenti nell’editor) o con Non mostrare questo tipo di suggerimento nella sua descrizione comando; le correzioni in Ctrl+. restano.

Il tester

Il Tester RegexSmith si apre ancorato accanto a Risultati ricerca. Il pattern proviene dal codice e resta collegato a esso: provalo sui tuoi esempi, modificalo e riscrivilo nel codice.

Come aprirlo

• ▶ Testa il modello… nella scheda al passaggio del mouse;
• Ctrl+. su un pattern › Testa questo modello in RegexSmith;
• clic destro in un file C# › Testa modello di espressione regolare;
• Visualizza › Altre finestre › Tester RegexSmith — non collegato al codice: un posto dove provare un pattern.

Il pattern e le sue opzioni

In alto, il file e la riga del pattern — fai clic per andarci. Sotto, la casella del pattern, la riga di stato (✓ sicuro, ⚠ può bloccarsi o l’errore del motore, poi N su M come previsto · ms) e i chip delle opzioni: IgnoreCase, Multiline, Singleline, IgnorePatternWhitespace, ExplicitCapture, RightToLeft, CultureInvariant. Ogni modifica viene eseguita di nuovo all’istante.

Esempi e aspettative

La prima volta ci sono gli esempi della scheda: due che dovrebbero corrispondere e uno che non dovrebbe. Digitane uno nuovo in Aggiungi un esempio e premi INVIO…; fai clic su un esempio per modificarlo, ✕ lo rimuove. Il segno prima di ogni esempio dice cosa dovrebbe fare — fai clic per cambiarlo:

Un esempio che fa il contrario diventa rosso — ✗ corrisponde o ✗ nessuna corrispondenza — così gli esempi diventano una piccola specifica del pattern. Le corrispondenze sono evidenziate, i gruppi sottolineati nei loro colori, gli spazi mostrati come puntini. Un’esecuzione che dura più di 1 secondo si interrompe con ⏱ troppo lento.

Gruppi dell'esempio selezionato elenca ogni corrispondenza dell’esempio selezionato: la corrispondenza intera, poi ogni gruppo con il suo valore e la sua posizione (non acquisito quando non ha partecipato).

Sostituisci

La scheda Sostituisci aggiunge una casella di sostituzione — $1, ${name}, $$ per un $ — e mostra il risultato per ogni esempio, come farebbe Regex.Replace.

Copiare, ripristinare, applicare

Copia come unit test mette negli Appunti un test con i tuoi esempi, per xUnit, NUnit o MSTest — la specifica passa nel progetto di test.

Ripristina torna al pattern e alle opzioni del codice; gli esempi restano.

Applica al codice riscrive il pattern nello stesso tipo di letterale che era (normale, verbatim o raw) insieme alle opzioni — un solo Annulla lo riporta indietro. Se quel codice è cambiato dopo che il tester lo ha aperto, non viene scritto nulla: apri di nuovo il tester dal pattern.

Gli esempi vengono ricordati per pattern e per soluzione in %LocalAppData%\RegexSmith\samples, così la volta successiva sono già lì. Nulla finisce nel repository.

Impostazioni

Strumenti › Opzioni › SmithWorks › RegexSmith. Ogni opzione ha una breve descrizione di cosa fa.

Opzione	Predefinito
Spiega i modelli al passaggio del mouse	attivo
Sottolinea i gruppi di acquisizione	attivo
RX001 Backtracking catastrofico	attivo
Chiedi una valutazione sul Marketplace	attivo

In basso: Ripristina predefiniti, Documentazione, Valuta nel Marketplace e Invia feedback.

Le impostazioni sono salvate in %LocalAppData%\RegexSmith.

FAQ

Registro modifiche

1.0.1

• I suggerimenti nell’editor hanno un proprio elenco nella pagina delle opzioni e un collegamento nella descrizione comando disattiva un tipo di suggerimento proprio dove lo vedi.

1.0.0

• Prima versione: la scheda al passaggio del mouse con una scomposizione in parole semplici, gruppi colorati, esempi verificati dal motore di .NET e uno stato; le sottolineature dei gruppi nel codice; RX001 per i pattern che possono bloccarsi, con correzioni atomiche e NonBacktracking in Ctrl+.; il Tester RegexSmith con aspettative, gruppi, Sostituisci, Copia come unit test e Applica al codice; una sola richiesta di valutazione.