hubrise_client 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9d13b21870a62cf2806b60260400ca941bd7df8893fedcc34f5ce442ce9ad489
+  data.tar.gz: b761dba1b9b3894fbdd7bc560e770cbf33cdea19fc76d9ec3817ab56772d0e05
+SHA512:
+  metadata.gz: 3da0fbcc970d4c14f64dad2b56c70b9966d38adacee775a782add770acf9fa7b93bec7a25bac1fa2a86a5988221c786154dec41807f2495d2df3d5941b8d86f3
+  data.tar.gz: e61453b95a35b4c3f09f20bafbf7b6ec87cc41fbbfb7be96c527b510a1454a7bffed71c75a2382b55fd323e4357ace837a850331bb92457abcfaf8aade3780eb

data/LICENSE

@@ -0,0 +1,21 @@
+MIT LICENSE
+
+Copyright (c)  nsave <nick.saveljev@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1 @@
+# hubrise_ruby_lib

data/Rakefile

@@ -0,0 +1,10 @@
+require "rake"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.libs << "lib"
+  t.pattern = "test/**/*_test.rb"
+  t.verbose = false
+end
+
+task default: :test

data/V1_ENDPOINTS.md

@@ -0,0 +1,256 @@
+### GET_ACCOUNT
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_account("zrn61")
+    // => [GET] /accounts/zrn61 with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_account()
+    // => [GET] /account with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### GET_ACCOUNTS
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_accounts()
+    // => [GET] /accounts with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### GET_USER
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_user()
+    // => [GET] /user with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### GET_LOCATIONS
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_locations()
+    // => [GET] /locations with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### GET_LOCATION
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_location("zrn61")
+    // => [GET] /locations/zrn61 with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_location()
+    // => [GET] /location with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### GET_ORDERS
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_orders("zrn61", {:status=>"new"})
+    // => [GET] /locations/zrn61/orders?status=new with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### GET_ORDER
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_order("zrn61", "wy3xz")
+    // => [GET] /locations/zrn61/orders/wy3xz with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### CREATE_ORDER
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).create_order("zrn61", {:status=>"new"})
+    // => [POST] /locations/zrn61/orders with {:headers=>{"Content-Type"=>"application/json"}, :body=>"{\"status\":\"new\"}"}
+    ```
+### UPDATE_ORDER
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).update_order("zrn61", "wy3xz", {:status=>"delivered"})
+    // => [PUT] /locations/zrn61/orders/wy3xz with {:headers=>{"Content-Type"=>"application/json"}, :body=>"{\"status\":\"delivered\"}"}
+    ```
+### GET_CALLBACK
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_callback()
+    // => [GET] /callback with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### GET_CALLBACK_EVENTS
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_callback_events()
+    // => [GET] /callback/events with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### DELETE_EVENT
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).delete_event("zrn61")
+    // => [DELETE] /callback/events/zrn61 with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### UPDATE_CALLBACK
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).update_callback({"order"=>["create"]})
+    // => [POST] /callback with {:headers=>{"Content-Type"=>"application/json"}, :body=>"{\"order\":[\"create\"]}"}
+    ```
+### DELETE_CALLBACK
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).delete_callback()
+    // => [DELETE] /callback with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### GET_LOCATION_CUSTOMER_LISTS
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_location_customer_lists("zrn61")
+    // => [GET] /locations/zrn61/customer_lists with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### GET_ACCOUNT_CUSTOMER_LISTS
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_account_customer_lists("zrn61")
+    // => [GET] /accounts/zrn61/customer_lists with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### GET_CUSTOMER_LIST
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_customer_list("zrn61")
+    // => [GET] /customer_lists/zrn61 with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+  - Initialized with `client_attrs = {:access_token=>"access_token1", :customer_list_id=>"wy3xz"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_customer_list()
+    // => [GET] /customer_lists/wy3xz with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### GET_ALL_CUSTOMERS
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_all_customers("zrn61")
+    // => [GET] /customer_lists/zrn61/customers with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+  - Initialized with `client_attrs = {:access_token=>"access_token1", :customer_list_id=>"wy3xz"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_all_customers()
+    // => [GET] /customer_lists/wy3xz/customers with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### SEARCH_CUSTOMERS
+  - Initialized with `client_attrs = {:access_token=>"access_token1", :customer_list_id=>"zrn61"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).search_customers({:email=>"nsave@*"})
+    // => [GET] /customer_lists/zrn61/customers?email=nsave@* with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).search_customers({:email=>"nsave@*"}, "wy3xz")
+    // => [GET] /customer_lists/wy3xz/customers?email=nsave@* with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### GET_CUSTOMER
+  - Initialized with `client_attrs = {:access_token=>"access_token1", :customer_list_id=>"zrn61"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_customer("zrk6b")
+    // => [GET] /customer_lists/zrn61/customers/zrk6b with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_customer("zrk6b", "wy3xz")
+    // => [GET] /customer_lists/wy3xz/customers/zrk6b with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### CREATE_CUSTOMER
+  - Initialized with `client_attrs = {:access_token=>"access_token1", :customer_list_id=>"zrn61"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).create_customer({:first_name=>"nsave"})
+    // => [POST] /customer_lists/zrn61/customers with {:headers=>{"Content-Type"=>"application/json"}, :body=>"{\"first_name\":\"nsave\"}"}
+    ```
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).create_customer({:first_name=>"nsave"}, "wy3xz")
+    // => [POST] /customer_lists/wy3xz/customers with {:headers=>{"Content-Type"=>"application/json"}, :body=>"{\"first_name\":\"nsave\"}"}
+    ```
+### UPDATE_CUSTOMER
+  - Initialized with `client_attrs = {:access_token=>"access_token1", :customer_list_id=>"zrn61"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).update_customer("zrk6b", {:first_name=>"nsave"})
+    // => [PUT] /customer_lists/zrn61/customers/zrk6b with {:headers=>{"Content-Type"=>"application/json"}, :body=>"{\"first_name\":\"nsave\"}"}
+    ```
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).update_customer("zrk6b", {:first_name=>"nsave"}, "wy3xz")
+    // => [PUT] /customer_lists/wy3xz/customers/zrk6b with {:headers=>{"Content-Type"=>"application/json"}, :body=>"{\"first_name\":\"nsave\"}"}
+    ```
+### GET_LOCATION_CATALOGS
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_location_catalogs("zrn61")
+    // => [GET] /locations/zrn61/catalogs with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### GET_ACCOUNT_CATALOGS
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_account_catalogs("zrn61")
+    // => [GET] /accounts/zrn61/catalogs with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### GET_CATALOG
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_catalog("zrn61")
+    // => [GET] /catalogs/zrn61 with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+  - Initialized with `client_attrs = {:access_token=>"access_token1", :catalog_id=>"wy3xz"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_catalog()
+    // => [GET] /catalogs/wy3xz with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### CREATE_ACCOUNT_CATALOG
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).create_account_catalog({:name=>"Catalog1"})
+    // => [POST] /account/catalogs with {:headers=>{"Content-Type"=>"application/json"}, :body=>"{\"name\":\"Catalog1\"}"}
+    ```
+### CREATE_LOCATION_CATALOG
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).create_location_catalog({:name=>"Catalog1"}, "zrn61")
+    // => [POST] /locations/zrn61/catalogs with {:headers=>{"Content-Type"=>"application/json"}, :body=>"{\"name\":\"Catalog1\"}"}
+    ```
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).create_location_catalog({:name=>"Catalog1"})
+    // => [POST] /location/catalogs with {:headers=>{"Content-Type"=>"application/json"}, :body=>"{\"name\":\"Catalog1\"}"}
+    ```
+### UPDATE_CATALOG
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).update_catalog({:name=>"Catalog1"}, "zrn61")
+    // => [PUT] /catalogs/zrn61 with {:headers=>{"Content-Type"=>"application/json"}, :body=>"{\"name\":\"Catalog1\"}"}
+    ```
+  - Initialized with `client_attrs = {:access_token=>"access_token1", :catalog_id=>"zrk6b"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).update_catalog({:name=>"Catalog1"})
+    // => [PUT] /catalogs/zrk6b with {:headers=>{"Content-Type"=>"application/json"}, :body=>"{\"name\":\"Catalog1\"}"}
+    ```
+### CREATE_IMAGE
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).create_image("bin1", "image/png", "zrn61")
+    // => [POST] /catalogs/zrn61/images with {:headers=>{"Content-Type"=>"image/png"}, :body=>"bin1"}
+    ```
+  - Initialized with `client_attrs = {:access_token=>"access_token1", :catalog_id=>"zrk6b"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).create_image("bin1", "image/png")
+    // => [POST] /catalogs/zrk6b/images with {:headers=>{"Content-Type"=>"image/png"}, :body=>"bin1"}
+    ```
+### GET_IMAGE
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_image("zrn61", "wy3xz")
+    // => [GET] /catalogs/wy3xz/images/zrn61 with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+  - Initialized with `client_attrs = {:access_token=>"access_token1", :catalog_id=>"zrk6b"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_image("zrn61")
+    // => [GET] /catalogs/zrk6b/images/zrn61 with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+### GET_IMAGE_DATA
+  - Initialized with `client_attrs = {:access_token=>"access_token1"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_image_data("zrn61", "wy3xz")
+    // => [GET] /catalogs/wy3xz/images/zrn61/data with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```
+  - Initialized with `client_attrs = {:access_token=>"access_token1", :catalog_id=>"zrk6b"}`
+    ```
+    Hubrise::APIClients::V1.new(client_attrs).get_image_data("zrn61")
+    // => [GET] /catalogs/zrk6b/images/zrn61/data with {:headers=>{"X-Access-Token"=>"access_token1"}}
+    ```

data/lib/hubrise_client.rb

@@ -0,0 +1,16 @@
+require "net/http"
+require "json"
+require "uri"
+require "logger"
+
+require_relative "hubrise_client/request"
+require_relative "hubrise_client/response"
+require_relative "hubrise_client/base"
+require_relative "hubrise_client/v1"
+
+module HubriseClient
+  class HubriseError              < StandardError; end
+  class HubriseAccessTokenMissing < HubriseError; end
+  class InvalidHubriseGrantParams < HubriseError; end
+  class InvalidHubriseToken       < HubriseError; end
+end

data/lib/hubrise_client/base.rb

@@ -0,0 +1,96 @@
+module HubriseClient
+  class Base
+    USE_HTTPS           = true
+    DEFAULT_API_HOST    = "api.hubrise.com".freeze
+    DEFAULT_API_PORT    = "433".freeze
+    DEFAULT_OAUTH_HOST  = "manager.hubrise.com".freeze
+    DEFAULT_OAUTH_PORT  = "433".freeze
+
+    attr_accessor :access_token,
+                  :app_instance_id,
+                  :user_id,
+                  :account_id,
+                  :location_id,
+                  :catalog_id,
+                  :customer_list_id,
+                  :logger
+
+    def initialize(app_id, app_secret, params = {}) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
+      @app_id     = app_id
+      @app_secret = app_secret
+      @api_host   = params[:api_host] || DEFAULT_API_HOST
+      @api_port   = params[:api_port] || DEFAULT_API_PORT
+      @oauth_host = params[:oauth_host] || DEFAULT_OAUTH_HOST
+      @oauth_port = params[:oauth_port] || DEFAULT_OAUTH_PORT
+      @use_https  = !!params.fetch(:use_https, USE_HTTPS)
+
+      initialize_scope_params(params)
+
+      @verbous = !!params[:verbous]
+      unless (@logger = params[:logger]) # rubocop:disable Style/GuardClause
+        @logger = Logger.new(STDOUT)
+        @logger.level = @verbous ? Logger::DEBUG : Logger::WARN
+      end
+    end
+
+    def build_authorization_url(redirect_uri, scope, params = {})
+      params = params.merge(
+        redirect_uri: redirect_uri,
+        scope: scope,
+        client_id: @app_id
+      )
+
+      (@use_https ? "https" : "http") + "://" + oauth2_hubrise_hostname_with_version + "/authorize?" + URI.encode_www_form(params) # rubocop:disable Metrics/LineLength
+    end
+
+    def authorize!(authorization_code)
+      api_response = api_request(oauth2_hubrise_hostname_with_version).perform(:post, "/token",
+                                                                                client_id: @app_id,
+                                                                                client_secret: @app_secret,
+                                                                                code: authorization_code)
+
+      case api_response.code
+      when "200"
+        initialize_scope_params(api_response.data)
+      when "404"
+        raise InvalidHubriseGrantParams
+      else
+        raise HubriseError, "Unexpected error: #{api_response.http_response.inspect}"
+      end
+
+      self
+    end
+
+    protected
+
+    def initialize_scope_params(params) # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/AbcSize, Metrics/LineLength
+      @access_token     = params[:access_token] || params["access_token"]
+      @app_instance_id  = params[:app_instance_id] || params["app_instance_id"]
+      @user_id          = params[:user_id] || params["user_id"]
+      @account_id       = params[:account_id] || params["account_id"]
+      @location_id      = params[:location_id] || params["location_id"]
+      @catalog_id       = params[:catalog_id] || params["catalog_id"]
+      @customer_list_id = params[:customer_list_id] || params["customer_list_id"]
+    end
+
+    def call_api(path, method = :get, data: {}, headers: {}, json: true)
+      raise(HubriseAccessTokenMissing) if @access_token.nil?
+
+      api_request("#{@api_host}:#{@api_port}/#{version}", @access_token).perform(method, path, data, json: json,
+                                                                                                      headers: headers)
+    end
+
+    def api_request(hostname, access_token = nil)
+      Request.new(
+        hostname: hostname,
+        access_token: access_token,
+        use_https: @use_https,
+        logger: @logger
+      )
+    end
+
+    def oauth2_hubrise_hostname_with_version
+      "#{@oauth_host}:#{@oauth_port}/oauth2/#{version}"
+    end
+  end
+end

data/lib/hubrise_client/request.rb

@@ -0,0 +1,65 @@
+module HubriseClient
+  class Request
+    REQUESTS_HASH = {
+      get: Net::HTTP::Get,
+      post: Net::HTTP::Post,
+      put: Net::HTTP::Put,
+      delete: Net::HTTP::Delete
+    }.freeze
+
+    def initialize(hostname:, access_token: nil, use_https: false, logger: nil)
+      @hostname     = hostname
+      @access_token = access_token
+      @use_https    = use_https
+      @protocol     = use_https ? "https" : "http"
+      @logger       = logger
+    end
+
+    def perform(method, path, data, json: true, headers: {})
+      uri           = URI.parse(@protocol + "://" + @hostname + path)
+      http_request  = build_request(uri, method, data, json: json, headers: headers)
+      http_response = perform_request(uri, http_request)
+
+      case http_response
+      when Net::HTTPUnauthorized
+        raise InvalidHubriseToken
+      else
+        raise(HubriseError, "Unexpected error") if http_response.code.start_with?("5")
+
+        Response.new(http_response)
+      end
+    rescue Errno::ECONNREFUSED
+      raise HubriseError, "API is not reachable"
+    end
+
+    protected
+
+    def build_request(uri, method, data, json:, headers:)
+      headers["X-Access-Token"] = @access_token if @access_token
+
+      if method == :get
+        uri = add_params_to_uri(uri, data)
+        data = nil
+      elsif json
+        headers["Content-Type"] ||= "application/json"
+        data = data.to_json
+      end
+
+      REQUESTS_HASH[method].new(uri, headers).tap do |request|
+        request.body = data
+      end
+    end
+
+    def add_params_to_uri(uri, params)
+      uri.query = [uri.query, URI.encode_www_form(params)].compact.join("&")
+      uri
+    end
+
+    def perform_request(uri, request)
+      http          = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl  = @use_https
+      http.set_debug_output(@logger) if @logger
+      http.request(request)
+    end
+  end
+end

data/lib/hubrise_client/response.rb

@@ -0,0 +1,35 @@
+module HubriseClient
+  class Response
+    attr_reader :code, :failed, :data, :error_type, :error_message, :errors, :http_response
+    alias failed? failed
+
+    def initialize(http_response)
+      @http_response  = http_response
+      @code           = http_response.code
+
+      json_body = begin
+                    JSON.parse(http_response.body)
+                  rescue StandardError
+                    nil
+                  end
+
+      @data = json_body || http_response.body
+
+      case http_response
+      when Net::HTTPSuccess
+        @failed  = false
+      else
+        @failed  = true
+        if json_body
+          @errors         = json_body["errors"]
+          @error_type     = json_body["error_type"]
+          @error_message  = json_body["message"]
+        end
+      end
+    end
+
+    def retry_after
+      http_response.is_a?(Net::HTTPTooManyRequests) && http_response["retry-after"].to_i
+    end
+  end
+end

data/lib/hubrise_client/v1.rb

@@ -0,0 +1,181 @@
+# rubocop:disable Naming/AccessorMethodName
+module HubriseClient
+  class V1 < Base
+    def version
+      :v1
+    end
+
+    # --------------------
+    # Accounts, locations, user
+    # --------------------
+    def get_account(account_id = nil)
+      if account_id
+        call_api("/accounts/#{account_id}")
+      else
+        call_api("/account")
+      end
+    end
+
+    def get_accounts
+      call_api("/accounts")
+    end
+
+    def get_user
+      call_api("/user")
+    end
+
+    def get_locations
+      call_api("/locations")
+    end
+
+    def get_location(location_id = nil)
+      if location_id
+        call_api("/locations/#{location_id}")
+      else
+        call_api("/location")
+      end
+    end
+
+    # --------------------
+    # Orders
+    # --------------------
+    def get_orders(location_id, search_params)
+      call_api("/locations/#{location_id}/orders", :get, data: search_params)
+    end
+
+    def get_order(location_id, order_id)
+      call_api("/locations/#{location_id}/orders/#{order_id}")
+    end
+
+    def create_order(location_id, params)
+      call_api("/locations/#{location_id}/orders", :post, data: params)
+    end
+
+    def update_order(location_id, order_id, params)
+      call_api("/locations/#{location_id}/orders/#{order_id}", :put, data: params)
+    end
+
+    # --------------------
+    # Callback, events
+    # --------------------
+    def get_callback
+      call_api("/callback")
+    end
+
+    def get_callback_events
+      call_api("/callback/events")
+    end
+
+    def delete_event(event_id)
+      call_api("/callback/events/#{event_id}", :delete)
+    end
+
+    def update_callback(params)
+      call_api("/callback", :post, data: params)
+    end
+
+    def delete_callback
+      call_api("/callback", :delete)
+    end
+
+    # --------------------
+    # Customer lists, customers
+    # --------------------
+    def get_location_customer_lists(location_id)
+      call_api("/locations/#{location_id}/customer_lists")
+    end
+
+    def get_account_customer_lists(account_id)
+      call_api("/accounts/#{account_id}/customer_lists")
+    end
+
+    def get_customer_list(customer_list_id = nil)
+      call_api("/customer_lists/#{customer_list_id_fallback(customer_list_id)}")
+    end
+
+    def get_all_customers(customer_list_id = nil)
+      search_customers({}, customer_list_id)
+    end
+
+    def search_customers(search_params, customer_list_id = nil)
+      call_api("/customer_lists/#{customer_list_id_fallback(customer_list_id)}/customers", :get, data: search_params)
+    end
+
+    def get_customer(customer_id, customer_list_id = nil)
+      call_api("/customer_lists/#{customer_list_id_fallback(customer_list_id)}/customers/#{customer_id}")
+    end
+
+    def create_customer(params, customer_list_id = nil)
+      call_api("/customer_lists/#{customer_list_id_fallback(customer_list_id)}/customers", :post, data: params)
+    end
+
+    def update_customer(customer_id, params, customer_list_id = nil)
+      call_api("/customer_lists/#{customer_list_id_fallback(customer_list_id)}/customers/#{customer_id}", :put,
+                data: params)
+    end
+
+    # --------------------
+    # Catalogs
+    # --------------------
+    def get_location_catalogs(location_id)
+      call_api("/locations/#{location_id}/catalogs")
+    end
+
+    def get_account_catalogs(account_id)
+      call_api("/accounts/#{account_id}/catalogs")
+    end
+
+    def get_catalog(catalog_id = nil)
+      call_api("/catalogs/#{catalog_id_fallback(catalog_id)}")
+    end
+
+    def create_account_catalog(params)
+      call_api("/account/catalogs", :post, data: params)
+    end
+
+    def create_location_catalog(params, location_id = nil)
+      if location_id
+        call_api("/locations/#{location_id}/catalogs", :post, data: params)
+      else
+        call_api("/location/catalogs", :post, data: params)
+      end
+    end
+
+    def update_catalog(params, catalog_id = nil)
+      call_api("/catalogs/#{catalog_id_fallback(catalog_id)}", :put, data: params)
+    end
+
+    # --------------------
+    # Images
+    # --------------------
+    def create_image(data, mime_type, catalog_id = nil)
+      call_api("/catalogs/#{catalog_id_fallback(catalog_id)}/images", :post, data: data,
+                                                                              headers: { "Content-Type" => mime_type },
+                                                                              json: false)
+    end
+
+    def get_image(image_id, catalog_id = nil)
+      call_api("/catalogs/#{catalog_id_fallback(catalog_id)}/images/#{image_id}")
+    end
+
+    def get_image_data(image_id, catalog_id = nil)
+      call_api("/catalogs/#{catalog_id_fallback(catalog_id)}/images/#{image_id}/data")
+    end
+
+    private
+
+    def customer_list_id_fallback(customer_list_id)
+      customer_list_id ||= @customer_list_id
+      raise("customer_list_id required") if customer_list_id.nil? || customer_list_id.empty?
+
+      customer_list_id
+    end
+
+    def catalog_id_fallback(catalog_id)
+      catalog_id ||= @catalog_id
+      raise("catalog_id required") if catalog_id.nil? || catalog_id.empty?
+
+      catalog_id
+    end
+  end
+end

data/lib/hubrise_client/version.rb

@@ -0,0 +1,3 @@
+module HubriseClient
+  VERSION = "2.0.0".freeze
+end

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification
+name: hubrise_client
+version: !ruby/object:Gem::Version
+  version: 2.0.0
+platform: ruby
+authors:
+- Antoine Monnier
+- Nick Save
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-05-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  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: rubocop
+  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: simplecov
+  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: 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: 
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- V1_ENDPOINTS.md
+- lib/hubrise_client.rb
+- lib/hubrise_client/base.rb
+- lib/hubrise_client/request.rb
+- lib/hubrise_client/response.rb
+- lib/hubrise_client/v1.rb
+- lib/hubrise_client/version.rb
+homepage: https://github.com/HubRise/ruby-client
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: Hubrise Ruby client
+test_files: []