RegexSmith

Por qué RegexSmith

Características

• La tarjeta emergente sobre un patrón en C#: el patrón con sus grupos en color, una línea por pieza en palabras sencillas, etiquetas de grupo en color y un estado: ✓ seguro, ⚠ puede bloquearse o ✕ no válido.
• Subrayado de grupos: una línea fina del color del grupo bajo cada grupo de captura, directamente en el código; los grupos anidados quedan más abajo.
• Ejemplos generados a partir del patrón —dos cadenas que coinciden y una que no—, comprobados por el motor real de .NET.
• RX001: una línea ondulada bajo las repeticiones que pueden tardar un tiempo exponencial, con correcciones en Ctrl+. y una vista previa de antes y después.
• El Probador de RegexSmith, acoplado junto a Resultados de la búsqueda: sus ejemplos con expectativas ✓/✗, coincidencias y grupos resaltados, una tabla de grupos y una pestaña Reemplazar.
• Aplicar al código: el patrón editado vuelve al mismo tipo de literal de cadena, con sus opciones, como una sola acción de Deshacer.
• Copiar como prueba unitaria para xUnit, NUnit o MSTest: sus ejemplos se convierten en casos de prueba.

La tarjeta emergente

Pase el puntero sobre la cadena de un patrón y la información sobre herramientas habitual de Visual Studio incluye una tarjeta de RegexSmith: qué significa el patrón, con qué coincide y si es seguro.

Dónde funciona

En archivos C#, sobre el patrón de:

• new Regex("…"), con o sin RegexOptions;
• los métodos estáticos Regex.IsMatch, Match, Matches, Replace, Split y Count;
• [GeneratedRegex("…")];
• [RegularExpression("…")]: la tarjeta indica entonces Validación: debe coincidir todo el valor;
• una const string del mismo archivo que use alguno de ellos.

Las cadenas normales, textuales (@"…") y sin formato ("""…""") se leen como las lee el compilador, así que "\\d" y @"\d" son el mismo patrón.

Qué muestra la tarjeta

El estado

«Seguro» significa solo eso: .NET acepta el patrón y no puede bloquearse. No significa que coincida con lo que usted pretende; para eso están los ejemplos y el probador.

Subrayado de grupos

Cada grupo de captura de un patrón recibe una línea fina de su color directamente en el código, del mismo color que en la tarjeta. Un patrón largo con cinco grupos se lee de un vistazo: qué parte es el año y cuál el id.

Un grupo dentro de otro queda un poco más abajo, para que ambas líneas sigan visibles. Los colores van en orden: salmón, verde, azul, violeta, ámbar, turquesa, y vuelta a empezar.

El subrayado se puede desactivar en la configuración: Subrayar grupos de captura.

Patrones que pueden bloquearse

Algunos patrones tardan un tiempo exponencial con una cadena larga que casi coincide: la forma clásica en que una expresión regular congela una solicitud web. RegexSmith los detecta por su forma y coloca una línea ondulada de advertencia bajo la repetición; pase el puntero sobre ella para ver el motivo.

Qué se subraya (RX001)

• Repetición anidada: (a+)+, ([a-z0-9]+\.?)+: una misma secuencia de caracteres puede repartirse entre la repetición interna y la externa de muchísimas maneras.
• Repetición de alternativas que coinciden con los mismos caracteres: (\w|\d)+: cualquiera de las dos ramas puede tomar un dígito, así que cada dígito duplica el trabajo.

No dentro de grupos atómicos ni de aserciones de búsqueda (lookaround), y nunca con RegexOptions.NonBacktracking: ahí no puede ocurrir.

Correcciones en Ctrl+.

Coloque el cursor sobre la línea ondulada y pulse Ctrl+.: cada corrección muestra una vista previa, con el patrón antes (tachado) y después.

RX001 se puede desactivar en la configuración (Sugerencias en el editor) o con No mostrar este tipo de sugerencia en su información sobre herramientas; las correcciones de Ctrl+. se mantienen.

El probador

