ecoportal-api 0.7.3 → 0.7.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f2afaf2e4ef28b96b6e1c7bac6e4d97b7c53299a127aed1e22e990a4ca4ac9e3
-  data.tar.gz: 5883d799e43fa71151674b91a2c7557fd968f2552895a86fe656b86e16617460
+  metadata.gz: 275ffcb5e9bfe17f44295a7c4438b9e169dc87f22afe19591752425ef008cdba
+  data.tar.gz: aeb53e930f75dc7299fc400a8a00624428dfe496b77a5fdf1af1075b144a6944
 SHA512:
-  metadata.gz: 33ffe71c4bb72543ab2289d5a945aed1264f955adeae5432a8f6580d5311590f258448a64d49b8ed2e1f73fdabf1482d936fc290d0e92152ba6830b36905b961
-  data.tar.gz: 2038ebf5714308446d54ab0b56a70612b6f8ab02b96f28ca8f860e21f1223dc9e2879e53bb05fe25592c7482b3b6d24877c07ed08d872e5086a32fe6ae231464
+  metadata.gz: 2e2e4c03089ccf675057b335a9c9e46a5a40a92d3720b256fb9a679eec6431885889171960bf106e3586efbc77d9b2384262c9e4aa52cdf34b6c291be78b76dd
+  data.tar.gz: c1df25f369172d215ba64bf932b63d78514871579540edabc991719a737999a5700828352bceca140d5715861b47cb6b2e4e56fab4b7b916fe5ef42627ec7e4f

data/CHANGELOG.md

@@ -1,6 +1,19 @@
 # Change Log
 All notable changes to this project will be documented in this file.
 
+## [0.7.4] - 2021-01-2
+
+### Added
+
+### Fixed
+  - changed `compact` to `compact!`:
+    - `Ecoportal::API::V1::Person#filter_tags=`
+    - `Ecoportal::API::Internal::Account#policy_group_ids=`
+    - `Ecoportal::API::Internal::Account#login_provider_ids=`
+    - `Ecoportal::API::Internal::Account#starred_ids=`
+
+### Changed
+
 ## [0.7.3] - 2020-11-30
 
 ### Added

data/ecoportal-api.gemspec

@@ -27,6 +27,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "redcarpet", "~> 3.5", ">= 3.5.0"
   spec.add_development_dependency "pry"      , "~> 0.13"
 
-  spec.add_dependency 'http',          '~> 3'
+  spec.add_dependency 'http',          '~> 4'
   spec.add_dependency 'hash-polyfill', '~> 0'
 end

data/lib/ecoportal/api.rb

@@ -11,4 +11,5 @@ end
 require "ecoportal/api/logger"
 require "ecoportal/api/common"
 require "ecoportal/api/v1"
+require "ecoportal/api/v2"
 require "ecoportal/api/internal"

data/lib/ecoportal/api/common/base_model.rb

@@ -108,10 +108,10 @@ module Ecoportal
           end
         end
 
-        def pretty_print
-          puts JSON.pretty_generate(as_json)
-          self
-        end
+        # def pretty_print
+        #   puts JSON.pretty_generate(as_json)
+        #   self
+        # end
 
         protected
 

data/lib/ecoportal/api/common/client.rb

@@ -119,11 +119,18 @@ module Ecoportal
           Ecoportal::API::Common::Response.new(response)
         end
 
-        # Creates a HTTP object adding the `X-ApiKey` param to the header.
+        # Creates a HTTP object adding the `X-ApiKey` or `X-ECOPORTAL-API-KEY` param to the header, depending on the API version.
         # @note It configures HTTP so it only allows body data in json format.
         # @return [HTTP] HTTP object.
         def base_request
-          @base_request ||= HTTP.headers("X-ApiKey" => @api_key).accept(:json)
+          @base_request ||= begin
+            case @version
+            when "v2"
+              HTTP.headers("X-ECOPORTAL-API-KEY" => @api_key).accept(:json)
+            else
+              HTTP.headers("X-ApiKey" => @api_key).accept(:json)
+            end
+          end
         end
 
         # Full URl builder of the request

data/lib/ecoportal/api/internal/account.rb

@@ -24,7 +24,7 @@ module Ecoportal
           ini_ids = (original_doc && original_doc["policy_group_ids"]) || []
           # preserve original order to avoid false updates
           doc["policy_group_ids"] = (ini_ids & value) + (value - ini_ids)
-          doc["policy_group_ids"].compact!
+          doc["policy_group_ids"].compact
         end
 
         # @return [Array<String>] the policy group ids of this user.
@@ -37,7 +37,7 @@ module Ecoportal
           unless value.is_a?(Array)
             raise "login_provider_ids= needs to be passed an Array, got #{value.class}"
           end
