ruby-vibe 0.0.1 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 38ac243997c9534289e2c30281046b2e210c9e2190c10e5144378f84d33c917e
-  data.tar.gz: 7b5f99b1d24ef41dd60ed6b8bd07591449789fc6945d73df58d284eeb042933f
+  metadata.gz: b502227c8730b2d5b3d98b9b58a94ee9d29bb24120699eb5dc748bb1b8217dd5
+  data.tar.gz: 1a3a64761ac1b43d3061bc2752b9653c2da4c275e596feed522efa302ea206ad
 SHA512:
-  metadata.gz: bd56e369f03b2c0b591cdc0096c3f66c53c95feab97ef111bfcee2213ea840de40c638734df857c8d589853e1642689c73b7d8de44cd50047c073a01a1de4bf3
-  data.tar.gz: b65e12ff689faad07beab6ada1934f638d769913db8325cc551625d1a35ec33a9d0e38d225652b29625550b9ec46ad436dfce517a44880b6840a22444fc9138f
+  metadata.gz: f910834235c9a6092ed771362b98a9bf243d82dd7a5dd533d4b8beceaecf0f6930e88a679eca9f85c852befd592690c25d497775d1787469e418bf4413918f02
+  data.tar.gz: 8778789d4c7f99e97c032df51e033288be10fb76af9d1a5b5fa77a16f7ae95650490894f566556fffe5cfa08c40a08c3ceed2528aa97dd94728b102574b28cfa

data/lib/ruby-vibe/bot.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require_relative 'client'
+
+module RubyVibe
+  ##
+  # Set of predefined viber api requests. This class is used directly by user.
+  # Define constants for configuration settings, or add them on initialization.
+  #
+  # @example Set default configuration
+  #   RubyVibe::TOKEN  = 'my_viber_auth_token'
+  #   RubyVibe::NAME   = 'my_viber_nickname'
+  #   RubyVibe::AVATAR = 'avatar_url'
+  #
+  class Bot < RubyVibe::Client
+    ##
+    # @example Initialize new bot with user-defined configuration
+    #  @bot = RubyVibe::Bot.new(token:  'auth_token',
+    #                           name:   'sender_name',
+    #                           avatar: 'https_avatar_url' )
+    #
+    # @param [String] token   **Optional**.  Auth token provided by Viber.
+    # @param [String] name    **Optional**.  Sender name provided by user.
+    # @param [String] avatar  **Optional**.  SSL link to user photo.
+    #
+    # @return [Bot] Bot object to work with.
+    #
+    def initialize(token: nil, name: nil, avatar: nil)
+      token  ||= RubyVibe::TOKEN
+      name   ||= RubyVibe::NAME
+      avatar ||= RubyVibe::AVATAR
+
+      super(token: token, name: name, avatar: avatar)
+    end
+
+    ##
+    # Send message to user.
+    # @see https://developers.viber.com/docs/api/rest-bot-api/#send-message
+    #
+    # @param [Hash] opts
+    #
+    # @option opts [String] message     **Required**. Message text
+    # @option opts [String] receiver    **Required**. Message receiver
+    # @option opts [String] sender_name **Optional**. Sender name || RubyVibe::NAME
+    # @option opts [String] avatar      **Optional**. Avatar url  || RubyVibe::AVATAR
+    # @option opts [String] keyboard    **Optional**. Add keyboard to message
+    # @option opts [String] rich_media  **Optional**. Send rich_media message
+    #
+    # @return [Hash] Response hash defined in RubyVibe::Client
+    #
+    def send_message(opts = {})
+      viberize(URL::SEND_MESSAGE, opts)
+    end
+
+    ##
+    # Broadcast message to multiple users.
+    # @see https://developers.viber.com/docs/api/rest-bot-api/#broadcast-message
+    #
+    # @param [Hash] opts Viber API options for broadcast_message request
+    #
+    # @option opts [String] message     **Required**. Message text
+    # @option opts [Array]  receivers   **Required**. Message receivers
+    # @option opts [String] sender_name **Optional**. Sender name || RubyVibe::NAME
+    # @option opts [String] avatar      **Optional**. Avatar url  || RubyVibe::AVATAR
+    # @option opts [String] keyboard    **Optional**. Add keyboard to message
+    # @option opts [String] rich_media  **Optional**. Send rich_media message
+    #
+    # @return [Hash] Response hash defined in RubyVibe::Client
+    #
+    def broadcast_message(opts = {})
+      viberize(URL::BROADCAST_MESSAGE, opts)
+    end
+
+    ##
+    # @see https://developers.viber.com/docs/api/rest-bot-api/#set-webhook
+    #
+    def set_webhook(opts = {})
+      viberize(URL::SET_WEBHOOK, opts)
+    end
+
+    ##
+    # @see https://developers.viber.com/docs/api/rest-bot-api/#get-account-info
+    #
+    def get_account_info
+      viberize(URL::GET_ACCOUNT_INFO, info: true)
+    end
+
+    ##
+    # @see https://developers.viber.com/docs/api/rest-bot-api/#get-user-details
+    #
+    def get_user_details(user_id)
+      viberize(URL::GET_USER_DETAILS, id: user_id, info: true)
+    end
+
+    ##
+    # @see https://developers.viber.com/docs/api/rest-bot-api/#get-online
+    #
+    def get_online(*user_ids)
+      viberize(URL::GET_ONLINE, ids: Array(user_ids), info: true)
+    end
+  end
+end

