This README is the one indexed from the repository at its latest ref, not from the tag for this version.

hamilton

Crystal wrapper for Telegram Bot API (updated to 9.6) with optional async execution. Telegram Mini Apps are not supported.

Installation

1. Add the dependency to your shard.yml:

   dependencies:
     hamilton:
       github: Scurrra/hamilton

2. Run shards install

Usage

require "hamilton"

API = Hamilton::Api.new(token: "<YOUR-API-TOKEN>")

handler = Hamilton::CmdHandler.new

@[Handler(handler)]
@[Handle(command: "/start")]
def handle_start_command(argument, context, update)
  # logic here
  return nil
end

@[Handler(handler)]
@[Handle(command: "help")]
def handle_help_command(argument, context, update)
  # logic here
  return nil
end

bot = Hamilton::Bot.new(
  api: API,
  handlers: [
    Hamilton::LogHandler.new, 
    handler
  ]
)

Signal::INT.trap do
  bot.stop
end

bot.listen

Usage guide with detailed explanation and example of the async bot can be found here.

Contributing

1. Fork it (https://github.com/Scurrra/hamilton/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

Contributors

• Scurrra - creator and maintainer