eco-helpers 1.5.14 → 2.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2627cbc4d42e91e131e891cc4248895660a62bab2c331b43ac8ad3cd28b9cdee
-  data.tar.gz: fb2c29b13a67114ce8bbfbd16b271519896c201ec58cb9fd37b48db238abb014
+  metadata.gz: caef8b4ee689f202db51c1be9ea77c1c2e3b21cf16dcaebdf7fd838a260b5e26
+  data.tar.gz: ad27f525af9bceff0342e5676f898a9da1dbb486c6aad796f2bb3646ccf5cb68
 SHA512:
-  metadata.gz: 6da008ea99e2e6e323afcfbc0be117dd56402b95be100a68d808d3b4e81537def757fb66418fc0028492ea2e12ac74def8d4c6c47a7d05589bac3814ce9e10d9
-  data.tar.gz: 78af32b3b9f4725211baf6e458db91c064f49f25814bbda7177fe61af1b453597d658f1d734e155c8ebeb863aabdd36a0b6b81a9fcd972c6d92f2911f05ac11f
+  metadata.gz: 4780834f301910259cb8958c1277de1972ac710f59f7803d34ed2263dc777c18a7a2503e3d6b36879b131b2625b657832a78a27471b690a5d9da8025d381df9f
+  data.tar.gz: 28b74a9f5d8fe22aadb053fbed4af2e35e4700a04e87fbfc201bd2336521f04814e25c0cbac7f48426172f4b21a05f8b4e4b551eaaffd4067c49609fce0dac92

data/CHANGELOG.md

@@ -1,7 +1,66 @@
 # Change Log
 All notable changes to this project will be documented in this file.
 
-## [1.5.14] - 2021-02-xx
+## [2.0.5] - 2021-02-24
+
+### Added
+### Changed
+### Fixed
+  - `Eco::API::Common::People::PersonParser#symbol_keys` to use `Array#select`
+    - as `Array#filter` was introduced in ruby `2.5.5`
+
+## [2.0.4] - 2021-02-23
+
+### Added
+### Changed
+  - `Eco::API::Common::People::PersonParser#defined_attrs` to include virtual attributes
+
+### Fixed
+
+## [2.0.3] - 2021-02-23
+
+### Added
+  - `Eco::API::UseCases::OozeSamples::OozeUpdateCase`: added integration to update page instances (non-templates)
+
+### Changed
+### Fixed
+  - `Eco::API::Policies::DefaultPolicies::UserAccess` complete default policy code.
+
+## [2.0.2] - 2021-02-22
+
+### Added
+### Changed
+  - upgraded dependencies with `ecoportal-api`
+
+### Fixed
+
+
+## [2.0.1] - 2021-02-22
+
+### Added
+### Changed
+  - upgraded dependencies with `ecoportal-api-oozes` to `ecoportal-api-v2`
+
+### Fixed
+
+## [1.5.15] - 2021-02-17
+
+### Added
+  - `Eco::API::Common::ClassHelpers` added support for class methods inheritance
+    - this is key to be able to define usecase models to inherit from
+  - `Eco::API::UseCases::OozeSamples::OozeUpdateCase`: added this sample to inherit from (simplifying use cases code)
+  - `Eco::API::Common::ClassHelpers` added inheritable attribute values
+  - added benchmarking to people loaders:
+    - `Eco::API::MicroCases#people_load`
+    - `Eco::API::MicroCases#people_cache`
+    - `Eco::API::MicroCases#people_search`
+    - `Eco::API::MicroCases#refresh`
+
+### Changed
+### Fixed
+  - `Eco::API::Policies::DefaultPolicies::UserAccess` typos in default api policy
+
+## [1.5.14] - 2021-02-05
 
 ### Added
   - `Eco::API::Policies::DefaultPolicies` policies that are run always (after the custom policies)

data/eco-helpers.gemspec

@@ -3,37 +3,39 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 require "./lib/eco/version"
 
