tgbotapi/README.md

4.3 KiB

TelegramBotAPI

Common info Awesome Kotlin Badge Chat in Telegram Build Status
TelegramBotAPI status Download Maven Central
TelegramBotAPI Extensions status Download Maven Central
TelegramBotAPI Util Extensions status Download Maven Central

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 of library. In fact it is independent library and can be used alone without any additional library
  • TelegramBotAPI Extensions - contains extensions (mostly for RequestsExecutor), which allows to use the core library in more pleasant way
  • TelegramBotAPI Util Extensions - 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.

Ok, where should I start?

In most cases, the most simple way will be to implement TelegramBotAPI Extensions and TelegramBotAPI Util Extensions 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.

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("^.*$"))...