RegexSmith

Proč RegexSmith

Funkce

• Karta při najetí myší nad vzorem v C#: vzor s barevnými skupinami, řádek srozumitelnými slovy pro každou část, barevné štítky skupin a stav — ✓ bezpečný, ⚠ může zamrznout nebo ✕ neplatný.
• Podtržení skupin: tenká čára v barvě skupiny pod každou zachytávací skupinou přímo v kódu; vnořené skupiny leží níž.
• Příklady vytvořené ze vzoru — dva řetězce, které odpovídají, a jeden, který ne — ověřené skutečným enginem .NET.
• RX001: vlnovka pod opakováními, která mohou trvat exponenciálně dlouho, s opravami v Ctrl+. a náhledem před a po.
• Tester RegexSmith, ukotvený vedle okna Výsledky hledání: vaše příklady s očekáváním ✓/✗, zvýrazněné shody a skupiny, tabulka skupin a karta Nahradit.
• Použít v kódu: upravený vzor se vrátí do stejného druhu řetězcového literálu, i s možnostmi, jako jeden krok Zpět.
• Kopírovat jako test jednotek pro xUnit, NUnit nebo MSTest — z vašich příkladů se stanou testovací případy.

Karta při najetí myší

Najeďte myší na řetězec vzoru a běžný popisek Visual Studia dostane kartu RegexSmith: co vzor znamená, čemu odpovídá a zda je bezpečný.

Kde funguje

V souborech C# nad vzorem v:

• new Regex("…"), s RegexOptions i bez nich;
• statických metodách Regex.IsMatch, Match, Matches, Replace, Split a Count;
• [GeneratedRegex("…")];
• [RegularExpression("…")] — karta pak uvádí Ověření: musí odpovídat celá hodnota;
• const string ve stejném souboru, který některé z nich používá.

Běžné, doslovné (@"…") i surové ("""…""") řetězce se čtou tak, jak je čte kompilátor, takže "\\d" a @"\d" jsou tentýž vzor.

Co karta ukazuje

Stav

„Bezpečný“ znamená jen to, že .NET vzor přijímá a nemůže zamrznout. Neznamená, že odpovídá tomu, co zamýšlíte — k tomu slouží příklady a tester.

Podtržení skupin

Každá zachytávací skupina vzoru dostane přímo v kódu tenkou čáru ve své barvě — ve stejné barvě jako na kartě. Dlouhý vzor s pěti skupinami se tak dá přečíst na první pohled: která část je rok a která id.

Skupina uvnitř jiné leží o kousek níž, aby zůstaly vidět obě čáry. Barvy jdou popořadě: lososová, zelená, modrá, fialová, jantarová, tyrkysová — a znovu.

Podtržení lze vypnout v nastavení: Podtrhávat zachytávající skupiny.

Vzory, které mohou zamrznout

Některé vzory trvají na dlouhém řetězci, který téměř odpovídá, exponenciálně dlouho — klasický způsob, jak regulární výraz zablokuje webový požadavek. RegexSmith je najde podle jejich tvaru a pod opakování umístí varovnou vlnovku; najetím myší zjistíte důvod.

Co se podtrhuje (RX001)

• Vnořené opakování: (a+)+, ([a-z0-9]+\.?)+ — jeden úsek stejných znaků lze mezi vnitřní a vnější opakování rozdělit velmi mnoha způsoby.
• Opakování alternativ, které odpovídají stejným znakům: (\w|\d)+ — číslici může vzít kterákoli větev, takže každá číslice práci zdvojnásobí.

Ne uvnitř atomických skupin a výhledů (lookaround) a nikdy s RegexOptions.NonBacktracking — tam k tomu dojít nemůže.

Opravy v Ctrl+.

Umístěte kurzor na vlnovku a stiskněte Ctrl+. — každá oprava ukáže náhled: vzor před (přeškrtnutý) a po.

RX001 lze vypnout v nastavení (Nápovědy v editoru) nebo odkazem Tento druh nápovědy nezobrazovat v jeho popisku; opravy v Ctrl+. zůstávají.

Tester

