tomba 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 14fc88b877a55b993f2d26a344212ba05c3e95caecc23c544340c33938a0cc2b
+  data.tar.gz: 3c083ee97a506e80b081dd8c1316bf396e5f0f6f445d402cb70d0c40d82a2e63
+SHA512:
+  metadata.gz: 79fa611ff51ae93ff978c716e9461e0a8677889fd0b880deac9ee75af5b76d11f7c4719fcb5427cdbdffd956310dd6a7d62a267d76514d17a9937f8d68b8bf1b
+  data.tar.gz: 47132687b7c2f5788bc1aafc47c0ad1318d9e1d69231323509bdceb1322fe1cf68966c72050d8d847a78ab51a26c41b520aa78fb6f6efbe604e92992837f0493

data/lib/tomba/client.rb

@@ -0,0 +1,122 @@
+require 'net/http'
+require 'uri'
+require 'json'
+require 'cgi'
+
+module Tomba
+    class Client
+
+        METHOD_GET = 'get'
+        METHOD_POST = 'post'
+        METHOD_PUT = 'put'
+        METHOD_PATCH = 'patch'
+        METHOD_DELETE = 'delete'
+        METHOD_HEAD = 'head'
+        METHOD_OPTIONS = 'options'
+        METHOD_CONNECT = 'connect'
+        METHOD_TRACE = 'trace'
+
+        def initialize()
+            @headers = {
+                'content-type' => '',
+                'user-agent' => RUBY_PLATFORM + ':ruby-' + RUBY_VERSION,
+                'x-sdk-version' => 'tomba:ruby:v1.0.0'
+
+            }
+            @endpoint = 'https://api.tomba.io/v1';
+        end
+
+        def set_key(value)
+            add_header('x-tomba-key', value)
+
+            return self
+        end
+
+        def set_secret(value)
+            add_header('x-tomba-secret', value)
+
+            return self
+        end
+
+        def set_endpoint(endpoint)
+            @endpoint = endpoint
+
+            return self
+        end
+
+        def add_header(key, value)
+            @headers[key.downcase] = value
+
+            return self
+        end
+
+        def call(method, path = '', headers = {}, params = {})
+            uri = URI.parse(@endpoint + path + ((method == METHOD_GET && params.length) ? '?' + encode(params) : ''))
+            return fetch(method, uri, headers, params)
+        end
+
+        protected
+
+        private
+
+        def fetch(method, uri, headers, params, limit = 5)
+            raise ArgumentError, 'Too Many HTTP Redirects' if limit == 0
+
+            http = Net::HTTP.new(uri.host, uri.port)
+            http.use_ssl = (uri.scheme == 'https')
+            payload = ''
+
+            headers = @headers.merge(headers)
+            @BOUNDARY = "----A30#3ad1"
+            if (method != METHOD_GET)
+                case headers['content-type'][0, headers['content-type'].index(';') || headers['content-type'].length]
+                    when 'application/json'
+                        payload = params.to_json
+                    else
+                        payload = encode(params)
+                end
+            end
+
+            begin
+                response = http.send_request(method.upcase, uri.request_uri, payload, headers)
+            rescue => error
+                raise Tomba::Exception.new(error.message)
+            end
+
+            # Handle Redirects
+            if (response.class == Net::HTTPRedirection || response.class == Net::HTTPMovedPermanently)
+                location = response['location']
+                uri = URI.parse(uri.scheme + "://" + uri.host + "" + location)
+
+                return fetch(method, uri, headers, {}, limit - 1)
+            end
+
+            begin
+                res = JSON.parse(response.body);
+            rescue JSON::ParserError => e
+                raise Tomba::Exception.new(response.body, response.code, nil)
+            end
+
+            if(response.code.to_i >= 400)
+                raise Tomba::Exception.new(res['errors']['message'], res['errors']['code'], res)
+            end
+
+            return res;
+        end
+
+
+        def encode(value, key = nil)
+            case value
+            when Hash  then value.map { |k,v| encode(v, append_key(key,k)) }.join('&')
+            when Array then value.map { |v| encode(v, "#{key}[]") }.join('&')
+            when nil   then ''
+            else
+            "#{key}=#{CGI.escape(value.to_s)}"
+            end
+        end
+
+        def append_key(root_key, key)
+            root_key.nil? ? key : "#{root_key}[#{key.to_s}]"
+        end
+    end
+end

data/lib/tomba/exception.rb

@@ -0,0 +1,14 @@
+module Tomba
+    class Exception < StandardError
+        @code = 0;
+        @response = nil;
+
+        def initialize(message, code, response)
+            super(message)
+            @code = code
+            @response = response
+        end
+        attr_reader :code
+        attr_reader :response
+    end
+end

data/lib/tomba/service.rb

@@ -0,0 +1,12 @@
+module Tomba
+    class Service
+
+        def initialize(client)
+            @client = client
+        end
+        
+        protected
+
+        private
+    end 
+end

