gitlab-triage 1.22.0 → 1.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0490c10fa9f789e91502f3cb74a56bf4a830d200a58310f3aaa0475683f0717b'
-  data.tar.gz: 347c7aa604de9c1b042caaa21b7f8daf7e300c8aea7af175913174c51f90ed2d
+  metadata.gz: f64813b8d681fea2e5b23b4e53682089f4642a38037019658a3798456d219a77
+  data.tar.gz: 626bfa2d49c630ddab0f28c032b7665a96f07a65faa9b20da3812c538f3fcb42
 SHA512:
-  metadata.gz: c428c46630d38c57e6c7e9db9b4d05e7d3751863163497c19f45b114a0d7b280cfe891c6bf595997ed45505881bc5f7eec4ad59934fe26a6f03f59fe3e533d63
-  data.tar.gz: 86b73ca21f856a51c9f4d5d79e40d2470003527aeae3910f5313df11121e705d5a25698b2e129e905cec2fd17e1e3cbe193a4f84dba2eb69e3a6c0db7d6964a4
+  metadata.gz: 5114d8ccdeccf7da91c2326f0b25c8ab3fe2c478ac4a90051f0757b545a90fc7087b16f573eae22e6ca85f0c3e9ded9e3e8d9299f8aad806325edee83b72753b
+  data.tar.gz: e03e119075fb170f5cfd424b6ec07c6739efc0975c928aeeea04c60cb01e2e89e0f596b1a84cd0d446073d0d20bcb6c9cc9bad7c65f590fd1ec9c15093b9556b

data/README.md

@@ -153,6 +153,7 @@ Used to declare a condition that must be satisfied by a resource before actions
 Available condition types:
 - [`date` condition](#date-condition)
 - [`milestone` condition](#milestone-condition)
+- [`iteration` condition](#iteration-condition)
 - [`state` condition](#state-condition)
 - [`upvotes` condition](#upvotes-condition)
 - [`labels` condition](#labels-condition)
@@ -209,6 +210,25 @@ conditions:
   milestone: v1
 ```
 
+##### Iteration condition
+
+Accepts the name of an iteration to filter upon. Also accepts the following
+timebox values:
+
+- `none`
+- `any`
+
+See the [`iteration_id` API field documentation](https://docs.gitlab.com/ee/api/issues.html) for their meaning.
+
+Example:
+
+```yml
+conditions:
+  iteration: none
+```
+
+> **Note:** This query is not supported using GraphQL yet.
+
 ##### State condition
 
 Accepts a string.
@@ -1060,6 +1080,7 @@ Here's a list of currently available Ruby expression API:
 | ----                    | ----            | ----        |
 | resource                | Hash            | The hash containing the raw data of the resource. Note that `resource[:type]` is the type of the policy (`issues`, `merge_requests`, or `epics`), not the API `type` field. |
 | author                  | String          | The username of the resource author |
+| state                   | String          | The state of the resource |
 | milestone               | Milestone       | The milestone attached to the resource |
 | labels                  | [Label]         | A list of labels, having only names |
 | labels_with_details     | [Label]         | A list of labels which has more information loaded from another API request |
@@ -1069,6 +1090,14 @@ Here's a list of currently available Ruby expression API:
 | project_path            | String          | The path with namespace to the issues or merge requests project |
 | full_resource_reference | String          | A full reference including project path to the issue or merge request |
 
+##### Methods for `Issue` (issue context)
+
+| Name                   | Return type    | Description |
+| ----                   | ----           | ----        |
+| merge_requests_count   | Integer        | The number of merge requests related to the issue |
+| related_merge_requests | [MergeRequest] | The list of merge requests related to the issue |
+| closed_by              | [MergeRequest] | The list of merge requests that close the issue |
+
 ##### Methods for `MergeRequest` (merge request context)
 
 | Method              | Return type | Description |

data/lib/gitlab/triage/engine.rb

@@ -38,6 +38,7 @@ module Gitlab
         merge_requests: %w[opened closed merged]
       }.with_indifferent_access.freeze
       MILESTONE_TIMEBOX_VALUES = %w[none any upcoming started].freeze
+      ITERATION_SELECTION_VALUES = %w[none any].freeze
       EpicsTriagingForProjectImpossibleError = Class.new(StandardError)
 
       def initialize(policies:, options:, network_adapter_class: DEFAULT_NETWORK_ADAPTER, graphql_network_adapter_class: DEFAULT_GRAPHQL_ADAPTER)
@@ -436,9 +437,21 @@ module Gitlab
         APIQueryBuilders::SingleQueryParamBuilder.new(*args)
       end
 
+      def iteration_condition_builder(iteration_value)
+        # Issues API should use the `iteration_id` param for timebox values, and `iteration_title` for iteration title
+        args =
+          if ITERATION_SELECTION_VALUES.include?(iteration_value.downcase)
+            ['iteration_id', iteration_value.titleize] # The API only accepts titleized values.
+          else
+            ['iteration_title', iteration_value]
+          end
+        APIQueryBuilders::SingleQueryParamBuilder.new(*args)
+      end
+
       def issues_resource_query(conditions)
         [].tap do |condition_builders|
           condition_builders << APIQueryBuilders::SingleQueryParamBuilder.new('weight', conditions[:weight]) if conditions[:weight]
+          condition_builders << iteration_condition_builder(conditions[:iteration]) if conditions[:iteration]
         end
       end
 

data/lib/gitlab/triage/resource/issue.rb

@@ -8,6 +8,22 @@ module Gitlab
     module Resource
       class Issue < Base
         include Shared::Issuable
+
+        def merge_requests_count
+          @merge_requests_count ||= resource.dig(:merge_requests_count)
+        end
+
+        def related_merge_requests
+          @related_merge_requests ||= network.query_api_cached(
+            resource_url(sub_resource_type: 'related_merge_requests'))
+            .map { |merge_request| MergeRequest.new(merge_request, parent: self) }
+        end
+
+        def closed_by
+          @closed_by ||= network.query_api_cached(
+            resource_url(sub_resource_type: 'closed_by'))
+            .map { |merge_request| MergeRequest.new(merge_request, parent: self) }
+        end
       end
     end
   end

data/lib/gitlab/triage/resource/shared/issuable.rb

@@ -47,6 +47,10 @@ module Gitlab
             @labels_chronologically ||= labels_with_details.sort_by(&:added_at)
           end
 
+          def state
+            @state ||= resource.dig(:state)
+          end
+
           def author
             @author ||= resource.dig(:author, :username)
           end

data/lib/gitlab/triage/version.rb

@@ -2,6 +2,6 @@
 
 module Gitlab
   module Triage
-    VERSION = '1.22.0'
+    VERSION = '1.23.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitlab-triage
 version: !ruby/object:Gem::Version
-  version: 1.22.0
+  version: 1.23.0
 platform: ruby
 authors:
 - GitLab
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-26 00:00:00.000000000 Z
+date: 2022-02-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport