ya_telegram_bot 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c607a290b4ddc0b1aa0e6655266736dfc049db55
-  data.tar.gz: d5de93cfa149d2e35f0f46053117335fdc3d6efd
+  metadata.gz: 824c8bc77b35bdf7d81bc9a111e2f893d8a03349
+  data.tar.gz: c852921184c91322dbbf2828e64f70a639913bbf
 SHA512:
-  metadata.gz: a72d2a026a4bbe3e6d12f4e77db06a7b249df924236c42aed30dbdd60700e86a7ff46a9cff8ae7d69c7c24aff60b8343d044cd25f907f0708b360c84bd2aeda7
-  data.tar.gz: dadfbb256be7c04a62dbb82f61710564b861a7da99ec8d2695bd3f94e29c5666ac7cf67e198e6476ae8677f4d4be5b341d52461b3abc4698cd5b8a6b5d26d40d
+  metadata.gz: 37e3bc364b16c3516cb84d5a68ab208a56a2ab290143bb4a43a7f484d236a428a71563419a8c17583572f6931ae898f128c306b61bbcfe8f7640b5983dfab834
+  data.tar.gz: 8e214248e540cf8ec074ceea7252b1320b009bf8f8d12000fafd8efc692729dbfb2107cc5f279e77ffe0714f4e3c52d2a1753e44ac96ea6bd5bef7ee78e1bc82

data/README.md

@@ -2,10 +2,9 @@
 
 **IN DEV**
 
-## What's new **0.3.0**
+## What's new **0.4.0**
 
-* Class `YATelegramBot::TelegramAPI::User`.
-* Class `YATelegramBot::TelegramAPI::Chat`.
+* `#send_photo` method on `Base`, `User`, `Chat`
 
 ## Usage
 
@@ -43,6 +42,9 @@ user.send_text text: '*hey hey!*',
 chat = Bot.updates[0].chat
 chat.send_text text: "Hi, #{chat.type == :private ? 'dude' : 'all'}!"
 
+# send photo
+user.send_photo file: File.new('my_awesome_photo.png'), caption: 'awesome photo'
+
 ```
 
 ## Contributing

data/lib/ya_telegram_bot/base.rb

@@ -53,6 +53,24 @@ module YATelegramBot
       response['ok'] && Message.new(response['result'], self)
     end
 
+    #
+    # send photo message to user.
+    #
+    # required params:
+    # * :chat [Fixnum] id of chat
+    # * :file [File] your photo
+    #
+    # additional params:
+    # * :caption [String] caption for your photo
+    # * :reply_to [Fixnum] id of message you reply
+    #
+    def send_photo(params = {})
+      response = send_api_request 'sendPhoto',
+                                  params_for_sending_photo(params)
+
+      response['ok'] && Message.new(response['result'], self)
+    end
+
     private
 
     def params_for_sending_text(params)
@@ -68,8 +86,22 @@ module YATelegramBot
       result
     end
 
+    def params_for_sending_photo(params)
+      fail NoChatSpecified unless params[:chat]
+      fail NoFileSpecified unless params[:file] && params[:file].is_a?(File)
+
+      result = { chat_id: params[:chat],
+                 photo: params[:file] }
+
+      result[:caption] = params[:caption] if params[:caption]
+      result[:reply_to_message_id] = params[:reply_to].to_i if params[:reply_to]
+
+      result
+    end
+
     def send_api_request(method, params = {})
       fail NoTokenSpecified unless defined?(@token)
+
       @telegram_api_url = 'https://api.telegram.org' unless defined? @telegram_api_url
       JSON.parse RestClient.post "#{@telegram_api_url}/#{@api_request_prefix}/#{method}",
                                  params

data/lib/ya_telegram_bot/exceptions.rb

@@ -1,7 +1,8 @@
 module YATelegramBot
-  class NoTokenSpecified; end
-  class ResponseIsNotOk; end
-  class NoChatSpecified; end
-  class NoMessageSpecified; end
-  class InitWithoutBot; end
+  class NoTokenSpecified < StandardError; end
+  class NoFileSpecified < StandardError; end
+  class ResponseIsNotOk < StandardError; end
+  class NoChatSpecified < StandardError; end
+  class NoMessageSpecified < StandardError; end
+  class InitWithoutBot < StandardError; end
 end

data/lib/ya_telegram_bot/telegram_api/chat.rb

@@ -27,7 +27,7 @@ module YATelegramBot
       end
 
       #
-      # uses bot to send text to this user.
+      # uses bot to send text to this chat.
       #
       # @param params [Hash] params for Base#send_text. This method will only set :chat to self[:id]
       #
@@ -37,6 +37,18 @@ module YATelegramBot
         params[:chat] = id
         @bot.send_text params
       end
+
+      #
+      # uses bot to send photo to this chat.
+      #
+      # @param params [Hash] params for Base#send_photo. This method will only set :chat to self[:id]
+      #
+      def send_photo(params = {})
+        fail InitWithoutBot unless @bot
+
+        params[:chat] = id
+        @bot.send_photo params
+      end
     end
   end
 end

data/lib/ya_telegram_bot/telegram_api/message.rb

@@ -49,6 +49,8 @@ module YATelegramBot
       # * :text [String]
       # * :as_plain_message [Boolean] default: true. If it's true, method won't set :reply_to parameter
       #
+      # TODO: what about files?
+      #
       # @example message.reply(text: 'Hi, *friend*!', markdown: true)
       #
       def reply(params = {})

data/lib/ya_telegram_bot/telegram_api/user.rb

@@ -35,6 +35,18 @@ module YATelegramBot
         params[:chat] = id
         @bot.send_text params
       end
+
+      #
+      # uses bot to send photo to this user.
+      #
+      # @param params [Hash] params for Base#send_photo. This method will only set :chat to self[:id]
+      #
+      def send_photo(params = {})
+        fail InitWithoutBot unless @bot
+
+        params[:chat] = id
+        @bot.send_photo params
+      end
     end
   end
 end

data/lib/ya_telegram_bot/version.rb

@@ -1,3 +1,3 @@
 module YATelegramBot
-  VERSION = '0.3.0'.freeze
+  VERSION = '0.4.0'.freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ya_telegram_bot
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Dmitriy Non