Продуктивность

Шаблоны писем и документов

Подставляет переменные в шаблоны писем и документов и сохраняет результат отдельно.

Python Windows macOS Linux Средний
Скачать templates.py
Описание

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

Шаблон содержит плейсхолдеры вида {{name}}, а значения берутся из JSON или повторяемых флагов set. Скрипт проверяет пропущенные переменные и по умолчанию не меняет исходник. Команда init создаёт пример письма или документа в новом файле.

Перед запуском
  • Результат пишется в новый файл и не заменяет шаблон или готовый документ без --force.
Запуск

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

python templates.py render --template letter.txt --vars data.json --output letter.md

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

Примеры

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

  • python templates.py init --type email --output email.txt
  • python templates.py render --template email.txt --set name=Анна --set company=Demo --output email.md
  • python templates.py list --template email.txt
Зависимости

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

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

templates.py

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

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

CLI 1.0.0

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

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

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

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

Категория

Продуктивность

Заметки, время, задачи, напоминания и автоматизация рутины.