Текст и документы

Замена по регулярному выражению

Меняет текст по regex с группами и обратными ссылками, сначала показывая примеры замен.

Python Windows macOS Linux Продвинутый
Скачать regex_replace.py
Описание

Что делает скрипт

Скрипт компилирует шаблон, ищет совпадения в файлах и показывает до пяти примеров до и после. Запись выполняется только с флагом --apply, по умолчанию в отдельную папку. Флаг --in-place дополнительно создаёт резервную копию .bak.

Перед запуском
  • Проверьте примеры замены перед использованием --apply.
  • --in-place меняет исходники и создаёт копии .bak.
Запуск

Быстрый старт

python regex_replace.py --path ./docs --pattern '(\d{4})-(\d{2})' --replacement '\2.\1'

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python regex_replace.py --path notes.md --pattern '\s+$' --replacement '' --flags m
  • python regex_replace.py --path ./docs --pattern 'draft' --replacement 'final' --apply
  • python regex_replace.py --path ./docs --pattern 'color' --replacement 'colour' --flags i --apply --in-place
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Исходник

regex_replace.py

#!/usr/bin/env python3
"""Замена текста по регулярному выражению с предпросмотром."""
from __future__ import annotations

import argparse
import re
import shutil
from pathlib import Path


def collect_files(root: Path, pattern: str, out_dir: Path) -> list[Path]:
    if root.is_file():
        return [root]
    files = []
    for path in sorted(root.rglob(pattern)):
        if path.is_file() and out_dir not in path.parents:
            files.append(path)
    return files


def parse_flags(value: str) -> int:
    flags = 0
    for char in value:
        if char == "i":
            flags |= re.IGNORECASE
        elif char == "m":
            flags |= re.MULTILINE
        elif char == "s":
            flags |= re.DOTALL
        elif char == "x":
            flags |= re.VERBOSE
        else:
            raise ValueError(f"Неизвестный флаг: {char}")
    return flags


def show_examples(text: str, regex: re.Pattern[str], replacement: str, limit: int) -> None:
    for index, match in enumerate(regex.finditer(text)):
        if index >= limit:
            break
        line = text.count("\n", 0, match.start()) + 1
        before = match.group(0)
        after = match.expand(replacement)
        print(f"  строка {line}: {before!r} -> {after!r}")


def main() -> int:
    parser = argparse.ArgumentParser(description="Замена по регулярному выражению")
    parser.add_argument("--path", type=Path, required=True, help="Файл или папка")
    parser.add_argument("--pattern", required=True, help="Регулярное выражение")
    parser.add_argument("--replacement", required=True, help="Строка замены, можно \\1 и \\g<name>")
    parser.add_argument("--flags", default="", help="Флаги regex: i, m, s, x")
    parser.add_argument("--glob", default="*", help="Маска файлов")
    parser.add_argument("--encoding", default="utf-8", help="Кодировка файлов")
    parser.add_argument("--output-dir", type=Path, default=Path("text-out"), help="Папка для копий")
    parser.add_argument("--apply", action="store_true", help="Записать результат")
    parser.add_argument("--in-place", action="store_true", help="Править исходные файлы")
    parser.add_argument("--dry-run", action="store_true", help="Только показать совпадения")
    parser.add_argument("--max-preview", type=int, default=5, help="Сколько примеров показать")
    args = parser.parse_args()

    root = args.path.expanduser().resolve()
    if not root.exists():
        parser.error(f"Путь не найден: {root}")
    if args.apply and args.dry_run:
        parser.error("Флаги --apply и --dry-run несовместимы")
    if args.in_place and not args.apply:
        parser.error("Для --in-place нужен --apply")
    try:
        regex = re.compile(args.pattern, parse_flags(args.flags))
    except (re.error, ValueError) as error:
        parser.error(f"Ошибка шаблона: {error}")

    out_dir = args.output_dir.expanduser().resolve()
    total_files = 0
    total_hits = 0

    for source in collect_files(root, args.glob, out_dir):
        try:
            text = source.read_text(encoding=args.encoding)
        except (UnicodeDecodeError, OSError) as error:
            print(f"Пропуск {source}: {error}")
            continue
        updated, hits = regex.subn(args.replacement, text)
        if hits == 0:
            continue
        total_files += 1
        total_hits += hits
        print(f"{source}: {hits} замен")
        show_examples(text, regex, args.replacement, args.max_preview)
        if not args.apply:
            continue
        if args.in_place:
            backup = source.with_name(source.name + ".bak")
            shutil.copy2(source, backup)
            source.write_text(updated, encoding=args.encoding)
        else:
            relative = source.relative_to(root) if root.is_dir() else Path(source.name)
            target = out_dir / relative
            if target.resolve() == source.resolve():
                print(f"  пропуск, выходной путь совпадает с входным: {source}")
                continue
            target.parent.mkdir(parents=True, exist_ok=True)
            target.write_text(updated, encoding=args.encoding)
            print(f"  записано {target}")

    print(f"Файлов: {total_files}, замен: {total_hits}")
    if not args.apply:
        print("Это предпросмотр. Для записи добавьте --apply.")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get text-regex-replace
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Текст и документы

Поиск, замена, кодировки, Markdown, CSV и работа с большими текстами.