Skip to content

FINAL_TEMPLATE_UPDATE.md

Latest commit

 

History

History
167 lines (137 loc) · 6.92 KB

FINAL_TEMPLATE_UPDATE.md

File metadata and controls

167 lines (137 loc) · 6.92 KB

Финальное обновление функции substitute_template_variables

✅ Выполненные изменения

1. Новый формат переменных

Было: {field} (одинарные фигурные скобки)
Стало: {{field}} (двойные фигурные скобки)

2. Поддерживаемые поля

Поле Описание Источник данных
{{first}} Имя user.name.first
{{middle}} Отчество user.name.middle
{{name}} Полное имя user.name.first + user.name.middle + user.name.last
{{position}} Должность user.position
{{mail}} Email адрес user.nickname@domain или user.emails[0]
{{telephone}} Рабочий телефон user.phone
{{mobile}} Мобильный телефон user.mobile или из user.phones
{{department}} Отдел user.department

3. Автоматическое удаление пустых полей

Функция теперь полностью удаляет HTML элементы, содержащие пустые переменные:

Удаляемые паттерны:

  • <div>...</div> с пустыми переменными
  • <p>...</p> с пустыми переменными
  • <span>...</span> с пустыми переменными
  • <blockquote>...</blockquote> с пустыми переменными
  • Строки, содержащие только пустые переменные
  • Пустые HTML теги после подстановки

Пример работы:

Шаблон:

<div>Имя: {{name}}</div>
<div>Отчество: {{middle}}</div>
<div>Фамилия: {{last}}</div>
<div>Телефон: {{telephone}}</div>
<div>Мобильный: {{mobile}}</div>
<div>Должность: {{position}}</div>
<div>Отдел: {{department}}</div>

Если у пользователя нет отчества, телефонов, должности и отдела:

<div>Имя: Иван Петров</div>

4. Улучшенная очистка результата

Функция выполняет многоуровневую очистку:

  1. Подстановка переменных - замена {{field}} на значения
  2. Удаление пустых переменных - удаление элементов с {{field}}
  3. Очистка пустых HTML тегов - удаление <div></div>, <blockquote></blockquote>
  4. Удаление пустых строк - очистка лишних переносов строк
  5. Финальная очистка - удаление завершающих пустых строк

🧪 Тестирование

Тест 1: Полные данные

user = {
    'name': {'first': 'Иван', 'middle': 'Петрович', 'last': 'Петров'},
    'position': 'Менеджер',
    'department': 'IT отдел',
    'phone': '+7-123-456-7890',
    'mobile': '+7-987-654-3210'
}

Результат: Все поля отображаются

Тест 2: Частичные данные

user = {
    'name': {'first': 'Анна', 'middle': '', 'last': 'Сидорова'},
    'position': 'Директор',
    'department': '',
    'phone': '+7-111-222-3333',
    'mobile': ''
}

Результат: Пустые поля (отчество, отдел, мобильный) удаляются

Тест 3: Минимальные данные

user = {
    'name': {'first': 'Петр', 'middle': '', 'last': 'Иванов'},
    'position': '',
    'department': '',
    'phone': '',
    'mobile': ''
}

Результат: Только имя и email отображаются

📋 Примеры использования

Пример 1: Базовый шаблон

<div><strong>{{name}}</strong></div>
<div>Email: {{mail}}</div>
<div>Телефон: {{telephone}}</div>
<div>Мобильный: {{mobile}}</div>
<div>Должность: {{position}}</div>
<div>Отдел: {{department}}</div>

Пример 2: Сложный HTML

<div style="font-family: Arial;">
    <div><strong>{{name}}</strong></div>
    <div>Email: <a href="mailto:{{mail}}">{{mail}}</a></div>
    <div>Телефон: {{telephone}}</div>
    <div>Мобильный: {{mobile}}</div>
    <div>Должность: {{position}}</div>
    <div>Отдел: {{department}}</div>
</div>

🔧 Технические детали

Регулярные выражения для очистки:

patterns_to_remove = [
    r'<div[^>]*>\s*{{[^}]+}}\s*</div>',
    r'<p[^>]*>\s*{{[^}]+}}\s*</p>',
    r'<span[^>]*>\s*{{[^}]+}}\s*</span>',
    r'<blockquote[^>]*>\s*{{[^}]+}}\s*</blockquote>',
    r'^\s*{{[^}]+}}\s*$',
]

# Дополнительная очистка
substituted = re.sub(r'<blockquote[^>]*>\s*<div[^>]*>\s*[^<]*:\s*</div>\s*</blockquote>', '', substituted)
substituted = re.sub(r'<div[^>]*>\s*[^<]*:\s*</div>', '', substituted)
substituted = re.sub(r'<div[^>]*>\s*</div>', '', substituted)

Обработка телефонов:

  • {{telephone}} - рабочий телефон из user.phone
  • {{mobile}} - мобильный телефон из user.mobile или поиск в user.phones с типом 'mobile'

Обработка email:

  • Приоритет: user.emails[0] если есть, иначе user.nickname@domain

✅ Преимущества нового подхода

  1. Чистый результат - автоматическое удаление пустых полей
  2. Гибкость - поддержка различных типов контактной информации
  3. Читаемость - четкое разделение между полями
  4. Производительность - эффективная обработка с регулярными выражениями
  5. Надежность - многоуровневая очистка гарантирует чистый результат

🎯 Статус: ЗАВЕРШЕНО

Функция substitute_template_variables успешно обновлена и протестирована. Все требования выполнены:

  • ✅ Поддержка двойных фигурных скобок {{field}}
  • ✅ Поддержка всех указанных полей
  • ✅ Автоматическое удаление пустых полей
  • ✅ Многоуровневая очистка результата
  • ✅ Обратная совместимость с существующим API
  • ✅ Протестировано на различных сценариях

Функция готова к использованию в продакшене! 🚀