RegexSmith

RegexSmith를 쓰는 이유

기능

• C# 패턴 위의 호버 카드: 그룹이 색으로 구분된 패턴, 각 부분을 쉬운 말로 설명하는 줄, 색이 있는 그룹 태그와 상태 — ✓ 안전, ⚠ 중단될 수 있음 또는 ✕ 잘못됨.
• 그룹 밑줄: 코드 안의 각 캡처 그룹 아래에 그룹 색의 가는 선이 그어집니다. 중첩된 그룹은 더 아래에 표시됩니다.
• 패턴으로 만든 샘플 — 일치하는 문자열 2개와 일치하지 않는 문자열 1개 — 를 실제 .NET 엔진으로 확인합니다.
• RX001: 지수 시간이 걸릴 수 있는 반복 아래에 물결선을 표시하고, Ctrl+.에서 수정과 변경 전후 미리 보기를 제공합니다.
• 찾기 결과 옆에 도킹되는 RegexSmith 테스터: ✓/✗ 기대값이 있는 샘플, 강조 표시되는 일치와 그룹, 그룹 표, 바꾸기 탭.
• 코드에 적용: 편집한 패턴을 옵션과 함께 같은 종류의 문자열 리터럴로 되돌려 쓰며, 실행 취소 한 번으로 되돌릴 수 있습니다.
• xUnit, NUnit, MSTest용 단위 테스트로 복사 — 샘플이 테스트 케이스가 됩니다.

호버 카드

패턴 문자열에 마우스를 올리면 Visual Studio의 일반 도구 설명에 RegexSmith 카드가 추가됩니다. 패턴의 의미, 무엇과 일치하는지, 안전한지를 알려 줍니다.

작동하는 위치

C# 파일에서 다음의 패턴 위:

• RegexOptions 유무와 관계없이 new Regex("…");
• 정적 메서드 Regex.IsMatch, Match, Matches, Replace, Split, Count;
• [GeneratedRegex("…")];
• [RegularExpression("…")] — 이 경우 카드에 유효성 검사: 값 전체가 일치해야 함이라고 표시됩니다;
• 이들 중 하나가 사용하는 같은 파일의 const string.

일반 문자열, 축자 문자열(@"…"), 원시 문자열("""…""")은 컴파일러와 같은 방식으로 읽히므로 "\\d"와 @"\d"는 같은 패턴입니다.

카드에 표시되는 내용

상태

‘안전’은 딱 그 의미뿐입니다: .NET이 패턴을 허용하고 멈출 수 없다는 것. 의도한 대상과 일치한다는 뜻은 아닙니다 — 그것을 확인하는 것이 샘플과 테스터입니다.

그룹 밑줄

패턴의 모든 캡처 그룹에 코드 안에서 바로 그 색의 가는 선이 그어집니다 — 카드와 같은 색입니다. 그룹이 다섯 개인 긴 패턴도 한눈에 읽힙니다: 어느 부분이 연도이고 어느 부분이 ID인지.

다른 그룹 안의 그룹은 조금 더 아래에 표시되므로 두 선이 모두 보입니다. 색은 연어색, 초록, 파랑, 보라, 호박색, 청록 순서로 반복됩니다.

밑줄은 설정에서 끌 수 있습니다: 캡처 그룹에 밑줄 표시.

멈출 수 있는 패턴

어떤 패턴은 거의 일치하는 긴 문자열에서 지수 시간이 걸립니다 — 정규식이 웹 요청을 멈추게 하는 전형적인 경우입니다. RegexSmith는 이런 패턴을 형태로 찾아내 반복 아래에 경고 물결선을 표시합니다. 마우스를 올리면 이유가 나옵니다.

밑줄이 그어지는 대상(RX001)

• 중첩된 반복: (a+)+, ([a-z0-9]+\.?)+ — 같은 문자들의 연속을 안쪽 반복과 바깥쪽 반복 사이에서 매우 많은 방법으로 나눌 수 있습니다.
• 같은 문자와 일치하는 대안의 반복: (\w|\d)+ — 숫자는 어느 분기로도 잡힐 수 있으므로 숫자 하나마다 작업량이 두 배가 됩니다.

원자 그룹이나 전방·후방 탐색 안에서는 해당하지 않으며, RegexOptions.NonBacktracking에서는 절대 표시되지 않습니다 — 그곳에서는 일어날 수 없기 때문입니다.

Ctrl+.의 수정

캐럿을 물결선에 두고 Ctrl+.를 누르세요 — 각 수정에 미리 보기가 표시됩니다: 변경 전(취소선)과 변경 후의 패턴.

RX001은 설정(편집기 힌트)이나 도구 설명의 이 종류의 힌트 표시 안 함으로 끌 수 있습니다. Ctrl+. 수정은 그대로 남습니다.

테스터

