teleruby 1.5.1 → 1.5.4

data/lib/objects/voice.rb

@@ -0,0 +1,20 @@
+#!/usr/bin/ruby
+# frozen_string_literal: true
+
+require_relative 'same/common_2'
+
+##
+# +Monday+, +August+ +24+ +2020+ +EAT+
+# ===This object represents a voice note.
+# Extends Common2 class.
+
+class Voice < Common2
+  def initialize(obj) # :nodoc:
+    super(obj)
+  end
+
+  # Duration of the audio in seconds as defined by sender.
+  def duration
+    @obj.duration
+  end
+end

data/lib/teleruby.rb

@@ -1,50 +1,14 @@
 #!/usr/bin/ruby
-# frozen_string_literal: true
 
-require_relative 'teleruby/all_apis'
-
-##
-# @lee_crey (Solomon Boloshe)
-#
-# @teleruby_support
+require_relative 'api/all'
 
 module Telegram
-  # Generic exception class.
-  class Error < StandardError; end
-
-  # Raise when chat_id, and user_id are incorrect,
-  class IdError < Error; end
-
-  # Raise when bot token is incorrect.
-  class TokenError < Error; end
-
-  # Raise when bot has not appropriate admin right in supergroups.
-  class PermissionError < Error; end
-
-  # Raise when one of optional parameters is incorrect and telegram
-  # unalbe to do the requested operation.
-  class TelegramError < Error; end
-
-  class FatalError < Error; end
-  class BadRequestError < Error; end
-  class UndefinedMethod < Error; end
-
-  # === Bot class
-  class Client < TGClient
+  # Telegram CLient(bot)
+  class Client
     include AllApis
-    def initialize(token)
+    def initialize(token: )
       @token = token
       @last_update = 0
     end
-
-    # for getting updates
-    # long polling
-    def run!(&block)
-      (fail LocalJumpError, 'block is not given' unless block_given?)
-      loop do
-        block.call
-      end
-    end
   end
 end
-

data/lib/teleruby/all_apis.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/ruby
+# frozen_string_literal: false
+
+# APIs
+require_relative 'api/send_apis'
+require_relative 'api/set_apis'
+require_relative 'api/delete_apis'
+require_relative 'api/other_apis'
+require_relative 'api/get_apis'
+require_relative 'api/nstandard'
+
+module Telegram
+  module AllApis
+    # directory => api
+    include SendApis     # send_apis.rb
+    include SetApis      # set_apis.rb
+    include DeleteApis   # delete_apis.rb
+    include OtherApis    # other_apis.rb
+    include GetApis      # get_apis.rb
+    include NonStandard  # nstandard.rb
+  end
+end

data/lib/teleruby/api/delete_apis.rb

@@ -0,0 +1,58 @@
+#!/usr/bin/ruby
+# frozen_string_literal: true
+
+require_relative '../core_api'
+
+module Telegram
+  module DeleteApis
+    ##
+    # Use this method to delete a chat photo.
+    def delete_chat_photo(chat_id)
+      unless chat_id.to_i.negative?
+        fail BadRequestError, %{can't delete private chat photo}
+      end
+
+      hash = { chat_id: chat_id }
+      response = post('deleteChatPhoto', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        fail PermissionError, response.description
+      end
+
+      response.result
+    end
+
+    ##
+    # Use this method to delete a group sticker set from a supergroup.
+    def delete_chat_sticker_set(chat_id)
+      unless chat_id.to_i.negative?
+        fail BadRequestError, %{can' delete sticker set of private chat}
+      end
+
+      hash = { chat_id: chat_id }
+      response = post('deleteChatStickerSet', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        fail PermissionError, response.description
+      end
+
+      response.result
+    end
+
+    ##
+    # Use this method to delete a message, including service messages.
+    def delete_message(chat_id, message_id)
+      hash = { chat_id: chat_id, message_id: message_id }
+      response = post('deleteMessage', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        fail TelegramError, response.description
+      end
+
+      response.result
+    end
+
+    ##
+    # Use this method to delete a sticker from a set created by the bot.
+    def delete_sticker_from_set(sticker)
+      throw NotImplementedError, 'currently not supported'
+    end
+  end
+end

data/lib/teleruby/api/get_apis.rb

@@ -0,0 +1,172 @@
+#!/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
+    ##
+    # Use this method to receive incoming updates using long polling.
+    def get_updates(limit = 10, &block) # rubocop:disable Metrics/MethodLength
+      blok = {}
+      if block_given?
+        blok = block.call
+        unless blok.instance_of? Hash # rubocop:disable Style/IfUnlessModifier
+          fail ArgumentError, 'expected object is hash'
+        end
+      end
+
+      hash = { 'timeout': 0, 'limit': limit, 'offset': @last_update }
+      hash.merge!(blok)
+      response = get('getUpdates', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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 = get('getMe')
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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 = get('getFile', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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
+        fail IdError, 'id must be private chat\'s id'
+      end
+
+      hash = { uesr_id: user_id }.merge!(params)
+      response = get('getProfilePhotos', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        fails 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
+        fail IdError, 'chat id must be supergroup id'
+      end
+      hash = { chat_id: chat_id }
+      response = get('getChatAdministrators', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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 = 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 = get('getChatMember', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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 = get('getStickerSetName', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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 = get('getChat', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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 = get('getMyCommands')
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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/MethodLength
+
+  # The End!
+end

data/lib/teleruby/api/nstandard.rb

@@ -0,0 +1,27 @@
+#!/usr/bin/ruby
+# frozen_string_literal: true
+
+require 'open-uri'
+
+module Telegram
+  module NonStandard
+    def download_file(file_d, dir = Dir.pwd)
+      d = Dir.new(dir)
+    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/teleruby/api/other_apis.rb

@@ -0,0 +1,241 @@
+#!/usr/bin/ruby
+# frozen_string_literal: true
+
+require_relative '../core_api'
+
+module Telegram
+  module OtherApis
+    ##
+    # 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 = post('forwardMessage', hash)
+      unless data.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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 = post('kickChatMember', hash)
+      unless data.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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 = post('unbanChatMember', hash)
+      unless data.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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 = post('restrictChatMember', hash)
+      unless data.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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 = post('promoteChatMember', hash)
+      unless data.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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 = post('exportChatInviteLink', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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 = post('pinChatMessage', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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 = post('stopPoll', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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 = post('uploadStickerFile', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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 = post('createNewStickerSet', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        fail 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 = post('addStickerToSet', hash)
+      unless response.ok # rubocop:disable Style/IfUnlessModifier
+        throw StandardError, response.description
+      end
+      response.result
+    end
+
+    def edit_message_live_location
+      fail 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 = post('answerCallbackQuery', hash)
+      unless response.ok
+        raise FatalError, response.description
+      end
+      response.result
+    end
+
+    def delete_webhook
+      fail 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 = post('editMessageText', hash)
+      unless response.ok
+        fail 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 = post('editMessageCaption', params)
+      unless response.ok
+        fail 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 = post('editMessageMedia', hash)
+      unless response.ok
+        fail 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 = post('editMessageReplyMarkup', params)
+      unless response.ok
+        fail 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 = post('answerInlineQuery', hash)
+      unless response.ok
+       fail FatalError, response.description
+      end
+      response.result
+    end
+  end
+end