data/lib/ruby-vibe/client.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+require 'rest-client'
+require 'json'
+
+module RubyVibe
+  ##
+  # This class is almost never used directly by user.
+  # Send actual request to viber api and perform type validation
+  # for token, name and avatar (must be strings).
+  #
+  class Client
+    attr_accessor :token, :name, :avatar
+
+    attr_reader :response, :payload_hash
+
+    alias sender name
+
+    ##
+    # @example Initialize new client
+    #
+    #   @client = Client.new(token: 'token', name: 'name', avatar: 'https_url')
+    #
+    # @param [String] token  **Required**. Viber auth token.
+    # @param [String] name   **Required**. Sender name.
+    # @param [String] avatar **Optional**. Avatar url.
+    #
+    # @raise [Token must be string] Token must be string.
+    # @raise [Name must be string] Name must be string.
+    # @raise [Avatar must use SSL] If defined, avatar must use https connection.
+    #
+    # @return [Object]
+    #
+    def initialize(token: nil, name: nil, avatar: nil)
+      raise 'Token must be string!' unless token.is_a? String
+      raise 'Sender name must be string' unless name.is_a? String
+
+      raise 'Avatar URL must use SSL' if !avatar.empty? && !(avatar.start_with? 'https://')
+
+      @token = token
+      @name = name
+      @avatar = avatar
+    end
+
+    private
+
+    ##
+    # Send payload to Viber API.
+    #
+    # @param [String] url **Required**. API url to send payload.
+    # @param [Hash] payload **Optional**. Payload to send with request.
+    # @return [Hash] Bot#response hash with all data.
+    #
+    def action(url, payload: {})
+      headers = {
+        'User-Agent': "RubyVibe client v#{RubyVibe::VERSION})",
+        'X-Viber-Auth-Token': @token
+      }
+
+      response = ::RestClient::Request.execute(
+        method: :post,
+        url: url,
+        payload: payload.to_json,
+        headers: headers,
+        timeout: 5,
+        verify_ssl: ::OpenSSL::SSL::VERIFY_NONE
+      )
+
+      @response = parse(response)
+    end
+
+    ##
+    # Method used by bot to construct viber api request.
+    # Prepare payload and send it to api url.
+    #
+    # @param [String] api_url **Required**. URL corresponding to method name.
+    # @param [Hash] opts **Optional**. Payload corresponding to method options.
+    #
+    def viberize(api_url, opts = {})
+      payload = load_payload(opts)
+      action(api_url, payload: payload)
+    end
+
+    ##
+    # Construct payload to send with request.
+    # If payload contain `info: true`, do not add sender name and avatar url.
+    # Otherwise, add them together with _options hash_ to payload.
+    # Nil values are not imported.
+    #
+    # @param [Hash] opts **Optional**. Data to create payload.
+    # @return [Hash] Client#payload_hash to send with request.
+    #
+    def load_payload(opts = {})
+      @payload_hash = {}
+
+      if opts[:info].nil?
+        @payload_hash[:sender] = {
+          sender_name: opts[:sender_name] || @name,
+          avatar: opts[:sender_avatar] || @avatar
+        }
+      end
+
+      opts.map do |key, value|
+        next if value.nil?
+        next if key == :info
+
+        @payload_hash[key] = value
+      end
+      @payload_hash
+    end
+
+    ##
+    # Construct response hash. Parse viber response and check status code.
+    # If code is not zero (**0**), add `error_message` to response.
+    #
+    def parse(response)
+      success = true
+      error_message = nil
+      hash = JSON.parse(response.body)
+
+      unless hash['status'].to_i.zero?
+        success = false
+        error_message = hash['status_message']
+      end
+
+      Struct.new(:success?, :data, :error_message).new(success, hash, error_message)
+    end
+  end
+end