-Gem::Specification.new do |s|
-  s.name          = "eco-helpers"
-  s.version       = Eco::VERSION
-  s.platform      = Gem::Platform::RUBY
-  s.authors       = ["Oscar Segura"]
-  s.email         = ["oscar@ecoportal.co.nz"]
-  s.date          = %q{2018-09-05}
-  s.summary       = %q{eco-helpers to manage people api cases}
-  s.homepage      = "https://www.ecoportal.com"
-  s.licenses      = %w[MIT]
-  s.required_ruby_version = '>= 2.4.4'
-
-  s.files         = `git ls-files -z`.split("\x0").reject do |f|
+Gem::Specification.new do |spec|
+  spec.name          = "eco-helpers"
+  spec.version       = Eco::VERSION
+  spec.platform      = Gem::Platform::RUBY
+  spec.authors       = ["Oscar Segura"]
+  spec.email         = ["oscar@ecoportal.co.nz"]
+  spec.date          = %q{2018-09-05}
+  spec.summary       = %q{eco-helpers to manage people api cases}
+  spec.homepage      = "https://www.ecoportal.com"
+  spec.licenses      = %w[MIT]
+
+  spec.required_ruby_version = '>= 2.4.4'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
     f.match(%r{^(test|spec|features)/})
   end
 
-  #s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
-  #s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-  s.require_paths = ["lib"]
-
-  s.add_development_dependency "bundler",   ">= 2.1.3",  "< 2.2"
-  s.add_development_dependency "rspec",     ">= 3.9",    "< 4"
-  s.add_development_dependency "rake",      ">= 12.3.0", "< 13"
-  s.add_development_dependency "yard",      ">= 0.9.18", "< 0.10"
-  s.add_development_dependency "redcarpet", ">= 3.5.0",  "< 3.6"
-
-  s.add_dependency 'ecoportal-api', '>= 0.7.4', '< 0.8'
-  s.add_dependency 'ecoportal-api-oozes', '>= 0.7.3', '< 0.8'
-  s.add_dependency 'aws-sdk-s3',    '>= 1.64.0', '< 2'
-  s.add_dependency 'aws-sdk-ses',   '>= 1.29.0', '< 2'
-  s.add_dependency 'dotenv',        '>= 2.7.0', '< 2.8'
-  s.add_dependency 'net-sftp',      '>= 2.1.2', '< 2.2'
+  #spec.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  #spec.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler",   ">= 2.2.11",  "< 2.3"
+  spec.add_development_dependency "rspec",     ">= 3.10.0", "< 3.11"
+  spec.add_development_dependency "rake",      ">= 13.0.3", "< 13.1"
+  spec.add_development_dependency "yard",      ">= 0.9.26", "< 0.10"
+  spec.add_development_dependency "redcarpet", ">= 3.5.1",  "< 3.6"
+
+  spec.add_dependency 'ecoportal-api', '>= 0.8.1', '< 0.9'
+  #spec.add_dependency 'ecoportal-api', '>= 0.7.5', '< 0.8'
+  spec.add_dependency 'ecoportal-api-v2', '>= 0.8.3', '< 0.9'
+  spec.add_dependency 'aws-sdk-s3',    '>= 1.83.0', '< 2'
+  spec.add_dependency 'aws-sdk-ses',   '>= 1.36.0', '< 2'
+  spec.add_dependency 'dotenv',        '>= 2.7.6', '< 2.8'
+  spec.add_dependency 'net-sftp',      '>= 3.0.0', '< 3.1'
 
 end

data/lib/eco/api.rb

@@ -1,5 +1,5 @@
 require 'ecoportal/api'
-require 'ecoportal/api-oozes'
+require 'ecoportal/api-v2'
 
 module Eco
   module API

data/lib/eco/api/common/class_helpers.rb

@@ -3,7 +3,7 @@ module Eco
     module Common
       module ClassHelpers
 
-        # Creates an class and instance object methods with name `name` to resolve `klass` name
+        # Creates a class and instance object methods with name `name` to resolve `klass` name
         def class_resolver(name, klass)
           define_singleton_method(name) { resolve_class(klass) }
           define_method(name) { self.class.resolve_class(klass) }
