Prompt и PromptRegistry

Класс Prompt

Композитный текстовый билдер. Хранит упорядоченный список частей и рендерит их в одну строку.

from edgebot import Prompt

Конструктор

Prompt(template: str = "")

Параметр	Описание
template	Стартовый шаблон. Может содержать плейсхолдеры {name} для подстановки

Методы

.append(text)

Добавляет блок текста в конец.

prompt.append(text: str) -> Prompt

.prepend(text)

Добавляет блок текста в начало.

prompt.prepend(text: str) -> Prompt

.render(**kwargs)

Склеивает части через \n и подставляет значения через str.format_map.

prompt.render(**kwargs) -> str

Осторожно

Отсутствующий ключ в kwargs при наличии плейсхолдера {name} вызовет KeyError.

Пример

p = Prompt("Привет, {name}!")
p.append("Баланс: {balance} ₽")
text = p.render(name="Иван", balance=1500)
# "Привет, Иван!\nБаланс: 1500 ₽"

Композиция

header = Prompt("📋 Заголовок")
body = Prompt("Основной текст")
body.prepend(header.render())  # добавить заголовок сверху

---

Класс PromptRegistry

Реестр фабрик промптов. Фабрика — функция, декорированная через @registry.register(key), возвращающая Prompt.

from edgebot import PromptRegistry

registry = PromptRegistry()

.register(key)

Декоратор для регистрации фабрики.

@registry.register("welcome")
def p_welcome(username: str) -> Prompt:
    return Prompt(f"Привет, @{username}!")

Параметр	Описание
key	Строковый ключ, по которому UIComponent запросит промпт

.get(key, **kwargs)

Вызывает фабрику и возвращает Prompt.

registry.get(key: str, **kwargs) -> Prompt

Raises	Условие
PromptNotFound	Ключ не зарегистрирован
TypeError	Фабрика вернула не Prompt

.has(key)

Проверяет наличие зарегистрированного промпта.

registry.has(key: str) -> bool

Автофильтрация kwargs

Фабрика объявляет только нужные параметры. Лишние ключи из kwargs отбрасываются автоматически по сигнатуре функции:

@registry.register("profile")
def p_profile(username: str, is_active: bool) -> Prompt:
    ...

# При вызове get("profile", username="john", is_active=True, age=25)
# age будет тихо отброшен

Если фабрика объявляет **kwargs — фильтрация отключается, все данные передаются как есть.