Skip to content

Composable backend selection, Telegram support, and Diataxis docs#76

Merged
timkpaine merged 1 commit into
mainfrom
tkp/composable-backends
Jun 22, 2026
Merged

Composable backend selection, Telegram support, and Diataxis docs#76
timkpaine merged 1 commit into
mainfrom
tkp/composable-backends

Conversation

@timkpaine

Copy link
Copy Markdown
Member

Make it trivial to run a bot against any combination of backends and add Telegram as a first-class backend.

Backends:

  • Add a top-level backend Hydra group (slack/discord/symphony/telegram), each fragment writing to a distinct BotConfig field so any combination can be selected at once, e.g. +gateway=bot +backend=[slack,telegram].
  • Add a bare gateway/bot.yaml skeleton; rewrite the pre-canned gateways (slack, discord, symphony, telegram, mixed, all) as thin selectors that match the chatom-based BotConfig and read credentials from env vars.
  • Update example configs and add an ad-hoc custom.yaml. Telegram:
  • Add csp_bot/backends/telegram.py, TelegramConfig and the telegram field on BotConfig, adapter init and user-access wiring in Bot, HTML help formatting, the Backend literal entry, exports, and the dev dependency. Docs (Diataxis restructure):
  • Slim Overview to orientation + getting started; rewrite Configuration around the two config groups; add Backends and Commands reference pages and a Writing-Commands how-to; update Installation, README, and sidebar.

Make it trivial to run a bot against any combination of backends and add
Telegram as a first-class backend.

Backends:
- Add a top-level `backend` Hydra group (slack/discord/symphony/telegram),
  each fragment writing to a distinct BotConfig field so any combination
  can be selected at once, e.g. `+gateway=bot +backend=[slack,telegram]`.
- Add a bare `gateway/bot.yaml` skeleton; rewrite the pre-canned gateways
  (slack, discord, symphony, telegram, mixed, all) as thin selectors that
  match the chatom-based BotConfig and read credentials from env vars.
- Update example configs and add an ad-hoc `custom.yaml`.
Telegram:
- Add csp_bot/backends/telegram.py, TelegramConfig and the telegram field
  on BotConfig, adapter init and user-access wiring in Bot, HTML help
  formatting, the Backend literal entry, exports, and the dev dependency.
Docs (Diataxis restructure):
- Slim Overview to orientation + getting started; rewrite Configuration
  around the two config groups; add Backends and Commands reference pages
  and a Writing-Commands how-to; update Installation, README, and sidebar.

Signed-off-by: Tim Paine <3105306+timkpaine@users.noreply.github.com>
@github-actions

Copy link
Copy Markdown
Contributor

Test Results

89 tests  +1   89 ✅ +1   1s ⏱️ ±0s
 1 suites ±0    0 💤 ±0 
 1 files   ±0    0 ❌ ±0 

Results for commit 626e48a. ± Comparison against base commit 684a470.

@codecov

codecov Bot commented Jun 22, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 65.49%. Comparing base (684a470) to head (626e48a).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main      #76      +/-   ##
==========================================
+ Coverage   65.34%   65.49%   +0.14%     
==========================================
  Files          29       29              
  Lines        1665     1672       +7     
  Branches      170      170              
==========================================
+ Hits         1088     1095       +7     
  Misses        545      545              
  Partials       32       32              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@timkpaine timkpaine marked this pull request as ready for review June 22, 2026 01:39
@timkpaine timkpaine requested a review from ptomecek as a code owner June 22, 2026 01:39
@timkpaine timkpaine merged commit a388841 into main Jun 22, 2026
5 checks passed
@timkpaine timkpaine deleted the tkp/composable-backends branch June 22, 2026 01:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant