zoho_hub 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 57cb4c2ca4e3b5f7f72773ae7b2492bd5335c7ff70b1ee014592b2f3f28eebe7
-  data.tar.gz: 64e3c1b8bf81edb48c6229d8e34b57f14ce9705bc4dbae8de32dddcccab54e2c
+  metadata.gz: f91e364b7e8432a5047a03f6fa2426201c502368c036bc604566de53de2e65fb
+  data.tar.gz: fc574d26b030f7d69025cc6004cb127a8eb7296ed9bba34566ac0c6de2c0b6fd
 SHA512:
-  metadata.gz: c77c9a08e05a48efbb5e6472022d408a8e8c4902b34d04d95896408c2f17276ebc531bcf2969712c1528a8e93d0f0919e77f82df576bdc02a246419a753198e7
-  data.tar.gz: cd4d488c82598ec99a8c48b9823772b72041ebd2600965ffbbdec2b3a816776915cd72a28713c2c54cb1f7ec0b17db04955187e2f0a55bece5ed103aed06a19d
+  metadata.gz: b4931bbcc3fcf425eae35d1b5a5eeca9c27112503e0444198504a2ab65667638f0a070808d8299d00ed7cd1ed03f71d63b0d0ad645cd22e0ef9823902b5028b5
+  data.tar.gz: 8898cf446859177ef26d0a73a066e7f5f0f7ede6fc2401833d4900f2524bc0a9d204890c0006ad59d79f822f8a0e1df7b0bd75f8ca9d60126829960aaad4eea5

data/.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on: [push, pull_request]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: "2.5"
+        bundler-cache: true
+    - name: rubocop version
+      timeout-minutes: 1
+      run: bundle exec rubocop --version
+    - name: rubocop
+      timeout-minutes: 5
+      run: bundle exec rubocop -c .rubocop.yml
+
+  test:
+    runs-on: ubuntu-latest
+    continue-on-error: ${{ matrix.experimental }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ["2.5", "2.6", "2.7", "3.0"]
+        experimental: [false]
+        include:
+        - ruby: "jruby"
+          experimental: true
+        - ruby: "truffleruby"
+          experimental: true
+    steps:
+    - uses: actions/checkout@v2
+    - uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{matrix.ruby}}
+        bundler-cache: true
+    - name: Run tests
+      timeout-minutes: 5
+      run: ${{matrix.env}} bundle exec rspec

data/.rubocop.yml

@@ -3,6 +3,13 @@ require: rubocop-rspec
 AllCops:
   TargetRubyVersion: 2.5.1
 