Tester RegexSmith se otevře ukotvený vedle okna Výsledky hledání. Vzor pochází z kódu a zůstává s ním propojený: vyzkoušejte ho na vlastních příkladech, upravte ho a zapište zpět.

Jak ho otevřít

• ▶ Otestovat vzor… na kartě při najetí myší;
• Ctrl+. na vzoru › Otestovat tento vzor v RegexSmith;
• pravé tlačítko v souboru C# › Otestovat vzor regulárního výrazu;
• Zobrazit › Další okna › Tester RegexSmith — bez propojení s kódem: místo, kde vyzkoušet vzor.

Vzor a jeho možnosti

Nahoře soubor a řádek vzoru — kliknutím na něj přejdete. Pod ním pole vzoru, stavový řádek (✓ bezpečný, ⚠ může zamrznout nebo chyba enginu, pak N z M podle očekávání · ms) a přepínače možností: IgnoreCase, Multiline, Singleline, IgnorePatternWhitespace, ExplicitCapture, RightToLeft, CultureInvariant. Každá změna se okamžitě spustí znovu.

Příklady a očekávání

Napoprvé jsou tu příklady z karty: dva, které mají odpovídat, a jeden, který nemá. Nový napište do pole Přidejte ukázku a stiskněte Enter…; kliknutím na příklad ho upravíte, ✕ ho odstraní. Značka před každým příkladem říká, co má dělat — kliknutím ji změníte:

Příklad, který dělá opak, zčervená — ✗ odpovídá nebo ✗ neodpovídá — takže se z příkladů stane malá specifikace vzoru. Shody jsou podbarvené, skupiny podtržené svými barvami, mezery zobrazené jako tečky. Běh, který trvá déle než 1 sekundu, se zastaví s ⏱ příliš pomalé.

Skupiny vybrané ukázky vypíše každou shodu vybraného příkladu: celou shodu a pak každou skupinu s její hodnotou a pozicí (nezachyceno, když se jí neúčastnila).

Nahradit

Karta Nahradit přidá pole náhrady — $1, ${name}, $$ pro $ — a ukáže výsledek pro každý příklad tak, jak by ho vrátil Regex.Replace.

Kopírovat, vrátit, použít

Kopírovat jako test jednotek vloží do schránky test s vašimi příklady pro xUnit, NUnit nebo MSTest — specifikace se přesune do testovacího projektu.

Vrátit se vrátí ke vzoru a možnostem z kódu; příklady zůstanou.

Použít v kódu zapíše vzor zpět jako stejný druh literálu, jakým byl (běžný, doslovný nebo surový), spolu s možnostmi — jeden krok Zpět to vrátí. Pokud se kód po otevření testeru změnil, nic se nezapíše: otevřete tester ze vzoru znovu.

Příklady se pamatují pro každý vzor a každé řešení v %LocalAppData%\RegexSmith\samples, takže příště už tam budou. Do repozitáře nic nejde.

Nastavení

Nástroje › Možnosti › SmithWorks › RegexSmith. Každá možnost má krátký popis toho, co dělá.

Možnost	Výchozí
Vysvětlovat vzory při najetí myší	zapnuto
Podtrhávat zachytávající skupiny	zapnuto
RX001 Katastrofální backtracking	zapnuto
Požádat o hodnocení na Marketplace	zapnuto

Dole: Obnovit výchozí, Dokumentace, Ohodnotit na Marketplace a Odeslat zpětnou vazbu.

Nastavení se ukládá do %LocalAppData%\RegexSmith.

Časté dotazy

Historie změn

1.0.1

• Nápovědy v editoru mají na stránce možností vlastní seznam a odkaz v popisku vypne druh nápovědy přímo tam, kde ji vidíte.

1.0.0

• První vydání: karta při najetí myší s rozborem srozumitelnými slovy, barevnými skupinami, příklady ověřenými enginem .NET a stavem; podtržení skupin v kódu; RX001 pro vzory, které mohou zamrznout, s opravami atomickou skupinou a NonBacktracking v Ctrl+.; Tester RegexSmith s očekáváním, skupinami, kartou Nahradit, příkazy Kopírovat jako test jednotek a Použít v kódu; jednorázová prosba o hodnocení.