mirror of
https://github.com/InsanusMokrassar/TelegramBotAPI.git
synced 2024-11-26 12:08:43 +00:00
77 lines
5.5 KiB
Markdown
77 lines
5.5 KiB
Markdown
# TelegramBotAPI
|
|
|
|
| Common info | [](https://github.com/KotlinBy/awesome-kotlin) [](https://t.me/InMoTelegramBotAPI) [](https://travis-ci.com/InsanusMokrassar/TelegramBotAPI) |
|
|
| -------------------------------------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
| TelegramBotAPI status | [](https://bintray.com/insanusmokrassar/StandardRepository/TelegramBotAPI/_latestVersion) [](https://maven-badges.herokuapp.com/maven-central/com.github.insanusmokrassar/TelegramBotAPI) |
|
|
| TelegramBotAPI Extensions status | [](https://bintray.com/insanusmokrassar/StandardRepository/TelegramBotAPI-extensions-api/_latestVersion) [](https://maven-badges.herokuapp.com/maven-central/com.github.insanusmokrassar/TelegramBotAPI-extensions-api) |
|
|
| TelegramBotAPI Util Extensions status | [](https://bintray.com/insanusmokrassar/StandardRepository/TelegramBotAPI-extensions-utils/_latestVersion) [](https://maven-badges.herokuapp.com/maven-central/com.github.insanusmokrassar/TelegramBotAPI-extensions-utils) |
|
|
|
|
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](TelegramBotAPI/README.md) - core of library. In fact it is independent library and can be used alone
|
|
without any additional library
|
|
* [TelegramBotAPI Extensions](TelegramBotAPI-extensions-api/README.md) - contains extensions (mostly for
|
|
`RequestsExecutor`), which allows to use the core library in more pleasant way
|
|
* [TelegramBotAPI Util Extensions](TelegramBotAPI-extensions-utils/README.md) - contains extensions for more comfortable
|
|
work with commands, updates and other different things
|
|
|
|
Most part of some specific solves or unuseful
|
|
moments are describing by official [Telegram Bot API](https://core.telegram.org/bots/api).
|
|
|
|
## JavaScript notes
|
|
|
|
In case if you are want to use this library inside of browser, you will need additional settings (thanks for help to [Alexander Nozik](https://research.jetbrains.org/researchers/altavir)):
|
|
|
|
<details>
|
|
<summary>Gradle build script help</summary>
|
|
|
|
```groovy
|
|
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")
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
</details>
|
|
|
|
## Ok, where should I start?
|
|
|
|
In most cases, the most simple way will be to implement
|
|
[TelegramBotAPI Extensions](TelegramBotAPI-extensions-api/README.md) and
|
|
[TelegramBotAPI Util Extensions](TelegramBotAPI-extensions-utils/README.md) for the reason that they contains more
|
|
simple tools. If you want to dive deeper in the core of library or develop something for it - welcome to
|
|
[TelegramBotAPI](TelegramBotAPI/README.md).
|
|
|
|
Anyway, all libraries are very typical inside of them. Examples:
|
|
|
|
* In `TelegramBotAPI` common request look like `requestsExecutor.execute(SomeRequest())`
|
|
* `TelegramBotAPI-extensions-api` typical syntax look like `requestsExecutor.someRequest()` (in most cases it would be
|
|
better to use `bot` name instead of `requestsExecutor`)
|
|
* `TelegramBotAPI-extensions-utils` will look like `filter.filterBaseMessageUpdates(chatId).filterExactCommands(Regex("^.*$"))...`
|