plan_my_stuff 0.15.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8a3c6c6445f04d677b6d6b4f0219f57326346b3f42aee6839ab98a0bbf680e63
-  data.tar.gz: f5f5adb4f7a11e2d35b907ae7ab1e15d9dc47f31313355be7da186bf9c5086d6
+  metadata.gz: 782add7d506a645b1f2c19c413de0ef21c91d31a91e07280c003523767a48368
+  data.tar.gz: c20c6aa1e5f98d297cfbcbae5c57c7c5d13dd24b746d26374294196e50b983a5
 SHA512:
-  metadata.gz: a31f3331be41dcd8c4a1369f729888e06ec64474a58c0b56d2c7d57d69b647b1f33b7acc0ae4eed26f03491ce5736a3ab60656900fc31e731bbadd2ae68c492c
-  data.tar.gz: 429281e1a5b431ab29fc5c2d91f15176c7556533df7a94d9990dc3e98a198d5b2d603205bd29f5d4efd210c131bc67b7d440de296857f2eeddd5c085fbc799a2
+  metadata.gz: bfcd02d86fa108d59ba15c75b3a7741c0d5c6c2cac701ac785d5d73aeee57025926910785383f5eac0f0c9fdb63ef32a9f72e2174e55ce0cf0c69dcac0c96f00
+  data.tar.gz: 8439a857e4d4a170b3802cbe34e040e940915c2b07dca61ea0cf9cd2e9a2995f7b02d447318ecda24ad8891ec080b6b2317a9b9e4b471dd11862002064b3ea19

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.16.0
+
+### Added
+
+- `PlanMyStuff::Issue.count(repo:, state:, labels:)` returns the total count of matching issues via the
+  GitHub Search API in a single request, without paginating full issue payloads. Mirrors `Issue.list`
+  kwargs (minus `page`/`per_page`); returns an `Integer`. Excludes PRs server-side via the `is:issue`
+  qualifier.
+
 ## 0.15.0
 
 ### Breaking

data/lib/plan_my_stuff/issue.rb

@@ -312,6 +312,37 @@ module PlanMyStuff
         filtered.map { |gi| build(gi, repo: resolved_repo) }
       end
 
+      # Counts GitHub issues matching the given filters without paginating full payloads.
+      #
+      # Uses GitHub's Search API (+search/issues+), which returns +total_count+ in a single
+      # request. The +is:issue+ qualifier excludes PRs server-side.
+      #
+      # Caveats:
+      # - The search index lags writes by up to ~1 minute, so freshly created/closed issues
+      #   may not be reflected immediately.
+      # - The Search API has its own rate limit (30 req/min authenticated) separate from
+      #   the core REST API.
+      #
+      # @param repo [Symbol, String, nil] defaults to config.default_repo
+      # @param state [Symbol] :open, :closed, or :all
+      # @param labels [Array<String>]
+      #
+      # @return [Integer]
+      #
+      def count(repo: nil, state: :open, labels: [])
+        client = PlanMyStuff.client
+        resolved_repo = client.resolve_repo!(repo)
+
+        normalized_state = state.to_s
+        qualifiers = ["repo:#{resolved_repo}", 'is:issue']
+        qualifiers << "is:#{normalized_state}" unless normalized_state == 'all'
+        labels_to_use = Array.wrap(labels).sort
+        qualifiers += labels_to_use.map do |label|
+          "label:\"#{label}\""
+        end
+        client.rest(:search_issues, qualifiers.join(' '), per_page: 1).total_count
+      end
+
       # Submits one or more pre-built payloads to GitHub's "Import Issues" preview endpoint
       # (+POST /repos/:repo/import/issues+). One request per payload: the endpoint only accepts a single
       # +{issue:, comments:}+ payload at a time.

data/lib/plan_my_stuff/version.rb

@@ -3,7 +3,7 @@
 module PlanMyStuff
   module VERSION
     MAJOR = 0
-    MINOR = 15
+    MINOR = 16
     TINY = 0
 
     # Set PRE to nil unless it's a pre-release (beta, rc, etc.)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: plan_my_stuff
 version: !ruby/object:Gem::Version
-  version: 0.15.0
+  version: 0.16.0
 platform: ruby
 authors:
 - Brands Insurance