checkoff 0.53.1 → 0.55.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 234864e30843bb30b598e38ef8e2571a6b5f6bbf37f07db7af5d4249ffe8ada2
-  data.tar.gz: 4e2eef390cc3fca5a3022a816811acadfc710983ec96f288567d6892f7d08e22
+  metadata.gz: e441dfbcef11d610f73873858235bd110aa27b730a40eca5c5a38aac3e27ff5c
+  data.tar.gz: 4810a4c39437830b9dd6a909102328d6f413600a30bf2fe92702d1a59fe4ae61
 SHA512:
-  metadata.gz: b035b186ac2b3fd74507020d165aa4b50c1c95d1a5848cbae0f579013dbf4fd6c6b0a3f648b00901544c525924ea7596009446777bb91db3ca5412fad6448136
-  data.tar.gz: c35c867d9aaac72f54355fb371ea298afb55ccf9502d6baca0f2bc928ca4a0896a3bd5c784c052a6f566852933fbac88dd51a2d0764e4940edd132b5d21f5c8d
+  metadata.gz: '08ad245068e7a1278a90943eff26e239175aa2874b9db59b682448f3069f8d3e71bddae0f21cefcddf2f315a95cfc0094800759487953fb519be6af9935886d1'
+  data.tar.gz: 02c0f071c4d722f26014d2029e13794a26e15ab1396291177e80b8d4506e301bd33b2e3984296314e8a57bf522c589c1a9f4684810564f8f3b387b1e780bbbe3

data/.solargraph.yml

@@ -3,6 +3,9 @@ include:
   - "**/*.rb"
   - ".git-hooks/**/*.rb"
 exclude:
+  - spec/**/*
+  - feature/**/*
+  - test/**/*
   - vendor/**/*
   - ".bundle/**/*"
 require: []

data/Gemfile.lock

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

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

@@ -13,34 +13,88 @@ module Checkoff
           @date_url_params = date_url_params
         end
 
+        # @sg-ignore
+        # @return [Array(Hash<String, String>, Array<[Symbol, Array]>)]
+        def convert
+          return [{}, []] if date_url_params.empty?
+
+          out = nil
+
+          %w[due_date start_date].each do |prefix|
+            next unless date_url_params.key? "#{prefix}.operator"
+            raise 'Teach me how to handle simultaneous date parameters' unless out.nil?
+
+            out = convert_for_prefix(prefix)
+          end
+
+          raise "Teach me to handle these parameters: #{date_url_params.inspect}" unless date_url_params.empty?
+
+          out
+        end
+
+        private
+
+        # @sg-ignore
+        # @param prefix [String]
+        # @return [Array(Hash<String, String>, Array<[Symbol, Array]>)]
+        def convert_for_prefix(prefix)
+          # example params:
+          #   due_date.operator=through_next
+          #   due_date.value=0
+          #   due_date.unit=day
+          operator = get_single_param("#{prefix}.operator")
+
+          out = if operator == 'through_next'
+                  handle_through_next(prefix)
+                elsif operator == 'between'
+                  handle_between(prefix)
+                else
+                  raise "Teach me how to handle date mode: #{operator.inspect}."
+                end
+
+          # mark these as done by deleting from the hash
+          date_url_params.delete_if { |k, _| k.start_with? prefix }
+
+          out
+        end
+
+        # https://developers.asana.com/docs/search-tasks-in-a-workspace
+        API_PREFIX = {
+          'due_date' => 'due_on',
+          'start_date' => 'start_on',
+        }.freeze
+
+        # @param prefix [String]
         # @return [Array(Hash<String, String>, Array<[Symbol, Array]>)] See https://developers.asana.com/docs/search-tasks-in-a-workspace
-        def handle_through_next
-          due_date_value = get_single_param('due_date.value').to_i
+        def handle_through_next(prefix)
+          value = get_single_param("#{prefix}.value").to_i
 
-          validate_unit_is_day!
+          validate_unit_is_day!(prefix)
 
           # @sg-ignore
           # @type [Date]
-          before = Date.today + due_date_value
+          before = Date.today + value
+
           # 'due_on.before' => '2023-01-01',
           # 'due_on.after' => '2023-01-01',
           # [{ 'due_on.before' => '2023-09-01' }, []]
-          [{ 'due_on.before' => before.to_s }, []]
+          [{ "#{API_PREFIX.fetch(prefix)}.before" => before.to_s }, []]
         end
 
+        # @param prefix [String]
         # @return [Array(Hash<String, String>, Array<[Symbol, Array]>)] See https://developers.asana.com/docs/search-tasks-in-a-workspace
-        def handle_between
-          due_date_after = get_single_param('due_date.after')
-          raise 'Teach me how to handle due_date_before' if date_url_params.key? 'due_date.before'
+        def handle_between(prefix)
+          after = get_single_param("#{prefix}.after")
+          raise "Teach me how to handle #{prefix}.before" if date_url_params.key? "#{prefix}.before"
 
