checkoff 0.58.1 → 0.60.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2b8e1f32a572bfcd4797199e3e8bf40a8bacfe3f20eb117a13f52e5f69feab5
-  data.tar.gz: fe61f004dcc81088a23acee2f2fe03c8cec9fc107d1850cc6450d6bde99bdbdc
+  metadata.gz: 560f8d3dadb4f15e7b3329091bd82e301b23dd479f558e1a637a04aa8bc2067b
+  data.tar.gz: bdfbe8d442602eaa15bb0c995677d88ad4897b8b8f068f04e087ca28ed02d255
 SHA512:
-  metadata.gz: 2e77e9c93328415564d60bc1b3b1ca29bb678ce425477137392acd26d92acd81823a9fa9e6db189ce2a22045ca6dc45df32a8548a9265889e95f86196d238b1e
-  data.tar.gz: 516063b25c108b17ac6039c3890cf375a623078b913a33fecb019ae4c9a4f76e2a1f3995fae4cb3c529d5dddcb2d9076f5ec07e940a464ed13330c5b63ab3fbd
+  metadata.gz: 5044cbdbe5d31947c795bdf3ca9d90ab71614059779c1a3ac3a3c19430a227ca89a1ee9ff661b3c523eef9cc9b019843aae41c4240d321b91725efc7dacc1731
+  data.tar.gz: ab7bf654fdd30941dfe00ad78351b6b5aa36275b36103b491954f953cf10a643a16d6895cb8c091db52b3586ea3fbe7c12f0be94beecd2498a83242a07d781ab

data/Gemfile.lock

@@ -12,7 +12,7 @@ GIT
 PATH
   remote: .
   specs:
-    checkoff (0.58.1)
+    checkoff (0.60.0)
       activesupport
       asana (> 0.10.0)
       cache_method
@@ -22,17 +22,24 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (7.0.8)
+    activesupport (7.1.0)
+      base64
+      bigdecimal
       concurrent-ruby (~> 1.0, >= 1.0.2)
+      connection_pool (>= 2.2.5)
+      drb
       i18n (>= 1.6, < 2)
       minitest (>= 5.1)
+      mutex_m
       tzinfo (~> 2.0)
     addressable (2.8.1)
       public_suffix (>= 2.0.2, < 6.0)
     ansi (1.5.0)
     ast (2.4.2)
     backport (1.2.0)
+    base64 (0.1.1)
     benchmark (0.2.1)
+    bigdecimal (3.1.4)
     builder (3.2.4)
     bump (0.10.0)
     cache (0.4.1)
@@ -43,11 +50,14 @@ GEM
     childprocess (4.1.0)
     coderay (1.1.3)
     concurrent-ruby (1.2.2)
+    connection_pool (2.4.1)
     crack (0.4.5)
       rexml
     dalli (3.2.6)
     diff-lcs (1.5.0)
     docile (1.4.0)
+    drb (2.1.1)
+      ruby2_keywords
     e2mmap (0.1.0)
     fakeweb (1.3.0)
     faraday (1.5.1)
@@ -110,6 +120,7 @@ GEM
     multi_json (1.15.0)
     multi_xml (0.6.0)
     multipart-post (2.1.1)
+    mutex_m (0.1.2)
     nokogiri (1.15.2)
       mini_portile2 (~> 2.8.2)
       racc (~> 1.4)

data/lib/checkoff/internal/project_selector_evaluator.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require_relative 'selector_classes/common'
+require_relative 'selector_classes/project'
+require_relative 'selector_evaluator'
+
+module Checkoff
+  # Evaluates project selectors against a project
+  class ProjectSelectorEvaluator < SelectorEvaluator
+    # @param project [Asana::Resources::Project]
+    # @param projects [Checkoff::Projects]
+    def initialize(project:,
+                   projects: Checkoff::Projects.new)
+      @item = project
+      @projects = projects
+      super()
+    end
+
+    private
+
+    COMMON_FUNCTION_EVALUATORS = (Checkoff::SelectorClasses::Common.constants.map do |const|
+      Checkoff::SelectorClasses::Common.const_get(const)
+    end - [Checkoff::SelectorClasses::Common::FunctionEvaluator]).freeze
+
+    PROJECT_FUNCTION_EVALUATORS = (Checkoff::SelectorClasses::Project.constants.map do |const|
+      Checkoff::SelectorClasses::Project.const_get(const)
+    end - [Checkoff::SelectorClasses::Project::FunctionEvaluator]).freeze
+
+    FUNCTION_EVALUTORS = (COMMON_FUNCTION_EVALUATORS + PROJECT_FUNCTION_EVALUATORS).freeze
+
+    # @return [Array<Class<ProjectSelectorClasses::FunctionEvaluator>>]
+    def function_evaluators
+      FUNCTION_EVALUTORS
+    end
+
+    # @return [Hash]
+    def initializer_kwargs
+      { projects: projects }
+    end
+
+    # @return [Asana::Resources::Project]
+    attr_reader :item
+    # @return [Checkoff::Projects]
+    attr_reader :projects
+  end
+end

