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

Files

T

lukaszraczylo 75c7ce3119 perf(client): pool req-body buffer + manual http.Request with cached URL

Two changes that together cut allocs/call from 15 to 13 (client-internal
bench) and per-call CPU from 600ns to 455ns (-24%) on the no-HTTP path:

1. Codec gets an optional BodyEncoder extension (MarshalTo io.Writer).
   When present, encodeJSONBody stream-encodes the request directly into
   a pooled *bytes.Buffer instead of allocating a [2-step] Marshal+Reader
   pair. DefaultCodec implements it via goccy/go-json.NewEncoder.
2. *Bot caches the parsed base URL on construction. buildRequest skips
   net/http.NewRequestWithContext for the common case and constructs
   *http.Request manually — clones the URL by value, sets the method
   path, and populates ContentLength + GetBody from the body's concrete
   type so RetryDoer's body-replay across attempts still works.

Cross-library bench (sendMessage round-trip vs httptest.Server): -2
allocs/call (104 -> 102), bytes -1.2%, time within noise (real HTTP
plumbing dominates). The CPU win is visible on synthetic stub-doer
benches and translates to lower GC pressure on sustained-throughput
workloads.

Slow-path fallback preserved for codecs that don't implement BodyEncoder
and for *Bot instances where url.Parse on the configured base failed —
they take the original NewRequestWithContext path.

2026-05-10 22:36:57 +01:00

dispatch

fix(api): generate CallRaw + per-element decode for []<union> returns

2026-05-09 18:57:54 +01:00

api.md

docs(reference): regenerate after typed-allowed-updates merge

2026-05-09 21:19:09 +01:00

client.md

perf(client): pool req-body buffer + manual http.Request with cached URL

2026-05-10 22:36:57 +01:00

dispatch.md

test(bench): cross-library benchmarks vs top 5 go telegram libraries

2026-05-10 21:52:00 +01:00

README.md

docs: auto-generate markdown reference + soften README

2026-05-09 14:14:37 +01:00

transport.md

docs(reference): regenerate after perf series

2026-05-10 02:57:25 +01:00

README.md

API Reference

Auto-generated from Go source comments by gomarkdoc. Do not edit by hand — run make docs to regenerate.

Packages

Package	Description
`api`	Telegram Bot API types and method wrappers — 176 methods, 301 types, fully generated
`client`	Bot client, codec, HTTP doer, retry middleware
`transport`	Long-poll and webhook transports
`dispatch`	Update router, filters, handler groups, named handlers
`dispatch/conversation`	Multi-step conversation state machines
`dispatch/filters/message`	Message filters — `Command`, `Text`, `IsReply`, etc.
`dispatch/filters/callback`	Callback query filters
`dispatch/filters/inline`	Inline query filters
`dispatch/filters/chatmember`	Chat member update filters
`dispatch/filters/chatjoinrequest`	Join request filters
`dispatch/filters/precheckoutquery`	Pre-checkout filters for payments

Also see

Project home — landing page with examples and overview
GitHub repository
pkg.go.dev — official Go package documentation