-          validate_unit_not_provided!
+          validate_unit_not_provided!(prefix)
 
           # Example value: 1702857600000
           # +1 is because API seems to operate on inclusive ranges
           # @type [Date]
           # @sg-ignore
-          after = Time.at(due_date_after.to_i / 1000).to_date + 1
-          [{ 'due_on.after' => after.to_s }, []]
+          after = Time.at(after.to_i / 1000).to_date + 1
+          [{ "#{API_PREFIX.fetch(prefix)}.after" => after.to_s }, []]
         end
 
         # @param param_key [String]
@@ -55,37 +109,20 @@ module Checkoff
           value[0]
         end
 
-        # @return [Array(Hash<String, String>, Array<[Symbol, Array]>)]
-        def convert
-          return [{}, []] if date_url_params.empty?
-
-          # example params:
-          #   due_date.operator=through_next
-          #   due_date.value=0
-          #   due_date.unit=day
-          due_date_operator = get_single_param('due_date.operator')
-
-          return handle_through_next if due_date_operator == 'through_next'
-
-          return handle_between if due_date_operator == 'between'
-
-          raise "Teach me how to handle date mode: #{due_date_operator.inspect}."
-        end
-
-        private
-
+        # @param prefix [String]
         # @return [void]
-        def validate_unit_not_provided!
-          return unless date_url_params.key? 'due_date.unit'
+        def validate_unit_not_provided!(prefix)
+          return unless date_url_params.key? "#{prefix}.unit"
 
-          raise "Teach me how to handle other due_date.unit for these params: #{date_url_params.inspect}"
+          raise "Teach me how to handle other #{prefix}.unit for these params: #{date_url_params.inspect}"
         end
 
+        # @param prefix [String]
         # @return [void]
-        def validate_unit_is_day!
-          unit = date_url_params.fetch('due_date.unit').fetch(0)
+        def validate_unit_is_day!(prefix)
+          unit = date_url_params.fetch("#{prefix}.unit").fetch(0)
 
-          raise 'Teach me how to handle other time units' unless unit == 'day'
+          raise "Teach me how to handle other time units: #{unit}" unless unit == 'day'
         end
 
         # @return [Hash<String, Array<String>>]

data/lib/checkoff/internal/task_selector_evaluator.rb

@@ -484,6 +484,38 @@ module Checkoff
       end
     end
 
+    # :last_story_created_less_than_n_days_ago function
+    class LastStoryCreatedLessThanNDaysAgoFunctionEvaluator < FunctionEvaluator
+      FUNCTION_NAME = :last_story_created_less_than_n_days_ago
+
+      def matches?
+        fn?(task_selector, FUNCTION_NAME)
+      end
+
+      def evaluate_arg?(_index)
+        false
+      end
+
+      # @param task [Asana::Resources::Task]
+      # @param num_days [Integer]
+      # @param excluding_resource_subtypes [Array<String>]
+      # @return [Boolean]
+      def evaluate(task, num_days, excluding_resource_subtypes)
+        # for whatever reason, .last on the enumerable does not impose ordering; .to_a does!
+
+        # @type [Array<Asana::Resources::Story>]
+        stories = task.stories.to_a.reject do |story|
+          excluding_resource_subtypes.include? story.resource_subtype
+        end
+        return true if stories.empty? # no stories == infinitely old!
+
+        last_story = stories.last
+        last_story_created_at = Time.parse(last_story.created_at)
+        n_days_ago = Time.now - (num_days * 24 * 60 * 60)
+        last_story_created_at < n_days_ago
+      end
+    end
+
     # String literals
     class StringLiteralEvaluator < FunctionEvaluator
       def matches?
@@ -567,6 +599,7 @@ module Checkoff
       Checkoff::TaskSelectorClasses::FieldGreaterThanOrEqualToNDaysFromTodayFunctionEvaluator,
       Checkoff::TaskSelectorClasses::CustomFieldLessThanNDaysFromNowFunctionEvaluator,
       Checkoff::TaskSelectorClasses::CustomFieldGreaterThanOrEqualToNDaysFromNowFunctionEvaluator,
+      Checkoff::TaskSelectorClasses::LastStoryCreatedLessThanNDaysAgoFunctionEvaluator,
       Checkoff::TaskSelectorClasses::StringLiteralEvaluator,
       Checkoff::TaskSelectorClasses::EstimateExceedsDurationFunctionEvaluator,
     ].freeze

data/lib/checkoff/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: checkoff
 version: !ruby/object:Gem::Version
-  version: 0.53.1
+  version: 0.55.0
 platform: ruby
 authors:
 - Vince Broz
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-09-12 00:00:00.000000000 Z
+date: 2023-09-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport