Замена по регулярному выражению
Меняет текст по regex с группами и обратными ссылками, сначала показывая примеры замен.
Что делает скрипт
Скрипт компилирует шаблон, ищет совпадения в файлах и показывает до пяти примеров до и после. Запись выполняется только с флагом --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 mpython regex_replace.py --path ./docs --pattern 'draft' --replacement 'final' --applypython regex_replace.py --path ./docs --pattern 'color' --replacement 'colour' --flags i --apply --in-place
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.