+Gemspec/RequiredRubyVersion:
+  Enabled: false
+
+Lint:
+  Exclude:
+    - bin/*
+
 # Don't force top level comments in every class
 Style/Documentation:
   Enabled: false
@@ -25,6 +32,12 @@ Metrics/ClassLength:
 Metrics/MethodLength:
   Max: 20
 
+Metrics/CyclomaticComplexity:
+  Max: 10
+
+Metrics/PerceivedComplexity:
+  Max: 10
+
 Metrics/AbcSize:
   Max: 30
 

data/.ruby-version

@@ -1 +1 @@
-2.5.3
+2.5.8

data/README.md

@@ -14,21 +14,35 @@ ActiveRecord, to do CRUD operations.
 
 ## Table of Contents
 
-* [Installation](#installation)
-* [Setup](#setup-process)
-  1. [Register your application](#1-register-your-application)
-  2. [Configure ZohoHub with your credentials](#2-configure-zohohub-with-your-credentials)
-  3. [Authorization request](#3-authorization-request)
-  4. [Access token](#4-access-token)
-  5. [Refresh token](#5-refresh-token)
-  6. [BasicZohoHub flow](#6-basic-zohohub-flow)
-  7. [BaseRecord and record classes](#7-baserecord-and-record-classes)
-* [Tips and suggestions](#tips-and-suggestions)
-* [Examples](#examples)
-  1. [Setup auth token and request CurrentUser](#setup-auth-token-and-request-currentuser)
-* [Development](#development)
-* [Contributing](#contributing)
-* [License](#license)
+- [ZohoHub](#zohohub)
+  - [Table of Contents](#table-of-contents)
+  - [Installation](#installation)
+  - [Setup process](#setup-process)
+    - [1. Register your application](#1-register-your-application)
+      - [1.1 Zoho Accounts URL](#11-zoho-accounts-url)
+      - [1.2 Authorized Redirect URI](#12-authorized-redirect-uri)
+    - [2. Configure ZohoHub with your credentials](#2-configure-zohohub-with-your-credentials)
+    - [3. Authorization request](#3-authorization-request)
+      - [3.1 Redirection based authentication](#31-redirection-based-authentication)
+      - [3.2 Self-Client Authorization](#32-self-client-authorization)
+      - [3.3 More on scopes](#33-more-on-scopes)
+      - [3.4 Offline access](#34-offline-access)
+    - [4. Access token](#4-access-token)
+    - [5. Refresh token](#5-refresh-token)
+    - [6. Basic ZohoHub flow](#6-basic-zohohub-flow)
+    - [7. BaseRecord and record classes](#7-baserecord-and-record-classes)
+      - [7.1 Reflection](#71-reflection)
+      - [7.2 Subclassing BaseRecord](#72-subclassing-baserecord)
+  - [8 Notifications](#8-notifications)
+    - [8.1 Enable notifications](#81-enable-notifications)
+    - [8.2 List notifications](#82-list-notifications)
+    - [8.3 Caveats](#83-caveats)
+  - [Tips and suggestions](#tips-and-suggestions)
+  - [Examples](#examples)
+    - [Setup auth token and request CurrentUser](#setup-auth-token-and-request-currentuser)
+  - [Development](#development)
+  - [Contributing](#contributing)
+  - [License](#license)
 
 ## Installation
 
@@ -198,7 +212,9 @@ To use an **access token** with ZohoHub, pass it to the `ZohoHub.setup_connectio
 
 ### 5. Refresh token
 
-TODO
+This gem automatically refresh the access token.
+
+If you want automatic refresh, use the refresh_token argument as in the next chapter.
 
 ---
 
@@ -210,7 +226,8 @@ token**, setup a ZohoHub connection:
 ```ruby
 ZohoHub.setup_connection access_token: 'ACCESS_TOKEN',
                          expires_in: 'EXPIRES_IN_SEC',
-                         api_domain: 'API_DOMAIN'
+                         api_domain: 'API_DOMAIN',
+                         refresh_token: 'REFRESH_TOKEN'
 ```
 
 Now you can issue requests to Zoho's API with the Connection object, e.g.:
@@ -256,7 +273,7 @@ Specify this module's fields as attributes:
 # lead.rb
 
 class Lead < ZohoHub::BaseRecord
-  attributes: :id, :first_name, :last_name, :phone, :email, :source, # etc.
+  attributes :id, :first_name, :last_name, :phone, :email, :source, # etc.
 end
 ```
 
@@ -283,8 +300,101 @@ lead = Lead.new(
 
 # Creates the new lead
 lead.save
+
+# Or in one step:
+lead = Lead.create(first_name: 'First name', ...)
+```
+
+Updating records:
+
+```ruby
+Lead.update(id: lead.id, first_name: "...", last_name: "...")
+
+# Or
+lead.update(first_name: "...", last_name: "...")
+
+# Or update up to 100 records in one call:
+leads = [{ id: id1, phone: "123" }, { id: id2, first_name: "..." }]
+Lead.update_all(leads)
+```
+
+Blueprint transition:
+
+```ruby
+Lead.blueprint_transition(lead.id, transition_id)
+
+# Or
+lead.blueprint_transition(transition_id)
+```
+
+Adding notes:
+
+```ruby
+Lead.add_note(id: lead.id, title: 'Note title', content: 'Note content')
+```
+
+Related records:
+
+```ruby
+Product.all_related(parent_module: 'Lead', parent_id: lead.id)
+Product.add_related(
+  parent_module: 'Lead',
+  parent_id: lead.id,
+  related_id: product.id
+)
+Product.remove_related(
+  parent_module: 'Lead',
+  parent_id: lead.id,
+  related_id: product.id
+)
+Product.update_related(...)
 ```
 
+Attachments (`ZohoHub::Attachment` is defined in the gem):
+
+```ruby
+Lead.related_attachments(parent_id: lead.id)
+# -> Array of Attachments
+
+attachment = Lead.download_attachment(parent_id: lead.id, attachment_id:attachment.id)
+# -> Attachment (attachment.file contains the file as a Tempfile)
+
+#NB: Lead.upload_attachment not implemented yet
+```
+
+## 8 Notifications
+Zoho allows you to receive a notification when a record of a module changes. Supported operation types are create, delete, edit, all.
+
+### 8.1 Enable notifications
+In order to receive notifications, you have to enable them first.
+```ruby
+# Enable notifications for a given channel:
+notification_url = 'https://example.org/api/notifications' # Zoho will send notifications by POST to this url
+token = '123abc' # Zoho will send this token back to you, so you can ensure that the notification is from Zoho
+channel_id = 1 # Choose a channel to handle the response
+events = %w[Leads.create Deals.edit Contacts.delete Sales_Orders.all] # Which events to receive notifications for
+channel_expiry = (DateTime.now + 1.day).iso8601 # choose a date when the channel should expire. 24h is the maximum, default is one hour
+
+ZohoHub::Notifications.enable(notification_url, channel_id, events, channel_expiry, token)
+```
+
+After enabling notifications, Zoho will execute a POST request to the provided notification_url every time the requested event occurs.
+
+For a list of an in-depth description of the response, check the [Zoho documentation](https://www.zoho.com/crm/developer/docs/api/notifications/overview.html)
+
+### 8.2 List notifications
+You can also retrieve all notifications that are currently enabled and that you are receiving uppdates for.
+
+```ruby
+# Get all enabled notifications
+ZohoHub::Notifications.all
+```
+
+### 8.3 Caveats
+
+* Zoho does not notify you when records are merged.
+* Since Zoho does not tell you what changed, you will have to request the record by yourself. Due to this you can miss changes, when they occur quickly after another. This is especially important for status changes, as you might miss state changes.
+
 ## Tips and suggestions
 
 * Using a tool such as Postman or curl to issue HTTP requests and verify responses in isolation

data/bin/console

@@ -20,7 +20,7 @@ puts 'Refreshing token...'
 token_params = ZohoHub::Auth.refresh_token(ENV['ZOHO_REFRESH_TOKEN'])
 ZohoHub.setup_connection(token_params)
 
-self.send(:include, ZohoHub)
+send(:include, ZohoHub)
 
 require 'pry'
 Pry.start

data/examples/models/potential.rb

@@ -28,6 +28,8 @@ module ZohoHub
     )
 
     def initialize(params = {})
+      super
+
       attributes.each do |attr|
         zoho_key = attr_to_zoho_key(attr)
 

data/lib/zoho_hub.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'backports/2.3.0/hash' if Gem::Version.new(RUBY_VERSION) < Gem::Version.new('2.3.0')
+require 'backports/2.5.0/hash' if Gem::Version.new(RUBY_VERSION) < Gem::Version.new('2.5.0')
 
 require 'zoho_hub/version'
 require 'zoho_hub/auth'
@@ -8,6 +9,7 @@ require 'zoho_hub/configuration'
 require 'zoho_hub/connection'
 require 'zoho_hub/errors'
 require 'zoho_hub/base_record'
+require 'zoho_hub/modules/attachment'
 require 'zoho_hub/settings/module'
 
 require 'zoho_hub/reflection/module_builder'
@@ -39,7 +41,7 @@ module ZohoHub
 
     connection_params = params.dup.slice(:access_token, :expires_in, :api_domain, :refresh_token)
 
-    @connection = Connection.new(connection_params)
+    @connection = Connection.new(**connection_params)
   end
 
   def connection

data/lib/zoho_hub/auth.rb

@@ -20,6 +20,7 @@ module ZohoHub
       ZohoCRM.settings.all
       ZohoCRM.modules.contacts.all
       ZohoCRM.modules.all
+      ZohoCRM.notifications.all
     ].freeze
 
     DEFAULT_ACCESS_TYPE = 'offline'

data/lib/zoho_hub/base_record.rb

@@ -12,7 +12,7 @@ module ZohoHub
     include WithAttributes
     include WithValidations
 
-    # Default nnumber of records when fetching all.
+    # Default number of records when fetching all.
     DEFAULT_RECORDS_PER_PAGE = 200
 
     # Default page number when fetching all.
@@ -49,7 +49,11 @@ module ZohoHub
                      # see https://www.zoho.com/crm/help/developer/api/search-records.html
                      params
                    else
-                     { criteria: "#{attr_to_zoho_key(params.keys.first)}:equals:#{params.values.first}" }
+                     key = attr_to_zoho_key(params.keys.first)
+
+                     {
+                       criteria: "#{key}:equals:#{params.values.first}"
+                     }
                    end
         end
 
@@ -78,6 +82,53 @@ module ZohoHub
         new(id: id).blueprint_transition(transition_id, data)
       end
 
+      def blueprint_transitions(id)
+        new(id: id).blueprint_transitions
+      end
+
+      def add_note(id:, title: '', content: '')
+        path = File.join(request_path, id, 'Notes')
+        post(path, data: [{ Note_Title: title, Note_Content: content }])
+      end
+
+      def all_related(parent_module:, parent_id:)
+        body = get(File.join(parent_module.constantize.request_path, parent_id, request_path))
+        response = build_response(body)
+
+        data = response.nil? ? [] : response.data
+
+        data.map { |json| new(json) }
+      end
+
+      def update_related(parent_module:, parent_id:, related_id:, data:)
+        path = File.join(
+          parent_module.constantize.request_path, parent_id, request_path, related_id
+        )
+        body = put(path, data: data)
+        build_response(body)
+      end
+
+      def add_related(parent_module:, parent_id:, related_id:)
+        update_related(
+          parent_module: parent_module, parent_id: parent_id, related_id: related_id, data: [{}]
+        )
+      end
+
+      def remove_related(parent_module:, parent_id:, related_id:)
+        body = delete(
+          File.join(parent_module.constantize.request_path, parent_id, request_path, related_id)
+        )
+        build_response(body)
+      end
+
+      def update_all(records)
+        zoho_params = records.transform_keys { |key| attr_to_zoho_key(key) }
+
+        body = put(File.join(request_path), data: zoho_params)
+
+        build_response(body)
+      end
+
       def all(params = {})
         params[:page] ||= DEFAULT_PAGE
         params[:per_page] ||= DEFAULT_RECORDS_PER_PAGE
@@ -103,6 +154,7 @@ module ZohoHub
         response = Response.new(body)
 
         raise InvalidTokenError, response.msg if response.invalid_token?
+        raise InternalError, response.msg if response.internal_error?
         raise RecordInvalid, response.msg if response.invalid_data?
         raise InvalidModule, response.msg if response.invalid_module?
         raise NoPermission, response.msg if response.no_permission?
@@ -116,8 +168,9 @@ module ZohoHub
     def initialize(params = {})
       attributes.each do |attr|
         zoho_key = attr_to_zoho_key(attr)
+        value = params[zoho_key].nil? ? params[attr] : params[zoho_key]
 
-        send("#{attr}=", params[zoho_key] || params[attr])
+        send("#{attr}=", value)
       end
     end
 
@@ -134,14 +187,21 @@ module ZohoHub
     end
 
     def update(params)
-      zoho_params = Hash[params.map { |k, v| [attr_to_zoho_key(k), v] }]
+      zoho_params = params.transform_keys { |key| attr_to_zoho_key(key) }
       body = put(File.join(self.class.request_path, id), data: [zoho_params])
+
       build_response(body)
     end
 
     def blueprint_transition(transition_id, data = {})
       body = put(File.join(self.class.request_path, id, 'actions/blueprint'),
                  blueprint: [{ transition_id: transition_id, data: data }])
+
+      build_response(body)
+    end
+
+    def blueprint_transitions
+      body = get(File.join(self.class.request_path, id, 'actions/blueprint'))
       build_response(body)
     end
 

data/lib/zoho_hub/cli/callback_server.rb

@@ -62,7 +62,7 @@ module ZohoHub
         url = ZohoHub::Auth.auth_url
         Launchy.open(url)
 
-        puts "Running callback server...."
+        puts 'Running callback server....'
         ZohoHub::OauthCallbackServer.run!
       end
 
@@ -79,13 +79,13 @@ module ZohoHub
       def parse(argv, _env)
         parser.parse!(argv)
         true
-      rescue OptionParser::ParseError => error
-        error_output(error)
+      rescue OptionParser::ParseError => e
+        error_output(e)
       end
 
       def error_output(error)
-        $stderr.puts "Error: #{error}"
-        $stderr.puts "Try `#{parser.program_name} server --help' for more information"
+        warn "Error: #{error}"
+        warn "Try `#{parser.program_name} server --help' for more information"
 
         false
       end

data/lib/zoho_hub/cli/read_modules.rb

@@ -107,13 +107,13 @@ module ZohoHub
       def parse(argv, _env)
         parser.parse!(argv)
         true
-      rescue OptionParser::ParseError => error
-        error_output(error)
+      rescue OptionParser::ParseError => e
+        error_output(e)
       end
 
       def error_output(error)
-        $stderr.puts "Error: #{error}"
-        $stderr.puts "Try `#{parser.program_name} server --help' for more information"
+        warn "Error: #{error}"
+        warn "Try `#{parser.program_name} server --help' for more information"
 
         false
       end

data/lib/zoho_hub/connection.rb

@@ -31,7 +31,7 @@ module ZohoHub
 
     BASE_PATH = '/crm/v2/'
 
-    def initialize(access_token:, api_domain: nil, expires_in: 3600, refresh_token: nil)
+    def initialize(access_token: nil, api_domain: nil, expires_in: 3600, refresh_token: nil)
       @access_token = access_token
       @expires_in = expires_in
       @api_domain = api_domain || self.class.infer_api_domain
@@ -88,7 +88,7 @@ module ZohoHub
       response = Response.new(http_response.body)
 
       # Try to refresh the token and try again
-      if response.invalid_token? && refresh_token?
+      if (response.invalid_token? || response.authentication_failure?) && refresh_token?
         log "Refreshing outdated token... #{@access_token}"
         params = ZohoHub::Auth.refresh_token(@refresh_token)
 
@@ -116,6 +116,7 @@ module ZohoHub
     def adapter
       Faraday.new(url: base_url) do |conn|
         conn.headers = authorization_header if access_token?
+        conn.use FaradayMiddleware::EncodeJson
         conn.use FaradayMiddleware::ParseJson
         conn.response :json, parser_options: { symbolize_names: true }
         conn.response :logger if ZohoHub.configuration.debug?

data/lib/zoho_hub/errors.rb

@@ -10,6 +10,9 @@ module ZohoHub
   class InvalidTokenError < StandardError
   end
 
+  class InternalError < StandardError
+  end
+
   class InvalidModule < StandardError
   end
 

data/lib/zoho_hub/modules/attachment.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'zoho_hub/base_record'
+
+module ZohoHub
+  class BaseRecord
+    class << self
+      def related_attachments(parent_id:)
+        body = get(File.join(request_path, parent_id, 'Attachments'))
+        response = build_response(body)
+
+        data = response.nil? ? [] : response.data
+
+        data.map { |json| Attachment.new(json) }
+      end
+
+      def download_attachment(parent_id:, attachment_id:)
+        attachment = related_attachments(parent_id: parent_id).find { |a| a.id == attachment_id }
+        uri = File.join(request_path, parent_id, 'Attachments', attachment_id)
+        res = ZohoHub.connection.adapter.get(uri)
+        attachment.content_type = res.headers['content-type']
+        extension = File.extname(attachment.file_name)
+        basename = File.basename(attachment.file_name, extension)
+        file = Tempfile.new([basename, extension])
+        file.binmode
+        file.write(res.body)
+        file.rewind
+        attachment.file = file
+        attachment
+      end
+    end
+  end
+
+  class Attachment < BaseRecord
+    attributes :id, :file_name, :created_by, :modified_by, :owner, :parent_id, :created_time,
+               :modified_time, :size
+
+    attribute_translation id: :id
+    attr_accessor :content_type, :file
+  end
+end

data/lib/zoho_hub/notifications.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require 'zoho_hub/response'
+require 'zoho_hub/with_connection'
+
+module ZohoHub
+  class Notifications
+    include WithConnection
+
+    # Default number of records when fetching all.
+    DEFAULT_RECORDS_PER_PAGE = 200
+
+    # Default page number when fetching all.
+    DEFAULT_PAGE = 1
+
+    # Minimum number of records to fetch when fetching all.
+    MIN_RECORDS = 2
+
+    class << self
+      def request_path
+        @request_path = 'actions/watch'
+      end
+
+      def all(params = {})
+        params[:page] ||= DEFAULT_PAGE
+        params[:per_page] ||= DEFAULT_RECORDS_PER_PAGE
+        params[:per_page] = MIN_RECORDS if params[:per_page] < MIN_RECORDS
+
+        body = get(request_path, params)
+        return [] if body.nil?
+
+        build_response(body)
+      end
+
+      def enable(notify_url, channel_id, events, channel_expiry = nil, token = nil)
+        body = post(request_path, watch: [{ notify_url: notify_url,
+                                            channel_id: channel_id,
+                                            events: events,
+                                            channel_expiry: channel_expiry,
+                                            token: token }])
+        build_response(body)
+      end
+
+      def build_response(body)
+        response = Response.new(body)
+
+        raise RecordInvalid, response.msg if response.invalid_data?
+        raise MandatoryNotFound, response.msg if response.mandatory_not_found?
+
+        response.data
+      end
+    end
+  end
+end

data/lib/zoho_hub/response.rb

@@ -14,6 +14,10 @@ module ZohoHub
       error_code?('INVALID_TOKEN')
     end
 
+    def internal_error?
+      error_code?('INTERNAL_ERROR')
+    end
+
     def authentication_failure?
       error_code?('AUTHENTICATION_FAILURE')
     end
@@ -39,7 +43,7 @@ module ZohoHub
     end
 
     def data
-      data = @params[:data] if @params.dig(:data)
+      data = @params[:data] if @params[:data]
       data || @params
     end
 
@@ -59,12 +63,13 @@ module ZohoHub
       msg
     end
 
-    # error response examples:
-    # {"data":[{"code":"INVALID_DATA","details":{},"message":"the id given seems to be invalid","status":"error"}]}
+    # Error response examples:
+    # {"data":[{"code":"INVALID_DATA","details":{},"message":"the id given...","status":"error"}]}
     # {:code=>"INVALID_TOKEN", :details=>{}, :message=>"invalid oauth token", :status=>"error"}
     def error_code?(code)
       if data.is_a?(Array)
         return false if data.size > 1
+
         return data.first[:code] == code
       end
 

data/lib/zoho_hub/string_utils.rb

@@ -8,7 +8,7 @@ module ZohoHub
       end
 
       def pluralize(text)
-        if ENV.key?('RAILS_ENV')
+        if defined?(ActiveSupport::Inflector)
           ActiveSupport::Inflector.pluralize(text)
         else
           "#{text}s"

data/lib/zoho_hub/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ZohoHub
-  VERSION = '0.4.0'
+  VERSION = '0.4.1'
 end

data/lib/zoho_hub/with_attributes.rb

@@ -44,8 +44,11 @@ module ZohoHub
       end
 
       def attr_to_zoho_key(attr_name)
-       return attribute_translation[attr_name.to_sym] if attribute_translation.key?(attr_name.to_sym)
-       attr_name.to_s.split('_').map(&:capitalize).join('_').to_sym
+        if attribute_translation.key?(attr_name.to_sym)
+          return attribute_translation[attr_name.to_sym]
+        end
+
+        attr_name.to_s.split('_').map(&:capitalize).join('_').to_sym
       end
 
       def zoho_key_translation
@@ -62,11 +65,12 @@ module ZohoHub
     # github.com/rails/rails/blob/master/activemodel/lib/active_model/attribute_assignment.rb
     def assign_attributes(new_attributes)
       unless new_attributes.is_a?(Hash)
-        raise ArgumentError, "When assigning attributes, you must pass a hash as an argument"
+        raise ArgumentError, 'When assigning attributes, you must pass a hash as an argument'
       end
+
       return if new_attributes.empty?
 
-      attributes = Hash[new_attributes.map { |k, v| [k.to_s, v] }]
+      attributes = new_attributes.transform_keys(&:to_s)
       attributes.each do |k, v|
         assign_attribute(k, v)
       end
@@ -86,13 +90,12 @@ module ZohoHub
       zoho_key.to_sym
     end
 
-    def assign_attribute(k, v)
-      setter = :"#{k}="
-      if respond_to?(setter)
-        public_send(setter, v)
-      else
-        raise ArgumentError, "Unknown attribute #{k}"
-      end
+    def assign_attribute(key, value)
+      setter = :"#{key}="
+
+      return public_send(setter, value) if respond_to?(setter)
+
+      raise ArgumentError, "Unknown attribute #{key}"
     end
   end
 end

data/lib/zoho_hub/with_connection.rb

@@ -13,11 +13,11 @@ module ZohoHub
       end
 
       def post(path, params = {})
-        ZohoHub.connection.post(path, params.to_json)
+        ZohoHub.connection.post(path, params)
       end
 
       def put(path, params = {})
-        ZohoHub.connection.put(path, params.to_json)
+        ZohoHub.connection.put(path, params)
       end
 
       def delete(path, params = {})

data/zoho_hub.gemspec

@@ -26,7 +26,7 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = '>= 2.1.0'
 
   spec.add_dependency 'addressable'
-  spec.add_dependency 'backports' if Gem::Version.new(RUBY_VERSION) < Gem::Version.new('2.3.0')
+  spec.add_dependency 'backports'
   spec.add_dependency 'faraday'
   spec.add_dependency 'faraday_middleware'
   spec.add_dependency 'launchy'
@@ -34,6 +34,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'rainbow'
   spec.add_dependency 'sinatra'
 
+  spec.add_development_dependency 'activesupport'
   spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'dotenv'
   spec.add_development_dependency 'pry-byebug'
@@ -42,4 +43,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rubocop'
   spec.add_development_dependency 'rubocop-rspec'
   spec.add_development_dependency 'simplecov'
+  spec.add_development_dependency 'webmock'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zoho_hub
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Ricardo Otero
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-07-18 00:00:00.000000000 Z
+date: 2021-05-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -24,6 +24,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: backports
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
@@ -108,6 +122,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -220,6 +248,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Simple gem to connect to Zoho CRM API V2
 email:
 - oterosantos@gmail.com
@@ -228,11 +270,11 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/ci.yml"
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
 - ".ruby-version"
-- ".travis.yml"
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -253,6 +295,8 @@ files:
 - lib/zoho_hub/configuration.rb
 - lib/zoho_hub/connection.rb
 - lib/zoho_hub/errors.rb
+- lib/zoho_hub/modules/attachment.rb
+- lib/zoho_hub/notifications.rb
 - lib/zoho_hub/oauth_callback_server.rb
 - lib/zoho_hub/reflection/module_builder.rb
 - lib/zoho_hub/response.rb
@@ -272,7 +316,7 @@ homepage: https://github.com/rikas/zoho_hub
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -287,9 +331,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
-signing_key: 
+rubyforge_project:
+rubygems_version: 2.7.6.2
+signing_key:
 specification_version: 4
 summary: Simple gem to connect to Zoho CRM API V2
 test_files: []

data/.travis.yml

@@ -1,8 +0,0 @@
-sudo: false
-language: ruby
-rvm:
-  - 2.1.10
-  - 2.2.10
-  - 2.3.7
-  - 2.4.4
-  - 2.5.3