data/lib/checkoff/internal/search_url/simple_param_converter.rb

@@ -70,6 +70,14 @@ module Checkoff
           end
         end
 
+        # Handle 'portfolios.ids' search url param
+        class PortfoliosIds < SimpleParam
+          # @return [Array<String>]
+          def convert
+            { 'portfolios.any' => single_value.split('~').join(',') }.to_a.flatten
+          end
+        end
+
         # Handle 'any_projects.ids' search url param
         class AnyProjectsIds < SimpleParam
           # @return [Array<String>]
@@ -188,6 +196,7 @@ module Checkoff
 
         # @type [Hash<String, Class<SimpleParam::SimpleParam>>] the mapping from param name to class
         ARGS = {
+          'portfolios.ids' => SimpleParam::PortfoliosIds,
           'any_projects.ids' => SimpleParam::AnyProjectsIds,
           'not_projects.ids' => SimpleParam::NotProjectsIds,
           'completion' => SimpleParam::Completion,

data/lib/checkoff/internal/selector_classes/common/function_evaluator.rb

@@ -0,0 +1,158 @@
+# frozen_string_literal: true
+
+require_relative '../function_evaluator'
+
+module Checkoff
+  module SelectorClasses
+    module Common
+      # Base class to evaluate a project selector function given fully evaluated arguments
+      class FunctionEvaluator < ::Checkoff::SelectorClasses::FunctionEvaluator
+        # @param selector [Array<(Symbol, Array)>,String]
+        def initialize(selector:, **_kwargs)
+          @selector = selector
+          super()
+        end
+
+        private
+
+        # @param project [Asana::Resources::Project]
+        # @param field_name [Symbol]
+        #
+        # @sg-ignore
+        # @return [Date, nil]
+        def pull_date_field_by_name(project, field_name)
+          if field_name == :modified
+            return Time.parse(project.modified_at).to_date unless project.modified_at.nil?
+
+            return nil
+          end
+
+          if field_name == :due
+            return Time.parse(project.due_at).to_date unless project.due_at.nil?
+
+            return Date.parse(project.due_on) unless project.due_on.nil?
+
+            return nil
+          end
+
+          raise "Teach me how to handle field #{field_name}"
+        end
+
+        # @param project [Asana::Resources::Project]
+        # @param field_name [Symbol]
+        #
+        # @sg-ignore
+        # @return [Date, Time, nil]
+        def pull_date_or_time_field_by_name(project, field_name)
+          if field_name == :due
+            return Time.parse(project.due_at) unless project.due_at.nil?
+
+            return Date.parse(project.due_on) unless project.due_on.nil?
+
+            return nil
+          end
+
+          if field_name == :start
+            return Time.parse(project.start_at) unless project.start_at.nil?
+
+            return Date.parse(project.start_on) unless project.start_on.nil?
+
+            return nil
+          end
+
+          raise "Teach me how to handle field #{field_name}"
+        end
+
+        # @sg-ignore
+        # @param project [Asana::Resources::Project]
+        # @param custom_field_gid [String]
+        # @return [Hash]
+        def pull_custom_field_or_raise(project, custom_field_gid)
+          # @type [Array<Hash>]
+          custom_fields = project.custom_fields
+          if custom_fields.nil?
+            raise "Could not find custom_fields under project (was 'custom_fields' included in 'extra_fields'?)"
+          end
+
+          # @sg-ignore
+          # @type [Hash, nil]
+          matched_custom_field = custom_fields.find { |data| data.fetch('gid') == custom_field_gid }
+          if matched_custom_field.nil?
+            raise "Could not find custom field with gid #{custom_field_gid} " \
+                  "in project #{project.gid} with custom fields #{custom_fields}"
+          end
+
+          matched_custom_field
+        end
+
+        # @return [Array<(Symbol, Array)>]
+        attr_reader :selector
+
+        # @sg-ignore
+        # @param custom_field [Hash]
+        # @return [Array<String>]
+        def pull_enum_values(custom_field)
+          resource_subtype = custom_field.fetch('resource_subtype')
+          case resource_subtype
+          when 'enum'
+            [custom_field.fetch('enum_value')]
+          when 'multi_enum'
+            custom_field.fetch('multi_enum_values')
+          else
+            raise "Teach me how to handle resource_subtype #{resource_subtype}"
+          end
+        end
+
+        # @param custom_field [Hash]
+        # @param enum_value [Object, nil]
+        # @return [Array<String>]
+        def find_gids(custom_field, enum_value)
+          if enum_value.nil?
+            []
+          else
+            raise "Unexpected enabled value on custom field: #{custom_field}" if enum_value.fetch('enabled') == false
+
+            [enum_value.fetch('gid')]
+          end
+        end
+
+        # @param project [Asana::Resources::Project]
+        # @param custom_field_gid [String]
+        # @return [Array<String>]
+        def pull_custom_field_values_gids(project, custom_field_gid)
+          custom_field = pull_custom_field_or_raise(project, custom_field_gid)
+          pull_enum_values(custom_field).flat_map do |enum_value|
+            find_gids(custom_field, enum_value)
+          end
+        end
+
+        # @sg-ignore
+        # @param project [Asana::Resources::Project]
+        # @param custom_field_name [String]
+        # @return [Hash, nil]
+        def pull_custom_field_by_name(project, custom_field_name)
+          custom_fields = project.custom_fields
+          if custom_fields.nil?
+            raise "custom fields not found on project - did you add 'custom_fields' in your extra_fields argument?"
+          end
+
+          # @sg-ignore
+          # @type [Hash, nil]
+          custom_fields.find { |field| field.fetch('name') == custom_field_name }
+        end
+
+        # @param project [Asana::Resources::Project]
+        # @param custom_field_name [String]
+        # @return [Hash]
+        def pull_custom_field_by_name_or_raise(project, custom_field_name)
+          custom_field = pull_custom_field_by_name(project, custom_field_name)
+          if custom_field.nil?
+            raise "Could not find custom field with name #{custom_field_name} " \
+                  "in project #{project.gid} with custom fields #{project.custom_fields}"
+          end
+          custom_field
+        end
+      end
+    end
+  end
+end

data/lib/checkoff/internal/selector_classes/common.rb

@@ -0,0 +1,226 @@
+# frozen_string_literal: true
+
+require_relative 'common/function_evaluator'
+
+module Checkoff
+  module SelectorClasses
+    module Common
+      # :and function
+      class AndFunctionEvaluator < FunctionEvaluator
+        FUNCTION_NAME = :and
+
+        def matches?
+          fn?(selector, FUNCTION_NAME)
+        end
+
+        # @param _resource [Asana::Resources::Task,Asana::Resources::Project]
+        # @param lhs [Object]
+        # @param rhs [Object]
+        # @return [Object]
+        def evaluate(_resource, lhs, rhs)
+          lhs && rhs
+        end
+      end
+
+      # :or function
+      #
+      # Does not yet shortcut, but may in future - be careful with side
+      # effects!
+      class OrFunctionEvaluator < FunctionEvaluator
+        FUNCTION_NAME = :or
+
+        def matches?
+          fn?(selector, FUNCTION_NAME)
+        end
+
+        # @param _resource [Asana::Resources::Task,Asana::Resources::Project]
+        # @param lhs [Object]
+        # @param rhs [Object]
+        # @return [Object]
+        def evaluate(_resource, lhs, rhs)
+          lhs || rhs
+        end
+      end
+
+      # :not function
+      class NotFunctionEvaluator < FunctionEvaluator
+        FUNCTION_NAME = :not
+
+        def matches?
+          fn?(selector, FUNCTION_NAME)
+        end
+
+        # @param _resource [Asana::Resources::Task,Asana::Resources::Project]
+        # @param subvalue [Object]
+        # @return [Boolean]
+        def evaluate(_resource, subvalue)
+          !subvalue
+        end
+      end
+
+      # :nil? function
+      class NilPFunctionEvaluator < FunctionEvaluator
+        def matches?
+          fn?(selector, :nil?)
+        end
+
+        # @param _resource [Asana::Resources::Task,Asana::Resources::Project]
+        # @param subvalue [Object]
+        # @return [Boolean]
+        def evaluate(_resource, subvalue)
+          subvalue.nil?
+        end
+      end
+
+      # :equals? function
+      class EqualsPFunctionEvaluator < FunctionEvaluator
+        FUNCTION_NAME = :equals?
+
+        def matches?
+          fn?(selector, FUNCTION_NAME)
+        end
+
+        # @param _resource [Asana::Resources::Task,Asana::Resources::Project]
+        # @param lhs [Object]
+        # @param rhs [Object]
+        # @return [Boolean]
+        def evaluate(_resource, lhs, rhs)
+          lhs == rhs
+        end
+      end
+
+      # :custom_field_value function
+      class CustomFieldValueFunctionEvaluator < FunctionEvaluator
+        FUNCTION_NAME = :custom_field_value
+
+        def matches?
+          fn?(selector, FUNCTION_NAME)
+        end
+
+        # @param _index [Integer]
+        def evaluate_arg?(_index)
+          false
+        end
+
+        # @param resource [Asana::Resources::Task,Asana::Resources::Project]
+        # @param custom_field_name [String]
+        # @return [String, nil]
+        def evaluate(resource, custom_field_name)
+          custom_field = pull_custom_field_by_name(resource, custom_field_name)
+          return nil if custom_field.nil?
+
+          custom_field['display_value']
+        end
+      end
+
+      # :custom_field_gid_value function
+      class CustomFieldGidValueFunctionEvaluator < FunctionEvaluator
+        def matches?
+          fn?(selector, :custom_field_gid_value)
+        end
+
+        def evaluate_arg?(_index)
+          false
+        end
+
+        # @sg-ignore
+        # @param resource [Asana::Resources::Task,Asana::Resources::Project]
+        # @param custom_field_gid [String]
+        # @return [String, nil]
+        def evaluate(resource, custom_field_gid)
+          custom_field = pull_custom_field_or_raise(resource, custom_field_gid)
+          custom_field['display_value']
+        end
+      end
+
+      # :custom_field_gid_value_contains_any_gid function
+      class CustomFieldGidValueContainsAnyGidFunctionEvaluator < FunctionEvaluator
+        FUNCTION_NAME = :custom_field_gid_value_contains_any_gid
+
+        def matches?
+          fn?(selector, FUNCTION_NAME)
+        end
+
+        def evaluate_arg?(_index)
+          false
+        end
+
+        # @param resource [Asana::Resources::Task,Asana::Resources::Project]
+        # @param custom_field_gid [String]
+        # @param custom_field_values_gids [Array<String>]
+        # @return [Boolean]
+        def evaluate(resource, custom_field_gid, custom_field_values_gids)
+          actual_custom_field_values_gids = pull_custom_field_values_gids(resource, custom_field_gid)
+
+          actual_custom_field_values_gids.any? do |custom_field_value|
+            custom_field_values_gids.include?(custom_field_value)
+          end
+        end
+      end
+
+      # :custom_field_value_contains_any_value
+      class CustomFieldValueContainsAnyValueFunctionEvaluator < FunctionEvaluator
+        FUNCTION_NAME = :custom_field_value_contains_any_value
+
+        def matches?
+          fn?(selector, FUNCTION_NAME)
+        end
+
+        def evaluate_arg?(_index)
+          false
+        end
+
+        # @param resource [Asana::Resources::Task,Asana::Resources::Project]
+        # @param custom_field_name [String]
+        # @param custom_field_values [Array<String>]
+        # @return [Boolean]
+        def evaluate(resource, custom_field_name, custom_field_values)
+          custom_field = pull_custom_field_by_name(resource, custom_field_name)
+
+          return false if custom_field.nil?
+
+          custom_field_values.include?(custom_field.fetch('display_value'))
+        end
+      end
+
+      # :custom_field_gid_value_contains_all_gids function
+      class CustomFieldGidValueContainsAllGidsFunctionEvaluator < FunctionEvaluator
+        FUNCTION_NAME = :custom_field_gid_value_contains_all_gids
+
+        def matches?
+          fn?(selector, FUNCTION_NAME)
+        end
+
+        def evaluate_arg?(_index)
+          false
+        end
+
+        # @param resource [Asana::Resources::Task,Asana::Resources::Project]
+        # @param custom_field_gid [String]
+        # @param custom_field_values_gids [Array<String>]
+        # @return [Boolean]
+        def evaluate(resource, custom_field_gid, custom_field_values_gids)
+          actual_custom_field_values_gids = pull_custom_field_values_gids(resource, custom_field_gid)
+
+          custom_field_values_gids.all? do |custom_field_value|
+            actual_custom_field_values_gids.include?(custom_field_value)
+          end
+        end
+      end
+
+      # String literals
+      class StringLiteralEvaluator < FunctionEvaluator
+        def matches?
+          selector.is_a?(String)
+        end
+
+        # @sg-ignore
+        # @param _resource [Asana::Resources::Task,Asana::Resources::Project]
+        # @return [String]
+        def evaluate(_resource)
+          selector
+        end
+      end
+    end
+  end
+end

data/lib/checkoff/internal/selector_classes/function_evaluator.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Checkoff
+  module SelectorClasses
+    # Base class to evaluate types of selector functions
+    class FunctionEvaluator
+      # @sg-ignore
+      # @param _index [Integer]
+      def evaluate_arg?(_index)
+        true
+      end
+
+      # @sg-ignore
+      # @return [Boolean]
+      def matches?
+        raise 'Override me!'
+      end
+
+      # @param _task [Asana::Resources::Task]
+      # @param _args [Array<Object>]
+      # @return [Object]
+      # @sg-ignore
+      def evaluate(_task, *_args)
+        raise 'Implement me!'
+      end
+
+      private
+
+      # @param object [Object]
+      # @param fn_name [Symbol]
+      def fn?(object, fn_name)
+        object.is_a?(Array) && !object.empty? && [fn_name, fn_name.to_s].include?(object[0])
+      end
+    end
+  end
+end