checkoff 0.39.4 → 0.41.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4157afdaf7db7bbf6334a968a5d06f1a5ce0f248d62aa854192b85c0514232ff
-  data.tar.gz: be6032a66aa14f3ddad56293d5728508f1540304f28c6acd59d1677097d26a0c
+  metadata.gz: ca8318553efc488d88a70b394e290ec8030f532ac9b3d4fa4fc67eb60849270a
+  data.tar.gz: cd86cc76ca2f74bed8e35212da234f5cbcad358db6a08d181f702fda149e785a
 SHA512:
-  metadata.gz: 6d6b3bcae0366a5da00d6735d7f2cb5a96d29cdf08b85ac8a9571dd2c13bce8553e2083d3760895ae02a1a3b1f354c07ab50b589d4bf9e55799faefa899150ca
-  data.tar.gz: a58eb7f567d9d70af6b0a60eac27fc918ce0fddccf6773bcc7e969c260269d114618d6042042331015f9c6e095ddc40cd3c9fa77ebd2cf99f3a17b8f1e30edd7
+  metadata.gz: ecde71759c34fe1cee589084e7c06577726af223cc207f3cb4236f02d3d4fba75662bf622d69de7cabc7f22acb6f041cd8ddfeb142f60aba07051b35a3ac9e00
+  data.tar.gz: bb87fb6a83333fc0efffcd4ce5a37da55689bd617642a15dbbb4b4a1c94cb8511aa9a2e9d11e4fc16fc6ec6631d8191976e125156a1241b8f27367fb0afd4d27

data/.git-hooks/pre_commit/circle_ci.rb

@@ -8,6 +8,7 @@ module Overcommit
     module PreCommit
       # CircleCI plugin for Overcommit to validate config file (.circleci/config.yml)
       class CircleCi < Base
+        # @return [Symbol, Array<[Symbol, String]>]
         def run
           result = execute(command)
           return :pass if result.success?

data/.git-hooks/pre_commit/punchlist.rb

@@ -10,7 +10,7 @@ module Overcommit
       # Runs `punchlist` against any modified Ruby files.
       class Punchlist < Base
         # @param stdout [String]
-        # @return [Array<Overcommit::Hook::Message]
+        # @return [Array<Overcommit::Hook::Message>]
         def parse_output(stdout)
           stdout.split("\n").map do |line|
             # @sg-ignore
@@ -19,12 +19,14 @@ module Overcommit
           end
         end
 
+        # @return [String]
         def files_glob
           "{" \
             "#{applicable_files.join(',')}" \
             "}"
         end
 
+        # @return [Symbol, Array<Overcommit::Hook::Message>]
         def run
           # @sg-ignore
           # @type [Overcommit::Subprocess::Result]

data/.git-hooks/pre_commit/solargraph_typecheck.rb

@@ -11,6 +11,7 @@ module Overcommit
     module PreCommit
       # Runs `solargraph typecheck` against any modified Ruby files.
       class SolargraphTypecheck < Base
+        # @return [Array<String>]
         def run
           errors = []
 
@@ -24,8 +25,11 @@ module Overcommit
 
         private
 
+        # @param file [String]
+        # @param errors [Array<String>]
+        # @return [void]
         def generate_errors_for_file(file, errors)
-          result = execute(['bundle', 'exec', 'solargraph', 'typecheck', '--level', 'strict', file])
+          result = execute(['bundle', 'exec', 'solargraph', 'typecheck', '--level', 'strong', file])
           return if result.success?
 
           # @type [String]
@@ -37,6 +41,9 @@ module Overcommit
           end
         end
 
+        # @param file [String]
+        # @param error [String]
+        # @return [Overcommit::Hook::Message, nil]
         def parse_error(file, error)
           # Parse the result for the line number                # @type [MatchData]
           match = error.match(/^(.+?):(\d+)/)

data/.solargraph.yml

@@ -4,6 +4,7 @@ include:
   - ".git-hooks/**/*.rb"
 exclude:
   - spec/**/*
+  - feature/**/*
   - test/**/*
   - vendor/**/*
   - ".bundle/**/*"