@@ -39,6 +39,15 @@ module Eco
           end.join("")
         end
 
+        # Helper to create an instance variable `name`
+        # @param [String, Symbol] the name of the variable
+        # @reutrn [String] the name of the created instance variable
+        def instance_variable_name(name)
+          str = name.to_s
+          str = "@#{str}" unless str.start_with?("@")
+          str
+        end
+
         # If the class for `name` exists, it returns it. Otherwise it generates it.
         # @param name [String, Symbol] the name of the new class
         # @param inherits [Class] the parent class to _inherit_ from
@@ -92,6 +101,41 @@ module Eco
           descendants(parent_class: parent_class, direct: direct).length > 0
         end
 
+        # Keeps track on class instance variables that should be inherited by child classes.
+        # @note
+        #   - subclasses will inherit the value as is at that moment
+        #   - any change afterwards will be only on the specific class (in line with class instance variables)
+        #   - adapted from https://stackoverflow.com/a/10729812/4352306
+        # TODO: this separates the logic of the method to the instance var. Think if would be possible to join them somehow.
+        def inheritable_class_vars(*vars)
+          @inheritable_class_vars ||= [:inheritable_class_vars]
+          @inheritable_class_vars += vars
+        end
+
+        # Builds the attr_reader and attr_writer of `attrs` and registers the associated instance variable as inheritable.
+        def inheritable_attrs(*attrs)
+          attrs.each do |attr|
+            class_eval %(
+              class << self; attr_accessor :#{attr} end
+            )
+          end
+          inheritable_class_vars(*attrs)
+        end
+
+        # This callback method is called whenever a subclass of the current class is created.
+        # @note
+        #   - values of the instance variables are copied as they are (no dups or clones)
+        #   - the above means: avoid methods that change the state of the mutable object on it
+        #   - mutating methods would reflect the changes on other classes as well
+        #   - therefore, `freeze` will be called on the values that are inherited.
+        def inherited(subclass)
+          inheritable_class_vars.each do |var|
+            instance_var = instance_variable_name(var)
+            value        = instance_variable_get(instance_var)
+            subclass.instance_variable_set(instance_var, value.freeze)
+          end
+        end
+
       end
     end
   end

data/lib/eco/api/common/loaders/error_handler.rb

@@ -16,6 +16,8 @@ module Eco
             end
           end
 
+          inheritable_class_vars :error
+          
           def initialize(handlers)
             raise "Expected Eco::API::Policies. Given #{handlers.class}" unless handlers.is_a?(Eco::API::Error::Handlers)
             handlers.on(self.error, &self.method(:main))

data/lib/eco/api/common/loaders/parser.rb

@@ -60,6 +60,8 @@ module Eco
               end
             end
 
+            private
+
             # Helper to obtain the current internal named attributes of the data
             # @param source_data [Array<String>, Hash] if `Array` those are already the `keys`, if `Hash` it gets the `keys`
             # @return [Array<String>] `keys` of `source_data`
@@ -76,6 +78,8 @@ module Eco
 
           end
 
+          inheritable_class_vars :attribute
+
           def initialize(person_parser)
             raise "Expected Eco::API::Common::People::PersonParser. Given #{policies.class}" unless person_parser.is_a?(Eco::API::Common::People::PersonParser)
             person_parser.define_attribute(self.attribute, dependencies: self.class.dependencies) do |attr_parser|

data/lib/eco/api/common/loaders/use_case.rb

@@ -14,6 +14,8 @@ module Eco
             end
           end
 
+          inheritable_class_vars :type
+
           def initialize(usecases)
             raise "Expected Eco::API::UseCases. Given #{usecases.class}" unless usecases.is_a?(Eco::API::UseCases)
             usecases.define(self.name, type: self.type, &self.method(:main))

data/lib/eco/api/common/people/person_parser.rb

