regexio/go
Генерируемый клиент с таймаутами и ретраями. Поддержка контекста и отмены валидации длинных паттернов.
Справочная система · v3.2
Точность в каждом символе
Техническая база знаний RegExio: API и SDK, примеры синтаксиса, глоссарий и инструкции по миграции. Всё, что нужно, чтобы паттерны вашей команды проходили ревью без оговорок.
Быстрый старт
Первый отчёт за четыре команды
От установки CLI до валидированного паттерна — без регистрации и без карты. Ниже минимальный путь для инженера, который уже знаком с регулярными выражениями.
- Установка бинарника из реестра или через brew / go install
- Команда regexio validate читает паттерн из аргумента или из стандартного ввода
- Флаг --engines pcre,re2,dotnet,rust включает кросс-движковый parity по умолчанию
- Результат печатается в stdout в JSON или человекочитаемом виде — удобно для CI
# 1. установка brew tap regexio/tools brew install regexio # 2. проверка паттерна из файла regexio validate config/email.patt \ --engines pcre,re2,dotnet,rust \ --cost-worst true # 3. вывод отчёта в JSON для CI regexio validate -f json config/email.patt > report.json
Код 01 · минимальный вызов CLI. Полный список флагов — в разделе Справочник по API.
Справочник по API
REST и WebSocket — два канала, один контракт
REST отвечает за синхронную валидацию и получение отчётов, WebSocket — за стриминг результатов на больших паттернах и за live-редактирование в IDE-вставках.
{
"pattern": "^[a-z0-9._%+-]+@[a-z0-9.-]+\\.[a-z]{2,}$",
"flags": ["i"],
"engines": ["pcre", "re2"],
"cost": { "worst": true, "samples": 1024 }
}
Отвечает массивом узлов дерева, оценкой стоимости и блоком parity. Заголовок X-Regexio-Report-Id позволяет повторно запросить отчёт по идентификатору.
// клиент отправляет { "type": "patch", "pattern": "(a|b)+c" } // сервер стримит { "type": "cost", "worst": "O(n·m)", "risk": "high" } { "type": "parity", "diff": ["re2:no-lookahead"] } { "type": "done", "ms": 41 }
Каждое изменение паттерна в редакторе шлёт patch-сообщение; сервер возвращает инкрементальные оценки без полного пересчёта дерева.
regexio-py
Синхронный и asyncio-интерфейсы, пандас-совместимый вывод отчётов и интеграция с pytest-фикстурами.
regexio-rs
Безопасная обёртка с trait-интерфейсом, сериализация отчётов в serde и оффлайн-режим для локального CI.
Patterns Library
Библиотека проверенных шаблонов
Каталог паттернов, прошедших стоимость и parity на всех четырёх движках. Каждый шаблон имеет версию, автора и ссылку на отчёт.
Проверено: 4/4 движка · rev 7
Рис. 05 — Patterns Library, раздел «Сетевые форматы»
Email (RFC 6522, упрощённый)
^[a-z0-9._%+-]+@[a-z0-9.-]+\.[a-z]{2,}$
O(n), без lookahead. Автор: А. Верещагин. Отчёт R-2025-0611.
IPv4 / IPv6 дуал
^(\d{1,3}\.){3}\d{1,3}$|^[0-9a-f:]+$
Разделён на альтернативы для предсказуемости в RE2. Отчёт R-2025-0542.
JWT (структурный скелет)
^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]*$
Проверка только формата, подпись не валидируется. Отчёт R-2025-0602.
Глоссарий
Словарь терминов регулярных выражений
Краткие определения, как их использует RegExio в отчётах. Полная версия — в справочнике на 142 страницы.
Катастрофический backtracking
Ситуация, при которой вложенные группы с альтернативой и повторением вызывают экспоненциальный рост числа переборов. RegExio помечает такие паттерны как risk: high и предлагает переформулировку.
Lookaround (lookahead / lookbehind)
Ассерция, не сдвигающая позицию курсора. Поддерживается не всеми движками: RE2 и Rust regex не знают lookbehind, что отражается в блоке parity.
Атомарные группы
Конструкция (…|…) с модификатором, запрещающая возврат. Снижает стоимость, но не заменяет правильный выбор структуры паттерна.
Parity-отчёт
Сводка различий в поведении одного паттерна на разных движках. Каждое отличие классифицируется как блокирующее или предупреждающее.
Миграция
Переход с других инструментов
Пошаговые инструкции для команд, использующих сторонние линтеры и валидаторы. Цель — без потери покрытия и с сохранением CI-порогов.
Из PCRE-скриптов
Команда regexio migrate pcre читает существующие .patt-файлы, строит граф переходов и выдаёт список мест, где поведение может отличаться в RE2.
Из онлайн-валидаторов
Импорт истории из популярных веб-инструментов через CSV. RegExio пересчитывает стоимость и parity для каждого сохранённого паттерна и помечает изменения.
Из собственного CI
Адаптер regexio ci-bridge принимает ваши текущие пороги отклика и переводит их в параметры API, чтобы сборки не ломились в день перехода.
Начните сегодня
Соберите свой справочник за вечер
Импортируйте существующие паттерны, запустите parity-отчёт и получите список правок с оценкой стоимости. Без карты и без регистрации.