teleruby 1.5.1 → 1.5.4

data/lib/api/get_apis.rb

@@ -0,0 +1,162 @@
+#!/usr/bin/ruby
+# frozen_string_literal: true
+
+require_relative '../core_api'
+
+##
+# Solomon Boloshe(Lee Crey)
+# Friday, August 21 2020 04:52:49 PM +0300
+
+module Telegram
+  module GetApis # rubocop:disable Metrics/ModuleLength
+    include CoreApi
+    # Use this method to receive incoming updates using long polling.
+    def get_updates(limit: 10, type: nil) # rubocop:disable Metrics/MethodLength
+      hash = { 'timeout': 0, 'limit': limit, 'offset': @last_update }
+      if type and (type.instance_of? Array)
+        hash.merge!({ allowed_updates: type })
+      end
+      response = http_get('getUpdates', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise TelegramError, response.desciption
+      end
+
+      result = response.result
+      if result.instance_of? Array
+        @last_update = result.last.update_id + 1 if result.last
+      end
+
+      updates = []
+      result.each do |update|
+        updates << Update.new(update)
+      end
+      updates
+    end
+    # rubocop:enalbe Metrics/MethodLength
+
+    # A simple method for testing your bot's authentication token.
+    def get_me
+      response = http_get('getMe')
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise TokenError, 'incorrect bot token'
+      end
+      BotUser.new(response.result)
+    end
+
+    # Use this method to get basic info about a file.
+    # Returns TFile object
+    def get_file(file_id)
+      hash = { file_id: file_id }
+      response = http_get('getFile', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise IdError, 'incorrect file id'
+      end
+      TFile.new(response.result)
+    end
+
+    # Use this method to get a list of profile pictures for a user.
+    def get_profile_photos(user_id, params = {}) # rubocop:disable Metrics/MethodLength
+      if user_id.to_i.negative? # rubocop:disable Style/IfUnlessModifier
+        raise IdError, 'id must be private chat\'s id'
+      end
+
+      hash = { uesr_id: user_id }.merge!(params)
+      response = http_get('getProfilePhotos', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise TelegramError, response.description
+      end
+
+      result = response.result
+      if result.instance_of? Array
+        profile = []
+        result.each do |e|
+          profile << ProfilePhoto.new(e)
+        end
+        return profile
+      end
+      ProfilePhoto.new(result)
+    end
+
+    # Use this method to get a list of administrators in a chat.
+    def get_chat_admins(chat_id)
+      unless chat_id.to_i.negative? # rubocop:disable Style/IfUnlessModifier
+        raise IdError, 'chat id must be supergroup id'
+      end
+      hash = { chat_id: chat_id }
+      response = http_get('getChatAdministrators', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise FatalError, 'fatal error'
+      end
+
+      result = response.result
+      users = []
+      result.each do |user|
+        users << ChatMember.new(user)
+      end
+      users
+    end
+    # rubocop:enable Metrics/MethodLength
+
+    # Use this method to get the number of members in a chat.
+    def get_chat_members_count(chat_id)
+      hash = { chat_id: chat_id }
+      response = http_get('getChatMemebersCount', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise IdError, %{don't use private chat id}
+      end
+      response.result
+    end
+
+    # Use this method to get information about a member of a chat.
+    def get_chat_member(chat_id, user_id)
+      hash = { chat_id: chat_id, user_id: user_id }
+      response = http_get('getChatMember', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise FatalError, response.description
+      end
+      ChatMember.new(response.result)
+    end
+
+    # Use this method to get a sticker set.
+    def get_sticker_set_name(name)
+      hash = { name: name }
+      response = http_get('getStickerSetName', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise Error, %{incorrect sticker set name}
+      end
+      StickerSet.new(response.result)
+    end
+
+    # Use this method to get up to date information about the chat.
+    def get_chat(chat_id) # rubocop:disable Metrics/MethodLength
+      hash = { chat_id: chat_id }
+      response = http_get('getChat', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise IdError, %{incorrect chat id}
+      end
+
+      if chat_id.negative?
+        return GetChat.new(response.result)
+      end
+      PrivateChat.new(response.result)
+    end
+
+    # Use this method to get the current list of the bot's commands.
+    def get_my_commands # rubocop:disable Metrics/MethodLength
+      response = http_get('getMyCommands')
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise TokenError, %{seems bot token error}
+      end
+
+      commands = []
+      result = response.result
+      result.each do |command|
+        commands << BotCommand.new(command)
+      end
+      commands
+    end
+  end
+  # rubocop:enable Metrics/ModuleLength
+
+  # The End!
+end

data/lib/api/nstandard.rb

@@ -0,0 +1,26 @@
+#!/usr/bin/ruby
+# frozen_string_literal: true
+
+require 'open-uri'
+
+module Telegram
+  module NonStandard
+    def download_file(file_d, dir = Dir.pwd)
+      raise NotImplementedError, 'not implemented'
+    end
+
+    def download_file_from(uri, dir = Dir.pwd)
+      uri = URI.parse(uri)
+    end
+
+    # use 'markdown'
+    def create_user_link(name, user_id)
+      "[#{name}](tg://user?id=#{id})"
+    end
+
+    # use 'markdow' for parse_mode
+    def create_text_link(message, url)
+      "[#{message}](#{url})"
+    end
+  end
+end

data/lib/api/other_apis.rb

@@ -0,0 +1,225 @@
+#!/usr/bin/ruby
+# frozen_string_literal: true
+
+require_relative '../core_api'
+
+module Telegram
+  module OtherApis
+    include CoreApi
+    # Use this method to forward messages of any kind.
+    def forward_message(from_chat_id, to_chat_id, message_id, params = {})
+      hash = { chat_id: to_chat_id, from_chat_id: from_chat_id }
+      hash2 = { message_id: message_id }.merge!(params)
+      hash.merge!(hash2)
+      data = http_post('forwardMessage', hash)
+      unless data.ok # rubocop:disable Style/IfUnlessModifier
+        raise TelegramError, data.description
+      end
+      data.result
+    end
+
+    # Use this method to kick a user from a group, a supergroup
+    # or a channel.
+    def kick_chat_member(chat_id, user_id, params = {})
+      hash = { chat_id: chat_id, user_id: user_id }.merge!(params)
+      data = http_post('kickChatMember', hash)
+      unless data.ok # rubocop:disable Style/IfUnlessModifier
+        raise TelegramError, data.description
+      end
+      data.result
+    end
+
+    # Use this method to unban a previously kicked user in a
+    # supergroup or channel.
+    def unban_chat_member(chat_id, user_id)
+      hash = { chat_id: chat_id, user_id: user_id }
+      data = http_post('unbanChatMember', hash)
+      unless data.ok # rubocop:disable Style/IfUnlessModifier
+        raise TelegramError, data.description
+      end
+      data.result
+    end
+
+    # Use this method to restrict a user in a supergroup.
+    def restrict_chat_member(chat_id, user_id, permissions, params = {})
+      hash = { chat_id: chat_id, user_id: user_id }
+      hash2 = { permissions: permissions }
+      hash.merge!(hash2)
+      data = http_post('restrictChatMember', hash)
+      unless data.ok # rubocop:disable Style/IfUnlessModifier
+        raise TelegramError, data.description
+      end
+      data.result
+    end
+
+    # Use this method to promote or demote a user in a supergroup or
+    # a channel.
+    def promote_chat_member(chat_id, user_id, params = {})
+      hash = { chat_id: chat_id, user_id: user_id }.merge!(params)
+      data = http_post('promoteChatMember', hash)
+      unless data.ok # rubocop:disable Style/IfUnlessModifier
+        raise TelegramError, data.description
+      end
+      data.result
+    end
+
+    # Use this method to generate a new invite link for a chat.
+    def export_chat_link(chat_id)
+      hash = { chat_id: chat_id }
+      response = http_post('exportChatInviteLink', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise TelegramError, response.description
+      end
+      response.result
+    end
+
+    # Use this method to pin a message in a group, a supergroup,
+    # or a channel.
+    def pin_chat_message(chat_id, message_id, params = {})
+      hash = { chat_id: chat_id, message_id: message_id }.merge!(params)
+      response = http_post('pinChatMessage', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise SecurityError, response.description
+      end
+      response.result
+    end
+
+    # Use this method to stop a poll which was sent by the bot.
+    def stop_poll(chat_id, message_id, params = {})
+      hash = { chat_id: chat_id, message_id: message_id }.merge!(params)
+      response = http_post('stopPoll', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise Error, response.description
+      end
+      response.result
+    end
+
+    # Use this method to upload a .PNG file with a sticker for later use
+    # in createNewStickerSet and addStickerToSet methods
+    # (can be used multiple times).
+    def upload_sticker_file(user_id, png_sticker)
+      hash = { user_id: user_id, png_sticker: png_sticker }
+      response = http_post('uploadStickerFile', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise Error, response.description
+      end
+      response.result
+    end
+
+    # Use this method to create a new sticker set owned by a user.
+    # The bot will be able to edit the sticker set thus created.
+    # You must use exactly one of the fields png_sticker or tgs_sticker.
+    def create_new_stricker_set(user_id, name, title, params = {})
+      hash = { user_id: user_id, name: name, title: title }.merge!(params)
+      response = http_post('createNewStickerSet', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise Error, response.description
+      end
+      response.result
+    end
+
+    # Use this method to add a new sticker to a set created by the bot.
+    def add_sticker_to_set(user_id, name, emojis, params = {})
+      hash = { user_id: user_id, name: name, emojis: emojis }.merge!(params)
+      response = http_post('addStickerToSet', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise StandardError, response.description
+      end
+      response.result
+    end
+
+    def edit_message_live_location
+      raise NotImplementedError, 'not implemented'
+    end
+
+    # Use this method to send answers to callback queries sent from inline
+    # keyboards. The answer will be displayed to the user as a notification
+    # at the top of the chat screen or as an alert. On success, True is
+    # returned.
+    def answer_callback_query(callback_query_id, params = {})
+      hash = { callback_query_id: callback_query_id }.merge!(params)
+      response = http_post('answerCallbackQuery', hash)
+      unless response.ok
+        raise FatalError, response.description
+      end
+      response.result
+    end
+
+    def delete_webhook
+      raise NotImplementedError, 'not support for now'
+    end
+
+    # Use this method to edit text and game messages. On success,
+    # if edited message is sent by the bot, the edited Message is returned,
+    # otherwise True is returned.
+    def edit_message_text(text, params = {})
+      hash = { text: text }.merge!(params)
+      response = http_post('editMessageText', hash)
+      unless response.ok
+        raise FatalError, response.description
+      end
+      if response.result == true
+        return true
+      end
+      Message.new(response.result)
+    end
+
+    # Use this method to edit captions of messages. On success, if edited
+    # message is sent by the bot, the edited Message is returned, otherwise
+    # True is returned.
+    def edit_message_caption(params = {})
+      response = http_post('editMessageCaption', params)
+      unless response.ok
+        raise FatalError, response.description
+      end
+      if response.result == true
+        return true
+      end
+      Message.new(response.result)
+    end
+
+    # Use this method to edit animation, audio, document, photo, or video
+    # messages. If a message is a part of a message album, then it can be
+    # edited only to a photo or a video. Otherwise, message type can be
+    # changed arbitrarily. When inline message is edited, new file can't
+    # be uploaded. Use previously uploaded file via its file_id or specify
+    # a URL. On success, if the edited message was sent by the bot, the edited
+    # Message is returned, otherwise True is returned.
+    def edit_message_media(media, params = {})
+      hash = { media: media }.merge!(params)
+      response = http_post('editMessageMedia', hash)
+      unless response.ok
+        raise FatalError, response.description
+      end
+      if response.result == true
+        return true
+      end
+      Message.new(response.result)
+    end
+
+    # Use this method to edit only the reply markup of messages. 
+    # On success, if edited message is sent by the bot, the edited Message
+    # is returned, otherwise True is returned.
+    def edit_message_reply_markup(params = {})
+      response = http_post('editMessageReplyMarkup', params)
+      unless response.ok
+        raise FatalError, response.description
+      end
+      if response.result == true
+        return true
+      end
+      Message.new(response.result)
+    end
+
+    # Use this method to send answers to an inline query. On success, True
+    # is returned. No more than 50 results per query are allowed.
+    def answer_inline_query(inline_query_id, result, params = {})
+      hash = { inline_query_id: inline_query_id, result: result }.merge!(params)
+      response = http_post('answerInlineQuery', hash)
+      unless response.ok
+       raise FatalError, response.description
+      end
+      response.result
+    end
+  end
+end

data/lib/api/send_apis.rb

@@ -0,0 +1,191 @@
+#!/usr/bin/ruby
+# frozen_string_literal: true
+
+require_relative '../core_api'
+
+# Solomon Boloshe(Lee Crey)
+# Friday, August 21 2020 05:35:05 PM +0300
+
+module Telegram
+  module SendApis # rubocop:disable Metrics/ModuleLength
+    include CoreApi
+    # Use this method to send text messages.
+    def send_message(chat_id, text, params = {})
+      hash = { chat_id: chat_id, text: text }.merge!(params)
+      response = http_post('sendMessage', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise FatalError, response.description
+      end
+      Message.new(response.result)
+    end
+
+    # Use this method to send photos.
+    def send_photo(chat_id, photo, params = {})
+      hash = { chat_id: chat_id, photo: photo }.merge!(params)
+      response = http_post('sendPhoto', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise FatalError, response.description
+      end
+      Message.new(response.result)
+    end
+
+    # Use this method to send audio files.
+    def send_audio(chat_id, audio, params = {})
+      hash = { chat_id: chat_id, audio: audio }.merge!(params)
+      response = http_post('sendAudio', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise FatalError, response.description
+      end
+      Message.new(response.result)
+    end
+
+    # Use this method to send general files.
+    def send_document(chat_id, document, params = {})
+      hash = { chat_id: chat_id, document: document }.merge!(params)
+      response = http_post('sendDocument', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise FatalError, response.description
+      end
+      Message.new(response.result)
+    end
+
+    # Use this method to send video files, Telegram clients support
+    # mp4 videos (other formats may be sent as Document).
+    def send_video(chat_id, video, params = {})
+      hash = { chat_id: chat_id, video: video }.merge!(params)
+      response = http_post('sendVideo', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+         raise FatalError, response.description
+      end
+      Message.new(response.result)
+    end
+
+    # Use this method to send animation files (GIF or H.264/MPEG-4
+    # AVC video without sound).
+    def send_animation(chat_id, animation, params = {})
+      hash = { chat_id: chat_id, animation: animation }.merge!(params)
+      response = http_post('sendAnimation', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise FatalError, response.description
+      end
+      Message.new(response.result)
+    end
+
+    # Use this method to send voice file
+    def send_voice(chat_id, voice, params = {})
+      hash = { chat_id: chat_id, voice: voice }.merge!(params)
+      response = http_post('sendVoice', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise FatalError, response.description
+      end
+      Message.new(response.result)
+    end
+
+    # Use this methods to send video note file
+    def send_video_note(chat_id, video_note, params = {})
+      hash = { chat_id: chat_id, video_note: video_note }.merge!(params)
+      response = http_post('sendVideoNote', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise FatalError, response.description
+      end
+      Message.new(response.result)
+    end
+
+    # Use this method to send a group of photos or videos as an album.
+    def send_media_group(chat_id, media, params = {})
+      hash = { chat_id: chat_id, media: media }.merge!(params)
+      response = http_post('sendMediaGroup', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise FatalError, response.description
+      end
+      Message.new(response.result)
+    end
+
+    # Use this method to send point on the map.
+    def send_location(chat_id, latitude, longitude, params = {})
+      hash = { chat_id: chat_id, latitude: latitude, longitude: longitude}
+      hash.merge!(params)
+      response = http_post('sendLocation', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise FatalError, response.description
+      end
+      Message.new(response.result)
+    end
+
+    # Use this method to send information about a venue.
+    def send_venue(chat_id, latitude, longitude, title, address, params = {})
+      hash = { chat_id: chat_id, latitude: latitude, longitude: longitude }
+      hash2 = { title: title, address: address}.merge!(params)
+      hash.merge!(hash2)
+      response = http_post('sendVenue', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise FatalError, response.description
+      end
+      Message.new(response.result)
+    end
+
+    # Use this method to send phone contacts.
+    def send_contact(chat_id, phone_number, first_name, params = {})
+      hash = { chat_id: chat_id, phone_number: phone_number }
+      hash2 = { first_name: first_name }.merge!(params)
+      hash.merge!(hash2)
+      response = http_post('sendContact', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise FatalError, response.description
+      end
+      Message.new(response.result)
+    end
+
+    # Use this method to send a native poll.
+    def send_poll(chat_id, question, options, params = {})
+      hash = { chat_id: chat_id, question: question }
+      hash2 = { options: options }.merge!(params)
+      hash.merge!(hash2)
+      response = http_post('sendPoll', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise FatalError, response.description
+      end
+      Message.new(response.result)
+    end
+
+    # Use this method to send an animated emoji that will display a 
+    # random value.
+    def send_dice(chat_id, params = {})
+      hash = { chat_id: chat_id}.merge!(params)
+      response = http_post('sendDice', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise FatalError, response.description
+      end
+      Message.new(response.description)
+    end
+
+    # Use this methods to send chat actions
+    # actions may be typing upload_photo record_video upload_video
+    # upload_audio upload_document find_location record_video_note
+    # upload_video_note 
+    def send_chat_action(chat_id, action) # rubocop:disable: Metrics/MethodLength
+       actions = %w{ typing upload_photo record_video upload_video
+       upload_audio upload_document find_location record_video_note
+       upload_video_note }
+       unless actions.include? action # rubocop:disable Style/IfUnlessModifier
+         raise Error, 'invalid chat action'
+       end
+       hash = { chat_id: chat_id, action: action }
+       response = http_post('sendChatAction', hash)
+       unless response.ok # rubocop:disable Style/IfUnlessModifier
+         raise IdError, 'incorrect chat id'
+       end
+       response.result
+    end
+
+    # Use this method to send sticker file
+    def send_sticker(chat_id, file, params = {})
+      hash = { chat_id: chat_id, sticker: file }.merge!(params)
+      response = http_post('sendSticker', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        raise FatalError, response.description
+      end
+      Message.new(response.result)
+    end
+  end
+end