-          doc["login_provider_ids"] = value.compact!
+          doc["login_provider_ids"] = value.compact
         end
 
         # @return [Array<String>] the login provider ids of this user.
@@ -50,7 +50,7 @@ module Ecoportal
           unless value.is_a?(Array)
             raise "starred_ids= needs to be passed an Array, got #{value.class}"
           end
-          doc["starred_ids"] = value.compact!
+          doc["starred_ids"] = value.compact
         end
 
         # @return [Array<String>] the starred page ids of this user.

data/lib/ecoportal/api/v1/person.rb

@@ -69,7 +69,7 @@ module Ecoportal
           ini_tags = (original_doc && original_doc["filter_tags"]) || []
           # preserve original order to avoid false updates
           doc["filter_tags"] = (ini_tags & end_tags) + (end_tags - ini_tags)
-          doc["filter_tags"].compact!
+          doc["filter_tags"].compact
         end
 
         # @return [Array<String>] the filter tags of this person.

data/lib/ecoportal/api/v2.rb

@@ -0,0 +1,47 @@
+module Ecoportal
+  module API
+    # @attr_reader client [Common::Client] a `Common::Client` object that holds the configuration of the api connection.
+    # @attr_reader logger [Logger] the logger.
+    class V2
+      extend Common::BaseClass
+      include Common::Logging
+
+      VERSION = "v2"
+      class_resolver :registers_class,  "Ecoportal::API::V2::Registers"
+      class_resolver :pages_class,  "Ecoportal::API::V2::Pages"
+
+      attr_reader :client, :logger
+
+      # Creates an `V2` object to scope version specific api requests.
+      # @note
+      #   - The const `VERSION` determineds the api version that client will query against.
+      #   - This means that each subclass of `V2` should define their own `VERSION` constant.
+      # @param api_key [String] the key version to stablish the api connection.
+      # @param host [String] api server domain.
+      # @param logger [Logger] an object with `Logger` interface to generate logs.
+      # @return [V2] an object with the api version suit.
+      def initialize(api_key, version: VERSION, host: "live.ecoportal.com", logger: default_logger)
+        @logger = logger
+        @client = Common::Client.new(
+          api_key: api_key,
+          host:    host,
+          version: self.class::VERSION,
+          logger:  @logger
+        )
+      end
+
+      # Obtain specific object for register api requests.
+      # @return [Register] an instance object ready to make register api requests.
+      def registers
+        registers_class.new(client)
+      end
+
+      def pages
+        pages_class.new(client)
+      end
+    end
+  end
+end
+
+require 'ecoportal/api/v2/registers'
+require 'ecoportal/api/v2/pages'

data/lib/ecoportal/api/v2/field.rb

@@ -0,0 +1,9 @@
+module Ecoportal
+  module API
+    class V2
+      class Field < Common::BaseModel
+        passthrough :id, :label, :value, :type
+      end
+    end
+  end
+end

data/lib/ecoportal/api/v2/page.rb

@@ -0,0 +1,30 @@
+module Ecoportal
+  module API
+    class V2
+      class Page < Common::BaseModel
+        passthrough :id, :name, :state
+
+        class_resolver :stage_class, "Ecoportal::API::V2::Stage"
+        class_resolver :field_class, "Ecoportal::API::V2::Field"
+
+        def stages
+          return nil unless doc["evolution"]
+          return @stages if defined?(@stages)
+          @stages = (doc["evolution"]["stages"] || []).each_with_index.map do |stage, i|
+            stage_class.new(stage, parent: self, key: ["stages", i])
+          end
+        end
+
+        def fields
+          return @fields if defined?(@fields)
+          @fields = (doc["components"] || []).each_with_index.map do |component, i|
+            field_class.new(component, parent: self, key: ["components", i])
+          end
+        end
+      end
+    end
+  end
+end
+
+require 'ecoportal/api/v2/stage'
+require 'ecoportal/api/v2/field'

data/lib/ecoportal/api/v2/pages.rb

@@ -0,0 +1,46 @@
+module Ecoportal
+  module API
+    class V2
+      # @attr_reader client [Common::Client] a `Common::Client` object that holds the configuration of the api connection.
+      class Pages
+        extend Common::BaseClass
+        include Enumerable
+        include Common::DocHelpers
+
+        attr_reader :client
+
+        class_resolver :page_class, "Ecoportal::API::V2::Page"
+
+        # @param client [Common::Client] a `Common::Client` object that holds the configuration of the api connection.
+        # @return [People] an instance object ready to make people api requests.
+        def initialize(client)
+          @client = client
+        end
+
+        def get(id, stage_id: nil)
+          if stage_id
+            response = get_with_stage_id(id, stage_id)
+            return page_class.new(response.body["data"])
+          end
+
+          response = client.get("/pages/#{id}")
+          # we get a 302 back when there's stages for the page
+          # let's follow it
+          if response.status == 302
+            stage_id = response.body["data"].match(/stages\/(.*)/)[1]
+            response = get_with_stage_id(id, stage_id)
+          end
+          page_class.new(response.body["data"])
+        end
+
+        private
+
+        def get_with_stage_id(id, stage_id)
+          client.get("/pages/#{id}/stages/#{stage_id}")
+        end
+      end
+    end
+  end
+end
+
+require 'ecoportal/api/v2/page'

