mirror of
https://github.com/lukaszraczylo/go-telegram.git
synced 2026-06-05 22:43:59 +00:00
lukaszraczylo
609c4ce649
Sends one fire-and-forget POST per process the first time a consumer constructs a Bot via client.New. Helps track real-world adoption and version spread of the library. No identifiers, no API contents. Implementation: - new client/version.go: exported Version var (currently 0.7.11) - new client/telemetry.go: sync.Once gate + telemetry.Send call - client.go New(): single fireTelemetryOnce() line at function entry - client/telemetry_test.go: TestMain disables outgoing pings during the library's own test suite README §Telemetry documents the payload, the opt-out env vars, and links to the upstream oss-telemetry source so consumers can audit what is sent. Opt out via any of: DO_NOT_TRACK=1 OSS_TELEMETRY_DISABLED=1 GO_TELEGRAM_DISABLE_TELEMETRY=1 osstelemetry.Disable() before the first client.New
69 lines
2.1 KiB
Go
69 lines
2.1 KiB
Go
package client
|
|
|
|
import (
|
|
"net/url"
|
|
)
|
|
|
|
const defaultBaseURL = "https://api.telegram.org"
|
|
|
|
// Bot is the Telegram Bot API client. Construct via New. All API methods
|
|
// (declared in package api) hang off *Bot via thin wrappers around call.
|
|
type Bot struct {
|
|
token string
|
|
base string
|
|
http HTTPDoer
|
|
codec Codec
|
|
logger Logger
|
|
|
|
// baseURL is the parsed form of base, lazily populated on first Call.
|
|
// Caching it avoids running url.Parse on every API request.
|
|
baseURL *url.URL
|
|
// pathPrefix is "/bot<token>/" built once so per-call URL assembly
|
|
// is a single string concatenation with the method name.
|
|
pathPrefix string
|
|
}
|
|
|
|
// Token returns the bot token. Exposed for advanced use cases (custom
|
|
// transports, manual URL building); ordinary code does not need it.
|
|
func (b *Bot) Token() string { return b.token }
|
|
|
|
// BaseURL returns the configured Telegram API base URL.
|
|
func (b *Bot) BaseURL() string { return b.base }
|
|
|
|
// HTTP returns the underlying HTTPDoer. Exposed for adapters that need
|
|
// to share connection pools or for diagnostic checks.
|
|
func (b *Bot) HTTP() HTTPDoer { return b.http }
|
|
|
|
// Codec returns the configured Codec.
|
|
func (b *Bot) Codec() Codec { return b.codec }
|
|
|
|
// Logger returns the configured Logger.
|
|
func (b *Bot) Logger() Logger { return b.logger }
|
|
|
|
// New constructs a Bot with the given token and optional configuration.
|
|
// The default HTTP client is tuned for long-poll workloads (see
|
|
// NewDefaultHTTPDoer); the default codec wraps encoding/json; the default
|
|
// logger discards records.
|
|
func New(token string, opts ...Option) *Bot {
|
|
fireTelemetryOnce()
|
|
b := &Bot{
|
|
token: token,
|
|
base: defaultBaseURL,
|
|
http: NewDefaultHTTPDoer(),
|
|
codec: DefaultCodec{},
|
|
logger: NoopLogger{},
|
|
}
|
|
for _, o := range opts {
|
|
o(b)
|
|
}
|
|
// Pre-compute URL pieces. Errors here are unlikely (defaultBaseURL is
|
|
// well-formed; user-supplied bases via WithBaseURL are validated by
|
|
// url.Parse below) but if parsing fails we leave baseURL nil and fall
|
|
// back to the string-concat path on the next Call.
|
|
if u, err := url.Parse(b.base); err == nil {
|
|
b.baseURL = u
|
|
}
|
|
b.pathPrefix = "/bot" + b.token + "/"
|
|
return b
|
|
}
|