3.3 KiB
3.3 KiB
go-tdlib
Go wrapper for TDLib (Telegram Database Library) with full support of TDLib v1.3.0
TDLib installation
Ubuntu 18.04 / Debian 9
Precompiled
curl "https://repo.zelenin.pw/gpg.key" | apt-key add -
echo "deb [arch=amd64] https://repo.zelenin.pw common contrib" > "/etc/apt/sources.list.d/tdlib.list"
apt-get update -y
apt-get install -y tdlib-dev
Manual compilation
apt-get update -y
apt-get install -y \
bc \
build-essential \
ca-certificates \
ccache \
cmake \
git \
gperf \
libssl-dev \
libreadline-dev \
zlib1g-dev
git clone --depth 1 -b "v1.3.0" "https://github.com/tdlib/td.git" ./tdlib-src
mkdir ./tdlib-src/build
cd ./tdlib-src/build
cmake -j$(echo 'scale=0; ('$(getconf _NPROCESSORS_ONLN)'+1)*3/4' | bc) -DCMAKE_BUILD_TYPE=Release ..
cmake -j$(echo 'scale=0; ('$(getconf _NPROCESSORS_ONLN)'+1)*3/4' | bc) --build .
make -j$(echo 'scale=0; ('$(getconf _NPROCESSORS_ONLN)'+1)*3/4' | bc) install
rm -rf ./../../tdlib-src
Usage
Client
Register an application to obtain an api_id and api_hash
package main
import (
"log"
"github.com/zelenin/go-tdlib/client"
)
func main() {
client.SetLogVerbosityLevel(1)
client.SetLogFilePath("/dev/stderr")
// client authorizer
authorizer := client.ClientAuthorizer()
go client.CliInteractor(authorizer)
// or bot authorizer
botToken := "000000000:gsVCGG5YbikxYHC7bP5vRvmBqJ7Xz6vG6td"
authorizer := client.BotAuthorizer(botToken)
const (
apiId = 00000
apiHash = "8pu9yg32qkuukj83ozaqo5zzjwhkxhnk"
)
authorizer.TdlibParameters <- &client.TdlibParameters{
UseTestDc: false,
DatabaseDirectory: "./.tdlib/database",
FilesDirectory: "./.tdlib/files",
UseFileDatabase: true,
UseChatInfoDatabase: true,
UseMessageDatabase: true,
UseSecretChats: false,
ApiId: apiId,
ApiHash: apiHash,
SystemLanguageCode: "en",
DeviceModel: "Server",
SystemVersion: "1.0.0",
ApplicationVersion: "1.0.0",
EnableStorageOptimizer: true,
IgnoreFileNames: false,
}
tdlibClient, err := client.NewClient(authorizer)
if err != nil {
log.Fatalf("NewClient error: %s", err)
}
me, err := tdlibClient.GetMe()
if err != nil {
log.Fatalf("GetMe error: %s", err)
}
log.Printf("Me: %s %s [%s]", me.FirstName, me.LastName, me.Username)
}
Receive updates
responses := make(chan client.Type, 100)
tdlibClient, err := client.NewClient(authorizer, client.WithListener(responses))
if err != nil {
log.Fatalf("NewClient error: %s", err)
}
for response := range responses {
if response.GetClass() == client.ClassUpdate {
log.Printf("%#v", response)
}
}
Notes
- WIP. Library API can be changed in the future
- The package includes a .tl-parser and generated json-schema for creating libraries in other languages
Author
Aleksandr Zelenin, e-mail: aleksandr@zelenin.me