@@ -12,7 +13,7 @@ domains: []
 reporters:
   - rubocop
   - require_not_found
-  - typecheck:strict
+  - typecheck:strong
   - update_errors
 formatter:
   rubocop:

data/Gemfile

@@ -19,15 +19,14 @@ gem 'overcommit', ['>=0.60.0', '<0.61.0']
 gem 'pry'
 gem 'punchlist'
 gem 'rake', '~> 13.0'
-# ensure recent definitions
-gem 'rbs', ['>3.0.3']
+gem 'rbs'
 gem 'rubocop', ['~> 1.52']
 gem 'rubocop-minitest'
 gem 'rubocop-rake'
 # ensure version with branch coverage
 gem 'simplecov', ['>=0.18.0']
 gem 'simplecov-lcov'
-gem 'solargraph'
+gem 'solargraph', ['>=0.49.0']
 gem 'undercover'
 gem 'webmock'
 

data/Gemfile.lock

@@ -12,7 +12,7 @@ GIT
 PATH
   remote: .
   specs:
-    checkoff (0.39.4)
+    checkoff (0.41.0)
       activesupport
       asana (> 0.10.0)
       cache_method
@@ -79,7 +79,7 @@ GEM
     imagen (0.1.8)
       parser (>= 2.5, != 2.5.1.1)
     iniparse (1.5.0)
-    jaro_winkler (1.5.4)
+    jaro_winkler (1.5.6)
     json (2.6.3)
     jwt (2.2.3)
     kramdown (2.4.0)
@@ -110,12 +110,12 @@ GEM
     multi_json (1.15.0)
     multi_xml (0.6.0)
     multipart-post (2.1.1)
-    nokogiri (1.14.3)
-      mini_portile2 (~> 2.8.0)
+    nokogiri (1.15.2)
+      mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
-    nokogiri (1.14.3-x86_64-darwin)
+    nokogiri (1.15.2-x86_64-darwin)
       racc (~> 1.4)
-    nokogiri (1.14.3-x86_64-linux)
+    nokogiri (1.15.2-x86_64-linux)
       racc (~> 1.4)
     oauth2 (1.4.11)
       faraday (>= 0.17.3, < 3.0)
@@ -136,11 +136,11 @@ GEM
     public_suffix (5.0.0)
     punchlist (1.3.0)
       source_finder (>= 2)
-    racc (1.6.2)
+    racc (1.7.1)
     rack (3.0.6.1)
     rainbow (3.1.1)
     rake (13.0.3)
-    rbs (3.1.0)
+    rbs (2.8.4)
     regexp_parser (2.8.0)
     reverse_markdown (2.1.1)
       nokogiri
@@ -171,24 +171,25 @@ GEM
     simplecov-html (0.12.3)
     simplecov-lcov (0.8.0)
     simplecov_json_formatter (0.1.3)
-    solargraph (0.48.0)
+    solargraph (0.49.0)
       backport (~> 1.2)
       benchmark
-      bundler (>= 1.17.2)
+      bundler (~> 2.0)
       diff-lcs (~> 1.4)
       e2mmap
       jaro_winkler (~> 1.5)
       kramdown (~> 2.3)
       kramdown-parser-gfm (~> 1.1)
       parser (~> 3.0)
-      reverse_markdown (>= 1.0.5, < 3)
-      rubocop (>= 0.52)
+      rbs (~> 2.0)
+      reverse_markdown (~> 2.0)
+      rubocop (~> 1.38)
       thor (~> 1.0)
       tilt (~> 2.0)
       yard (~> 0.9, >= 0.9.24)
     source_finder (3.2.1)
-    thor (1.2.1)
-    tilt (2.1.0)
+    thor (1.2.2)
+    tilt (2.2.0)
     tomlrb (2.0.3)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
@@ -225,13 +226,13 @@ DEPENDENCIES
   pry
   punchlist
   rake (~> 13.0)
-  rbs (> 3.0.3)
+  rbs
   rubocop (~> 1.52)
   rubocop-minitest
   rubocop-rake
   simplecov (>= 0.18.0)
   simplecov-lcov
-  solargraph
+  solargraph (>= 0.49.0)
   undercover
   webmock
 

data/lib/checkoff/internal/config_loader.rb

@@ -39,6 +39,7 @@ module Checkoff
     # Load configuration file
     class ConfigLoader
       class << self
+        # @return EnvFallbackConfigLoader
         def load(sym)
           yaml_result = load_yaml_file(sym)
           EnvFallbackConfigLoader.new(yaml_result, sym, yaml_filename(sym))

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

@@ -31,12 +31,20 @@ module Checkoff
             end
           end
 
-          attr_reader :key, :values
+          # @return [String]
+          attr_reader :key
+
+          # @return [Array<String>]
+          attr_reader :values
 
           # Inputs:
           #   123_column_456 means "abc" project, "def" section
           #   123 means "abc" project
           #   123~456 means "abc" and "def" projects
+          #
+          # @param projects [Array<String>]
+          # @param sections [Array<String>]
+          # @return [void]
           def parse_projects_and_sections(projects, sections)
             single_value.split('~').each do |project_section_pair|
               # @sg-ignore
@@ -49,6 +57,8 @@ module Checkoff
             end
           end
 
+          # @param verb [String]
+          # @return [Array<String>]
           def convert_from_projects_and_sections(verb)
             projects = []
             sections = []
@@ -62,6 +72,7 @@ module Checkoff
 
         # Handle 'any_projects.ids' search url param
         class AnyProjectsIds < SimpleParam
+          # @return [Array<String>]
           def convert
             convert_from_projects_and_sections('any')
           end
@@ -69,6 +80,7 @@ module Checkoff
 
         # Handle 'not_projects.ids' search url param
         class NotProjectsIds < SimpleParam
+          # @return [Array<String>]
           def convert
             convert_from_projects_and_sections('not')
           end
@@ -76,6 +88,7 @@ module Checkoff
 
         # Handle 'completion' search url param
         class Completion < SimpleParam
+          # @return [Array<String>]
           def convert
             case single_value
             when 'incomplete'
@@ -90,6 +103,7 @@ module Checkoff
 
         # Handle 'not_tags.ids' search url param
         class NotTagsIds < SimpleParam
+          # @return [Array<String>]
           def convert
             tag_ids = single_value.split('~')
             ['tags.not', tag_ids.join(',')]
@@ -98,6 +112,7 @@ module Checkoff
 
         # handle 'subtask' search url param
         class Subtask < SimpleParam
+          # @return [Array<[String, Boolean]>]
           def convert
             case single_value
             when 'is_not_subtask'
@@ -112,6 +127,7 @@ module Checkoff
 
         # Handle 'any_tags.ids' search url param
         class AnyTagsIds < SimpleParam
+          # @return [Array<String>]
           def convert
             tag_ids = single_value.split('~')
             ['tags.any', tag_ids.join(',')]
@@ -120,6 +136,7 @@ module Checkoff
 
         # Handle 'sort' search url param
         class Sort < SimpleParam
+          # @return [Array<String>]
           def convert
             # https://developers.asana.com/reference/searchtasksforworkspace
             conversion = {
@@ -132,6 +149,16 @@ module Checkoff
             ['sort_by', conversion.fetch(single_value)]
           end
         end
+
+        # Handle 'milestone' search url param
+        class Milestone < SimpleParam
+          # @return [Array<String>]
+          def convert
+            return %w[resource_subtype milestone] if single_value == 'is_milestone'
+
+            raise "Teach me how to handle #{key} = #{values}"
+          end
+        end
       end
 
       # Convert simple parameters - ones where the param name itself
@@ -160,6 +187,7 @@ module Checkoff
           'any_tags.ids' => SimpleParam::AnyTagsIds,
           'subtask' => SimpleParam::Subtask,
           'sort' => SimpleParam::Sort,
+          'milestone' => SimpleParam::Milestone,
         }.freeze
 
         # https://developers.asana.com/docs/search-tasks-in-a-workspace
@@ -170,12 +198,14 @@ module Checkoff
         def convert_arg(key, values)
           # @type [Class<SimpleParam::SimpleParam>]
           clazz = ARGS.fetch(key)
+          # @sg-ignore
           # @type [SimpleParam::SimpleParam]
           obj = clazz.new(key: key, values: values)
           # @sg-ignore
           obj.convert
         end
 
+        # @return [Hash<String, Array<String>>]
         attr_reader :simple_url_params
       end
     end

data/lib/checkoff/internal/task_selector_evaluator.rb

@@ -3,28 +3,47 @@
 module Checkoff
   # Base class to evaluate a task selector function given fully evaluated arguments
   class FunctionEvaluator
+    # @param task_selector [Array<(Symbol, Array)>]
+    # @param tasks [Checkoff::Tasks]
     def initialize(task_selector:,
                    tasks:)
       @task_selector = task_selector
       @tasks = tasks
     end
 
+    # @sg-ignore
+    # @param _index [Integer]
     def evaluate_arg?(_index)
       true
     end
 
+    # @sg-ignore
+    # @return [Boolean]
+    def matches?
+      raise 'Override 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
 
+    # @sg-ignore
+    # @param task [Asana::Resources::Task]
+    # @param custom_field_gid [String]
+    # @return [Hash]
     def pull_custom_field_or_raise(task, custom_field_gid)
+      # @type [Array<Hash>]
       custom_fields = task.custom_fields
       if custom_fields.nil?
         raise "Could not find custom_fields under task (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} " \
@@ -34,8 +53,12 @@ module Checkoff
       matched_custom_field
     end
 
+    # @return [Array<(Symbol, Array)>]
     attr_reader :task_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
@@ -48,6 +71,9 @@ module Checkoff
       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?
         []
@@ -58,12 +84,42 @@ module Checkoff
       end
     end
 
+    # @param task [Asana::Resources::Task]
+    # @param custom_field_gid [String]
+    # @return [Array<String>]
     def pull_custom_field_values_gids(task, custom_field_gid)
       custom_field = pull_custom_field_or_raise(task, custom_field_gid)
       pull_enum_values(custom_field).flat_map do |enum_value|
         find_gids(custom_field, enum_value)
       end
     end
+
+    # @sg-ignore
+    # @param task [Asana::Resources::Task]
+    # @param custom_field_name [String]
+    # @return [Hash, nil]
+    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?"
+      end
+
+      # @sg-ignore
+      # @type [Hash, nil]
+      custom_fields.find { |field| field.fetch('name') == custom_field_name }
+    end
+
+    # @param task [Asana::Resources::Task]
+    # @param custom_field_name [String]
+    # @return [Hash]
+    def pull_custom_field_by_name_or_raise(task, custom_field_name)
+      custom_field = pull_custom_field_by_name(task, custom_field_name)
+      if custom_field.nil?
+        raise "Could not find custom field with name #{custom_field_name} " \
+              "in task #{task.gid} with custom fields #{task.custom_fields}"
+      end
+      custom_field
+    end
   end
 
   # :and function
@@ -72,6 +128,10 @@ module Checkoff
       fn?(task_selector, :and)
     end
 
+    # @param _task [Asana::Resources::Task]
+    # @param lhs [Object]
+    # @param rhs [Object]
+    # @return [Object]
     def evaluate(_task, lhs, rhs)
       lhs && rhs
     end
@@ -83,6 +143,9 @@ module Checkoff
       fn?(task_selector, :not)
     end
 
+    # @param _task [Asana::Resources::Task]
+    # @param subvalue [Object]
+    # @return [Boolean]
     def evaluate(_task, subvalue)
       !subvalue
     end
@@ -94,6 +157,9 @@ module Checkoff
       fn?(task_selector, :nil?)
     end
 
+    # @param _task [Asana::Resources::Task]
+    # @param subvalue [Object]
+    # @return [Boolean]
     def evaluate(_task, subvalue)
       subvalue.nil?
     end
@@ -105,10 +171,15 @@ module Checkoff
       fn?(task_selector, :tag)
     end
 
+    # @param _index [Integer]
     def evaluate_arg?(_index)
       false
     end
 
