checkoff 0.44.1 → 0.44.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5186c70798590604d6800a0c6da9ee511ea72114e9cfea4f47bb3f4f77b5237
-  data.tar.gz: 814265150a1a7af8b8980e7f71e2f085d762ef0b1c690a6b04e31c72ef128e2b
+  metadata.gz: a1e122dcb6fa01052af47f61287ae9c9935f33f2b8f76d88ab1c28b60f760643
+  data.tar.gz: cd3b9ebb8285f665db56624db599cc16b8f48e7b3e9bc7a1496be8bb0d406825
 SHA512:
-  metadata.gz: 89b6ec01624867af12f192762ff2179846856d60641efdd6e1f59acd2a3a22dbbe76d9ad439ed21086385004d1c973c229a49ad085036e8696507bbaf275c44a
-  data.tar.gz: 0d344a736addad549df2918c8d24d351ece8a13c7962a2af951569073f0c3956e9b9094a0e0ccc691d429019885af9e4fa0dc64b1ce7401ae62b15ba0facfef2
+  metadata.gz: b26dcb1341e3b69da84d527206dc637529fc1e00d2dd9c813a9f0979f5cbf3bebd7a5cb8d5ce4974684026755e84074381b9582866cdeb633c1ed88485856b7f
+  data.tar.gz: 960570cff6bfc672295d5a1ca14fb9048d06f59b22ad89253f1aa93f701c6c84346c5fcb8bc12d183fa7981ad6464f372d5d898bd2ab05e4560bf5bd07c23841

data/Gemfile.lock

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

data/config/definitions.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 #
+# rubocop:disable Layout/LineLength
 # @!parse
 #   class Time
 #     class << self
@@ -16,7 +17,12 @@
 #       def workspaces; end
 #       # @return [Asana::ProxiedResourceClasses::Section]
 #       def sections; end
+#       # @return [Asana::ProxiedResourceClasses::Project]
+#       def projects; end
+#       # @return [Asana::ProxiedResourceClasses::UserTaskList]
+#       def user_task_lists; end
 #     end
+#     class Collection < Asana::Resources::Collection; end
 #     module Resources
 #       class Task
 #         # @return [String, nil]
@@ -45,6 +51,42 @@
 #         # @param options [Hash] the request I/O options.
 #         # @return [Asana::Resources::Task]
 #         def find_by_id(id, options: {}); end
+#         # Returns the compact task records for some filtered set of tasks. Use one
+#         # or more of the parameters provided to filter the tasks returned. You must
+#         # specify a `project`, `section`, `tag`, or `user_task_list` if you do not
+#         # specify `assignee` and `workspace`.
+#         #
+#         # @param assignee [String] The assignee to filter tasks on.
+#         # @param workspace [String] The workspace or organization to filter tasks on.
+#         # @param project [String] The project to filter tasks on.
+#         # @param section [Gid] The section to filter tasks on.
+#         # @param tag [Gid] The tag to filter tasks on.
+#         # @param user_task_list [Gid] The user task list to filter tasks on.
+#         # @param completed_since [String] Only return tasks that are either incomplete or that have been
+#         # completed since this time.
+#         #
+#         # @param modified_since [String] Only return tasks that have been modified since the given time.
+#         #
+#         # @param per_page [Integer] the number of records to fetch per page.
+#         # @param options [Hash] the request I/O options.
+#         # Notes:
+#         #
+#         # If you specify `assignee`, you must also specify the `workspace` to filter on.
+#         #
+#         # If you specify `workspace`, you must also specify the `assignee` to filter on.
+#         #
+#         # Currently, this is only supported in board views.
+#         #
+#         # A task is considered "modified" if any of its properties change,
+#         # or associations between it and other objects are modified (e.g.
+#         # a task being added to a project). A task is not considered modified
+#         # just because another object it is associated with (e.g. a subtask)
+#         # is modified. Actions that count as modifying the task include
+#         # assigning, renaming, completing, and adding stories.
+#         # @return [Asana::Collection<Asana::Resources::Task>]
+#         def find_all(assignee: nil, workspace: nil, project: nil, section: nil,
+#                      tag: nil, user_task_list: nil, completed_since: nil,
+#                      modified_since: nil, per_page: 20, options: {}); end
 #         # @param section [Asana::Resources::section]
 #         # @param options [Hash] the request I/O options.
 #         # @return [Array<Asana::Resources::Task>]
@@ -66,5 +108,35 @@
 #         # @return [Array<Asana::Resources::Section>]
 #         def get_sections_for_project(client, project_gid:, options: {}); end
 #       end
+#       class Project
+#         # Returns the compact project records for all projects in the workspace.
+#         #
+#         # @param workspace [Strin] The workspace or organization to find projects in.
+#         # @param is_template [Boolean] **Note: This parameter can only be included if a team is also defined, or the workspace is not an organization**
+#         # Filters results to include only template projects.
+#         #
+#         # @param archived [Boolean] Only return projects whose `archived` field takes on the value of
+#         # this parameter.
+#         #
+#         # @param per_page [Integer] the number of records to fetch per page.
+#         # @param options [Hash] the request I/O options.
+#         # @return [Asana::Collection<Asana::Resources::Project>]
+#         def find_by_workspace(client, workspace: required("workspace"), is_template: nil, archived: nil, per_page: 20, options: {}); end
+#         # Returns the complete project record for a single project.
+#         #
+#         # @param id [String] The project to get.
+#         # @param options [Hash] the request I/O options.
+#         # @return [Asana::Resources::Project]
+#         def find_by_id(id, options: {}); end
+#       end
+#       class UserTaskList
+#         # @param user_gid [String]  (required) A string identifying a user. This can either be the string \"me\", an email, or the gid of a user.
+#         # @param workspace [String]  (required) The workspace in which to get the user task list.
+#         # @param options [Hash] the request I/O options
+#         # @return [Asana::Resources::UserTaskList]
+#         def get_user_task_list_for_user(client, user_gid:,
+#             workspace: nil, options: {}); end
+#       end
 #     end
 #   end
