mirror of https://github.com/lukaszraczylo/go-telegram.git synced 2026-06-05 22:43:59 +00:00

Files

T

lukaszraczylo 9072e9eafb Initial release of go-telegram

A fully-generated, strongly-typed Go client for the Telegram Bot API.

* 176 methods + 301 types generated from Bot API v10.0
* 1408 auto-generated tests (8 scenarios per method)
* Typed unions throughout — no 'any' in the public surface
* Pluggable HTTP transport and JSON codec (default goccy/go-json)
* Built-in retry middleware honouring Telegram's retry_after
* Generic dispatcher with filters and conversation handlers
* Self-verifying codegen pipeline (regen → audit → emit → run tests)
* 14 example bots covering common patterns

2026-05-09 13:09:27 +01:00

main.go

Initial release of go-telegram

2026-05-09 13:09:27 +01:00

README.md

Initial release of go-telegram

2026-05-09 13:09:27 +01:00

README.md

pagination

Multi-page inline keyboard for browsing a list. No server-side session required — page state is encoded in callback data.

What it shows

OnCommand("/list") sends the first page with inline navigation buttons
OnCallback("^page:(\\d+)$") parses page number from callback data via c.Values["regex_match"]
api.EditMessageText edits the message in-place on each page turn
api.AnswerCallbackQuery dismisses the loading spinner

Pattern

Callback data format: page:<n> where n is the 0-based page index.

The renderPage helper builds both the text content and the keyboard in one call. Only [« Prev] or [Next »] buttons that make sense for the current page are rendered, so the keyboard is always minimal.

Running

export TELEGRAM_BOT_TOKEN=123456:ABC...
go run ./examples/pagination

Send /list to the bot. Tap Next/Prev to navigate 20 sample items, 5 per page.

Extending

To paginate dynamic data (database results, API responses), replace sampleItems with a function that takes (page, pageSize) and returns items + total count.