telegruby 1.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 53358132510ab2ef5f34d7faa20e13c08730dab2
+  data.tar.gz: 4b6a9166d16611fe3bbba3cbae8f9c20edea5fb9
+SHA512:
+  metadata.gz: cb80c64134254302b7dc3b4dcbc01c4565c49355b222bc887d9f5e50a3fcd08aafd5f3cef07add30e4831f17774f9b0b69de2da1e9fc8e62bc42f836f5614023
+  data.tar.gz: 98c557ece1450f7b9b8d3f5990dec71268f24dd816d2fc0a7bc5b3242af5bf271abbfbc33a13db885a19fc712d179fde0f8be6656b2870c3c4fd62cb273b4304

data/lib/telegruby.rb

@@ -0,0 +1,293 @@
+require 'httmultiparty'
+require 'json'
+
+module Telegruby
+  class Bot
+    attr_accessor :id
+
+    def initialize(api_token)
+      @token = api_token
+      @endpoint = "https://api.telegram.org/bot#{@token}/"
+      @id = 0
+    end
+
+    # See https://core.telegram.org/bots/api for the full method list
+
+    def get_updates(options = {}, error_callback = nil)
+      if options == {}
+        options = {
+          :offset => @id
+        }
+      end
+
+      request = self.get_request("getUpdates", options)
+      if request.code != 200
+        return error_callback request
+      end
+      update = Update.new(JSON.parse(request.body, object_class: OpenStruct))
+      
+      if !update.result.empty?
+        # there are updates, so mark them as 'seen'
+        @id = (update.result.last.update_id + 1)
+      end
+      
+      return update
+    end
+
+    # Send a plaintext message to a chat id
+    def send_message(id, text, reply: nil)
+      options = {
+        :chat_id => id,
+        :text => text
+      }
+
+      if !reply.nil?
+        options.merge!(:reply_to_message_id => reply)
+      end
+      
+      self.get_request("sendMessage", options)
+    end
+
+    def forward_message(id, from_id, message_id)
+      options = {
+        :chat_id => id,
+        :from_chat_id => from_id,
+        :message_id => message_id
+      }
+
+      self.get_request("forwardMessage", options)
+    end
+   
+    # Sends a photo message to a chat id
+    def send_photo(id, filename: nil, file_id: nil, reply: nil)
+      options = {
+        :chat_id => id,
+      }
+      if file_id
+        options.merge!(:photo => file_id)
+      else
+        options.merge!(:photo => File.new(filename))
+      end
+     
+      if !reply.nil?
+        options.merge!(:reply_to_message_id => reply)
+      end
+
+      self.post_request("sendPhoto", options)
+    end
+
+    # Sends a photo from a byte string
+    def send_photo_bytestring(id, str, reply: nil)
+      Tempfile.open(["img", ".jpg"]) { |f|
+        f.binmode
+        f.write(str)
+       
+        self.send_photo(id, f.path, reply)
+      }
+    end
+
+    def send_voice(id, filename: nil, file_id: nil, reply: nil)
+      options = {
+        :chat_id => id,
+      }
+      if file_id
+        options.merge!(:audio => file_id)
+      else
+        options.merge!(:audio => File.new(filename))
+      end
+     
+      if !reply.nil?
+        options.merge!(:reply_to_message_id => reply)
+      end
+
+      self.post_request("sendVoice", options)
+    end
+
+    def send_sticker(id, file_id: nil, filename: nil, reply: nil)
+      options = {
+        :chat_id => id,
+      }
+      if file_id
+        options.merge!(:sticker => file_id)
+      else
+        options.merge!(:sticker => File.new(filename))
+      end
+
+      if !reply.nil?
+        options.merge!(:reply_to_message_id => reply)
+      end
+
+      self.post_request("sendSticker", options)
+    end
+
+    def send_audio(id, filename: nil, file_id: nil, reply: nil)
+      options = {
+        :chat_id => id,
+      } 
+      if file_id
+        options.merge!(:audio => file_id)
+      else
+        options.merge!(:audio => File.new(filename))
+      end
+
+      if !reply.nil?
+        options.merge!(:reply_to_message_id => reply)
+      end
+
+      self.post_request("sendAudio", options)
+    end
+
+    def send_video(id, filename: nil, file_id: nil, reply: nil)
+      options = {
+        :chat_id => id,
+      }
+      if file_id
+        options.merge!(:video => file_id)
+      else
+        options.merge!(:video => File.new(filename))
+      end
+
+      if !reply.nil?
+        options.merge!(:reply_to_message_id => reply)
+      end
+
+      self.post_request("sendVideo", options)
+    end
+
+    def send_location(id, lat, long, reply: nil)
+      options = {
+        :chat_id => id,
+        :latitude => lat,
+        :longitude => long
+      }
+      
+      if !reply.nil?
+        options.merge!(:reply_to_message_id => reply)
+      end
+
+      self.post_request("sendLocation", options)
+    end
+    def send_action(id, action)
+      options = {
+        :chat_id => id,
+        :action => action
+      }
+      
+      return self.post_request("sendChatAction", options)
+    end
+
+    # Sends a document by filename or file ID
+    def send_document(id, filename: nil, file_id: nil, reply: nil)
+      options = {
+        :chat_id => id
+      }
+      
+      if file_id
+        options.merge!(:document => file_id)
+      else
+        options.merge!(:document => File.new(filename))
+      end
+
+      if !reply.nil?
+        options.merge!(:reply_to_message_id => reply)
+      end
+
+      return self.post_request("sendDocument", options)
+    end
+    def get_userphoto(id, offset: nil, limit: nil)
+      options = {
+        :user_id => id,
+        :offset => offset,
+        :limit => limit
+      }
+      
+      return self.get_request("getUserProfilePhotos", options)
+    end
+    
+    def set_webhook(url = nil, certificate = nil)
+      options = {
+        :url => nil,
+      }
+      if certificate
+        options.merge!(:certificate => File.new(certificate))
+      end
+      
+      return self.get_request("setWebhook", options)
+    end
+
+    protected
+
+    # Provides a generic method for GET requests.
+    def get_request(name, options = {})
+      HTTMultiParty::get(@endpoint + name, query: options)
+    end
+
+    # Provides a generic method for POST requests.
+    def post_request(name, options = {})
+      HTTMultiParty::post(@endpoint + name, query: options).body
+    end
+  end
+
+  module_function
+
+  # Reads an API token from a JSON file.
+  # The result of this should be
+  # passed to Telegruby::Bot.new
+  def read_config(filename)
+    begin
+      data = JSON.parse(File.read(filename))
+
+      if !data.key? "token"
+        return false
+      end
+
+      return data
+    rescue
+      return false
+    end
+  end
+
+  # Given an Update object, gets messages as structs.
+  def collect_msgs(update)
+    update.result.map { |msg|
+      Message.new(msg)
+    }
+  end
+
+  # Update object generated by
+  # Telegruby::Bot::get_updates
+  class Update < OpenStruct
+    def results?
+      !self.result.empty?
+    end
+  end
+
+  # Message structure generated by
+  # collect_msgs from an update hash.
+  # Has some convenience methods.
+  class Message < OpenStruct
+    def initialize(hash_msg)
+      super(hash_msg)
+    end
+
+    def timestamp
+      self.message.date
+    end
+
+    def older_than?(secs)
+      ((Time.now.to_i - self.timestamp) > secs)
+    end
+
+    def chat_id
+      self.message.chat.id
+    end
+
+    def body
+      self.message.text
+    end
+
+    def message_id
+      self.message.message_id
+    end
+  end
+end

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: telegruby
+version: !ruby/object:Gem::Version
+  version: 1.1.0
+platform: ruby
+authors:
+- '"Lain"'
+- Rei
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-07-17 00:00:00.000000000 Z
+dependencies: []
+description: Basic Telegram Bot API library, used for a few bots in the wild.
+email: lain@lain.org.uk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/telegruby.rb
+homepage: https://github.com/telegram-wired/telegruby
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: Basic Telegram Bot API library.
+test_files: []