puzzle 0.1.0 → 0.2.0

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.2.0

data/lib/puzzle/company.rb

@@ -13,6 +13,10 @@ module Puzzle
       @active_contacts = company_info["activeContacts"]
     end
 
+    # Return a list of companies
+    # => pageSize: The attribute specifies the maximum number of records to be returned in a request. The default value is 50 and the system limit is 100.
+    # => name: Name of the desired company (indexed to include Company Name, URL, and ticker symbol)
+    # => View http://developer.jigsaw.com/documentation/search_and_get_api_guide/6_Data_Keys_and_Values for available search parameter
     def self.find(options)
       companies = []
       result = Puzzle::Request.get("/searchCompany", options)

data/lib/puzzle/const.rb

@@ -0,0 +1,14 @@
+module Puzzle
+  module ErrorCode
+    PARAM_ERROR = "PARAM_ERROR"
+    LOGIN_FAIL = "LOGIN_FAIL"
+    TOKEN_FAIL = "TOKEN_FAIL"
+    PURCHASE_LOW_POINTS = "PURCHASE_LOW_POINTS"
+    CONTACT_NOT_EXIST = "CONTACT_NOT_EXIS"
+    CONTACT_NOT_OWNED = "CONTACT_NOT_OWNED"
+    SEARCH_ERROR = "SEARCH_ERROR"
+    SYS_ERROR = "SYS_ERROR"
+    NOT_IMPLEMENTED = "NOT_IMPLEMENTED"
+    NOT_AVAILABLE = "NOT_AVAILABLE"
+  end
+end

data/lib/puzzle/contact.rb

@@ -43,6 +43,14 @@ module Puzzle
       @owned_type = contact_info["ownedType"]
     end
 
+    # Return a list of contacts
+    # => pageSize: The attribute specifies the maximum number of records to be returned in a request. The system limit and default value is 500.
+    # => firstname: firstname of the contact to be searched
+    # => lastname: last (or family) name of the contact to be searched
+    # => levels: employee rank (e.g. VP, Staff)
+    # => companyName: company for whom contact works (indexed to include Company Name, URL, and ticker symbol)
+    # => email: full email address of the contact to be searched
+    # => View http://developer.jigsaw.com/documentation/search_and_get_api_guide/6_Data_Keys_and_Values for available search parameter
     def self.find(options)
       contacts = []
       result = Puzzle::Request.get("/searchContact", options)

data/lib/puzzle/error.rb

@@ -0,0 +1,11 @@
+module Puzzle
+  class Error
+    attr_accessor :stack_trace, :code, :message, :http_status_code
+    def initialize(error)
+      @code = error["errorCode"]
+      @message = error["errorMsg"]
+      @stack_trace = error["stackTrace"]
+      @http_status_code = error["httpStatusCode"] 
+    end
+  end
+end

data/lib/puzzle/exception.rb

@@ -0,0 +1,14 @@
+module Puzzle
+  module Exception
+    class ParamError < StandardError; end
+    class LoginFail < StandardError; end
+    class TokenFail < StandardError; end
+    class PurchaseLowPoints < StandardError; end
+    class ContactNotExist < StandardError; end
+    class ContactNotOwned < StandardError; end
+    class SearchError < StandardError; end
+    class SysError < StandardError; end
+    class NotImplemented < StandardError; end
+    class NotAvailable < StandardError; end
+  end
+end

data/lib/puzzle/request.rb

@@ -1,3 +1,6 @@
+require File.join(File.dirname(__FILE__), 'exception')
+require File.join(File.dirname(__FILE__), 'error')
+require File.join(File.dirname(__FILE__), 'const')
 require "json"
 require "cgi"
 require "net/http"
@@ -30,8 +33,7 @@ module Puzzle
           # TODO: Support XML format  
         end
       else
-        # TODO: Handle Errors
-        false
+        handle_error(response.body, format)
       end
     end
 
@@ -55,6 +57,57 @@ module Puzzle
         "#{CGI.escape(key.to_s).gsub(/%(5B|5D)/n) { [$1].pack("H*") }}=#{CGI.escape(value.to_s)}"
       }.join("&")
     end
+
+    def self.handle_error(error_body, format = "json")
+      error = parse_error(error_body, format)
+      case error.http_status_code
+      when 400
+        raise Puzzle::Exception::ParamError, error.message
+      when 403
+        case error.code
+        when Puzzle::ErrorCode::LOGIN_FAIL
+          raise Puzzle::Exception::LoginFail, error.message
+        when Puzzle::ErrorCode::TOKEN_FAIL
+          raise Puzzle::Exception::TokenFail, error.message
+        end
+      when 404
+        raise Puzzle::Exception::ContactNotExist, error.message
+      when 405
+        case error.code
+        when Puzzle::ErrorCode::CONTACT_NOT_OWNED
+          raise Puzzle::Exception::ContactNotOwned, error.message
+        when Puzzle::ErrorCode::PURCHASE_LOW_POINTS
+          raise Puzzle::Exception::PurchaseLowPoints, error.message
+        end
+      when 500
+        case error.code
+        when Puzzle::ErrorCode::SEARCH_ERROR
+          raise Puzzle::Exception::SearchError, error.message
+        when Puzzle::ErrorCode::SYS_ERROR
+          raise Puzzle::Exception::SysError, error.message
+        end
+      when 501
+        raise Puzzle::Exception::NotImplemented, error.message
+      when 503
+        raise Puzzle::Exception::NotAvailable, error.message
+      else
+        raise StandardError, "Unknown Error"
+      end
+    end
+
+    def self.parse_error(error_data, format = "json")
+      error = nil
+      case format
+      when "json"
+        parsed_error = JSON.parse(error_data)
+        if parsed_error && parsed_error.length > 0
+          error = Error.new(parsed_error[0])
+        end
+      when "xml"
+        # TODO: Add xml support
+      end
+      error
+    end
   end
 end
 

data/puzzle.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = "puzzle"
-  s.version = "0.1.0"
+  s.version = "0.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Simon Gingras"]
@@ -26,7 +26,10 @@ Gem::Specification.new do |s|
     "lib/puzzle.rb",
     "lib/puzzle/company.rb",
     "lib/puzzle/configuration.rb",
+    "lib/puzzle/const.rb",
     "lib/puzzle/contact.rb",
+    "lib/puzzle/error.rb",
+    "lib/puzzle/exception.rb",
     "lib/puzzle/request.rb",
     "puzzle.gemspec",
     "test/helper.rb",

metadata

@@ -2,7 +2,7 @@
 name: puzzle
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Simon Gingras
@@ -86,7 +86,10 @@ files:
 - lib/puzzle.rb
 - lib/puzzle/company.rb
 - lib/puzzle/configuration.rb
+- lib/puzzle/const.rb
 - lib/puzzle/contact.rb
+- lib/puzzle/error.rb
+- lib/puzzle/exception.rb
 - lib/puzzle/request.rb
 - puzzle.gemspec
 - test/helper.rb
@@ -104,7 +107,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 1302281104639078200
+      hash: -4390695954410806016
       segments: 
       - 0
       version: "0"