fbe 0.38.2 → 0.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84ae98aaec66eaacc0865c0be05fc5490305a5e723c402c66eabc65d9d5490f2
-  data.tar.gz: 4d3922a6dbfd4b04d8ac2eda2a155fda33ddc3e2c71886c0b99d61558830ff26
+  metadata.gz: bcdd3a7dc6452b707cd14157c1009b9b7a1f551f9ea66c5cc31c08849e87a2d3
+  data.tar.gz: 2d1b97f86162a5e853df3a19e8ba6c4f96f398c51c19aa5a2bab0ee036cba1b4
 SHA512:
-  metadata.gz: 15d6d7d1b03ebe56d06fef55c9981ccd6a97c5c072bbf54a81e87c9841323659af82124b6e968e2a4d9d1495672830249c8b66a7273f8411b56a7d6b85f9b0a5
-  data.tar.gz: 79b5bd15396e2bed6317b1f202cd07f302c8a0db674165fafa1796da2119c0e22e2d218211106f4d6438b1aaa7012f1f102f80f59250908481876a00ebc6b956
+  metadata.gz: a8e6f7be8faebeaa3aa2ad93f809988ef7fba01265faa67da6bf0c292cf088f1a655305820b1a72570dcd2282a065a1f6570daa349c0ea26458beed96a3d0845
+  data.tar.gz: 4c2747bdf3bee54e7ecdf667db8d55f93323fc4448f1398753200b963404d5723e094f34064461787999456fa1316a551f470890dc7c6569310f28ccd8338c68

data/.github/workflows/typos.yml

@@ -16,6 +16,6 @@ jobs:
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v5
-      - uses: crate-ci/typos@v1.36.2
+      - uses: crate-ci/typos@v1.36.3
         with:
           config: .github/.typos.toml

data/Gemfile.lock

@@ -87,7 +87,7 @@ GEM
       others (~> 0.1)
       tago (~> 0.1)
       yaml (~> 0.3)
-    faraday (2.13.4)
+    faraday (2.14.0)
       faraday-net_http (>= 2.0, < 3.5)
       json
       logger
@@ -189,7 +189,7 @@ GEM
     regexp_parser (2.11.3)
     retries (0.0.5)
     rexml (3.4.4)
-    rubocop (1.80.2)
+    rubocop (1.81.1)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -197,7 +197,7 @@ GEM
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.46.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
     rubocop-ast (1.47.1)

data/lib/fbe/iterate.rb

@@ -97,6 +97,7 @@ class Fbe::Iterate
     @label = nil
     @since = 0
     @query = nil
+    @sort_by = nil
     @repeats = 1
     @quota_aware = true
     @lifetime_aware = true
@@ -164,6 +165,24 @@ class Fbe::Iterate
     @query = query
   end
 
+  # Sets the field to sort results by in ascending order.
+  #
+  # When set, all matching results will be fetched, sorted by the specified
+  # field, and iterated in order. This executes the query once per repository
+  # instead of calling one() repeatedly.
+  #
+  # @param [String] prop The fact attribute to sort by
+  # @return [nil] Nothing is returned
+  # @raise [RuntimeError] If prop is nil, already set, or not a valid field name
+  # @example Sort issues by number
+  #   iterator.sort_by('issue')
+  def sort_by(prop)
+    raise 'Sort field is already set' unless @sort_by.nil?
+    raise 'Cannot set sort field to nil' if prop.nil?
+    raise 'Sort field must be a String' unless prop.is_a?(String)
+    @sort_by = prop
+  end
+
   # Sets the label for tracking iteration state.
   #
   # The label is used to create marker facts in the factbase that track
@@ -245,6 +264,7 @@ class Fbe::Iterate
         ]
       end
     starts = before.dup
+    values = {}
     loop do
       if @quota_aware && oct.off_quota?
         @loog.info("We are off GitHub quota, time to stop after #{started.ago}")
@@ -277,11 +297,24 @@ class Fbe::Iterate
           @loog.debug("We've seen too many (#{seen[repo]}) in #{repo}, let's see next one")
           next
         end
-        nxt = @fb.query(@query).one(@fb, before: before[repo], repository: repo)
+        nxt =
+          if @sort_by
+            values[repo] ||= @fb.query(@query).each(
+              @fb, before: before[repo], repository: repo
+            ).map { _1[@sort_by]&.first }.compact.sort.each
+            begin
+              values[repo].next
+            rescue StopIteration
+              nil
+            end
+          else
+            @fb.query(@query).one(@fb, before: before[repo], repository: repo)
+          end
         before[repo] =
           if nxt.nil?
             @loog.debug("Next element after ##{before[repo]} not suggested, re-starting from ##{@since}: #{@query}")
             restarted << repo
+            values.delete(repo) if @sort_by
             @since
           else
             @loog.debug("Next is ##{nxt}, starting from it")

data/lib/fbe.rb

@@ -10,5 +10,5 @@
 # License:: MIT
 module Fbe
   # Current version of the gem (changed by +.rultor.yml+ on every release)
-  VERSION = '0.38.2' unless const_defined?(:VERSION)
+  VERSION = '0.39.0' unless const_defined?(:VERSION)
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fbe
 version: !ruby/object:Gem::Version
-  version: 0.38.2
+  version: 0.39.0
 platform: ruby
 authors:
 - Yegor Bugayenko