#!/usr/bin/env python3 """Шаблоны писем и документов с подстановкой переменных.""" from __future__ import annotations import argparse import json import re from pathlib import Path PLACEHOLDER = re.compile(r"{{\s*([A-Za-z0-9_.-]+)\s*}}") EMAIL_TEMPLATE = """Тема: {{subject}} Здравствуйте, {{name}}! {{body}} С уважением, {{sender}} {{signature}} """ DOCUMENT_TEMPLATE = """# {{title}} Дата: {{date}} Автор: {{author}} ## Цель {{purpose}} ## Основная часть {{body}} ## Итог {{summary}} """ def parse_values(args: argparse.Namespace) -> dict[str, str]: values: dict[str, str] = {} if args.vars: path = args.vars.expanduser() if not path.is_file(): raise SystemExit(f"Файл переменных не найден: {path}") try: data = json.loads(path.read_text(encoding="utf-8")) except json.JSONDecodeError as error: raise SystemExit(f"Ошибка JSON: {error}") if not isinstance(data, dict): raise SystemExit("Файл переменных должен содержать объект") values.update({str(key): str(value) for key, value in data.items()}) for item in args.set or []: if "=" not in item: raise SystemExit(f"Ожидался формат key=value: {item}") key, value = item.split("=", 1) values[key.strip()] = value return values def command_init(args: argparse.Namespace) -> int: output = args.output.expanduser() if output.exists() and not args.force: raise SystemExit(f"Файл уже существует: {output}. Добавьте --force.") output.parent.mkdir(parents=True, exist_ok=True) text = EMAIL_TEMPLATE if args.type == "email" else DOCUMENT_TEMPLATE output.write_text(text, encoding="utf-8") print(f"Шаблон создан: {output}") return 0 def command_render(args: argparse.Namespace) -> int: template = args.template.expanduser() if not template.is_file(): raise SystemExit(f"Шаблон не найден: {template}") text = template.read_text(encoding="utf-8") values = parse_values(args) missing = sorted({match.group(1) for match in PLACEHOLDER.finditer(text) if match.group(1) not in values}) if missing and not args.allow_missing: raise SystemExit("Не заданы переменные: " + ", ".join(missing)) result = PLACEHOLDER.sub(lambda match: values.get(match.group(1), match.group(0)), text) output = args.output.expanduser() if output.exists() and not args.force: raise SystemExit(f"Файл уже существует: {output}. Добавьте --force.") output.parent.mkdir(parents=True, exist_ok=True) output.write_text(result, encoding="utf-8") print(f"Готовый файл: {output}") return 0 def command_list(args: argparse.Namespace) -> int: template = args.template.expanduser() if not template.is_file(): raise SystemExit(f"Шаблон не найден: {template}") names = sorted({match.group(1) for match in PLACEHOLDER.finditer(template.read_text(encoding="utf-8"))}) if not names: print("Переменных в шаблоне нет.") return 0 for name in names: print(name) return 0 def build_parser() -> argparse.ArgumentParser: parser = argparse.ArgumentParser(description="Шаблоны писем и документов") sub = parser.add_subparsers(dest="command", required=True) init_parser = sub.add_parser("init", help="Создать пример шаблона") init_parser.add_argument("--type", choices=["email", "document"], default="email") init_parser.add_argument("--output", type=Path, required=True) init_parser.add_argument("--force", action="store_true") init_parser.set_defaults(func=command_init) render_parser = sub.add_parser("render", help="Подставить переменные") render_parser.add_argument("--template", type=Path, required=True) render_parser.add_argument("--vars", type=Path) render_parser.add_argument("--set", action="append", default=[], help="key=value, можно повторять") render_parser.add_argument("--output", type=Path, required=True) render_parser.add_argument("--force", action="store_true") render_parser.add_argument("--allow-missing", action="store_true") render_parser.set_defaults(func=command_render) list_parser = sub.add_parser("list", help="Показать переменные шаблона") list_parser.add_argument("--template", type=Path, required=True) list_parser.set_defaults(func=command_list) return parser def main() -> int: args = build_parser().parse_args() return args.func(args) if __name__ == "__main__": raise SystemExit(main())