+    # @sg-ignore
+    # @param task [Asana::Resources::Task]
+    # @param tag_name [String]
+    # @return [Boolean]
     def evaluate(task, tag_name)
       task.tags.map(&:name).include? tag_name
     end
@@ -120,6 +191,8 @@ module Checkoff
       fn?(task_selector, :due)
     end
 
+    # @param task [Asana::Resources::Task]
+    # @return [Boolean]
     def evaluate(task)
       @tasks.task_ready?(task)
     end
@@ -131,6 +204,9 @@ module Checkoff
       fn?(task_selector, :due_date_set)
     end
 
+    # @sg-ignore
+    # @param task [Asana::Resources::Task]
+    # @return [Boolean]
     def evaluate(task)
       !task.due_at.nil? || !task.due_on.nil?
     end
@@ -142,17 +218,16 @@ module Checkoff
       fn?(task_selector, :custom_field_value)
     end
 
+    # @param _index [Integer]
     def evaluate_arg?(_index)
       false
     end
 
+    # @param task [Asana::Resources::Task]
+    # @param custom_field_name [String]
+    # @return [String, nil]
     def evaluate(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?"
-      end
-
-      custom_field = custom_fields.find { |field| field.fetch('name') == custom_field_name }
+      custom_field = pull_custom_field_by_name(task, custom_field_name)
       return nil if custom_field.nil?
 
       custom_field['display_value']
@@ -169,6 +244,10 @@ module Checkoff
       false
     end
 
+    # @sg-ignore
+    # @param task [Asana::Resources::Task]
+    # @param custom_field_gid [String]
+    # @return [String, nil]
     def evaluate(task, custom_field_gid)
       custom_field = pull_custom_field_or_raise(task, custom_field_gid)
       custom_field['display_value']
@@ -185,6 +264,10 @@ module Checkoff
       false
     end
 
+    # @param task [Asana::Resources::Task]
+    # @param custom_field_gid [String]
+    # @param custom_field_values_gids [Array<String>]
+    # @return [Boolean]
     def evaluate(task, custom_field_gid, custom_field_values_gids)
       actual_custom_field_values_gids = pull_custom_field_values_gids(task, custom_field_gid)
 
@@ -204,6 +287,10 @@ module Checkoff
       false
     end
 
+    # @param task [Asana::Resources::Task]
+    # @param custom_field_gid [String]
+    # @param custom_field_values_gids [Array<String>]
+    # @return [Boolean]
     def evaluate(task, custom_field_gid, custom_field_values_gids)
       actual_custom_field_values_gids = pull_custom_field_values_gids(task, custom_field_gid)
 
@@ -213,8 +300,34 @@ module Checkoff
     end
   end
 
+  # :custom_field_less_than_n_days_from_now function
+  class CustomFieldLessThanNDaysFromNowFunctionEvaluator < FunctionEvaluator
+    def matches?
+      fn?(task_selector, :custom_field_less_than_n_days_from_now)
+    end
+
+    def evaluate_arg?(_index)
+      false
+    end
+
+    # @param task [Asana::Resources::Task]
+    # @param custom_field_name [String]
+    # @param num_days [Integer]
+    # @return [Boolean]
+    def evaluate(task, custom_field_name, num_days)
+      custom_field = pull_custom_field_by_name_or_raise(task, custom_field_name)
+
+      time_str = custom_field.fetch('display_value')
+      time = Time.parse(time_str)
+      n_days_from_now = (Time.now + (num_days * 24 * 60 * 60))
+      time < n_days_from_now
+    end
+  end
+
   # Evaluator task selectors against a task
   class TaskSelectorEvaluator
+    # @param task [Asana::Resources::Task]
+    # @param tasks [Checkoff::Tasks]
     def initialize(task:,
                    tasks: Checkoff::Tasks.new)
       @task = task
@@ -232,12 +345,18 @@ module Checkoff
       AndFunctionEvaluator,
       DuePFunctionEvaluator,
       DueDateSetPFunctionEvaluator,
+      CustomFieldLessThanNDaysFromNowFunctionEvaluator,
     ].freeze
 
+    # @param task_selector [Array]
+    # @return [Boolean, Object, nil]
     def evaluate(task_selector)