@@ -99,9 +99,16 @@ module Eco
           #  - the list is sorted according `CORE_ATTRS` + `ACCOUNT_ATTRS` + schema attrs
           # @return [Array<String>] list of all attribute defined parsers.
           def defined_attrs
-            defined = @parsers.keys
-            defined = (all_attrs || defined) && defined
-            defined - (defined - all_attrs)
+            defined     = @parsers.keys
+            defined     = (all_attrs | defined) & defined
+            defined - symbol_keys
+          end
+
+          # Symbol keys are type or import parsers (that do not belong to the model)
+          # @note this was introduced to boost virtual fields to treat in different phases of the parsing process
+          # @return [Array<Symbol>] all the parsers defined as Symbol
+          def symbol_keys
+            @parsers.keys.select {|k| k.is_a?(Symbol)}
           end
 
           # Returns a list of all the internal attributes of the model that have a parser defined & that should be active.

data/lib/eco/api/common/version_patches/ecoportal_api/external_person.rb

@@ -13,6 +13,15 @@ module Ecoportal
           original_doc["details"] = JSON.parse(doc["details"])
         end
 
+        def identify
+          if entry
+            entry.to_s(:identify)
+          else
+            str_id = id ? "id: '#{id}'; " : ""
+            "#{name}' (#{str_id}ext_id: '#{external_id}'; email: '#{email}')"
+          end
+        end
+
       end
     end
   end

data/lib/eco/api/microcases/people_cache.rb

@@ -6,7 +6,14 @@ module Eco
       # @return [Eco::API::Organization::People] the `People` object with the data.
       def people_cache(filename = enviro.config.people.cache)
         logger.info("Going to get all the people via API")
+
+        start = Time.now
         people = session.batch.get_people
+        secs    = Time.now - start
+        cnt     = people.count
+        per_sec = (cnt.to_f / secs).floor
+        logger.info("Loaded #{cnt} people in #{secs} seconds (#{per_sec} people/sec)")
+
         file   = file_manager.save_json(people, filename, :timestamp)
         logger.info("#{people.length} people loaded and saved locally to #{file}.")
         Eco::API::Organization::People.new(people)

data/lib/eco/api/microcases/people_load.rb

@@ -18,27 +18,35 @@ module Eco
       def people_load(filename = enviro.config.people.cache, modifier: [:newest, :api])
         modifier  = [modifier].flatten
         load_file = [:file, :newest].any? {|flag| modifier.include?(flag)}
-        people    = case
-                    when filename && load_file
-                      if file = people_load_filename(filename, newest: modifier.include?(:newest))
-                        file_manager.load_json(file).tap do |people|
-                          logger.info("#{people&.length} people loaded from file #{file}") if people.is_a?(Array)
-                        end
-                      else
-                        logger.error("could not find the file #{file_manager.dir.file(filename)}")
-                        exit unless modifier.include?(:api)
-                        people_load(modifier: modifier - [:newest, :file])
-                      end
-                    when modifier.include?(:api)
-                      logger.info("Going to get all the people via API")
-                      session.batch.get_people.tap do |people|
-                        if modifier.include?(:save) && people && people.length > 0
-                          file = file_manager.save_json(people, filename, :timestamp)
-                          logger.info("#{people.length } people saved to file #{file}.")
-                        end
-                      end
-                    end
-        Eco::API::Organization::People.new(people)
+        case
+        when filename && load_file
+          if file = people_load_filename(filename, newest: modifier.include?(:newest))
+            file_manager.load_json(file).tap do |people|
+              logger.info("#{people&.length} people loaded from file #{file}") if people.is_a?(Array)
+            end
+          else
+            logger.error("could not find the file #{file_manager.dir.file(filename)}")
+            exit unless modifier.include?(:api)
+            people_load(modifier: modifier - [:newest, :file])
+          end
+        when modifier.include?(:api)
+          logger.info("Going to get all the people via API")
+
+          start = Time.now
+          session.batch.get_people.tap do |people|
+            secs    = Time.now - start
+            cnt     = people.count
+            per_sec = (cnt.to_f / secs).floor
+            logger.info("Loaded #{cnt} people in #{secs} seconds (#{per_sec} people/sec)")
+
+            if modifier.include?(:save) && people && people.length > 0
+              file = file_manager.save_json(people, filename, :timestamp)
+              logger.info("#{people.length } people saved to file #{file}.")
+            end
+          end
+        end.yield_self do |people|
+          Eco::API::Organization::People.new(people)
+        end
       end
 
       private