data/lib/ecoportal/api/v2/register_search_result.rb

@@ -0,0 +1,20 @@
+module Ecoportal
+  module API
+    class V2
+      class RegisterSearchResult < Common::BaseModel
+        passthrough :id, :name, :state
+
+        class_resolver :stage_class, "Ecoportal::API::V2::Stage"
+
+        def stages
+          return @stages if defined?(@stages)
+          @stages = (doc["stages"] || []).each_with_index.map do |stage, i|
+            stage_class.new(stage, parent: self, key: ["stages", i])
+          end
+        end
+      end
+    end
+  end
+end
+
+require 'ecoportal/api/v2/stage'

data/lib/ecoportal/api/v2/registers.rb

@@ -0,0 +1,65 @@
+module Ecoportal
+  module API
+    class V2
+      # @attr_reader client [Common::Client] a `Common::Client` object that holds the configuration of the api connection.
+      class Registers
+        extend Common::BaseClass
+        include Enumerable
+        include Common::DocHelpers
+
+        class_resolver :register_search_result_class, "Ecoportal::API::V2::RegisterSearchResult"
+
+        attr_reader :client
+
+        # @param client [Common::Client] a `Common::Client` object that holds the configuration of the api connection.
+        # @return [People] an instance object ready to make people api requests.
+        def initialize(client)
+          @client = client
+        end
+
+        def search(register_id, options = {})
+          # supply a query string
+          # or a filter array (copy/paste from dev tools in the browser)
+          options = {query: nil, filters: []}.update(options)
+          options = {}.tap do |ret|
+            options.each do |key, value|
+              if key == :filters && value.any?
+                ret[key] = {filters: value}.to_json
+              else
+                ret[key] = value if key
+              end
+            end
+          end
+
+          cursor_id = nil
+          results = 0
+          loop do
+            options.update(cursor_id: cursor_id) if cursor_id
+            response = client.get("/registers/#{register_id}/search", params: options)
+            raise "Request failed - Status #{response.status}: #{response.body}" unless response.success?
+
+            data = response.body["data"]
+            unless (total = data["total"]) == 0
+              results += data["results"].length
+              percent  = results * 100 / total
+              msg      = "Registers SEARCH"
+              print "#{msg}: #{percent.round}% (of #{total})\r"
+              $stdout.flush 
+            end
+
+            data["results"].each do |result|
+              object = register_search_result_class.new(result)
+              yield object
+            end
+
+            # break unless (cursor_id = data["cursor_id"])
+            break if total == results
+          end
+          self
+        end
+      end
+    end
+  end
+end
+
+require 'ecoportal/api/v2/register_search_result'

data/lib/ecoportal/api/v2/stage.rb

@@ -0,0 +1,9 @@
+module Ecoportal
+  module API
+    class V2
+      class Stage < Common::BaseModel
+        passthrough :id, :name, :state
+      end
+    end
+  end
+end

data/lib/ecoportal/api/version.rb

@@ -1,5 +1,5 @@
 module Ecoportal
   module API
-    VERSION = "0.7.3"
+    VERSION = "0.7.4"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ecoportal-api
 version: !ruby/object:Gem::Version
-  version: 0.7.3
+  version: 0.7.4
 platform: ruby
 authors:
 - Tapio Saarinen
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-11-30 00:00:00.000000000 Z
+date: 2021-01-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -124,14 +124,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3'
+        version: '4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3'
+        version: '4'
 - !ruby/object:Gem::Dependency
   name: hash-polyfill
   requirement: !ruby/object:Gem::Requirement
@@ -205,6 +205,13 @@ files:
 - lib/ecoportal/api/v1/person_schemas.rb
 - lib/ecoportal/api/v1/schema_field.rb
 - lib/ecoportal/api/v1/schema_field_value.rb
+- lib/ecoportal/api/v2.rb
+- lib/ecoportal/api/v2/field.rb
+- lib/ecoportal/api/v2/page.rb
+- lib/ecoportal/api/v2/pages.rb
+- lib/ecoportal/api/v2/register_search_result.rb
+- lib/ecoportal/api/v2/registers.rb
+- lib/ecoportal/api/v2/stage.rb
 - lib/ecoportal/api/version.rb
 homepage: https://www.ecoportal.com
 licenses: