checkoff 0.41.0 → 0.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ca8318553efc488d88a70b394e290ec8030f532ac9b3d4fa4fc67eb60849270a
-  data.tar.gz: cd86cc76ca2f74bed8e35212da234f5cbcad358db6a08d181f702fda149e785a
+  metadata.gz: af9b4c58d6440cc99eab9508632a3140d3f1519ad32fdf5f21b65833291999ba
+  data.tar.gz: 8d32790e9071087f948f9c1e3a3f3870f2de3dd0a1ab835e2b3727b7725d69e0
 SHA512:
-  metadata.gz: ecde71759c34fe1cee589084e7c06577726af223cc207f3cb4236f02d3d4fba75662bf622d69de7cabc7f22acb6f041cd8ddfeb142f60aba07051b35a3ac9e00
-  data.tar.gz: bb87fb6a83333fc0efffcd4ce5a37da55689bd617642a15dbbb4b4a1c94cb8511aa9a2e9d11e4fc16fc6ec6631d8191976e125156a1241b8f27367fb0afd4d27
+  metadata.gz: cf699102f03d8d6169e317f94aa88229537626ea74ec3b17446396e35fcf7e9d758d1b881d3c0d4fade4324a52e4ec64ed60d6540cac736e11440a9b4fbb1ca4
+  data.tar.gz: ea3952f4603dcb3344b856df43f11686589f8341763bb360d467bb99c852922b8480c3a41a86829dd25a79d3874561675e4ac4d98e09dddbc059720d86577583

data/Gemfile.lock

@@ -12,7 +12,7 @@ GIT
 PATH
   remote: .
   specs:
-    checkoff (0.41.0)
+    checkoff (0.43.0)
       activesupport
       asana (> 0.10.0)
       cache_method

data/lib/checkoff/internal/config_loader.rb

@@ -8,19 +8,27 @@ module Checkoff
     # Use the provided config from a YAML file, and fall back to env
     # variable if it's not populated for a key'
     class EnvFallbackConfigLoader
+      # @param config [Hash<Symbol, Object>]
+      # @param sym [Symbol]
+      # @param yaml_filename [String]
       def initialize(config, sym, yaml_filename)
         @config = config
         @envvar_prefix = sym.upcase
         @yaml_filename = yaml_filename
       end
 
+      # @param key [Symbol]
+      # @return [Object]
       def [](key)
         config_value = @config[key]
         return config_value unless config_value.nil?
 
+        # @sg-ignore
         ENV.fetch(envvar_name(key), nil)
       end
 
+      # @param key [Symbol]
+      # @return [Object]
       def fetch(key)
         out = self[key]
         return out unless out.nil?
@@ -31,6 +39,8 @@ module Checkoff
 
       private
 
+      # @param key [Symbol]
+      # @return [String]
       def envvar_name(key)
         "#{@envvar_prefix}__#{key.upcase}"
       end
@@ -39,7 +49,8 @@ module Checkoff
     # Load configuration file
     class ConfigLoader
       class << self
-        # @return EnvFallbackConfigLoader
+        # @sg-ignore
+        # @return [Hash<Symbol, Object>]
         def load(sym)
           yaml_result = load_yaml_file(sym)
           EnvFallbackConfigLoader.new(yaml_result, sym, yaml_filename(sym))
@@ -47,13 +58,18 @@ module Checkoff
 
         private
 
+        # @param sym [Symbol]
+        # @return [Hash<[String, Symbol], Object>]
         def load_yaml_file(sym)
           filename = yaml_filename(sym)
           return {} unless File.exist?(filename)
 
+          # @sg-ignore
           YAML.load_file(filename).with_indifferent_access
         end
 
+        # @param sym [Symbol]
+        # @return [String]
         def yaml_filename(sym)
           file = "#{sym}.yml"
           File.expand_path("~/.#{file}")

data/lib/checkoff/internal/task_selector_evaluator.rb

@@ -3,7 +3,7 @@
 module Checkoff
   # Base class to evaluate a task selector function given fully evaluated arguments
   class FunctionEvaluator
-    # @param task_selector [Array<(Symbol, Array)>]
+    # @param task_selector [Array<(Symbol, Array)>,String]
     # @param tasks [Checkoff::Tasks]
     def initialize(task_selector:,
                    tasks:)
@@ -101,7 +101,7 @@ module Checkoff
     def pull_custom_field_by_name(task, custom_field_name)
       custom_fields = task.custom_fields
       if custom_fields.nil?
-        raise "custom fields not found on task - did you add 'custom_field' in your extra_fields argument?"
+        raise "custom fields not found on task - did you add 'custom_fields' in your extra_fields argument?"
       end
 
       # @sg-ignore
@@ -165,6 +165,21 @@ module Checkoff
     end
   end
 
+  # :equals? function
+  class EqualsPFunctionEvaluator < FunctionEvaluator
+    def matches?
+      fn?(task_selector, :equals?)
+    end
+
+    # @param _task [Asana::Resources::Task]
+    # @param lhs [Object]
+    # @param rhs [Object]
+    # @return [Boolean]
+    def evaluate(_task, lhs, rhs)
+      lhs == rhs
+    end
+  end
+
   # :tag function
   class TagPFunctionEvaluator < FunctionEvaluator
     def matches?
@@ -324,6 +339,20 @@ module Checkoff
     end
   end
 
+  # String literals
+  class StringLiteralEvaluator < FunctionEvaluator
+    def matches?
+      task_selector.is_a?(String)
+    end
+
+    # @sg-ignore
+    # @param _task [Asana::Resources::Task]
+    # @return [String]
+    def evaluate(_task)
+      task_selector
+    end
+  end
+
   # Evaluator task selectors against a task
   class TaskSelectorEvaluator
     # @param task [Asana::Resources::Task]
@@ -337,6 +366,7 @@ module Checkoff
     FUNCTION_EVALUTORS = [
       NotFunctionEvaluator,
       NilPFunctionEvaluator,
+      EqualsPFunctionEvaluator,
       TagPFunctionEvaluator,
       CustomFieldValueFunctionEvaluator,
       CustomFieldGidValueFunctionEvaluator,
@@ -346,6 +376,7 @@ module Checkoff
       DuePFunctionEvaluator,
       DueDateSetPFunctionEvaluator,
       CustomFieldLessThanNDaysFromNowFunctionEvaluator,
+      StringLiteralEvaluator,
     ].freeze
 
     # @param task_selector [Array]
@@ -375,13 +406,18 @@ module Checkoff
     # @param evaluator [FunctionEvaluator]
     # @return [Boolean, Object, nil]
     def try_this_evaluator(task_selector, evaluator)
-      evaluated_args = task_selector[1..].map.with_index do |item, index|
-        if evaluator.evaluate_arg?(index)
-          evaluate(item)
-        else
-          item
-        end
-      end
+      # if task_selector is an array
+      evaluated_args = if task_selector.is_a?(Array)
+                         task_selector[1..].map.with_index do |item, index|
+                           if evaluator.evaluate_arg?(index)
+                             evaluate(item)
+                           else
+                             item
+                           end
+                         end
+                       else
+                         []
+                       end
 
       evaluator.evaluate(task, *evaluated_args)
     end

data/lib/checkoff/task_searches.rb

@@ -27,6 +27,17 @@ module Checkoff
 
     include Asana::Resources::ResponseHelper
 
+    # @!parse
+    #   extend CacheMethod::ClassMethods
+
+    # @param config [Hash<Symbol, Object>]
+    # @param workspaces [Checkoff::Workspaces]
+    # @param task_selectors [Checkoff::TaskSelectors]
+    # @param projects [Checkoff::Projects]
+    # @param clients [Checkoff::Clients]
+    # @param client [Asana::Client]
+    # @param search_url_parser [Checkoff::Internal::SearchUrl::Parser]
+    # @param asana_resources_collection_class [Class<Asana::Resources::Collection>]
     def initialize(config: Checkoff::Internal::ConfigLoader.load(:asana),
                    workspaces: Checkoff::Workspaces.new(config: config),
                    task_selectors: Checkoff::TaskSelectors.new(config: config),
@@ -49,6 +60,7 @@ module Checkoff
     # @return [Array<Asana::Resources::Task>]
     def task_search(workspace_name, url, extra_fields: [])
       workspace = workspaces.workspace_or_raise(workspace_name)
+      # @sg-ignore
       api_params, task_selector = @search_url_parser.convert_params(url)
       path = "/workspaces/#{workspace.gid}/tasks/search"
       options = calculate_api_options(extra_fields)
@@ -76,8 +88,13 @@ module Checkoff
     # bundle exec ./task_searches.rb
     # :nocov:
     class << self
+      # @return [void]
       def run
+        # @sg-ignore
+        # @type [String]
         workspace_name = ARGV[0] || raise('Please pass workspace name as first argument')
+        # @sg-ignore
+        # @type [String]
         url = ARGV[1] || raise('Please pass task search URL as second argument')
         task_searches = Checkoff::TaskSearches.new
         task_search = task_searches.task_search(workspace_name, url)
@@ -86,7 +103,14 @@ module Checkoff
     end
     # :nocov:
 
-    attr_reader :task_selectors, :projects, :workspaces, :client
+    # @return [Checkoff::TaskSelectors]
+    attr_reader :task_selectors
+    # @return [Checkoff::Projects]
+    attr_reader :projects
+    # @return [Checkoff::Workspaces]
+    attr_reader :workspaces
+    # @return [Asana::Client]
+    attr_reader :client
   end
 end
 

data/lib/checkoff/tasks.rb

@@ -4,25 +4,25 @@
 
 require_relative 'sections'
 require_relative 'workspaces'
+require_relative 'internal/config_loader'
 require 'asana'
 
 module Checkoff
   # Pull tasks from Asana
   class Tasks
     MINUTE = 60
-    # @sg-ignore
     HOUR = MINUTE * 60
     DAY = 24 * HOUR
     REALLY_LONG_CACHE_TIME = HOUR
-    # @sg-ignore
     LONG_CACHE_TIME = MINUTE * 15
-    # @sg-ignore
     SHORT_CACHE_TIME = MINUTE * 5
 
+    # @param config [Hash<Symbol, Object>]
     # @param client [Asana::Client]
     # @param workspaces [Checkoff::Workspaces]
-    # @param time_class [Class<Time>]
     # @param sections [Checkoff::Sections]
+    # @param time_class [Class<Time>]
+    # @param asana_task [Class<Asana::Resources::Task>]
     def initialize(config: Checkoff::Internal::ConfigLoader.load(:asana),
                    client: Checkoff::Clients.new(config: config).client,
                    workspaces: Checkoff::Workspaces.new(config: config,
@@ -39,8 +39,10 @@ module Checkoff
       @workspaces = workspaces
     end
 
-    def task_ready?(task)
-      return false if incomplete_dependencies?(task)
+    # @param task [Asana::Resources::Task]
+    # @param ignore_dependencies [Boolean]
+    def task_ready?(task, ignore_dependencies: false)
+      return false if !ignore_dependencies && incomplete_dependencies?(task)
 
       due = due_time(task)
 
@@ -50,11 +52,19 @@ module Checkoff
     end
 
     # Pull a specific task by name
+    # @param workspace_name [String]
+    # @param project_name [String, Symbol]
+    # @param section_name [String, nil, Symbol]
+    # @param task_name [String]
+    # @param only_uncompleted [Boolean]
+    # @param extra_fields [Array<String>]
+    # @sg-ignore
     # @return [Asana::Resources::Task, nil]
     def task(workspace_name, project_name, task_name,
              section_name: :unspecified,
              only_uncompleted: true,
              extra_fields: [])
+      # @sg-ignore
       tasks = tasks_from_section(workspace_name,
                                  project_name,
                                  section_name: section_name,
@@ -74,6 +84,7 @@ module Checkoff
       client.tasks.find_by_id(task_gid, options: options)
     end
 
+    # @param name [String]
     # @param workspace_gid [String]
     # @param assignee_gid [String]
     # @return [Asana::Resources::Task]
@@ -85,13 +96,19 @@ module Checkoff
                          workspace: workspace_gid, name: name)
     end
 
-    # Return an end-user URL to the task in question
+    # @param task [Asana::Resources::Task]
+    # @return [String] end-user URL to the task in question
     def url_of_task(task)
       "https://app.asana.com/0/0/#{task.gid}/f"
     end
 
     private
 
+    # @param workspace_name [String]
+    # @param project_name [String, Symbol]
+    # @param section_name [String, nil, :unspecified]
+    # @param only_uncompleted [Boolean]
+    # @param extra_fields [Array<String>]
     # @return [Array<Asana::Resources::Task>]
     def tasks_from_section(workspace_name, project_name,
                            section_name:,
@@ -109,6 +126,7 @@ module Checkoff
       end
     end
 
+    # @return [Asana::Client]
     attr_reader :client
 
     # @return [Checkoff::Projects]
@@ -131,6 +149,7 @@ module Checkoff
       nil
     end
 
+    # @param task [Asana::Resources::Task]
     def incomplete_dependencies?(task)
       # Avoid a redundant fetch.  Unfortunately, Ruby SDK allows
       # dependencies to be fetched along with other attributes--but

data/lib/checkoff/version.rb

@@ -3,5 +3,5 @@
 # Command-line and gem client for Asana (unofficial)
 module Checkoff
   # Version of library
-  VERSION = '0.41.0'
+  VERSION = '0.43.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: checkoff
 version: !ruby/object:Gem::Version
-  version: 0.41.0
+  version: 0.43.0
 platform: ruby
 authors:
 - Vince Broz
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-06-19 00:00:00.000000000 Z
+date: 2023-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport