examples

README

Examples

Most examples use environment variable client builders. You can do it manually, see bot-auth-manual for example.

1. Obtain api_id and api_hash for your application and set as APP_ID, APP_HASH
2. Set SESSION_FILE to something like ~/session.yourbot.json for persistent auth
3. Run example.

Please don't share APP_ID or APP_HASH, it can't be easily rotated.

Name	Description	Features
auth	User authentication from terminal input	Custom UserAuthenticator
bot-auth-manual	Bot authentication	session.Storage, setup without environment variables
bot-echo	Echo bot	UpdateDispatcher, message sender
bot-upload	One-shot uploader for bot	NoUpdates flag, uploads with MIME, custom file name and as audio, resolving peer by username, HTML message
gif-download	Saved gif backup (and restore) for user	Download, upload, middlewares with rate limit, unpack
bg-run	Using client without Run	contrib/bg package
pretty-print	Pretty-print requests, responses and updates	The tgp package, middleware and custom UpdateHandler for all updates
updates	Updates engine example	The updates package that recovers missed updates

Environment variables

Name	Description
BOT_TOKEN	Token from BotFather
APP_ID	api_id of Telegram app from my.telegram.org
APP_HASH	api_hash of Telegram app from my.telegram.org
SESSION_FILE	Path to session file, like /home/super-bot/.gotd/session.super-bot.json
SESSION_DIR	Path to session directory, if SESSION_FILE is not set, like /home/super-bot/.gotd

Support

Still don't know how to use specific features? See user support.

Documentation

Overview

Package examples contains usage examples for gotd features.

Index

• func Run(f func(ctx context.Context, log *zap.Logger) error)

Functions

func Run

func Run(f func(ctx context.Context, log *zap.Logger) error)

Run runs f callback with context and logger, panics on error.