data/lib/eco/api/microcases/people_refresh.rb

@@ -18,7 +18,13 @@ module Eco
         msg  = "Going to refresh #{people.length} people with server data"
         msg += " (including #{created} that were created)" if created > 0
         logger.info(msg)
+
+        start = Time.now
         entries = session.batch.get_people(people, silent: true)
+        secs    = Time.now - start
+        cnt     = entries.count
+        per_sec = (cnt.to_f / secs).floor
+        logger.info("Re-loaded #{cnt} people (out of #{people.length}) in #{secs} seconds (#{per_sec} people/sec)")
 
         missing = people.length - entries.length
         logger.error("Missed to obtain #{missing} people during the refresh") if missing > 0

data/lib/eco/api/microcases/people_search.rb

@@ -11,24 +11,49 @@ module Eco
       # @return [Eco::API::Organization::People] the `People` object with the found persons.
       def people_search(data, options: {}, silent: true)
         session.logger.info("Going to api get #{data.length} entries...")
-        status = session.batch.search(data, silent: silent)
-        people = Eco::API::Organization::People.new(status.people)
-        session.logger.info("... could get #{people.length} people (out of #{data.length} entries)")
+
+        start = Time.now
+        people = session.batch.search(data, silent: silent).yield_self do |status|
+          secs    = Time.now - start
+          Eco::API::Organization::People.new(status.people).tap do |people|
+            cnt     = people.count
+            per_sec = (cnt.to_f / secs).floor
+            msg     = "... could get #{cnt} people (out of #{data.length} entries) in #{secs} seconds (#{per_sec} people/sec)"
+            session.logger.info(msg)
+          end
+        end
 
         # get the supervisors of found people (current supervisors)
         supers = people_search_prepare_supers_request(people)
         if supers.length > 0
           session.logger.info("  Going to api get #{supers.length} current supervisors...")
-          status = session.batch.search(supers, silent: silent)
-          people = people.merge(status.people, strict: micro.strict_search?(options))
+          start = Time.now
+          people = session.batch.search(supers, silent: silent).yield_self do |status|
+            secs    = Time.now - start
+            found   = status.people
+            cnt     = found.count
+            per_sec = (cnt.to_f / secs).floor
+            msg     = "... could find #{cnt} current supers (out of #{supers.length}) in #{secs} seconds (#{per_sec} people/sec)"
+            session.logger.info(msg)
+            people.merge(found, strict: micro.strict_search?(options))
+          end
         end
 
         # get the supervisors referred in the input data (future supervisors)
         supers = people_search_prepare_supers_request(data, people)
         if supers.length > 0
-          session.logger.info("  Going to api get #{supers.length} supervisors as per entries...")
-          status = session.batch.search(supers, silent: silent)
-          people = people.merge(status.people, strict: micro.strict_search?(options))
+          session.logger.info("  Going to api get #{supers.length} supervisors as per input entries...")
+          start = Time.now
+
+          people = session.batch.search(supers, silent: silent).yield_self do |status|
+            secs    = Time.now - start
+            found   = status.people
+            cnt     = found.count
+            per_sec = (cnt.to_f / secs).floor
+            msg     = "... could find #{cnt} input supers (out of #{supers.length}) in #{secs} seconds (#{per_sec} people/sec)"
+            session.logger.info(msg)
+            people.merge(found, strict: micro.strict_search?(options))
+          end
         end
 
         session.logger.info("Finally got #{people.length} people (out of #{data.length} entries)")

