tgbot 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 662c96b10f41495f1a6aec7c80801950d22d40eb
+  data.tar.gz: ce8833bebe2c18dc1976ef330460d64cacd52d23
+SHA512:
+  metadata.gz: cba3af636ed854c1e225ae3cdbea48db5145ee3fc9422a3ff7431b60206c1e5ac3652bac64e59b2413184e871134d07df4d10a03b4acf66fe155e6b962c0af92
+  data.tar.gz: 64129d237a5b93b5cb4e7a1c7aa56321cd4704df44c99b57fac81120965b548ece3defed49057e841aee1cfadfe05b6ada9853fcab90a3a638fcbd29968edb95

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in tgbot.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 hyrious
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,42 @@
+# `Tgbot`
+
+A tiny but easy-to-use wrapper of [Telegram Bot API](https://core.telegram.org/bots/api).
+
+It's still under experiment, not ready for use.
+
+## `future.rb`
+
+```ruby
+# `Tgbot.run' will start a loop until `Interrupt (Ctrl+C)' occured
+Tgbot.run TOKEN, proxy: 'https://127.0.0.1:1080' do |bot|
+  bot.start do # once
+    bot.ok "this is @#{bot.first_name}, sir."
+  end
+  bot.get 'drive' do # if message['drive']
+    bot.send_photo garage.pop rescue bot.retry(1) { |x| bot.sorry "Failed #{x} times." }
+  end                          # totally retry ^ times
+  bot.on /\-md([.^]+)\Z/m do |matched|
+    phantomjs 'md.js', matched
+    bot.send_photo 'cp.jpg' rescue bot.sorry
+  end
+  bot.finish do # rescue Interrupt
+    bot.ok 'byebye.'
+  end
+  bot.before_update do |update|
+    # do something before handling every [update]
+  end
+  bot.after_update do |update|
+    # do something after handling every [update]
+  end
+end
+```
+
+## Further future
+
+Features often needed by bots.
+
+- database
+- session
+- access control
+- dynamically add functions
+- 

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+
+desc 'Make lib/*.json'
+task :json do
+  cd 'tools'
+  ruby 'gen_types_json.rb'
+  cp 'types.json', '../lib'
+  ruby 'gen_methods_json.rb'
+  cp 'methods.json', '../lib'
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "tgbot"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/example.rb

@@ -0,0 +1,34 @@
+require './helper'
+save_pid
+require 'tgbot'
+@garage = load_data.shuffle
+
+TOKEN = 
+Tgbot.run TOKEN, proxy: 'https://127.0.0.1:1080' do |bot|
+
+  bot.start do
+    log "this is \e[33m#{bot.name}\e[32m, master.", 2
+  end
+  bot.finish do
+    log "byebye.", 1
+  end
+  bot.get 'drive' do |x, update|
+    pic = @garage.pop
+    log ">> Sending #{File.basename(pic)} to @#{update.message.from.username} ##{update.id}", 6
+    update.reply_photo pic, caption: File.basename(pic, '.*')
+  end
+  bot.before do |update|
+    log ">> Processing ##{update.id} #{bot.timeout}"
+  end
+  bot.after do |update|
+    if update.done?
+      log "=> Success ##{update.id}", 2
+    else
+      log "?> Retry ##{update.id}", 3
+    end
+  end
+
+end
+
+save_data @garage
+delete_pid

data/lib/methods.json

@@ -0,0 +1 @@
+{"getUpdates":{"ret":"[Update]","params":{"offset":{"type":"Integer","optional":true},"limit":{"type":"Integer","optional":true},"timeout":{"type":"Integer","optional":true},"allowed_updates":{"type":"[String]","optional":true}}},"setWebhook":{"ret":"True","params":{"url":{"type":"String","optional":false},"certificate":{"type":"InputFile","optional":true},"max_connections":{"type":"Integer","optional":true},"allowed_updates":{"type":"[String]","optional":true}}},"deleteWebhook":{"ret":"True","params":{}},"getWebhookInfo":{"ret":"WebhookInfo","params":{}},"getMe":{"ret":"User","params":{}},"sendMessage":{"ret":"Message","params":{"chat_id":{"type":"Integer|String","optional":false},"text":{"type":"String","optional":false},"parse_mode":{"type":"String","optional":true},"disable_web_page_preview":{"type":"Boolean","optional":true},"disable_notification":{"type":"Boolean","optional":true},"reply_to_message_id":{"type":"Integer","optional":true},"reply_markup":{"type":"InlineKeyboardMarkup|ReplyKeyboardMarkup|ReplyKeyboardRemove|ForceReply","optional":true}}},"forwardMessage":{"ret":"Message","params":{"chat_id":{"type":"Integer|String","optional":false},"from_chat_id":{"type":"Integer|String","optional":false},"disable_notification":{"type":"Boolean","optional":true},"message_id":{"type":"Integer","optional":false}}},"sendPhoto":{"ret":"Message","params":{"chat_id":{"type":"Integer|String","optional":false},"photo":{"type":"InputFile|String","optional":false},"caption":{"type":"String","optional":true},"disable_notification":{"type":"Boolean","optional":true},"reply_to_message_id":{"type":"Integer","optional":true},"reply_markup":{"type":"InlineKeyboardMarkup|ReplyKeyboardMarkup|ReplyKeyboardRemove|ForceReply","optional":true}}},"sendAudio":{"ret":"Message","params":{"chat_id":{"type":"Integer|String","optional":false},"audio":{"type":"InputFile|String","optional":false},"caption":{"type":"String","optional":true},"duration":{"type":"Integer","optional":true},"performer":{"type":"String","optional":true},"title":{"type":"String","optional":true},"disable_notification":{"type":"Boolean","optional":true},"reply_to_message_id":{"type":"Integer","optional":true},"reply_markup":{"type":"InlineKeyboardMarkup|ReplyKeyboardMarkup|ReplyKeyboardRemove|ForceReply","optional":true}}},"sendDocument":{"ret":"Message","params":{"chat_id":{"type":"Integer|String","optional":false},"document":{"type":"InputFile|String","optional":false},"caption":{"type":"String","optional":true},"disable_notification":{"type":"Boolean","optional":true},"reply_to_message_id":{"type":"Integer","optional":true},"reply_markup":{"type":"InlineKeyboardMarkup|ReplyKeyboardMarkup|ReplyKeyboardRemove|ForceReply","optional":true}}},"sendVideo":{"ret":"Message","params":{"chat_id":{"type":"Integer|String","optional":false},"video":{"type":"InputFile|String","optional":false},"duration":{"type":"Integer","optional":true},"width":{"type":"Integer","optional":true},"height":{"type":"Integer","optional":true},"caption":{"type":"String","optional":true},"disable_notification":{"type":"Boolean","optional":true},"reply_to_message_id":{"type":"Integer","optional":true},"reply_markup":{"type":"InlineKeyboardMarkup|ReplyKeyboardMarkup|ReplyKeyboardRemove|ForceReply","optional":true}}},"sendVoice":{"ret":"Message","params":{"chat_id":{"type":"Integer|String","optional":false},"voice":{"type":"InputFile|String","optional":false},"caption":{"type":"String","optional":true},"duration":{"type":"Integer","optional":true},"disable_notification":{"type":"Boolean","optional":true},"reply_to_message_id":{"type":"Integer","optional":true},"reply_markup":{"type":"InlineKeyboardMarkup|ReplyKeyboardMarkup|ReplyKeyboardRemove|ForceReply","optional":true}}},"sendVideoNote":{"ret":"Message","params":{"chat_id":{"type":"Integer|String","optional":false},"video_note":{"type":"InputFile|String","optional":false},"duration":{"type":"Integer","optional":true},"length":{"type":"Integer","optional":true},"disable_notification":{"type":"Boolean","optional":true},"reply_to_message_id":{"type":"Integer","optional":true},"reply_markup":{"type":"InlineKeyboardMarkup|ReplyKeyboardMarkup|ReplyKeyboardRemove|ForceReply","optional":true}}},"sendLocation":{"ret":"Message","params":{"chat_id":{"type":"Integer|String","optional":false},"latitude":{"type":"Float","optional":false},"longitude":{"type":"Float","optional":false},"disable_notification":{"type":"Boolean","optional":true},"reply_to_message_id":{"type":"Integer","optional":true},"reply_markup":{"type":"InlineKeyboardMarkup|ReplyKeyboardMarkup|ReplyKeyboardRemove|ForceReply","optional":true}}},"sendVenue":{"ret":"Message","params":{"chat_id":{"type":"Integer|String","optional":false},"latitude":{"type":"Float","optional":false},"longitude":{"type":"Float","optional":false},"title":{"type":"String","optional":false},"address":{"type":"String","optional":false},"foursquare_id":{"type":"String","optional":true},"disable_notification":{"type":"Boolean","optional":true},"reply_to_message_id":{"type":"Integer","optional":true},"reply_markup":{"type":"InlineKeyboardMarkup|ReplyKeyboardMarkup|ReplyKeyboardRemove|ForceReply","optional":true}}},"sendContact":{"ret":"Message","params":{"chat_id":{"type":"Integer|String","optional":false},"phone_number":{"type":"String","optional":false},"first_name":{"type":"String","optional":false},"last_name":{"type":"String","optional":false},"disable_notification":{"type":"Boolean","optional":true},"reply_to_message_id":{"type":"Integer","optional":true},"reply_markup":{"type":"InlineKeyboardMarkup|ReplyKeyboardMarkup|ReplyKeyboardRemove|ForceReply","optional":true}}},"sendChatAction":{"ret":"True","params":{"chat_id":{"type":"Integer|String","optional":false},"action":{"type":"String","optional":false}}},"getUserProfilePhotos":{"ret":"UserProfilePhotos","params":{"user_id":{"type":"Integer","optional":false},"offset":{"type":"Integer","optional":true},"limit":{"type":"Integer","optional":true}}},"getFile":{"ret":"File","params":{"file_id":{"type":"String","optional":false}}},"kickChatMember":{"ret":"True","params":{"chat_id":{"type":"Integer|String","optional":false},"user_id":{"type":"Integer","optional":false},"until_date":{"type":"Integer","optional":true}}},"unbanChatMember":{"ret":"True","params":{"chat_id":{"type":"Integer|String","optional":false},"user_id":{"type":"Integer","optional":false}}},"restrictChatMember":{"ret":"True","params":{"chat_id":{"type":"Integer|String","optional":false},"user_id":{"type":"Integer","optional":false},"until_date":{"type":"Integer","optional":true},"can_send_messages":{"type":"Boolean","optional":true},"can_send_media_messages":{"type":"Boolean","optional":true},"can_send_other_messages":{"type":"Boolean","optional":true},"can_add_web_page_previews":{"type":"Boolean","optional":true}}},"promoteChatMember":{"ret":"True","params":{"chat_id":{"type":"Integer|String","optional":false},"user_id":{"type":"Integer","optional":false},"can_change_info":{"type":"Boolean","optional":true},"can_post_messages":{"type":"Boolean","optional":true},"can_edit_messages":{"type":"Boolean","optional":true},"can_delete_messages":{"type":"Boolean","optional":true},"can_invite_users":{"type":"Boolean","optional":true},"can_restrict_members":{"type":"Boolean","optional":true},"can_pin_messages":{"type":"Boolean","optional":true},"can_promote_members":{"type":"Boolean","optional":true}}},"exportChatInviteLink":{"ret":"String","params":{"chat_id":{"type":"Integer|String","optional":false}}},"setChatPhoto":{"ret":"True","params":{"chat_id":{"type":"Integer|String","optional":false},"photo":{"type":"InputFile","optional":false}}},"deleteChatPhoto":{"ret":"True","params":{"chat_id":{"type":"Integer|String","optional":false}}},"setChatTitle":{"ret":"True","params":{"chat_id":{"type":"Integer|String","optional":false},"title":{"type":"String","optional":false}}},"setChatDescription":{"ret":"True","params":{"chat_id":{"type":"Integer|String","optional":false},"description":{"type":"String","optional":true}}},"pinChatMessage":{"ret":"True","params":{"chat_id":{"type":"Integer|String","optional":false},"message_id":{"type":"Integer","optional":false},"disable_notification":{"type":"Boolean","optional":true}}},"unpinChatMessage":{"ret":"True","params":{"chat_id":{"type":"Integer|String","optional":false}}},"leaveChat":{"ret":"Boolean","params":{"chat_id":{"type":"Integer|String","optional":false}}},"getChat":{"ret":"Chat","params":{"chat_id":{"type":"Integer|String","optional":false}}},"getChatAdministrators":{"ret":"[ChatMember]","params":{"chat_id":{"type":"Integer|String","optional":false}}},"getChatMembersCount":{"ret":"Integer","params":{"chat_id":{"type":"Integer|String","optional":false}}},"getChatMember":{"ret":"ChatMember","params":{"chat_id":{"type":"Integer|String","optional":false},"user_id":{"type":"Integer","optional":false}}},"answerCallbackQuery":{"ret":"True","params":{"callback_query_id":{"type":"String","optional":false},"text":{"type":"Boolean","optional":true},"show_alert":{"type":"Boolean","optional":true},"url":{"type":"String","optional":true},"cache_time":{"type":"Integer","optional":true}}},"editMessageText":{"ret":"Message|True","params":{"chat_id":{"type":"Integer|String","optional":true},"message_id":{"type":"Integer","optional":true},"inline_message_id":{"type":"String","optional":true},"text":{"type":"String","optional":false},"parse_mode":{"type":"String","optional":true},"disable_web_page_preview":{"type":"Boolean","optional":true},"reply_markup":{"type":"InlineKeyboardMarkup","optional":true}}},"editMessageCaption":{"ret":"Message|True","params":{"chat_id":{"type":"Integer|String","optional":true},"message_id":{"type":"Integer","optional":true},"inline_message_id":{"type":"String","optional":true},"caption":{"type":"String","optional":true},"reply_markup":{"type":"InlineKeyboardMarkup","optional":true}}},"editMessageReplyMarkup":{"ret":"Message|True","params":{"chat_id":{"type":"Integer|String","optional":true},"message_id":{"type":"Integer","optional":true},"inline_message_id":{"type":"String","optional":true},"reply_markup":{"type":"InlineKeyboardMarkup","optional":true}}},"deleteMessage":{"ret":"True","params":{"chat_id":{"type":"Integer|String","optional":false},"message_id":{"type":"Integer","optional":false}}},"sendSticker":{"ret":"Message","params":{"chat_id":{"type":"Integer|String","optional":false},"sticker":{"type":"InputFile|String","optional":false},"disable_notification":{"type":"Boolean","optional":true},"reply_to_message_id":{"type":"Integer","optional":true},"reply_markup":{"type":"InlineKeyboardMarkup|ReplyKeyboardMarkup|ReplyKeyboardRemove|ForceReply","optional":true}}},"getStickerSet":{"ret":"StickerSet","params":{"name":{"type":"String","optional":false}}},"uploadStickerFile":{"ret":"File","params":{"user_id":{"type":"Integer","optional":false},"png_sticker":{"type":"InputFile","optional":false}}},"createNewStickerSet":{"ret":"True","params":{"name":{"type":"String","optional":false},"title":{"type":"String","optional":false},"png_sticker":{"type":"InputFile|String","optional":false},"emojis":{"type":"String","optional":false},"contains_masks":{"type":"Boolean","optional":true},"mask_position":{"type":"MaskPosition","optional":true}}},"addStickerToSet":{"ret":"True","params":{"user_id":{"type":"Integer","optional":false},"name":{"type":"String","optional":false},"png_sticker":{"type":"InputFile|String","optional":false},"emojis":{"type":"String","optional":false},"mask_position":{"type":"MaskPosition","optional":true}}},"setStickerPositionInSet":{"ret":"True","params":{"sticker":{"type":"String","optional":false},"position":{"type":"Integer","optional":false}}},"deleteStickerFromSet":{"ret":"True","params":{"sticker":{"type":"String","optional":false}}},"answerInlineQuery":{"ret":"Boolean","params":{"inline_query_id":{"type":"String","optional":false},"results":{"type":"[InlineQueryResult]","optional":false},"cache_time":{"type":"Integer","optional":true},"is_personal":{"type":"Boolean","optional":true},"next_offset":{"type":"String","optional":true},"switch_pm_text":{"type":"String","optional":true},"switch_pm_parameter":{"type":"String","optional":true}}},"sendInvoice":{"ret":"Message","params":{"chat_id":{"type":"Integer","optional":false},"title":{"type":"String","optional":false},"description":{"type":"String","optional":false},"payload":{"type":"String","optional":false},"provider_token":{"type":"String","optional":false},"start_parameter":{"type":"String","optional":false},"currency":{"type":"String","optional":false},"prices":{"type":"[LabeledPrice]","optional":false},"photo_url":{"type":"String","optional":true},"photo_size":{"type":"Integer","optional":true},"photo_width":{"type":"Integer","optional":true},"photo_height":{"type":"Integer","optional":true},"need_name":{"type":"Boolean","optional":true},"need_phone_number":{"type":"Boolean","optional":true},"need_email":{"type":"Boolean","optional":true},"need_shipping_address":{"type":"Boolean","optional":true},"is_flexible":{"type":"Boolean","optional":true},"disable_notification":{"type":"Boolean","optional":true},"reply_to_message_id":{"type":"Integer","optional":true},"reply_markup":{"type":"InlineKeyboardMarkup","optional":true}}},"answerShippingQuery":{"ret":"True","params":{"shipping_query_id":{"type":"String","optional":false},"ok":{"type":"Boolean","optional":false},"shipping_options":{"type":"[ShippingOption]","optional":true},"error_message":{"type":"String","optional":true}}},"answerPreCheckoutQuery":{"ret":"True","params":{"pre_checkout_query_id":{"type":"String","optional":false},"ok":{"type":"Boolean","optional":false},"error_message":{"type":"String","optional":true}}},"sendGame":{"ret":"Message","params":{"chat_id":{"type":"Integer","optional":false},"game_short_name":{"type":"String","optional":false},"disable_notification":{"type":"Boolean","optional":true},"reply_to_message_id":{"type":"Integer","optional":true},"reply_markup":{"type":"InlineKeyboardMarkup","optional":true}}},"setGameScore":{"ret":"Message|True","params":{"user_id":{"type":"Integer","optional":false},"score":{"type":"Integer","optional":false},"force":{"type":"Boolean","optional":true},"disable_edit_message":{"type":"Boolean","optional":true},"chat_id":{"type":"Integer","optional":true},"message_id":{"type":"Integer","optional":true},"inline_message_id":{"type":"String","optional":true}}},"getGameHighScores":{"ret":"[GameHighScore]","params":{"user_id":{"type":"Integer","optional":false},"chat_id":{"type":"Integer","optional":true},"message_id":{"type":"Integer","optional":true},"inline_message_id":{"type":"String","optional":true}}}}

data/lib/tgbot.rb

@@ -0,0 +1,5 @@
+require 'tgbot/version'
+require 'tgbot/core'
+require 'tgbot/update'
+require 'tgbot/runner'
+require 'tgbot/dsl'

data/lib/tgbot/core.rb

@@ -0,0 +1,145 @@
+require 'json'
+require 'faraday'
+
+module Tgbot
+  API_URL = 'https://api.telegram.org'.freeze
+  TYPES   = JSON.parse(File.read File.expand_path '../types.json'  , __dir__).freeze
+  METHODS = JSON.parse(File.read File.expand_path '../methods.json', __dir__).freeze
+  
+  # This bot supports a minimal usage of Telegram Bot APIs.
+  #   bot = Bot.new TOKEN, proxy: 'https://127.0.0.1:1080'
+  #
+  # API's methods' input and output are hash.
+  #   bot.get_updates offset: 0 #=> { 'ok' => 'true', 'result' => [] }
+  # 
+  # It will check type of params before post method, and
+  # if invalid, it will raise an error with detail.
+  class Bot
+    attr_accessor :token
+
+    # Initialize a bot, and call getMe at once to see if given token is valid.
+    # If everything ok, the bot will get its id and name and so on.
+    # token :: String = TOKEN of your bot from botfather
+    # opts  :: Hash   = Options passed to Faraday.new
+    def initialize(token, **opts)
+      @token = token
+      get_connection(**opts)
+      identify_self
+    end
+
+    # Get bot's info.
+    def identify_self
+      x = get_me
+      if x['ok']
+        @me = x['result']
+      else
+        raise ArgumentError, 'not found myself, check your token.'
+      end
+    end
+
+    # Shortcuts for bot's info.
+    def id        ; @me && @me['id']        ; end
+    def first_name; @me && @me['first_name']; end
+    def username  ; @me && @me['username']  ; end
+    alias name first_name
+
+    # Connect to API_URL. It will take few seconds.
+    # opts :: Hash = Options passed to Faraday.new
+    def get_connection(**opts)
+      @conn = Faraday.new(url: API_URL, **opts) do |faraday|
+        faraday.request :multipart
+        faraday.request :url_encoded
+        faraday.adapter Faraday.default_adapter
+      end
+    end
+
+    # Verify methods and params then call(post) it.
+    # `:get_me' and `:getMe' are both valid.
+    def method_missing(meth, **kwargs)
+      camelized_meth = camelize meth
+      meth_body = METHODS[camelized_meth]
+      super unless meth_body
+      ret, params = meth_body.values_at 'ret', 'params'
+      check_params! (JSON.parse JSON.generate kwargs), params
+      call camelized_meth, kwargs
+    end
+
+    def call meth, kwargs
+      JSON.parse @conn.post("/bot#{@token}/#{meth}", kwargs).body
+    rescue
+      {}
+    end
+
+    # Check args to meet method declaration. Raises error if invalid.
+    def check_params! kwargs, params
+      params.each do |param, info|
+        arg = kwargs[param]
+        type, optional = info.values_at 'type', 'optional'
+        if (arg.nil? && !optional) || (!arg.nil? && !check_type(arg, type))
+          raise ArgumentError, "[#{param}] should be #{type}\n#{error_message_of_type type}"
+        end
+      end
+    end
+
+    # Get declaration of type in form of:
+    #   User := { id :: Integer, first_name :: String }
+    def error_message_of_type type
+      (type.delete('[]').split('|') - ['True', 'Boolean', 'Integer', 'Float', 'String']).map { |type|
+        "#{type} := { #{TYPES[type].map { |field, info|
+          "#{info['optional'] ? '' : '*'}#{field} :: #{info['type']}"
+        }.join(', ')} }"
+      }.join(' ')
+    end
+
+    # Check arg to meet type declaration. Returns false if invalid.
+    def check_type arg, type
+      case type
+      when 'True'    then return arg == true
+      when 'Boolean' then return arg == true || arg == false
+      when 'Integer' then return arg.is_a? Integer
+      when 'Float'   then return arg.is_a? Float
+      when 'String'  then return arg.is_a? String
+      end
+      if type[0] == '['
+        return arg.is_a?(Array) ? arg.all? { |a| check_type a, type[1..-2] } : false
+      elsif type.include? '|'
+        return type.split('|').any? { |t| check_type arg, t }
+      end
+      return false unless TYPES[type]
+      check_params(arg, TYPES[type])
+    end
+
+    # Check args to meet method declaration. Returns false if invalid.
+    def check_params kwargs, params
+      check_params!(kwargs, params)
+      true
+    rescue
+      false
+    end
+
+    def get_types
+      TYPES.keys.map(&:to_sym)
+    end
+
+    def get_methods
+      METHODS.keys.map { |e| underscore e }.map(&:to_sym)
+    end
+
+    # Transform 'TheName' or 'theName' to 'the_name'.
+    def underscore str
+      str.gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2')
+         .gsub(/([a-z\d])([A-Z])/,'\1_\2').downcase
+    end
+
+    # Transform 'the_name' to 'theName'.
+    def camelize meth
+      ret = String(meth).split('_')
+      ret.drop(1).map(&:capitalize!)
+      ret.join
+    end
+
+    def inspect
+      "#<Bot token=#{@token} id=#{id} first_name=#{first_name} username=#{username}>"
+    end
+  end
+end