data/lib/tomba/services/account.rb

@@ -0,0 +1,19 @@
+module Tomba
+    class Account < Service
+
+        def get_account()
+            path = '/me'
+
+            params = {}
+
+            return @client.call('get', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+
+        protected
+
+        private
+    end 
+end

data/lib/tomba/services/count.rb

@@ -0,0 +1,27 @@
+module Tomba
+    class Count < Service
+
+        def email_count(domain:)
+            if domain.nil?
+                raise Tomba::Exception.new('Missing required parameter: "domain"')
+            end
+
+            path = '/email-count'
+
+            params = {}
+
+            if !domain.nil?
+                params[:domain] = domain
+            end
+
+            return @client.call('get', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+
+        protected
+
+        private
+    end 
+end

data/lib/tomba/services/domain.rb

@@ -0,0 +1,36 @@
+module Tomba
+    class Domain < Service
+
+        def domain_search(domain:, page: nil, limit: nil, department: nil)
+            if domain.nil?
+                raise Tomba::Exception.new('Missing required parameter: "domain"')
+            end
+
+            path = '/domain-search/{domain}'
+                .gsub('{domain}', domain)
+
+            params = {}
+
+            if !page.nil?
+                params[:page] = page
+            end
+
+            if !limit.nil?
+                params[:limit] = limit
+            end
+
+            if !department.nil?
+                params[:department] = department
+            end
+
+            return @client.call('get', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+
+        protected
+
+        private
+    end 
+end

data/lib/tomba/services/finder.rb

@@ -0,0 +1,40 @@
+module Tomba
+    class Finder < Service
+
+        def email_finder(domain:, first_name:, last_name:)
+            if domain.nil?
+                raise Tomba::Exception.new('Missing required parameter: "domain"')
+            end
+
+            if first_name.nil?
+                raise Tomba::Exception.new('Missing required parameter: "firstName"')
+            end
+
+            if last_name.nil?
+                raise Tomba::Exception.new('Missing required parameter: "lastName"')
+            end
+
+            path = '/email-finder/{domain}'
+                .gsub('{domain}', domain)
+
+            params = {}
+
+            if !first_name.nil?
+                params[:first_name] = first_name
+            end
+
+            if !last_name.nil?
+                params[:last_name] = last_name
+            end
+
+            return @client.call('get', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+
+        protected
+
+        private
+    end 
+end

data/lib/tomba/services/keys.rb

@@ -0,0 +1,59 @@
+module Tomba
+    class Keys < Service
+
+        def get_keys()
+            path = '/keys/{id}'
+
+            params = {}
+
+            return @client.call('get', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+        def delete_key(id:)
+            if id.nil?
+                raise Tomba::Exception.new('Missing required parameter: "id"')
+            end
+
+            path = '/keys/{id}'
+                .gsub('{id}', id)
+
+            params = {}
+
+            return @client.call('delete', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+        def create_key()
+            path = '/keys/{id}'
+
+            params = {}
+
+            return @client.call('post', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+        def reset_key(id:)
+            if id.nil?
+                raise Tomba::Exception.new('Missing required parameter: "id"')
+            end
+
+            path = '/keys/{id}'
+                .gsub('{id}', id)
+
+            params = {}
+
+            return @client.call('put', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+
+        protected
+
+        private
+    end 
+end

data/lib/tomba/services/leads-attributes.rb

@@ -0,0 +1,59 @@
+module Tomba
+    class LeadsAttributes < Service
+
+        def get_lead_attributes()
+            path = '/leads/attributes/{id}'
+
+            params = {}
+
+            return @client.call('get', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+        def delete_lead_attribute(id:)
+            if id.nil?
+                raise Tomba::Exception.new('Missing required parameter: "id"')
+            end
+
+            path = '/leads/attributes/{id}'
+                .gsub('{id}', id)
+
+            params = {}
+
+            return @client.call('delete', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+        def create_lead_attribute()
+            path = '/leads/attributes/{id}'
+
+            params = {}
+
+            return @client.call('post', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+        def update_lead_attribute(id:)
+            if id.nil?
+                raise Tomba::Exception.new('Missing required parameter: "id"')
+            end
+
+            path = '/leads/attributes/{id}'
+                .gsub('{id}', id)
+
+            params = {}
+
+            return @client.call('put', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+
+        protected
+
+        private
+    end 
+end

data/lib/tomba/services/leads-lists.rb

@@ -0,0 +1,59 @@
+module Tomba
+    class LeadsLists < Service
+
+        def get_lists()
+            path = '/leads_lists/{id}'
+
+            params = {}
+
+            return @client.call('get', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+        def delete_list_id(id:)
+            if id.nil?
+                raise Tomba::Exception.new('Missing required parameter: "id"')
+            end
+
+            path = '/leads_lists/{id}'
+                .gsub('{id}', id)
+
+            params = {}
+
+            return @client.call('delete', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+        def create_list()
+            path = '/leads_lists/{id}'
+
+            params = {}
+
+            return @client.call('post', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+        def update_list_id(id:)
+            if id.nil?
+                raise Tomba::Exception.new('Missing required parameter: "id"')
+            end
+
+            path = '/leads_lists/{id}'
+                .gsub('{id}', id)
+
+            params = {}
+
+            return @client.call('put', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+
+        protected
+
+        private
+    end 
+end

data/lib/tomba/services/logs.rb

@@ -0,0 +1,19 @@
+module Tomba
+    class Logs < Service
+
+        def get_logs()
+            path = '/logs'
+
+            params = {}
+
+            return @client.call('get', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+
+        protected
+
+        private
+    end 
+end

data/lib/tomba/services/sources.rb

@@ -0,0 +1,24 @@
+module Tomba
+    class Sources < Service
+
+        def email_sources(email:)
+            if email.nil?
+                raise Tomba::Exception.new('Missing required parameter: "email"')
+            end
+
+            path = '/email-sources/{email}'
+                .gsub('{email}', email)
+
+            params = {}
+
+            return @client.call('get', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+
+        protected
+
+        private
+    end 
+end

data/lib/tomba/services/status.rb

@@ -0,0 +1,45 @@
+module Tomba
+    class Status < Service
+
+        def domain_status(domain:)
+            if domain.nil?
+                raise Tomba::Exception.new('Missing required parameter: "domain"')
+            end
+
+            path = '/domain-status'
+
+            params = {}
+
+            if !domain.nil?
+                params[:domain] = domain
+            end
+
+            return @client.call('get', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+        def auto_complete(query:)
+            if query.nil?
+                raise Tomba::Exception.new('Missing required parameter: "query"')
+            end
+
+            path = '/domains-suggestion'
+
+            params = {}
+
+            if !query.nil?
+                params[:query] = query
+            end
+
+            return @client.call('get', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+
+        protected
+
+        private
+    end 
+end

data/lib/tomba/services/usage.rb

@@ -0,0 +1,19 @@
+module Tomba
+    class Usage < Service
+
+        def get_usage()
+            path = '/usage'
+
+            params = {}
+
+            return @client.call('get', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+
+        protected
+
+        private
+    end 
+end

data/lib/tomba/services/verifier.rb

@@ -0,0 +1,24 @@
+module Tomba
+    class Verifier < Service
+
+        def email_verifier(email:)
+            if email.nil?
+                raise Tomba::Exception.new('Missing required parameter: "email"')
+            end
+
+            path = '/email-verifier/{email}'
+                .gsub('{email}', email)
+
+            params = {}
+
+            return @client.call('get', path, {
+                'content-type' => 'application/json',
+            }, params);
+        end
+
+
+        protected
+
+        private
+    end 
+end

data/lib/tomba/version.rb

@@ -0,0 +1,4 @@
+
+module Tomba
+    VERSION = '1.0.0'
+end

data/lib/tomba.rb

@@ -0,0 +1,18 @@
+require 'net/http'
+require 'uri'
+require 'json'
+require_relative 'tomba/client'
+require_relative 'tomba/service'
+require_relative 'tomba/exception'
+require_relative 'tomba/services/account'
+require_relative 'tomba/services/domain'
+require_relative 'tomba/services/finder'
+require_relative 'tomba/services/verifier'
+require_relative 'tomba/services/sources'
+require_relative 'tomba/services/status'
+require_relative 'tomba/services/count'
+require_relative 'tomba/services/usage'
+require_relative 'tomba/services/logs'
+require_relative 'tomba/services/keys'
+require_relative 'tomba/services/leads-lists'
+require_relative 'tomba/services/leads-attributes'

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: tomba
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Mohamed Ben rebia
+- Tomba technology web service LLC
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2021-10-19 00:00:00.000000000 Z
+dependencies: []
+description: official Ruby library for Tomba
+email:
+- b.mohamed@tomba.io
+- info@tomba.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/tomba.rb
+- lib/tomba/client.rb
+- lib/tomba/exception.rb
+- lib/tomba/service.rb
+- lib/tomba/services/account.rb
+- lib/tomba/services/count.rb
+- lib/tomba/services/domain.rb
+- lib/tomba/services/finder.rb
+- lib/tomba/services/keys.rb
+- lib/tomba/services/leads-attributes.rb
+- lib/tomba/services/leads-lists.rb
+- lib/tomba/services/logs.rb
+- lib/tomba/services/sources.rb
+- lib/tomba/services/status.rb
+- lib/tomba/services/usage.rb
+- lib/tomba/services/verifier.rb
+- lib/tomba/version.rb
+homepage: https://tomba.io
+licenses:
+- Apache-2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.6
+signing_key: 
+specification_version: 4
+summary: Tomba.io is an Email Finder for B2B sales and email marketing
+test_files: []