data/lib/ruby-vibe/shortcuts.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+module RubyVibe
+  ##
+  # Shortcut to initialize Bot and send message.
+  # @see https://developers.viber.com/docs/api/rest-bot-api/#send-message
+  #
+  # @note Configuration constants must be defined to use this class.
+  #
+  # @example Configure constants
+  #   RubyVibe::TOKEN  = 'my_api_token'
+  #   RubyVibe::NAME   = 'my_nickname'
+  #   RubyVibe::AVATAR = 'https_avatar_url'
+  #
+  # @example Send text message
+  #   msg = RubyVibe::SendMessage[message: 'text', sender_name: 'my_nickname']
+  #   pp msg.error_message unless msg.success?
+  #
+  class SendMessage
+    ##
+    # Send message to user.
+    #
+    # @param  [Hash]   opts
+    # @return [Data#response]
+    # @see Bot#send_message
+    #
+    def self.[](opts = {})
+      Bot.new.send_message(opts)
+    end
+  end
+
+  ##
+  # Shortcut to initialize Bot and broadcast message.
+  # @see https://developers.viber.com/docs/api/rest-bot-api/#broadcast-message
+  #
+  # @note Configuration constants must be defined to use shortcut classes
+  #
+  # @example Configure constants
+  #   RubyVibe::TOKEN  = 'my_api_token'
+  #   RubyVibe::NAME   = 'my_nickname'
+  #   RubyVibe::AVATAR = 'https_avatar_url'
+  #
+  class BroadcastMessage
+    ##
+    # @example Broadcast message to multiple users
+    #   msg = RubyVibe::BroadcastMessage[message:   'text',
+    #                                    receivers: %w[user_1 user_2]
+    #                                    ]
+    #   pp msg.error_message unless msg.success?
+    #
+    def self.[](opts = {})
+      Bot.new.broadcast_message(opts)
+    end
+  end
+
+  ##
+  # @see https://developers.viber.com/docs/api/rest-bot-api/#set-webhook
+  #
+  class SetWebhook
+    # @note Configuration constants must be defined to use shortcut classes
+    def self.[](opts = {})
+      Bot.new.set_webhook(opts)
+    end
+  end
+
+  ##
+  # @see https://developers.viber.com/docs/api/rest-bot-api/#get-account-info
+  #
+  class GetAccountInfo
+    # @note Configuration constants must be defined to use shortcut classes
+    def self.[]
+      Bot.new.get_account_info
+    end
+  end
+
+  ##
+  # @see https://developers.viber.com/docs/api/rest-bot-api/#get-user-details
+  #
+  class GetUserDetails
+    # @note Configuration constants must be defined to use shortcut classes
+    def self.[](user_id)
+      Bot.new.get_user_details(user_id)
+    end
+  end
+
+  ##
+  # @see https://developers.viber.com/docs/api/rest-bot-api/#get-online
+  #
+  class GetOnline
+    # @note Configuration constants must be defined to use shortcut classes
+    def self.[](*user_ids)
+      Bot.new.get_online(*user_ids)
+    end
+  end
+end

data/lib/ruby-vibe/url.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+##
+# Viber API urls as constant for corresponding method.
+#
+# @see https://developers.viber.com/docs/api/rest-bot-api
+#
+module URL
+  # viber api url
+  API = 'https://chatapi.viber.com/pa'
+
+  # api url to set webhook
+  SET_WEBHOOK = "#{API}/set_webhook".freeze
+
+  # api url to send message to user
+  SEND_MESSAGE = "#{API}/send_message".freeze
+
+  # api url to get info about your account
+  GET_ACCOUNT_INFO = "#{API}/get_account_info".freeze
+
+  # api url to get info about user (twice per 12h for each ID)
+  GET_USER_DETAILS = "#{API}/get_user_details".freeze
+
+  # api url to broadcast message to multiple users (must be subscribed to bot)
+  BROADCAST_MESSAGE = "#{API}/broadcast_message".freeze
+
+  # api url to check if user(s) is online
+  GET_ONLINE = "#{API}/get_online".freeze
+end

