Popularity
3.0
Growing
Activity
9.3
-
31
1
6

Description

Library for Object-Oriented and type-safe work with Telegram Bot API.

Programming language: Kotlin
License: Apache License 2.0
Tags: Library     KotlinJS     KotlinJVM     Multiplatform     Telegram-bot-api    
Latest version: v0.30.10

TelegramBotAPI alternatives and similar libraries

Based on the "Multiplatform" category.
Alternatively, view TelegramBotAPI alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of TelegramBotAPI or a related project?

Add another 'Multiplatform' Library

README

TelegramBotAPI

Common info Awesome Kotlin Badge Build Status Small survey
Useful links [Chat in Telegram](badges/chat.svg) [Create bot](badges/template.svg) [KDocs](badges/kdocs.svg) Examples, Mini tutorial
TelegramBotAPI Core status Download Maven Central
TelegramBotAPI Extensions status Download Maven Central
TelegramBotAPI Util Extensions status Download Maven Central
TelegramBotAPI All status Download Maven Central

At the time of publication of version 0.28.0 there are errors in serialization plugins like kotlinx.serialization#1004. It is possible, that both JVM and JS version may work improperly in some cases with kotlinx.serialization version 1.0.0-RC

It is a complex of libraries for working with TelegramBotAPI in type-safe and strict way as much as it possible. In the list of this complex currently next projects:

  • [TelegramBotAPI Core](tgbotapi.core/README.md) - core of library. In fact it is independent library and can be used alone without any additional library
  • [TelegramBotAPI API Extensions](tgbotapi.extensions.api/README.md) - contains extensions (mostly for RequestsExecutor), which allows to use the core library in more pleasant way
  • [TelegramBotAPI Util Extensions](tgbotapi.extensions.utils/README.md) - contains extensions for more comfortable work with commands, updates and other different things
  • [TelegramBotAPI](tgbotapi/README.md) - concentration of all previously mentioned libraries

Most part of some specific solves or unuseful moments are describing by official Telegram Bot API.

JavaScript notes

Versions before 0.28.0

In case if you are want to use this library inside of browser, you will need additional settings (thanks for help to Alexander Nozik):

Gradle build script help (for versions before 0.28.0)

dependencies {
    /* ... */

    implementation "com.github.insanusmokrassar:TelegramBotAPI:$tgbot_api_version"
    implementation "com.github.insanusmokrassar:TelegramBotAPI-extensions-api:$tgbot_api_version" // optional
    implementation "com.github.insanusmokrassar:TelegramBotAPI-extensions-utils:$tgbot_api_version" // optional

    /* Block of dependencies for correct building in browser */
    implementation(npm("fs"))
    implementation(npm("bufferutil"))
    implementation(npm("utf-8-validate"))
    implementation(npm("abort-controller"))
    implementation(npm("text-encoding"))
}

/* ... */

kotlin {
    target {
        browser {
            /* Block for fix of exception in absence of some functionality, https://github.com/ktorio/ktor/issues/1339 */
            dceTask {
                dceOptions {
                    keep("ktor-ktor-io.\$\$importsForInline\$\$.ktor-ktor-io.io.ktor.utils.io")
                }
            }
        }
    }
}

Ok, where should I start?

[Libraries hierarchy](resources/TelegramBotAPI-libraries-hierarchy.svg)

In most cases, the most simple way will be to implement [TelegramBotAPI](tgbotapi/README.md) - it contains all necessary tools for comfort usage of this library. If you want to exclude some libraries, you can implement just [TelegramBotAPI API Extensions](tgbotapi.extensions.api/README.md), [TelegramBotAPI Util Extensions](tgbotapi.extensions.utils/README.md) or even [TelegramBotAPI Core](tgbotapi.core/README.md).

If you want to dive deeper in the core of library or develop something for it - welcome to learn more from [TelegramBotAPI Core](tgbotapi.core/README.md) and our Telegram Chat.

Anyway, all libraries are very typical inside of them. Examples:

  • In TelegramBotAPI common request look like requestsExecutor.execute(SomeRequest())
  • tgbotapi.extensions.api typical syntax look like requestsExecutor.someRequest() (in most cases it would be better to use bot name instead of requestsExecutor)
  • tgbotapi.extensions.utils will look like filter.filterBaseMessageUpdates(chatId).filterExactCommands(Regex("^.*$"))...

Build instruction

If you want to build this project or to contribute, there are several recommendations:

Build

In case if you want to just build project, run next command:

./gradlew clean build

On windows:

gradlew.bat clean build

Publishing for work with your version locally

In case, if you want to work in your other projects using your modification (or some state) of this library, you can use next code:

./gradlew clean build publishToMavenLocal

On windows:

gradlew.bat clean build publishToMavenLocal

But you must remember, that in this case your local maven repo must be the first one from your project retrieving libraries:

repositories {
    mavenLocal() // that must be the first one
    jcenter()
    mavenCentral()
}

Besides, for your own version you can change variable library_version in the file [gradle.properties](./gradle.properties).