RegexSmith

Warum RegexSmith

Funktionen

• Die Hover-Karte über einem Muster in C#: das Muster mit farbigen Gruppen, eine Zeile pro Teil in einfachen Worten, farbige Gruppenetiketten und ein Status – ✓ sicher, ⚠ kann hängen oder ✕ ungültig.
• Gruppenunterstreichungen: eine dünne Linie in der Farbe der Gruppe unter jeder Erfassungsgruppe direkt im Code; verschachtelte Gruppen liegen tiefer.
• Beispiele aus dem Muster – zwei Zeichenfolgen, die passen, und eine, die nicht passt – geprüft von der echten .NET-Engine.
• RX001: eine Wellenlinie unter Wiederholungen, die exponentielle Zeit brauchen können, mit Korrekturen in Ctrl+. und einer Vorher-Nachher-Vorschau.
• Der RegexSmith-Tester, angedockt neben den Suchergebnissen: Ihre Beispiele mit ✓/✗-Erwartungen, hervorgehobene Treffer und Gruppen, eine Gruppentabelle und eine Registerkarte Ersetzen.
• Auf Code anwenden: Das bearbeitete Muster kommt in dieselbe Art von Zeichenfolgenliteral zurück, mit seinen Optionen, als ein einziges Rückgängig.
• Als Komponententest kopieren für xUnit, NUnit oder MSTest – Ihre Beispiele werden zu Testfällen.

Die Hover-Karte

Zeigen Sie auf die Zeichenfolge eines Musters, und die übliche QuickInfo von Visual Studio erhält eine RegexSmith-Karte: was das Muster bedeutet, was es findet und ob es sicher ist.

Wo sie funktioniert

In C#-Dateien über dem Muster von:

• new Regex("…"), mit oder ohne RegexOptions;
• den statischen Methoden Regex.IsMatch, Match, Matches, Replace, Split und Count;
• [GeneratedRegex("…")];
• [RegularExpression("…")] – die Karte zeigt dann Validierung: Der gesamte Wert muss passen;
• einem const string in derselben Datei, den einer davon verwendet.

Normale, wörtliche (@"…") und rohe ("""…""") Zeichenfolgen werden so gelesen wie vom Compiler, daher sind "\\d" und @"\d" dasselbe Muster.

Was die Karte zeigt

Der Status

„Sicher“ bedeutet nur das: .NET akzeptiert das Muster, und es kann nicht hängen. Es bedeutet nicht, dass es findet, was Sie beabsichtigen – dafür gibt es die Beispiele und den Tester.

Gruppenunterstreichungen

Jede Erfassungsgruppe eines Musters erhält direkt im Code eine dünne Linie in ihrer Farbe – derselben Farbe wie in der Karte. Ein langes Muster mit fünf Gruppen lässt sich so auf einen Blick lesen: welcher Teil das Jahr ist, welcher die ID.

Eine Gruppe in einer anderen liegt etwas tiefer, sodass beide Linien sichtbar bleiben. Die Farben folgen der Reihe nach: Lachs, Grün, Blau, Violett, Bernstein, Türkis – und wieder von vorn.

Die Unterstreichungen lassen sich in den Einstellungen ausschalten: Erfassungsgruppen unterstreichen.

Muster, die hängen können

Manche Muster brauchen bei einer langen Zeichenfolge, die fast passt, exponentielle Zeit – der klassische Weg, wie ein regulärer Ausdruck eine Webanfrage einfriert. RegexSmith erkennt sie an ihrer Form und setzt eine Warn-Wellenlinie unter die Wiederholung; zeigen Sie darauf, um den Grund zu sehen.

Was unterstrichen wird (RX001)

• Verschachtelte Wiederholung: (a+)+, ([a-z0-9]+\.?)+ – eine Folge gleicher Zeichen lässt sich auf sehr viele Arten zwischen innerer und äußerer Wiederholung aufteilen.
• Wiederholung von Alternativen, die dieselben Zeichen treffen: (\w|\d)+ – eine Ziffer kann von jedem der beiden Zweige genommen werden, also verdoppelt jede Ziffer die Arbeit.

Nicht innerhalb atomarer Gruppen oder Lookarounds und nie mit RegexOptions.NonBacktracking – dort kann es nicht passieren.

Korrekturen in Ctrl+.

Setzen Sie den Cursor auf die Wellenlinie und drücken Sie Ctrl+. – jede Korrektur zeigt eine Vorschau: das Muster vorher (durchgestrichen) und nachher.

RX001 lässt sich in den Einstellungen (Hinweise im Editor) oder mit Diese Art von Hinweis nicht anzeigen im Tooltip ausschalten; die Korrekturen unter Ctrl+. bleiben.

Der Tester