data/lib/ruby-vibe/version.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+##
+# Gem version
+#
+module RubyVibe
+  # version number to change with new update
+  VERSION = '2.0.0'
+end

data/lib/ruby_vibe.rb

@@ -1,16 +1,29 @@
-require 'ruby_vibe/client'
-require 'ruby_vibe/calls'
-require 'ruby_vibe/version'
-require 'ruby_vibe/configuration'
-require 'ruby_vibe/urls'
+# frozen_string_literal: true
 
-class RubyVibe
+require_relative 'ruby-vibe/url'
+require_relative 'ruby-vibe/bot'
+require_relative 'ruby-vibe/shortcuts'
+require_relative 'ruby-vibe/version'
 
-  attr_accessor :client
-  
-  include Calls
+##
+# RubyVibe represent a main module for Viber Bot.
+# Multiple classes are used as shortcut classes,
+# calling methods from RubyVibe::Bot class.
+# Actual request to viber api is done by RubyVibe::Client class.
+# Urls for viber API are defined in URL module.
+#
+# @see RubyVibe::Bot
+# @see RubyVibe::Client
+# @see URL
+# @see [File] lib/ruby-vibe/shortcuts.rb
+#
+module RubyVibe
+  # viber api auth_token to be used if not given by user
+  TOKEN  = ''
 
-  def initialize(auth_token: nil)
-    @client = Client.new(auth_token: auth_token)
-  end
-end
+  # sender name to be used if not given by user
+  NAME   = ''
+
+  # avatar url to be used if not given by user (require https)
+  AVATAR = ''
+end

metadata

@@ -1,43 +1,58 @@
 --- !ruby/object:Gem::Specification
 name: ruby-vibe
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 2.0.0
 platform: ruby
 authors:
 - Adem Dinarevic
 autorequire:
-bindir: bin
+bindir:
+- bin
 cert_chain: []
-date: 2021-07-10 00:00:00.000000000 Z
+date: 2022-01-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: rest-client
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.1.4
+        version: 2.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.1.4
+        version: 0.14.1
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 13.0.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 13.0.3
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -59,14 +74,12 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- lib/ruby-vibe/bot.rb
+- lib/ruby-vibe/client.rb
+- lib/ruby-vibe/shortcuts.rb
+- lib/ruby-vibe/url.rb
+- lib/ruby-vibe/version.rb
 - lib/ruby_vibe.rb
-- lib/ruby_vibe/calls.rb
-- lib/ruby_vibe/calls/info.rb
-- lib/ruby_vibe/calls/messaging.rb
-- lib/ruby_vibe/client.rb
-- lib/ruby_vibe/configuration.rb
-- lib/ruby_vibe/urls.rb
-- lib/ruby_vibe/version.rb
 homepage: https://github.com/ademdc/ruby-vibe
 licenses:
 - MIT
@@ -79,7 +92,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 3.0.1
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/lib/ruby_vibe/calls/info.rb

@@ -1,37 +0,0 @@
-class RubyVibe
-  module Calls
-    module Info
-
-      def get_account_data
-        client.action(RubyVibe::URLS::GET_ACCOUNT_INFO)
-      end
-
-      def set_webhook(url, events: [], send_name: true, send_photo: true)
-        payload = {
-          url: url,
-          event_types: events,
-          send_name: send_name,
-          send_photo: send_photo
-        }
-
-        client.action(RubyVibe::URLS::SET_WEBHOOK, payload: payload)
-      end
-
-      def get_user_details(user_id)
-        payload = {
-          id: user_id
-        }
-
-        client.action(RubyVibe::URLS::GET_USER_DETAILS, payload: payload)
-      end
-
-      def get_online(ids=[])
-        payload = {
-          ids: ids
-        }
-        
-        client.action(RubyVibe::URLS::GET_ONLINE, payload: payload)
-      end
-    end
-  end
-end

data/lib/ruby_vibe/calls/messaging.rb

