go-tdlib/README.md
Aleksandr Zelenin 74bc598956 TDLib 1.3.0
2018-09-06 00:45:29 +03:00

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