Compare commits
4 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| fce6e8d013 | |||
| 57b3706241 | |||
| f9584c5afe | |||
| 07df710ce6 |
@@ -4,6 +4,7 @@ using BotPages.Core.Abstractions;
|
||||
using BotPages.Core.Context;
|
||||
using BotPages.Core.Logging;
|
||||
using BotPages.Core.Routing;
|
||||
using System.Reflection;
|
||||
|
||||
/// <summary>
|
||||
/// Основное приложение BotPages.
|
||||
@@ -90,6 +91,45 @@ public sealed class BotPagesApp
|
||||
return this;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Зарегистрировать все маршруты для страницы.
|
||||
/// Маршрутом является <see cref="RouteAttribute"/>.
|
||||
/// Так же берется полное название класса.
|
||||
/// </summary>
|
||||
public BotPagesApp AutoMapRoute()
|
||||
{
|
||||
// Берём все загруженные сборки в текущем AppDomain
|
||||
var assemblies = AppDomain.CurrentDomain.GetAssemblies();
|
||||
|
||||
// Находим все типы, которые наследуются от Page
|
||||
var pageTypes = assemblies
|
||||
.SelectMany(a =>
|
||||
{
|
||||
try
|
||||
{
|
||||
return a.GetTypes();
|
||||
}
|
||||
catch (ReflectionTypeLoadException ex)
|
||||
{
|
||||
// Если часть типов не загрузилась — берём только успешные
|
||||
return ex.Types.Where(t => t != null)!;
|
||||
}
|
||||
})
|
||||
.Where(t => t != null
|
||||
&& t.IsClass
|
||||
&& !t.IsAbstract
|
||||
&& t.IsSubclassOf(typeof(Page)))
|
||||
.ToList();
|
||||
|
||||
// Выводим полные имена
|
||||
foreach (var type in pageTypes)
|
||||
{
|
||||
_routes.Map(type);
|
||||
}
|
||||
|
||||
return this;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Обработать входящее обновление.
|
||||
/// </summary>
|
||||
@@ -161,7 +201,7 @@ public sealed class BotPagesApp
|
||||
|
||||
if (page is null)
|
||||
{
|
||||
await ctx.Navigation.GoToHome(ctx, ct);
|
||||
await ctx.Navigation.GoToHomeAsync(ctx, ct);
|
||||
return;
|
||||
}
|
||||
|
||||
|
||||
@@ -22,47 +22,6 @@ public sealed class PageContext
|
||||
/// <summary>Адаптер мессенджера.</summary>
|
||||
public required IMessengerAdapter Adapter { get; init; }
|
||||
|
||||
//Storage
|
||||
|
||||
/// <summary>Получить состояние по ключу.</summary>
|
||||
public Task<T?> GetStorageAsync<T>(string key, CancellationToken ct)
|
||||
=> StateStorage.GetAsync<T>(SessionKey, key, ct);
|
||||
|
||||
/// <summary>Сохранить состояние по ключу.</summary>
|
||||
public Task SetStorageAsync<T>(string key, T state, CancellationToken ct)
|
||||
=> StateStorage.SetAsync<T>(SessionKey, key, state, ct);
|
||||
|
||||
/// <summary>Удалить состояние по ключу.</summary>
|
||||
public Task<bool> RemoveStorageAsync(string key, CancellationToken ct)
|
||||
=> StateStorage.RemoveAsync(SessionKey, key, ct);
|
||||
|
||||
/// <summary>Удалить все состояния по ключу.</summary>
|
||||
public Task<bool> ClearStorageAsync(CancellationToken ct)
|
||||
=> StateStorage.ClearAsync(SessionKey, ct);
|
||||
|
||||
//Adapter
|
||||
|
||||
/// <summary>
|
||||
/// Отправить текстовое сообщение.
|
||||
/// </summary>
|
||||
public Task SendTextAsync(string text, MessageFormat format = MessageFormat.Plain,
|
||||
IEnumerable<IEnumerable<InlineButton>>? inline = null,
|
||||
IEnumerable<IEnumerable<ReplyButton>>? reply = null,
|
||||
CancellationToken ct = default)
|
||||
=> Adapter.SendTextAsync(this.Update.Chat.Id, text, format, inline, reply, ct);
|
||||
|
||||
/// <summary>
|
||||
/// Отправить файл.
|
||||
/// </summary>
|
||||
public Task SendFileAsync(FileDescriptor file, string? caption = null, MessageFormat? captionFormat = null, CancellationToken ct = default)
|
||||
=> Adapter.SendFileAsync(this.Update.Chat.Id, file, caption, captionFormat, ct);
|
||||
|
||||
/// <summary>
|
||||
/// Отправить файл.
|
||||
/// </summary>
|
||||
public Task SendFileAsync(FileDescriptor file, string? caption = null, CancellationToken ct = default)
|
||||
=> Adapter.SendFileAsync(this.Update.Chat.Id, file, caption, null, ct);
|
||||
|
||||
/// <summary>
|
||||
/// Получить билдер альбомов.
|
||||
/// </summary>
|
||||
|
||||
31
BotPages.Core/Context/PageContextAdapterExtensions.cs
Normal file
31
BotPages.Core/Context/PageContextAdapterExtensions.cs
Normal file
@@ -0,0 +1,31 @@
|
||||
using BotPages.Core.Abstractions;
|
||||
using BotPages.Core.Messaging;
|
||||
|
||||
namespace BotPages.Core;
|
||||
|
||||
/// <summary>
|
||||
/// Расширения <see cref="PageContext"/> для работы с <see cref="IMessengerAdapter"/>
|
||||
/// </summary>
|
||||
public static class PageContextAdapterExtensions
|
||||
{
|
||||
/// <summary>
|
||||
/// Отправить текстовое сообщение.
|
||||
/// </summary>
|
||||
public static Task SendTextAsync(this PageContext ctx, string text, MessageFormat format = MessageFormat.Plain,
|
||||
IEnumerable<IEnumerable<InlineButton>>? inline = null,
|
||||
IEnumerable<IEnumerable<ReplyButton>>? reply = null,
|
||||
CancellationToken ct = default)
|
||||
=> ctx.Adapter.SendTextAsync(ctx.Update.Chat.Id, text, format, inline, reply, ct);
|
||||
|
||||
/// <summary>
|
||||
/// Отправить файл.
|
||||
/// </summary>
|
||||
public static Task SendFileAsync(this PageContext ctx, FileDescriptor file, string? caption = null, MessageFormat? captionFormat = null, CancellationToken ct = default)
|
||||
=> ctx.Adapter.SendFileAsync(ctx.Update.Chat.Id, file, caption, captionFormat, ct);
|
||||
|
||||
/// <summary>
|
||||
/// Отправить файл.
|
||||
/// </summary>
|
||||
public static Task SendFileAsync(this PageContext ctx, FileDescriptor file, string? caption = null, CancellationToken ct = default)
|
||||
=> ctx.Adapter.SendFileAsync(ctx.Update.Chat.Id, file, caption, null, ct);
|
||||
}
|
||||
38
BotPages.Core/Context/PageContextNavigationExtensions.cs
Normal file
38
BotPages.Core/Context/PageContextNavigationExtensions.cs
Normal file
@@ -0,0 +1,38 @@
|
||||
namespace BotPages.Core;
|
||||
|
||||
/// <summary>
|
||||
/// Расширения <see cref="PageContext"/> для работы с <see cref="NavigationService"/>
|
||||
/// </summary>
|
||||
public static class PageContextNavigationExtensions
|
||||
{
|
||||
|
||||
/// <summary>
|
||||
/// Перейти по маршруту без аргументов.
|
||||
/// </summary>
|
||||
public static Task GoToHomeAsync(this PageContext ctx, CancellationToken ct)
|
||||
=> ctx.Navigation.GoToHomeAsync(ctx, ct);
|
||||
|
||||
/// <summary>
|
||||
/// Перейти по маршруту без аргументов.
|
||||
/// </summary>
|
||||
public static Task GoToAsync(this PageContext ctx, string route, CancellationToken ct)
|
||||
=> ctx.Navigation.GoToAsync(route, ctx, ct);
|
||||
|
||||
/// <summary>
|
||||
/// Перейти по маршруту с аргументами.
|
||||
/// </summary>
|
||||
public static Task GoToAsync<TArgs>(this PageContext ctx, string route, TArgs args, CancellationToken ct)
|
||||
=> ctx.Navigation.GoToAsync<TArgs>(route, args, ctx, ct);
|
||||
|
||||
/// <summary>
|
||||
/// Перейти на страницу без аргументов.
|
||||
/// </summary>
|
||||
public static Task GoToAsync<TPage>(this PageContext ctx, CancellationToken ct) where TPage : Page
|
||||
=> ctx.Navigation.GoToAsync<TPage>(ctx, ct);
|
||||
|
||||
/// <summary>
|
||||
/// Перейти на страницу с аргументами.
|
||||
/// </summary>
|
||||
public static Task GoToAsync<TPage, TArgs>(this PageContext ctx, TArgs args, CancellationToken ct) where TPage : StatefullPage<TArgs>
|
||||
=> ctx.Navigation.GoToAsync<TPage, TArgs>(ctx, args!, ct);
|
||||
}
|
||||
26
BotPages.Core/Context/PageContextStorageExtensions.cs
Normal file
26
BotPages.Core/Context/PageContextStorageExtensions.cs
Normal file
@@ -0,0 +1,26 @@
|
||||
using BotPages.Core.Abstractions;
|
||||
|
||||
namespace BotPages.Core;
|
||||
|
||||
/// <summary>
|
||||
/// Расширения <see cref="PageContext"/> для работы с <see cref="IStateStorage"/>
|
||||
/// </summary>
|
||||
public static class PageContextStorageExtensions
|
||||
{
|
||||
|
||||
/// <summary>Получить состояние по ключу.</summary>
|
||||
public static Task<T?> GetStorageAsync<T>(this PageContext ctx, string key, CancellationToken ct)
|
||||
=> ctx.StateStorage.GetAsync<T>(ctx.SessionKey, key, ct);
|
||||
|
||||
/// <summary>Сохранить состояние по ключу.</summary>
|
||||
public static Task SetStorageAsync<T>(this PageContext ctx, string key, T state, CancellationToken ct)
|
||||
=> ctx.StateStorage.SetAsync<T>(ctx.SessionKey, key, state, ct);
|
||||
|
||||
/// <summary>Удалить состояние по ключу.</summary>
|
||||
public static Task<bool> RemoveStorageAsync(this PageContext ctx, string key, CancellationToken ct)
|
||||
=> ctx.StateStorage.RemoveAsync(ctx.SessionKey, key, ct);
|
||||
|
||||
/// <summary>Удалить все состояния по ключу.</summary>
|
||||
public static Task<bool> ClearStorageAsync(this PageContext ctx, CancellationToken ct)
|
||||
=> ctx.StateStorage.ClearAsync(ctx.SessionKey, ct);
|
||||
}
|
||||
@@ -17,6 +17,7 @@ public sealed class MessageBuilder
|
||||
private string? _progressTitle = null;
|
||||
private int? _progressPercent = null;
|
||||
private string? _progressMessageId = null;
|
||||
private bool _disableReplyKeyboard;
|
||||
|
||||
/// <summary>Создать билдер сообщений.</summary>
|
||||
public MessageBuilder(PageContext ctx) => _ctx = ctx;
|
||||
@@ -64,9 +65,20 @@ public sealed class MessageBuilder
|
||||
return this;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Отключение Reply клавиатуры.
|
||||
/// </summary>
|
||||
/// <returns></returns>
|
||||
public MessageBuilder DisableReply()
|
||||
{
|
||||
_disableReplyKeyboard = true;
|
||||
return this;
|
||||
}
|
||||
|
||||
/// <summary>Добавить reply‑кнопку.</summary>
|
||||
public MessageBuilder Reply(params ReplyButton[] label)
|
||||
{
|
||||
_disableReplyKeyboard = false;
|
||||
_reply.Add(label.ToList());
|
||||
return this;
|
||||
}
|
||||
@@ -74,6 +86,7 @@ public sealed class MessageBuilder
|
||||
/// <summary>Добавить строку reply‑кнопок.</summary>
|
||||
public MessageBuilder Reply(IEnumerable<ReplyButton> row)
|
||||
{
|
||||
_disableReplyKeyboard = false;
|
||||
_reply.Add(row.ToList());
|
||||
return this;
|
||||
}
|
||||
@@ -81,6 +94,7 @@ public sealed class MessageBuilder
|
||||
/// <summary>Добавить строку reply‑кнопок.</summary>
|
||||
public MessageBuilder Reply(IEnumerable<IEnumerable<ReplyButton>> row)
|
||||
{
|
||||
_disableReplyKeyboard = false;
|
||||
_reply.AddRange(row.Select(t => t.ToList()).ToList());
|
||||
return this;
|
||||
}
|
||||
@@ -113,7 +127,11 @@ public sealed class MessageBuilder
|
||||
// Текст
|
||||
if (!string.IsNullOrWhiteSpace(_text))
|
||||
{
|
||||
await _ctx.SendTextAsync(_text, _format, _inline, _reply, ct);
|
||||
List<List<ReplyButton>>? reply = null;
|
||||
if (_disableReplyKeyboard) reply = new();
|
||||
else if (_reply.Any()) reply = _reply;
|
||||
|
||||
await _ctx.SendTextAsync(_text, _format, _inline, reply, ct);
|
||||
}
|
||||
|
||||
// Файлы
|
||||
|
||||
@@ -31,7 +31,7 @@ public sealed class NavigationService
|
||||
/// <summary>
|
||||
/// Перейти по маршруту без аргументов.
|
||||
/// </summary>
|
||||
public Task GoToHome(PageContext ctx, CancellationToken ct)
|
||||
public Task GoToHomeAsync(PageContext ctx, CancellationToken ct)
|
||||
{
|
||||
return NavigateAsync(_defaultPage!, ctx, null, ct);
|
||||
}
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
namespace BotPages.Core.Routing;
|
||||
using System.Reflection;
|
||||
|
||||
namespace BotPages.Core.Routing;
|
||||
|
||||
/// <summary>
|
||||
/// Реестр маршрутов страниц.
|
||||
@@ -26,4 +28,14 @@ internal sealed class RoutesRegistry
|
||||
/// Получить снимок всех маршрутов.
|
||||
/// </summary>
|
||||
public IReadOnlyDictionary<string, Type> Snapshot() => _routes;
|
||||
|
||||
internal void Map(Type? type)
|
||||
{
|
||||
foreach(var attr in type.GetCustomAttributes<RouteAttribute>(inherit: true))
|
||||
{
|
||||
_routes.Add(attr.Template, type);
|
||||
}
|
||||
|
||||
_routes.Add(type.FullName, type);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -104,7 +104,9 @@ public sealed class TelegramAdapter : IMessangerAdapterSetup
|
||||
.ToArray()
|
||||
);
|
||||
}
|
||||
else if (reply is not null && reply.Any())
|
||||
else if (reply is not null)
|
||||
{
|
||||
if (reply.Any())
|
||||
{
|
||||
markup = new ReplyKeyboardMarkup(
|
||||
reply.Select(row => row.Select(b => new KeyboardButton(b.Label)).ToArray()).ToArray()
|
||||
@@ -113,6 +115,11 @@ public sealed class TelegramAdapter : IMessangerAdapterSetup
|
||||
ResizeKeyboard = true
|
||||
};
|
||||
}
|
||||
else
|
||||
{
|
||||
markup = new ReplyKeyboardRemove();
|
||||
}
|
||||
}
|
||||
|
||||
var parseMode = ParseMode.None;
|
||||
|
||||
|
||||
@@ -27,7 +27,7 @@ public sealed class SubmitPage : SingletonPage
|
||||
}
|
||||
while (i < 100);
|
||||
|
||||
await ctx.Navigation.GoToHome(ctx, ct);
|
||||
await ctx.Navigation.GoToHomeAsync(ctx, ct);
|
||||
}
|
||||
|
||||
public override Task OnLeave(PageContext ctx, CancellationToken ct)
|
||||
|
||||
@@ -19,7 +19,7 @@ public sealed class TitlePage : SingletonPage
|
||||
{
|
||||
if (text == "Меню")
|
||||
{
|
||||
return ctx.Navigation.GoToHome(ctx, ct);
|
||||
return ctx.Navigation.GoToHomeAsync(ctx, ct);
|
||||
}
|
||||
else
|
||||
{
|
||||
|
||||
5
TZ.md
5
TZ.md
@@ -17,7 +17,6 @@
|
||||
- **Page** — класс, отвечающий за состояние экрана бота.
|
||||
- `Page` — базовый класс.
|
||||
- `Page<TArguments>` — страница с аргументами.
|
||||
- `ModalPage` / `ModalPage<TArguments>` — модальная страница (перехватывает ввод, блокирует переходы).
|
||||
- **Контекст:**
|
||||
- `UserContext` — данные пользователя (UserId, MessengerType).
|
||||
- `ChatContext` — данные чата (ChatId, Title, ThreadId?, ленивое обновление).
|
||||
@@ -25,7 +24,7 @@
|
||||
- **Состояние:**
|
||||
- `IStateStorage` — универсальный интерфейс хранения.
|
||||
- Базовая реализация: InMemory.
|
||||
- Ключ: `CompositeSessionKey(MessengerType:string, ChatId, UserId?)`.
|
||||
- Ключ: `CompositeSessionKey(MessengerType:string, ChatId, UserId)`.
|
||||
- История состояний: опционально (None, LastN, TimeWindow, Full).
|
||||
|
||||
---
|
||||
@@ -125,7 +124,7 @@
|
||||
```
|
||||
- Пример:
|
||||
```csharp
|
||||
app.AddMiddleware<IUpdateMiddleware, LoggingMiddleware>();
|
||||
app.AddMiddleware<LoggingMiddleware>();
|
||||
app.AddMiddleware<ErrorMiddleware>(params);
|
||||
```
|
||||
- Порядок регистрации = порядок выполнения.
|
||||
|
||||
Reference in New Issue
Block a user