@@ -1,40 +0,0 @@
-class RubyVibe
-  module Calls
-    module Messaging
-
-      def send_message(receiver:, text:, sender_name: nil, sender_avatar: nil, tracking_data: nil, type: 'text', keyboard: nil)
-        payload = {
-          receiver:receiver,
-          sender:{
-             name:sender_name || RubyVibe.config.sender_name,
-             avatar:sender_avatar || RubyVibe.config.sender_avatar
-          },
-          tracking_data:tracking_data,
-          type:type,
-          text:text
-        }.compact
-
-        payload.merge!({ keyboard: keyboard }) unless keyboard.nil?
-
-        client.action(RubyVibe::URLS::MESSAGE, payload: payload)
-      end
-
-      def broadcast_message(broadcast_list:[], text:, sender_name: nil, sender_avatar: nil, type: 'text', rich_media: nil, keyboard: nil)
-        payload = {
-          sender:{
-             name: sender_name || RubyVibe.config.sender_name,
-             avatar: sender_avatar || RubyVibe.config.sender_avatar
-          },
-         type: type,
-          text: text,
-          broadcast_list: broadcast_list,
-        }
-
-        payload.merge!({ rich_media: rich_media }) unless rich_media.nil?
-        payload.merge!({ keyboard: keyboard }) unless keyboard.nil?
-
-        client.action(RubyVibe::URLS::BROADCAST_MESSAGE, payload: payload)
-      end
-    end
-  end
-end

data/lib/ruby_vibe/calls.rb

@@ -1,9 +0,0 @@
-require 'ruby_vibe/calls/info'
-require 'ruby_vibe/calls/messaging'
-
-class RubyVibe
-  module Calls 
-    include Info
-    include Messaging
-  end
-end

data/lib/ruby_vibe/client.rb

@@ -1,51 +0,0 @@
-require 'rest-client'
-require 'json'
-require 'byebug'
-
-class RubyVibe
-  class Client
-    
-    attr_accessor :token
-
-    def initialize(auth_token:) 
-      RubyVibe.configure
-
-      @token = auth_token 
-    end
-
-    def action(url, payload: {}, http_method: :post)
-      headers = {
-        'User-Agent': "RubyVibe client v#{RubyVibe::VERSION})",
-        'X-Viber-Auth-Token': token || RubyVibe.config.auth_token
-      }
-
-      response = ::RestClient::Request.execute(
-        method:     http_method, 
-        url:        url,
-        payload:    payload.to_json, 
-        headers:    headers,
-        timeout:    5, 
-        verify_ssl: ::OpenSSL::SSL::VERIFY_NONE
-      )
-      
-      return_response(response)
-    end
-
-    private
-
-    def return_response(response)
-      success       = true
-      error_message = nil
-      hash          = JSON.parse(response.body)
-
-      unless hash.dig('status').to_i == 0
-        success = false 
-        error_message =  hash.dig('status_message')
-      end
-     
-
-      Struct.new(:success?, :hash, :error_message).new(success, hash, error_message)
-    end
-
-  end
-end

data/lib/ruby_vibe/configuration.rb

@@ -1,21 +0,0 @@
-class RubyVibe
-  class << self
-    # Accessor for global configuration.
-    attr_accessor :config
-  end
-
-  def self.configure
-    self.config ||= Configuration.new
-    yield(config) if block_given?
-  end
-
-  class Configuration
-    attr_accessor :auth_token, :sender_name, :sender_avatar
-
-    def initialize
-      @auth_token    = nil
-      @sender_name   = nil
-      @sender_avatar = 'http://avatar.example.com'
-    end
-  end
-end

data/lib/ruby_vibe/urls.rb

@@ -1,11 +0,0 @@
-class RubyVibe
-  module URLS
-    API               = 'https://chatapi.viber.com/pa'.freeze
-    SET_WEBHOOK       = "#{API}/set_webhook".freeze
-    MESSAGE           = "#{API}/send_message".freeze
-    GET_ACCOUNT_INFO  = "#{API}/get_account_info".freeze
-    GET_USER_DETAILS  = "#{API}/get_user_details".freeze
-    BROADCAST_MESSAGE = "#{API}/broadcast_message".freeze
-    GET_ONLINE        = "#{API}/get_online".freeze
-  end
-end

data/lib/ruby_vibe/version.rb

@@ -1,3 +0,0 @@
-class RubyVibe
-  VERSION='0.0.1'.freeze
-end