+# rubocop:enable Layout/LineLength

data/lib/checkoff/projects.rb

@@ -17,19 +17,18 @@ module Checkoff
   # Work with projects in Asana
   class Projects
     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
 
     # @!parse
     #   extend CacheMethod::ClassMethods
 
+    # @param config [Hash<Symbol, Object>]
     # @param client [Asana::Client]
+    # @param workspaces [Checkoff::Workspaces]
     def initialize(config: Checkoff::Internal::ConfigLoader.load(:asana),
                    client: Checkoff::Clients.new(config: config).client,
                    workspaces: Checkoff::Workspaces.new(config: config,
@@ -59,8 +58,9 @@ module Checkoff
       if project_name.is_a?(Symbol) && project_name.to_s.start_with?('my_tasks')
         my_tasks(workspace_name)
       else
-        projects = projects_by_workspace_name(workspace_name)
-        projects.find do |project|
+        # @type [Asana::Collection<Asana::Resources::Project>]
+        ps = projects_by_workspace_name(workspace_name)
+        ps.find do |project|
           project.name == project_name
         end
       end
@@ -80,13 +80,12 @@ module Checkoff
 
     # find uncompleted tasks in a list
     # @param [Array<Asana::Resources::Task>] tasks
-    # @return [Array<Asana::Resources::Task>]
+    # @return [Enumerable<Asana::Resources::Task>]
     def active_tasks(tasks)
       tasks.select { |task| task.completed_at.nil? }
     end
 
     # pull task objects from a named project
-    # @sg-ignore
     # @param [Asana::Resources::Project] project
     # @param [Boolean] only_uncompleted
     # @param [Array<String>] extra_fields
@@ -102,31 +101,30 @@ module Checkoff
 
     private
 
+    # @return [Asana::Client]
     attr_reader :client
 
-    # @sg-ignore
+    # @return [Asana::ProxiedResourceClasses::Project]
     def projects
       client.projects
     end
     cache_method :projects, LONG_CACHE_TIME
 
-    # @sg-ignore
     # @param [String] workspace_name
-    # @return [Array<Asana::Resources::Project>]
+    # @return [Asana::Collection<Asana::Resources::Project>]
     def projects_by_workspace_name(workspace_name)
       workspace = @workspaces.workspace_or_raise(workspace_name)
       raise "Could not find workspace named #{workspace_name}" unless workspace
 
-      projects.find_by_workspace(workspace: workspace.gid)
+      projects.find_by_workspace(workspace: workspace.gid, per_page: 100)
     end
+    cache_method :projects_by_workspace_name, LONG_CACHE_TIME
 
-    # @sg-ignore
     # @param [String] workspace_name
     # @return [Asana::Resources::Project]
     def my_tasks(workspace_name)
       workspace = @workspaces.workspace_or_raise(workspace_name)
       # @sg-ignore
-      # @type [Asana::Resources::UserTaskList]
       result = client.user_task_lists.get_user_task_list_for_user(user_gid: 'me',
                                                                   workspace: workspace.gid)
       gid = result.gid

data/lib/checkoff/sections.rb

@@ -59,6 +59,7 @@ module Checkoff
       # @sg-ignore
       client.sections.get_sections_for_project(project_gid: project.gid)
     end
+    cache_method :sections_or_raise, SHORT_CACHE_TIME
 
     # Given a workspace name and project name, then provide a Hash of
     # tasks with section name -> task list of the uncompleted tasks

data/lib/checkoff/tasks.rb

@@ -162,10 +162,10 @@ module Checkoff
       # @sg-ignore
       # @type [Array<Asana::Resources::Task>, nil]
       dependencies = task.instance_variable_get(:@dependencies)
-      dependencies = task.dependencies if dependencies.nil?
+      dependencies = task.dependencies.map { |task| { 'gid' => task.gid } } if dependencies.nil?
 
       dependencies.any? do |parent_task_info|
-        parent_task_gid = parent_task_info.gid
+        parent_task_gid = parent_task_info.fetch('gid')
         parent_task = @asana_task.find_by_id(client, parent_task_gid,
                                              options: { fields: ['completed'] })
         !parent_task.completed

data/lib/checkoff/version.rb

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

data/lib/checkoff/workspaces.rb

@@ -41,6 +41,7 @@ module Checkoff
         workspace.name == workspace_name
       end
     end
+    cache_method :workspace, LONG_CACHE_TIME
 
     # @return [Asana::Resources::Workspace]
     def default_workspace

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: checkoff
 version: !ruby/object:Gem::Version
-  version: 0.44.1
+  version: 0.44.3
 platform: ruby
 authors:
 - Vince Broz
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-07-01 00:00:00.000000000 Z
+date: 2023-07-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport