#!/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") 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())