data/lib/tgbot/dsl.rb

@@ -0,0 +1,54 @@
+require 'tgbot/runner'
+
+module Tgbot
+  class DSL
+    attr_accessor :runner
+    def initialize(token, **opts)
+      @runner = Runner.new(token, **opts)
+      @procs = { command: {} }
+    end
+    def start(&blk)
+      @procs[:start] = blk
+    end
+    def finish(&blk)
+      @procs[:finish] = blk
+    end
+    def before(&blk)
+      @procs[:before] = blk
+    end
+    def after(&blk)
+      @procs[:after] = blk
+    end
+    def on(regex, &blk)
+      @procs[:command][regex] = blk
+    end
+    alias get on
+    def run
+      yield self if block_given?
+      @procs[:start]&.call
+      begin
+        @runner.mainloop do |update|
+          @procs[:before]&.call update
+          update.done = true
+          @procs[:command].each do |key, blk|
+            x = update.text&.match key
+            blk.call x, update if x
+          end
+          @procs[:after]&.call update
+        end
+      rescue Interrupt
+        @procs[:finish]&.call
+      rescue => e
+        puts $!
+        puts e.backtrace
+        retry
+      end
+    end
+    def method_missing(meth, *args, &blk)
+      @runner.send(meth, *args, &blk)
+    end
+  end
+  def self.run(token, **opts, &blk)
+    DSL.new(token, **opts).run(&blk)
+  end
+end