data/lib/eco/api/policies/default_policies/99_user_access_policy.rb

@@ -1,18 +1,18 @@
 class Eco::API::Policies::DefaultPolicies::UserAccess < Eco::API::Common::Loaders::Policy
   name "default-user-access"
 
-  attr_reader :session, :options
+  attr_reader   :session, :options, :job
   attr_accessor :account_removed_count
 
   def main(people, session, options, policy, job)
-    @session = session; @options = options
+    @session = session; @options = options; @job = job
 
     self.account_removed_count = 0
 
     people.each do |person|
-      remove_account_when_no_email!(person) if person.email.to_s.empty?
-      account.policy_group_ids = [defid]    if no_policy_group_ids?(person)
-      refresh_abilities!(person.account)
+      remove_account_when_no_email!(person)    if person.email.to_s.empty?
+      person.account.policy_group_ids = defid  if no_policy_group_ids?(person)
+      refresh_abilities!(person)
     end
 
     warn_account_removal!
@@ -22,14 +22,14 @@ class Eco::API::Policies::DefaultPolicies::UserAccess < Eco::API::Common::Loader
 
   def warn_account_removal!
     if account_removed_count > 0
-      msg = "Removed account to #{account_removed_count} people"
+      msg = "(DefaultPolicy on job '#{job.name}') Removed account to #{account_removed_count} people"
       session.logger.warn(msg)
     end
   end
 
   def remove_account_when_no_email!(person)
     if person.account
-      account_removed_count += 1 if had_account?(person)
+      self.account_removed_count += 1 if had_account?(person)
       person.account = nil
     end
   end
@@ -40,23 +40,11 @@ class Eco::API::Policies::DefaultPolicies::UserAccess < Eco::API::Common::Loader
     return !!person.original_doc["account"]
   end
 
-  def provision_basic_level!(person)
-    if account = person.account
-
-      unless options.dig(:exclude, :abilities)
-        account.permissions_custom = session.new_preset(person)
-
-        if no_abilities?(person)
-          account.permissions_custom = min_abilities
-        end
-      end
-
-    end
-  end
-
-  def refresh_abilities!(account)
-    return nil unless account
-
+  def refresh_abilities!(person)
+    return nil if options.dig(:exclude, :abilities)
+    return nil unless account = person.account
+    account.permissions_custom = session.new_preset(person)
+    account.permissions_custom = min_abilities if no_abilities?(person)
   end
 
   def no_policy_group_ids?(person)
@@ -64,8 +52,8 @@ class Eco::API::Policies::DefaultPolicies::UserAccess < Eco::API::Common::Loader
   end
 
   def no_abilities?(person)
-    person.account.permissions_custom &&
-    person.account.permissions_custom.values.all?(&:nil?)
+    return true unless account = person.account
+    account.permissions_custom && account.permissions_custom.values.all?(&:nil?)
   end
 
   def min_abilities
@@ -86,14 +74,14 @@ class Eco::API::Policies::DefaultPolicies::UserAccess < Eco::API::Common::Loader
   end
 
   def defid
-    @defid ||= policy_groups.to_id(default_group)
+    @defid ||= policy_groups.to_id([default_group]).compact
   end
 
   def default_group
     session.config.people.default_usergroup
   end
 
-  def pgs
+  def policy_groups
     session.policy_groups
   end
 

data/lib/eco/api/session/batch.rb

@@ -88,10 +88,7 @@ module Eco
 
         def get(params: {}, silent: false)
           fatal "cannot batch get without api connnection, please provide a valid api connection!" unless people_api = api&.people
-
           params = {per_page: DEFAULT_BATCH_BLOCK}.merge(params)
-          client = people_api.client
-
           return people_api.get_all(params: params, silent: silent)
         end
 

data/lib/eco/api/session/config/workflow.rb

@@ -195,6 +195,7 @@ module Eco
           # @yieldreturn [Eco::API::UseCases::BaseIO] the `io` input/output object carried througout all the _workflow_
           # @return [Eco::API::Session::Config::Workflow] the current stage object (to ease chainig).
           def run(key = nil, io:, &block)