RegexSmith 테스터는 찾기 결과 옆에 도킹되어 열립니다. 패턴은 코드에서 가져오며 코드와 연결된 상태로 유지됩니다: 직접 만든 샘플로 시험하고, 바꾸고, 다시 쓰세요.

여는 방법

• 호버 카드의 ▶ 패턴 테스트…;
• 패턴에서 Ctrl+. › RegexSmith에서 이 패턴 테스트;
• C# 파일에서 마우스 오른쪽 클릭 › 정규식 패턴 테스트;
• 보기 › 다른 창 › RegexSmith 테스터 — 코드와 연결되지 않은, 패턴을 시험해 보는 공간입니다.

패턴과 옵션

맨 위에는 패턴의 파일과 줄이 있으며, 클릭하면 그곳으로 이동합니다. 그 아래에는 패턴 상자, 상태 줄(✓ 안전, ⚠ 중단될 수 있음 또는 엔진 오류, 이어서 M개 중 N개 예상대로 · ms), 옵션 칩이 있습니다: IgnoreCase, Multiline, Singleline, IgnorePatternWhitespace, ExplicitCapture, RightToLeft, CultureInvariant. 변경할 때마다 즉시 다시 실행됩니다.

샘플과 기대값

처음에는 카드의 샘플이 들어 있습니다: 일치해야 하는 것 2개와 일치하지 않아야 하는 것 1개. 새 샘플은 샘플을 추가하고 Enter 키를 누르세요…에 입력합니다. 샘플을 클릭하면 편집할 수 있고, ✕를 누르면 제거됩니다. 각 샘플 앞의 표시는 그 샘플이 어떻게 되어야 하는지 나타내며, 클릭해서 바꿀 수 있습니다:

반대로 동작하는 샘플은 빨간색이 됩니다 — ✗ 일치 또는 ✗ 불일치 — 이렇게 샘플은 패턴의 작은 명세가 됩니다. 일치 부분은 색으로 칠해지고, 그룹은 각 색으로 밑줄이 그어지며, 공백은 점으로 표시됩니다. 1초를 넘는 실행은 ⏱ 너무 느림으로 중단됩니다.

선택한 샘플의 그룹에는 선택한 샘플의 모든 일치가 나열됩니다: 전체 일치, 그다음 각 그룹의 값과 위치(참여하지 않은 경우 캡처되지 않음).

바꾸기

바꾸기 탭에는 대체 문자열 상자가 추가되고 — $1, ${name}, $는 $$ — Regex.Replace와 같은 방식으로 각 샘플의 결과가 표시됩니다.

복사, 되돌리기, 적용

단위 테스트로 복사는 샘플을 담은 xUnit, NUnit 또는 MSTest용 테스트를 클립보드에 복사합니다 — 명세가 테스트 프로젝트로 옮겨 갑니다.

되돌리기는 코드의 패턴과 옵션으로 돌아갑니다. 샘플은 그대로 남습니다.

코드에 적용은 패턴을 원래와 같은 종류의 리터럴(일반, 축자, 원시)로 옵션과 함께 다시 씁니다 — 실행 취소 한 번으로 되돌릴 수 있습니다. 테스터가 연 뒤에 그 코드가 바뀌었다면 아무것도 쓰지 않습니다: 패턴에서 테스터를 다시 여세요.

샘플은 패턴별, 솔루션별로 %LocalAppData%\RegexSmith\samples에 기억되므로 다음에도 그대로 있습니다. 리포지토리에는 아무것도 들어가지 않습니다.

설정

도구 › 옵션 › SmithWorks › RegexSmith. 모든 옵션에 하는 일을 알려 주는 짧은 설명이 있습니다.

옵션	기본값
마우스를 올리면 패턴 설명	켜짐
캡처 그룹에 밑줄 표시	켜짐
RX001 치명적인 역추적	켜짐
Marketplace 평가 요청	켜짐

아래쪽에는 기본값으로 다시 설정, 설명서, Marketplace에서 평가, 피드백 보내기가 있습니다.

설정은 %LocalAppData%\RegexSmith에 저장됩니다.

자주 묻는 질문

변경 내역

1.0.1

• 편집기 힌트가 옵션 페이지에 자체 목록을 갖게 되었고, 도구 설명의 링크로 보이는 그 자리에서 힌트 종류를 끌 수 있습니다.

1.0.0

• 첫 릴리스: 쉬운 말로 풀어 쓴 설명, 색으로 구분된 그룹, .NET 엔진으로 확인한 샘플, 상태를 보여 주는 호버 카드; 코드 안의 그룹 밑줄; 멈출 수 있는 패턴을 위한 RX001과 Ctrl+.의 원자 그룹 및 NonBacktracking 수정; 기대값, 그룹, 바꾸기, 단위 테스트로 복사, 코드에 적용을 갖춘 RegexSmith 테스터; 한 번만 하는 평가 요청.