checkoff 0.94.0 → 0.95.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3728a0da90fb49dedd232b05722fbb87f03789d3bf9bc15513e4fa4b88f9e6fc
-  data.tar.gz: 16ce81c8b51905620414ff21f9469ce83c100a61985f355b8a27de20b7234b3c
+  metadata.gz: 31607f856925472f48fd4ae56a34d190bef6ea7105086b399e1f2755a0f1dfa5
+  data.tar.gz: 8af77b66a6a15caa5e5f3c5b46746f042d30d6ff56742845a6c537b3afe01d11
 SHA512:
-  metadata.gz: d73466d69b7b116eb8c58c0053b7cf13cedf288477e7cc8862de091fdd183e5a84355e19841e09df003da9b44d2b87ac90a459845c9186737069002f5312e455
-  data.tar.gz: 207d7d34ecdc3435892afe3b96860df2373e36067f8c75866f7b87d5a6f0aac0ebe89b0889b45d6a31ddec1ac6211f592fce4b657aa70ffad5e5c504deeea773
+  metadata.gz: 5da70b5bbbd6538afa7b7953dfff42ec6377afe959f224c548d8886e64b36f1c101425c1ee51e6fced39ed8b06baa5f3c0f1aa96e92078cfebf1e1949ae4c3c9
+  data.tar.gz: 93f0ae0f4b00cf74cad672b3492b927ea72dc9f2dabd9b052e98da20098953848a69c55e79bcceda6ce6ce8c21fa77b0c08aff8f3378d0cb15a516f17e04a23e

data/Gemfile.lock

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

data/config/definitions.rb

@@ -50,6 +50,8 @@
 #         def assignee; end
 #         # @return [String, nil]
 #         def html_notes; end
+#         # @return [Array<Hash{String => Hash{String => String}}>]
+#         def memberships; end
 #         class << self
 #           # @return [Asana::Resources::Task]
 #           def create(client, assignee:, workspace:, name:); end

data/lib/checkoff/internal/task_hashes.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Checkoff
+  module Internal
+    # Builds on the standard API representation of an Asana task with some
+    # convenience keys.
+    class TaskHashes
+      # @param task [Asana::Resources::Task]
+      # @return [Hash]
+      def task_to_h(task)
+        # @type [Hash]
+        task_hash = task.to_h
+        task_hash['unwrapped'] = {}
+        unwrap_custom_fields(task_hash)
+        unwrap_memberships(task_hash)
+        task_hash['task'] = task.name
+        task_hash
+      end
+
+      private
+
+      # @param task_hash [Hash]
+      # @return [void]
+      def unwrap_custom_fields(task_hash)
+        unwrapped_custom_fields = task_hash.fetch('custom_fields', []).group_by do |cf|
+          cf['name']
+        end.transform_values(&:first)
+        task_hash['unwrapped']['custom_fields'] = unwrapped_custom_fields
+      end
+
+      # @param task_hash [Hash]
+      # @param resource [String]
+      # @param key [String]
+      #
+      # @return [void]
+      def unwrap_membership(task_hash, resource, key)
+        # @sg-ignore
+        # @type [Array<Hash>]
+        memberships = task_hash.fetch('memberships', [])
+        # @sg-ignore
+        # @type [Hash]
+        unwrapped = task_hash.fetch('unwrapped')
+        unwrapped["membership_by_#{resource}_#{key}"] = memberships.group_by do |membership|
+          membership[resource][key]
+        end.transform_values(&:first)
+      end
+
+      # @param task_hash [Hash]
+      # @return [void]
+      def unwrap_memberships(task_hash)
+        unwrap_membership(task_hash, 'section', 'gid')
+        unwrap_membership(task_hash, 'project', 'gid')
+        unwrap_membership(task_hash, 'project', 'name')
+      end
+    end
+  end
+end

data/lib/checkoff/tasks.rb

@@ -6,6 +6,7 @@ require_relative 'sections'
 require_relative 'workspaces'
 require_relative 'internal/config_loader'
 require_relative 'internal/task_timing'
+require_relative 'internal/task_hashes'
 require 'asana'
 
 module Checkoff
@@ -145,6 +146,23 @@ module Checkoff
       end
     end
 
+    # Builds on the standard API representation of an Asana task with some
+    # convenience keys:
+    #
+    # <regular keys from API response>
+    # +
+    # unwrapped:
+    #  membership_by_section_gid: Hash<String, Hash (membership)>
+    #  membership_by_project_gid: Hash<String, Hash (membership)>
+    #  membership_by_project_name: Hash<String, Hash (membership)>
+    # task: String (name)
+    #
+    # @param task [Asana::Resources::Task]
+    # @return [Hash]
+    def task_to_h(task)
+      task_hashes.task_to_h(task)
+    end
+
     private
 
     # @return [Checkoff::Internal::TaskTiming]
@@ -152,6 +170,11 @@ module Checkoff
       @task_timing ||= Checkoff::Internal::TaskTiming.new(time_class: @time_class)
     end
 
+    # @return [Checkoff::Internal::TaskHashes]
+    def task_hashes
+      @task_hashes ||= Checkoff::Internal::TaskHashes.new
+    end
+
     # @param workspace_name [String]
     # @param project_name [String, Symbol]
     # @param section_name [String, nil, Symbol<:unspecified>]

data/lib/checkoff/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: checkoff
 version: !ruby/object:Gem::Version
-  version: 0.94.0
+  version: 0.95.0
 platform: ruby
 authors:
 - Vince Broz
@@ -152,6 +152,7 @@ files:
 - lib/checkoff/internal/selector_classes/task.rb
 - lib/checkoff/internal/selector_classes/task/function_evaluator.rb
 - lib/checkoff/internal/selector_evaluator.rb
+- lib/checkoff/internal/task_hashes.rb
 - lib/checkoff/internal/task_selector_evaluator.rb
 - lib/checkoff/internal/task_timing.rb
 - lib/checkoff/my_tasks.rb