El Probador de RegexSmith se abre acoplado junto a Resultados de la búsqueda. El patrón viene del código y sigue vinculado a él: pruébelo con sus propios ejemplos, modifíquelo y escríbalo de vuelta.

Cómo abrirlo

• ▶ Probar patrón… en la tarjeta emergente;
• Ctrl+. sobre un patrón › Probar este patrón en RegexSmith;
• clic derecho en un archivo C# › Probar patrón de expresión regular;
• Ver › Otras ventanas › Probador de RegexSmith: sin vínculo con el código, un lugar para probar un patrón.

El patrón y sus opciones

Arriba, el archivo y la línea del patrón: haga clic para ir allí. Debajo, el cuadro del patrón, la línea de estado (✓ seguro, ⚠ puede bloquearse o el error del motor, y luego N de M según lo esperado · ms) y los botones de opciones: IgnoreCase, Multiline, Singleline, IgnorePatternWhitespace, ExplicitCapture, RightToLeft, CultureInvariant. Cada cambio se vuelve a ejecutar al instante.

Ejemplos y expectativas

La primera vez aparecen los ejemplos de la tarjeta: dos que deben coincidir y uno que no. Escriba uno nuevo en Agregue un ejemplo y presione Entrar…; haga clic en un ejemplo para editarlo y ✕ lo elimina. La marca delante de cada ejemplo indica qué debe hacer; haga clic en ella para cambiarla:

Un ejemplo que hace lo contrario se vuelve rojo —✗ coincide o ✗ no coincide—, así que los ejemplos se convierten en una pequeña especificación del patrón. Las coincidencias aparecen sombreadas, los grupos subrayados con sus colores y los espacios como puntos. Una ejecución que tarda más de 1 segundo se detiene con ⏱ demasiado lento.

Grupos del ejemplo seleccionado enumera cada coincidencia del ejemplo seleccionado: la coincidencia completa y luego cada grupo con su valor y su posición (no capturado cuando no participó).

Reemplazar

La pestaña Reemplazar añade un cuadro de reemplazo —$1, ${name}, $$ para un $— y muestra el resultado de cada ejemplo, tal como lo haría Regex.Replace.

Copiar, revertir, aplicar

Copiar como prueba unitaria pone en el portapapeles una prueba con sus ejemplos, para xUnit, NUnit o MSTest: la especificación pasa al proyecto de pruebas.

Revertir vuelve al patrón y las opciones del código; los ejemplos se conservan.

Aplicar al código escribe el patrón de vuelta como el mismo tipo de literal que era (normal, textual o sin formato), junto con las opciones; una sola acción de Deshacer lo revierte. Si ese código cambió después de que el probador lo abriera, no se escribe nada: vuelva a abrir el probador desde el patrón.

Los ejemplos se recuerdan por patrón y por solución en %LocalAppData%\RegexSmith\samples, así que la próxima vez ya estarán ahí. Nada va al repositorio.

Configuración

Herramientas › Opciones › SmithWorks › RegexSmith. Cada opción tiene una breve descripción de lo que hace.

Opción	Predeterminado
Explicar patrones al mantener el puntero	activado
Subrayar grupos de captura	activado
RX001 Retroceso catastrófico	activado
Pedir una valoración en el Marketplace	activado

Abajo: Restablecer valores predeterminados, Documentación, Valorar en Marketplace y Enviar comentarios.

La configuración se guarda en %LocalAppData%\RegexSmith.

Preguntas frecuentes

Historial de cambios

1.0.1

• Las sugerencias en el editor tienen su propia lista en la página de opciones, y un vínculo en la información sobre herramientas desactiva un tipo de sugerencia justo donde lo ve.

1.0.0

• Primera versión: la tarjeta emergente con un desglose en palabras sencillas, grupos en color, ejemplos comprobados por el motor de .NET y un estado; el subrayado de grupos en el código; RX001 para patrones que pueden bloquearse, con correcciones de grupo atómico y NonBacktracking en Ctrl+.; el Probador de RegexSmith con expectativas, grupos, Reemplazar, Copiar como prueba unitaria y Aplicar al código; una petición única de valoración.