Der RegexSmith-Tester öffnet sich angedockt neben den Suchergebnissen. Das Muster kommt aus dem Code und bleibt mit ihm verknüpft: Probieren Sie es an eigenen Beispielen aus, ändern Sie es und schreiben Sie es zurück.

Öffnen

• ▶ Muster testen… in der Hover-Karte;
• Ctrl+. auf einem Muster › Dieses Muster in RegexSmith testen;
• Rechtsklick in einer C#-Datei › Regex-Muster testen;
• Ansicht › Weitere Fenster › RegexSmith-Tester – nicht mit Code verknüpft: ein Ort, um ein Muster auszuprobieren.

Das Muster und seine Optionen

Oben Datei und Zeile des Musters – ein Klick führt dorthin. Darunter das Musterfeld, die Statuszeile (✓ sicher, ⚠ kann hängen oder der Fehler der Engine, dann N von M wie erwartet · ms) und die Optionsschalter: IgnoreCase, Multiline, Singleline, IgnorePatternWhitespace, ExplicitCapture, RightToLeft, CultureInvariant. Jede Änderung wird sofort neu ausgeführt.

Beispiele und Erwartungen

Beim ersten Mal sind die Beispiele der Karte da: zwei, die passen sollen, und eines, das nicht passen soll. Ein neues geben Sie in Beispiel hinzufügen und Eingabetaste drücken… ein; ein Klick auf ein Beispiel bearbeitet es, ✕ entfernt es. Das Zeichen vor jedem Beispiel sagt, was es tun soll – ein Klick ändert es:

Ein Beispiel, das das Gegenteil tut, wird rot – ✗ passt oder ✗ passt nicht –, so werden die Beispiele zu einer kleinen Spezifikation des Musters. Treffer sind getönt, Gruppen in ihren Farben unterstrichen, Leerzeichen als Punkte dargestellt. Ein Lauf, der länger als 1 Sekunde dauert, stoppt mit ⏱ zu langsam.

Gruppen des ausgewählten Beispiels listet jeden Treffer des ausgewählten Beispiels auf: den gesamten Treffer, dann jede Gruppe mit Wert und Position (nicht erfasst, wenn sie nicht beteiligt war).

Ersetzen

Die Registerkarte Ersetzen fügt ein Ersetzungsfeld hinzu – $1, ${name}, $$ für ein $ – und zeigt das Ergebnis für jedes Beispiel, wie es Regex.Replace liefern würde.

Kopieren, zurücksetzen, anwenden

Als Komponententest kopieren legt einen Test mit Ihren Beispielen in die Zwischenablage, für xUnit, NUnit oder MSTest – die Spezifikation wandert ins Testprojekt.

Zurücksetzen kehrt zu Muster und Optionen aus dem Code zurück; die Beispiele bleiben.

Auf Code anwenden schreibt das Muster als dieselbe Art von Literal zurück, die es war (normal, wörtlich oder roh), zusammen mit den Optionen – ein Rückgängig macht es wieder rückgängig. Hat sich der Code geändert, nachdem der Tester ihn geöffnet hat, wird nichts geschrieben: Öffnen Sie den Tester erneut vom Muster aus.

Die Beispiele werden pro Muster und pro Projektmappe in %LocalAppData%\RegexSmith\samples gespeichert, sodass sie beim nächsten Mal schon da sind. Nichts landet im Repository.

Einstellungen

Extras › Optionen › SmithWorks › RegexSmith. Jede Option hat eine kurze Beschreibung ihrer Wirkung.

Option	Standard
Muster beim Daraufzeigen erklären	ein
Erfassungsgruppen unterstreichen	ein
RX001 Katastrophales Backtracking	ein
Um eine Bewertung im Marketplace bitten	ein

Unten: Auf Standard zurücksetzen, Dokumentation, Im Marketplace bewerten und Feedback senden.

Die Einstellungen werden in %LocalAppData%\RegexSmith gespeichert.

FAQ

Änderungsprotokoll

1.0.1

• Hinweise im Editor haben eine eigene Liste auf der Optionsseite, und ein Link im Tooltip schaltet eine Art von Hinweis direkt dort ab, wo Sie ihn sehen.

1.0.0

• Erste Version: die Hover-Karte mit einer Aufschlüsselung in einfachen Worten, farbigen Gruppen, von der .NET-Engine geprüften Beispielen und einem Status; Gruppenunterstreichungen im Code; RX001 für Muster, die hängen können, mit Korrekturen per atomarer Gruppe und NonBacktracking in Ctrl+.; der RegexSmith-Tester mit Erwartungen, Gruppen, Ersetzen, „Als Komponententest kopieren“ und „Auf Code anwenden“; eine einmalige Bitte um eine Bewertung.