data/lib/tgbot/runner.rb

@@ -0,0 +1,46 @@
+require 'json'
+require 'ostruct'
+require 'tgbot/core'
+require 'tgbot/update'
+
+module Tgbot
+  class Runner
+    attr_accessor :bot, :offset, :timeout, :updates
+    def initialize(token, **opts)
+      @bot      = Bot.new(token, **opts)
+      @offset   = 0
+      @timeout  = 2
+      @updates  = []
+    end
+    def mainloop
+      loop do
+        @updates.each { |u| u.count += 1 }
+        update_updates
+        @updates.each { |update| yield update }
+      end
+    end
+    def update_updates
+      @updates.delete_if(&:done?)
+      x = x
+      t = time { x = @bot.get_updates offset: @offset + 1, limit: 7, timeout: @timeout }
+      case
+      when t > @timeout then @timeout += [@timeout / 2, 1].max
+      when t < @timeout then @timeout -= 1
+      end
+      @timeout = [[0, @timeout].max, 15].min
+      x['result'].each { |e| @updates.push Update.new(@bot, hash_to_ostruct(e)) } if x['ok']
+      @offset = [*@updates.map(&:update_id), @offset].max
+    end
+    def hash_to_ostruct hash
+      JSON.parse JSON.generate(hash), object_class: OpenStruct
+    end
+    def time
+      t = Time.now
+      yield
+      Time.now - t
+    end
+    def method_missing(meth, *args, &blk)
+      @bot.send(meth, *args, &blk)
+    end
+  end
+end