+            raise "Missing BaseIO object" unless io.is_a?(Eco::API::UseCases::BaseIO)
             begin
               if key
                 io = stage(key).run(io: io, &block)

data/lib/eco/api/usecases.rb

@@ -160,3 +160,4 @@ require_relative 'usecases/use_case_chain'
 require_relative 'usecases/base_io'
 require_relative 'usecases/use_case_io'
 require_relative 'usecases/default_cases'
+require_relative 'usecases/ooze_samples'

data/lib/eco/api/usecases/ooze_samples.rb

@@ -0,0 +1,11 @@
+module Eco
+  module API
+    class UseCases
+      class OozeSamples
+
+      end
+    end
+  end
+end
+
+require_relative 'ooze_samples/ooze_update_case'

data/lib/eco/api/usecases/ooze_samples/ooze_update_case.rb

@@ -0,0 +1,131 @@
+class Eco::API::UseCases::OozeSamples::OozeUpdateCase < Eco::API::Common::Loaders::UseCase
+  name "single-ooze-case"
+  type :other
+
+  attr_reader :session, :options, :usecase
+
+  SAVE_PATCH = "ooze_patch_update.json"
+
+  def main(session, options, usecase)
+    @session = session; @options = options; @usecase = usecase
+    yield
+    end_script!
+  end
+
+  private
+
+  def end_script!
+    exit_if_no_changes!
+    backup_patch!
+    launch_request unless options[:simulate]
+    exit(0)
+  end
+
+  def ooze_id
+    options.dig(:source, :ooze_id)
+  end
+
+  def stage_id
+    options.dig(:source, :stage_id)
+  end
+
+  def stage(id_name = stage_id)
+    if stg = ooze.stages[id_name] || ooze.stages.get_by_name(id_name)
+      return apiv2.pages.get(ooze_id, stage_id: stg.id).tap do |stage|
+        if stage
+          new_target(stage)
+          logger.info("Got #{object_reference(stage)} from #{object_reference(ooze)}")
+        else
+          logger.error("Could not get stage '#{id_name}' in ooze '#{ooze_id}'")
+          exit(1)
+        end
+      end
+    end
+    raise "Stage '#{id_name}' doesn't exist in ooze '#{ooze_id}'"
+  end
+
+  def ooze
+    @ooze ||= apiv2.pages.get(ooze_id).tap do |ooze|
+      if ooze
+        new_target(ooze)
+        logger.info("Got #{object_reference(ooze)}")
+      else
+        logger.error("Could not get ooze '#{ooze_id}'")
+        exit(1)
+      end
+    end
+  end
+
+  def launch_request
+    prompt_to_confirm!
+
+    apiv2.pages.update(target).tap do |response|
+      if response.success?
+        logger.info("All went OK")
+      else
+        logger.error(response.body)
+      end
+    end
+  end
+
+  def exit_if_no_changes!
+    unless changes = !!patch_doc["page"]
+      logger.warn "No Changes!!"
+      exit(0)
+    end
+  end
+
+  def apiv2
+   @apiv2 ||= session.api(version: :oozes)
+  end
+
+  def target
+    @target
+  end
+
+  def new_target(object)
+    if @target && patch_doc["page"]
+      logger.warn "You you are switching to a new target #{object_reference(object)} after doing unsaved changes to #{object_reference(@target)}"
+    end
+    @target = object
+  end
+
+  def object_reference(obj)
+    return "No reference" unless obj
+    "".tap do |ref|
+      case obj
+      when Ecoportal::API::V2::Page::Stage
+        ref << "Stage "
+      when Ecoportal::API::V2::Pages::PageStage
+        ref << "StagePage "
+      when Ecoportal::API::V2::Page
+        ref << "Page "
+      end
+      ref << "'#{obj.name}' " if obj.respond_to?(:name)
+    end
+  end
+
+
+  def patch_doc
+    apiv2.pages.get_body(target)
+  end
+
+  def backup_patch!
+    # store the request
+    File.open(SAVE_PATCH, "w") do |file|
+      #file << (patch_doc || {}).to_json
+      file << JSON.pretty_generate(patch_doc || {})
+    end
+    puts "Saved patch at: #{File.expand_path(SAVE_PATCH)}"
+  end
+
+  def logger
+    session.logger
+  end
+
+  def prompt_to_confirm!
+    print "\nDo you want to proceed (y/N)?  "
+    exit(1) unless $stdin.gets.chomp.to_s.downcase == "y"
+  end
+
+end

