telegrambot 1.1.2

data/README.md

@@ -0,0 +1,74 @@
+# Telegrambot [![Build Status](https://travis-ci.org/mijailr/telegrambot.svg?branch=master)](https://travis-ci.org/mijailr/telegrambot)
+(iba a escribir este readme en ingles, pero luego dije: "¿pa qué?")
+
+Otro wrapper de Telegram, resulta que los que habían por allí no funcionaban como yo necesitaba, por lo que escribí esta a mi gusto.
+
+## Instalacion
+
+Se instala como cualquier `gem` via Gemfile:
+
+```ruby
+gem 'telegrambot'
+```
+
+Y luego:
+
+    $ bundle
+
+O directamente con:
+
+    $ gem install telegrambot
+
+## Uso
+
+Muy simple de usar:
+
+```ruby
+# Configuras el token
+bot_token = "213652360:AAGYiBuAslikmBFnO9zvgwns2ckWDVKOpJg"
+bot = Telegrambot::Client.new(bot_token)
+
+# Luego sólo llamas al endpoint de telegram en snake_case
+updates = bot.api.get_updates
+
+# O para enviar un mensaje
+mensaje = "¡Mira! me envié un mensaje"
+bot.api.send_message(chat_id: -160175187, text: mensaje)
+
+# Incluso puedes enviar InlineKeyboard
+boton = Telegrambot::Types::InlineKeyboardButton.new(
+  text: "Visita mi página",
+  url: "https://mijailr.com")
+markup = Telegrambot::Types::InlineKeyboardMarkup.new(inline_keyboard: boton)
+bot.api.send_message(chat_id: -160175187, text: mensaje, reply_markup: markup)
+
+```
+Como puedes ver todos los types declarados en la documentación de la api de Telegram tienen exactamente el mismo nombre aquí por lo que basta con ver esa documentación para saber que usar aquí.
+
+Lo único que cambia son los enpoints que pasan de CamelCase a snake_case por lo que todo lo que llames con la api es asi.
+
+
+### Para webhook
+
+Para web hook es la misma lógica, si usas ruby on rails es más sensillo.
+
+```ruby
+# Solo debes agregar a algún método de un controlador
+def webhook
+  bot_token = "213652360:AAGYiBuAslikmBFnO9zvgwns2ckWDVKOpJg"
+  bot = Telegrambot::Client.new(bot_token)
+  mensaje = bot.listen_webhook(params)
+  # De aquí en adelante lo puedes usar como un objeto Telegrambot::Types::Message
+  # También puedes saber si el mensaje trae un `bot_command`
+  if mensaje.command?
+    mensaje.command
+    mensaje.attributes
+    # haces lo que necesites con mensaje.command y mensaje.attributes
+  end
+end
+```
+
+Si no usas rails, asegurate que `params` sea un hash.
+## License
+
+ [GNU GPLv3](http://www.gnu.org/licenses/gpl-3.0.txt).

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "telegrambot/bot"
+
+# 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

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/lib/telegrambot.rb

@@ -0,0 +1,9 @@
+require 'virtus'
+require 'logger'
+require 'json'
+require 'faraday'
+require 'telegrambot/version'
+require 'telegrambot/types'
+require 'telegrambot/api'
+require 'telegrambot/client'
+require 'telegrambot/exceptions'

data/lib/telegrambot/api.rb

@@ -0,0 +1,89 @@
+module Telegrambot
+  class Api
+
+    attr_reader :token
+
+    REPLY_MARKUP_TYPES = [
+        Telegrambot::Types::ReplyKeyboardMarkup,
+        Telegrambot::Types::ReplyKeyboardHide,
+        Telegrambot::Types::ForceReply,
+        Telegrambot::Types::InlineKeyboardMarkup
+    ].freeze
+
+    def initialize(token)
+      @token = token
+    end
+
+    private_instance_methods :snakecase
+    # Convierte un camelCase a snake_case
+    # @return String
+    def self.snakecase(endpoint)
+      endpoint.to_s.gsub(/::/, '/').
+      gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+      gsub(/([a-z\d])([A-Z])/,'\1_\2').
+      tr("-", "_").
+      downcase
+    end
+
+
+    # Endpoints de Telegram Bot API (Metaprogramming)
+    # @see https://core.telegram.org/bots/api#available-methods
+    # @return [Hash]
+    # @raise [Telegrambot::Exceptions::ResponseError]
+    # @param raw_params [Hash] Hash de opciones de telegram
+    %w(
+        getUpdates setWebhook getMe sendMessage forwardMessage sendPhoto
+        sendAudio sendDocument sendSticker sendVideo sendVoice sendLocation
+        sendVenue sendContact sendChatAction getUserProfilePhotos getFile
+        kickChatMember unbanChatMember answerCallbackQuery editMessageText
+        editMessageCaption editMessageReplyMarkup answerInlineQuery getChat
+        leaveChat getChatAdministrators getChatMember getChatMembersCount
+    ).map{ |e| snakecase(e) }.each do | endpoint |
+      define_method endpoint do | raw_params = {} |
+        params = build_params(raw_params)
+        response = rest_client.post("/bot#{token}/#{camelcase(endpoint)}", params)
+        raise Telegrambot::Exceptions::ResponseError.new(response) unless response.status == 200
+        JSON.parse(response.body)
+      end
+    end
+
+    private
+
+    # Convierte un snake_case a camelCase
+    # @return String
+    def camelcase(endpoint)
+      words = endpoint.split('_')
+      words.drop(1).map(&:capitalize!)
+      words.join
+    end
+
+    def build_params(hash)
+      hash.each_with_object({}) do |(key, value), params|
+        params[key] = sanitize_value(value)
+      end
+    end
+
+    def sanitize_value(value)
+      json_inline_query_results(json_reply_markup(value))
+    end
+
+    def json_reply_markup(value)
+      return value unless REPLY_MARKUP_TYPES.include?(value.class)
+      value.to_compact_hash.to_json
+    end
+
+    def json_inline_query_results(value)
+      return value unless value.is_a?(Array) && value.all? { |i| INLINE_QUERY_RESULT_TYPES.include?(i.class) }
+      value.map { |i| i.to_compact_hash.select { |_, v| v } }.to_json
+    end
+
+    def rest_client
+      Faraday.new(url: 'https://api.telegram.org') do |faraday|
+          faraday.request :multipart
+          faraday.request :url_encoded
+          faraday.adapter Faraday.default_adapter
+        end
+    end
+
+  end
+end

data/lib/telegrambot/client.rb

@@ -0,0 +1,18 @@
+module Telegrambot
+  class Client
+    attr_reader :api
+
+    def initialize(token)
+      @api = Api.new(token)
+    end
+
+    # Escucha Webhooks
+    # @return [Telegrambot::Types::Update]
+    # @param update [Hash]
+    def listen_webhook(data)
+      update = Telegrambot::Types::Update.new(data)
+    end
+
+
+  end
+end

data/lib/telegrambot/exceptions.rb

@@ -0,0 +1 @@
+require 'telegrambot/exceptions/response_error'

data/lib/telegrambot/exceptions/response_error.rb

@@ -0,0 +1,28 @@
+module Telegrambot::Exceptions
+  class ResponseError < StandardError
+    attr_reader :response
+
+    def initialize(response)
+      @response = response
+    end
+
+    def to_s
+      super +
+      format(' (%s)', data.map { |k, v| %(#{k}: "#{v}")}.join(', '))
+    end
+
+    def error_code
+      data[:error_code] || data['error_code']
+    end
+
+    private
+
+    def data
+      @data ||= begin
+        JSON.parse(response.body)
+      rescue JSON::ParseError
+        { error_code: response.status, uri: response.env.url.to_s }
+      end
+    end
+  end
+end

data/lib/telegrambot/types.rb

@@ -0,0 +1,26 @@
+require 'telegrambot/types/base'
+require 'telegrambot/types/user'
+require 'telegrambot/types/chat'
+require 'telegrambot/types/voice'
+require 'telegrambot/types/message_entity'
+require 'telegrambot/types/audio'
+require 'telegrambot/types/photo_size'
+require 'telegrambot/types/document'
+require 'telegrambot/types/sticker'
+require 'telegrambot/types/video'
+require 'telegrambot/types/voice'
+require 'telegrambot/types/contact'
+require 'telegrambot/types/location'
+require 'telegrambot/types/venue'
+require 'telegrambot/types/message'
+require 'telegrambot/types/user_profile_photos'
+require 'telegrambot/types/file'
+require 'telegrambot/types/keyboard_button'
+require 'telegrambot/types/reply_keyboard_markup'
+require 'telegrambot/types/reply_keyboard_hide'
+require 'telegrambot/types/inline_keyboard_button'
+require 'telegrambot/types/inline_keyboard_markup'
+require 'telegrambot/types/callback_query'
+require 'telegrambot/types/force_reply'
+require 'telegrambot/types/chat_member'
+require 'telegrambot/types/update'

data/lib/telegrambot/types/audio.rb

@@ -0,0 +1,10 @@
+module Telegrambot::Types
+  class Audio < Base
+    attribute :file_id, String
+    attribute :duration, Integer
+    attribute :performer, String
+    attribute :title, String
+    attribute :mime_type, String
+    attribute :file_size, Integer
+  end
+end

data/lib/telegrambot/types/base.rb

@@ -0,0 +1,18 @@
+module Telegrambot::Types
+  class Base
+    include Virtus.model
+    
+    # @return [Hash]
+    def to_compact_hash
+      Hash[attributes.dup.delete_if { |_, v| v.nil? }.map do |key, value|
+            value =
+              if value.class.ancestors.include?(Telegrambot::Types::Base)
+                value.to_compact_hash
+              else
+                value
+              end
+            [key, value]
+      end]
+    end
+  end
+end

data/lib/telegrambot/types/callback_query.rb

@@ -0,0 +1,9 @@
+module Telegrambot::Types
+  class CallbackQuery < Base
+    attribute :id, String
+    attribute :from, User
+    attribute :message, Message
+    attribute :inline_message_id, String
+    attribute :data, String
+  end
+end

data/lib/telegrambot/types/chat.rb

@@ -0,0 +1,10 @@
+module Telegrambot::Types
+  class Chat < Base
+    attribute :id, Integer
+    attribute :type, String
+    attribute :title, String
+    attribute :user_name, String
+    attribute :first_name, String
+    attribute :last_name, String
+  end
+end

data/lib/telegrambot/types/chat_member.rb

@@ -0,0 +1,6 @@
+module Telegrambot::Types
+  class ChatMember < Base
+    attribute :user, User
+    attribute :status, String
+  end
+end

data/lib/telegrambot/types/contact.rb

@@ -0,0 +1,8 @@
+module Telegrambot::Types
+  class Contact < Base
+    attribute :phone_number, String
+    attribute :first_name, String
+    attribute :last_name, String
+    attribute :user_id, Integer
+  end
+end

data/lib/telegrambot/types/document.rb

@@ -0,0 +1,9 @@
+module Telegrambot::Types
+  class Document < Base
+    attribute :file_id, String
+    attribute :thumb, PhotoSize
+    attribute :file_name, String
+    attribute :mime_type, String
+    attribute :file_size, Integer
+  end
+end

data/lib/telegrambot/types/file.rb

@@ -0,0 +1,7 @@
+module Telegrambot::Types
+  class File < Base
+    attribute :file_id, String
+    attribute :file_size, Integer
+    attribute :file_path, String
+  end
+end

data/lib/telegrambot/types/force_reply.rb

@@ -0,0 +1,6 @@
+module Telegrambot::Types
+  class ForceReply < Base
+    attribute :force_reply, Boolean
+    attribute :selective, Boolean
+  end
+end

data/lib/telegrambot/types/inline_keyboard_button.rb

@@ -0,0 +1,8 @@
+module Telegrambot::Types
+  class InlineKeyboardButton < Base
+    attribute :text, String
+    attribute :url, String
+    attribute :callback_data, String
+    attribute :switch_inline_query, String
+  end
+end

data/lib/telegrambot/types/inline_keyboard_markup.rb

@@ -0,0 +1,15 @@
+module Telegrambot::Types
+  class InlineKeyboardMarkup < Base
+    attribute :inline_keyboard, Array[Array[InlineKeyboardButton]]
+    # @return [Hash]
+    def to_compact_hash
+      hsh = super
+      hsh[:inline_keyboard].map! do |arr|
+        arr.map do |item|
+          item.is_a?(InlineKeyboardButton) ? item.to_compact_hash : item
+        end
+      end
+      hsh
+    end
+  end
+end

data/lib/telegrambot/types/inline_query.rb

@@ -0,0 +1,9 @@
+module Telegrambot::Type
+  class InlineQuery < Base
+    attribute :id, String
+    attribute :from, User
+    attribute :location, Location
+    attribute :query, String
+    attribute :offset, String
+  end
+end

data/lib/telegrambot/types/inline_query_result_article.rb

@@ -0,0 +1,15 @@
+module Telegrambot::Type
+  class InlineQueryResultArticle < Base
+    attribute :type, String, default: 'article'
+    attribute :id, String
+    attribute :title, String
+    attribute :input_message_content, InputMessageContent
+    attribute :reply_markup, InlineKeyboardMarkup
+    attribute :url, String
+    attribute :hide_url, Boolean
+    attribute :description, String
+    attribute :thumb_url, String
+    attribute :thumb_width, Integer
+    attribute :thumb_height, Integer
+  end
+end