data/lib/tgbot/update.rb

@@ -0,0 +1,76 @@
+require 'faraday'
+require 'mimemagic'
+module Tgbot
+  class Update
+    attr_accessor :bot, :update, :type, :done, :count
+    def initialize bot, update
+      @bot, @update = bot, update
+      @type         = get_type
+      @done         = false
+      @count        = 0
+    end
+    alias done? done
+    def id
+      @update.update_id
+    end
+    def chat_id
+      @update[@type].chat&.id
+    end
+    def text
+      @update[@type].text
+    end
+    def send_message(text = nil, **kwargs)
+      return unless chat_id
+      return unless text = text || kwargs.delete(:text)
+      @bot.send_message(chat_id: chat_id, text: text, **kwargs)
+    end
+    def reply_message(text = nil, **kwargs)
+      return unless chat_id
+      return unless text = text || kwargs.delete(:text)
+      @bot.send_message(
+        chat_id: chat_id, text: text, 
+        reply_to_message_id: @update[@type].message_id, **kwargs)
+    end
+    %i(photo audio document video voice video_note).each do |name|
+      class_eval %{
+        def send_#{name}(#{name} = nil, **kwargs)
+          return unless chat_id
+          return unless #{name} = #{name} || kwargs.delete(:#{name})
+          @bot.send_#{name}(
+            chat_id: chat_id,
+            #{name}: Faraday::UploadIO.new(#{name}, MimeMagic.by_path(#{name}).type),
+            **kwargs)
+        end
+        def reply_#{name}(#{name} = nil, **kwargs)
+          return unless chat_id
+          return unless #{name} = #{name} || kwargs.delete(:#{name})
+          @bot.send_#{name}(
+            chat_id: chat_id,
+            #{name}: Faraday::UploadIO.new(#{name}, MimeMagic.by_path(#{name}).type),
+            reply_to_message_id: @update[@type].message_id, **kwargs)
+        end
+      }
+    end
+    def get_type
+      %i(
+        message
+        edited_message
+        channel_post
+        edited_channel_post
+        inline_query
+        chosen_inline_result
+        callback_query
+        shipping_query
+        pre_checkout_query
+      ).find { |f| @update[f] }
+    end
+    def method_missing(field)
+      @update[field]
+    end
+    def inspect
+      "#<Update ##{id} #{@type}=#{@update[@type]}>"
+    end
+    alias to_str inspect
+    alias to_s inspect
+  end
+end