data/lib/eco/version.rb

@@ -1,3 +1,3 @@
 module Eco
-  VERSION = "1.5.14"
+  VERSION = "2.0.5"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: eco-helpers
 version: !ruby/object:Gem::Version
-  version: 1.5.14
+  version: 2.0.5
 platform: ruby
 authors:
 - Oscar Segura
@@ -16,67 +16,67 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.1.3
+        version: 2.2.11
     - - "<"
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '2.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.1.3
+        version: 2.2.11
     - - "<"
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '2.3'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.9'
+        version: 3.10.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: '4'
+        version: '3.11'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '3.9'
+        version: 3.10.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: '4'
+        version: '3.11'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 12.3.0
+        version: 13.0.3
     - - "<"
       - !ruby/object:Gem::Version
-        version: '13'
+        version: '13.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 12.3.0
+        version: 13.0.3
     - - "<"
       - !ruby/object:Gem::Version
-        version: '13'
+        version: '13.1'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.18
+        version: 0.9.26
     - - "<"
       - !ruby/object:Gem::Version
         version: '0.10'
@@ -86,7 +86,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.18
+        version: 0.9.26
     - - "<"
       - !ruby/object:Gem::Version
         version: '0.10'
@@ -96,7 +96,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.5.0
+        version: 3.5.1
     - - "<"
       - !ruby/object:Gem::Version
         version: '3.6'
@@ -106,7 +106,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.5.0
+        version: 3.5.1
     - - "<"
       - !ruby/object:Gem::Version
         version: '3.6'
@@ -116,47 +116,47 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.7.4
+        version: 0.8.1
     - - "<"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '0.9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.7.4
+        version: 0.8.1
     - - "<"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '0.9'
 - !ruby/object:Gem::Dependency
-  name: ecoportal-api-oozes
+  name: ecoportal-api-v2
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.7.3
+        version: 0.8.3
     - - "<"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '0.9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.7.3
+        version: 0.8.3
     - - "<"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '0.9'
 - !ruby/object:Gem::Dependency
   name: aws-sdk-s3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.64.0
+        version: 1.83.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '2'
@@ -166,7 +166,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.64.0
+        version: 1.83.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '2'
@@ -176,7 +176,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.29.0
+        version: 1.36.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '2'
@@ -186,7 +186,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.29.0
+        version: 1.36.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '2'
@@ -196,7 +196,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.7.0
+        version: 2.7.6
     - - "<"
       - !ruby/object:Gem::Version
         version: '2.8'
@@ -206,7 +206,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.7.0
+        version: 2.7.6
     - - "<"
       - !ruby/object:Gem::Version
         version: '2.8'
@@ -216,20 +216,20 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.1.2
+        version: 3.0.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '3.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.1.2
+        version: 3.0.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '3.1'
 description: 
 email:
 - oscar@ecoportal.co.nz
@@ -405,6 +405,8 @@ files:
 - lib/eco/api/usecases/default_cases/update_case.rb
 - lib/eco/api/usecases/default_cases/update_details_case.rb
 - lib/eco/api/usecases/default_cases/upsert_case.rb
+- lib/eco/api/usecases/ooze_samples.rb
+- lib/eco/api/usecases/ooze_samples/ooze_update_case.rb
 - lib/eco/api/usecases/use_case.rb
 - lib/eco/api/usecases/use_case_chain.rb
 - lib/eco/api/usecases/use_case_io.rb