-      return true if task_selector == []
+      return true if task_selector.empty?
 
+      # @param evaluator_class [Class<FunctionEvaluator>]
       FUNCTION_EVALUTORS.each do |evaluator_class|
+        # @sg-ignore
+        # @type [FunctionEvaluator]
         evaluator = evaluator_class.new(task_selector: task_selector,
                                         tasks: tasks)
 
@@ -246,11 +365,15 @@ module Checkoff
         return try_this_evaluator(task_selector, evaluator)
       end
 
-      raise "Syntax issue trying to handle #{task_selector}"
+      raise "Syntax issue trying to handle #{task_selector.inspect}"
     end
 
     private
 
+    # @sg-ignore
+    # @param task_selector [Array]
+    # @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)
@@ -263,6 +386,11 @@ module Checkoff
       evaluator.evaluate(task, *evaluated_args)
     end
 
-    attr_reader :task, :tasks, :task_selector
+    # @return [Asana::Resources::Task]
+    attr_reader :task
+    # @return [Checkoff::Tasks]
+    attr_reader :tasks
+    # @return [Array<(Symbol, Array)>]
+    attr_reader :task_selector
   end
 end

data/lib/checkoff/task_searches.rb

@@ -19,12 +19,9 @@ module Checkoff
   # Run task searches against the Asana API
   class TaskSearches
     MINUTE = 60
-    # @sg-ignore
     HOUR = MINUTE * 60
     DAY = 24 * HOUR
-    # @sg-ignore
     REALLY_LONG_CACHE_TIME = HOUR * 1
-    # @sg-ignore
     LONG_CACHE_TIME = MINUTE * 15
     SHORT_CACHE_TIME = MINUTE
 
@@ -62,7 +59,6 @@ module Checkoff
                                                     client: client)
       tasks.select { |task| task_selectors.filter_via_task_selector(task, task_selector) }
     end
-    # @sg-ignore
     cache_method :task_search, LONG_CACHE_TIME
 
     private
@@ -81,11 +77,7 @@ module Checkoff
     # :nocov:
     class << self
       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)

data/lib/checkoff/task_selectors.rb

@@ -21,6 +21,10 @@ module Checkoff
     LONG_CACHE_TIME = MINUTE * 15
     SHORT_CACHE_TIME = MINUTE
 
+    # @sg-ignore
+    # @param [Hash] config
+    # @param [Asana::Client] client
+    # @param [Checkoff::Tasks] tasks
     def initialize(config: Checkoff::Internal::ConfigLoader.load(:asana),
                    client: Checkoff::Clients.new(config: config).client,
                    tasks: Checkoff::Tasks.new(config: config,
@@ -30,8 +34,8 @@ module Checkoff
     end
 
     # @param [Asana::Resources::Task] task
-    # @param [Hash<Symbol, Object>] task_selector Filter based on
-    #        description.  Examples: {tag: 'foo'} {:not {tag: 'foo'} (:tag 'foo')
+    # @param [Array<(Symbol, Array)>] task_selector Filter based on
+    #        task details.  Examples: [:tag, 'foo'] [:not, [:tag, 'foo']] [:tag, 'foo']
     # @return [Boolean]
     def filter_via_task_selector(task, task_selector)
       evaluator = TaskSelectorEvaluator.new(task: task, tasks: tasks)
@@ -40,16 +44,19 @@ module Checkoff
 
     private
 
+    # @return [Checkoff::Tasks]
     attr_reader :tasks
 
     # bundle exec ./task_selectors.rb
     # :nocov:
     class << self
+      # @sg-ignore
       # @return [String]
       def project_name
         ARGV[1] || raise('Please pass project name to pull tasks from as first argument')
       end
 
+      # @sg-ignore
       # @return [String]
       def workspace_name
         ARGV[0] || raise('Please pass workspace name as first argument')
@@ -61,6 +68,7 @@ module Checkoff
         JSON.parse(task_selector_json)
       end
 
+      # @return [void]
       def run
         require 'checkoff/projects'
 

data/lib/checkoff/version.rb

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

metadata

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