fbe 0.40.0 → 0.41.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d19c0535556f2bc17f04be6cd25be80552d3016e22d1abc52ad867425e29cd31
-  data.tar.gz: 9a9dc13820984a088462dae32ce4b1c3adeb236290770a56529ee9aa1308405e
+  metadata.gz: e5e897714a3789136f4e029b50a785506d23a21e3a666c670ce470aadc87eb1c
+  data.tar.gz: f1a86de706ff760e725f56ac060c4a36c5b5a5c4def42ffb4c46c289852b2e91
 SHA512:
-  metadata.gz: d81b8b123cd43763746e53d02f62b9f2430fb9ab0a21e70d4f6250ca499ac5a3fc59775ddfbd37138fadcc8c7d51f0cc8a724e4923c3c9837deecd022d3c789b
-  data.tar.gz: 63e1fd591916726362b7fdc68c2153f57f3e2a22c5db01b4d280262d6dd3fbbf86b573bc612c2e4c3fb51b8e0211f7c89e910f0b85bdb59bf1edfa4913f3e7ab
+  metadata.gz: 51a2136d5e94ee50f1fa941e368976a91502e8a4469d0e4bd4fcf87cb6b0f90b86393224a28daf48b315c072c2f4c474eafa89fc41ce526df15b193be6d85bbb
+  data.tar.gz: dc51650d3aa4c74680070d50fac3488b6d49ea591ad8231a6a2b3e311f1abb63f11aeea895545b6fed63a1c7c385da068dd53f53ed931c192b710e93302d3cf3

data/.github/workflows/reuse.yml

@@ -16,4 +16,4 @@ jobs:
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v5
-      - uses: fsfe/reuse-action@v5
+      - uses: fsfe/reuse-action@v6

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.37.2
+      - uses: crate-ci/typos@v1.38.1
         with:
           config: .github/.typos.toml

data/Gemfile.lock

@@ -146,7 +146,7 @@ GEM
     logger (1.7.0)
     loog (0.6.1)
       logger (~> 1.0)
-    minitest (5.25.5)
+    minitest (5.26.0)
     minitest-reporters (1.7.1)
       ansi
       builder

data/lib/fbe/conclude.rb

@@ -8,6 +8,7 @@ require_relative '../fbe'
 require_relative 'fb'
 require_relative 'if_absent'
 require_relative 'octo'
+require_relative 'over'
 
 # Creates an instance of {Fbe::Conclude} and evals it with the block provided.
 #
@@ -195,29 +196,16 @@ class Fbe::Conclude
   #     end
   #   end
   def roll(&)
-    if @lifetime_aware && @options.lifetime && Time.now - @epoch > @options.lifetime * 0.9
-      @loog.debug("We ran out of lifetime (#{@epoch.ago} already), can't even start")
-      return
-    end
-    if @timeout_aware && @options.timeout && Time.now - @kickoff > @options.timeout * 0.9
-      @loog.debug("We've spent more than #{@kickoff.ago}, won't even start")
-      return
-    end
+    return 0 if Fbe.over?(
+      global: @global, options: @options, loog: @loog, epoch: @epoch, kickoff: @kickoff,
+      quota_aware: @quota_aware, lifetime_aware: @lifetime_aware, timeout_aware: @timeout_aware
+    )
     passed = 0
-    oct = Fbe.octo(loog: @loog, options: @options, global: @global)
     @fb.query(@query).each do |a|
-      if @quota_aware && oct.off_quota?(threshold: 100)
-        @loog.info('We ran out of GitHub quota, must stop here')
-        break
-      end
-      if @lifetime_aware && @options.lifetime && Time.now - @epoch > @options.lifetime * 0.9
-        @loog.debug("We ran out of lifetime (#{@epoch.ago} already), must stop here")
-        break
-      end
-      if @timeout_aware && @options.timeout && Time.now - @kickoff > @options.timeout * 0.9
-        @loog.debug("We've spent more than #{@kickoff.ago}, must stop here")
-        break
-      end
+      break if Fbe.over?(
+        global: @global, options: @options, loog: @loog, epoch: @epoch, kickoff: @kickoff,
+        quota_aware: @quota_aware, lifetime_aware: @lifetime_aware, timeout_aware: @timeout_aware
+      )
       @fb.txn do |fbt|
         n = yield fbt, a
         @loog.info("#{n.what}: #{n.details}") unless n.nil?
@@ -226,6 +214,9 @@ class Fbe::Conclude
     end
     @loog.debug("Found and processed #{passed} facts by: #{@query}")
     passed
+  rescue Fbe::OffQuota => e
+    @loog.info(e.message)
+    passed
   end
 
   # Populates a new fact based on a previous fact and a processing block.

data/lib/fbe/github_graph.rb

@@ -95,16 +95,32 @@ class Fbe::Graph
   # @param [String] owner The repository owner (username or organization)
   # @param [String] name The repository name
   # @param [String] branch The branch name (e.g., "master" or "main")
-  # @return [Integer] The total number of commits in the branch
+  # @param [Array<Array<String, String, String>> repos List of owner, name, branch
+  # @return [Integer, Array<Hash>] The total number of commits in the branch or array with hash
   # @example
   #   graph = Fbe::Graph.new(token: 'github_token')
   #   count = graph.total_commits('octocat', 'Hello-World', 'main')
   #   puts count #=> 42
-  def total_commits(owner, name, branch)
-    result = query(
-      <<~GRAPHQL
-        {
-          repository(owner: "#{owner}", name: "#{name}") {
+  # @example
+  #   result = Fbe.github_graph.total_commits(
+  #     repos: [
+  #       ['zerocracy', 'fbe', 'master'],
+  #       ['zerocracy', 'judges-action', 'master']
+  #     ]
+  #   )
+  #   puts result #=>
+  #   [{"owner"=>"zerocracy", "name"=>"fbe", "branch"=>"master", "total_commits"=>754},
+  #    {"owner"=>"zerocracy", "name"=>"judges-action", "branch"=>"master", "total_commits"=>2251}]
+  def total_commits(owner = nil, name = nil, branch = nil, repos: nil)
+    raise 'Need owner, name and branch or repos' if owner.nil? && name.nil? && branch.nil? && repos.nil?
+    raise 'Owner, name and branch is required' if (owner.nil? || name.nil? || branch.nil?) && repos.nil?
+    raise 'Repos list cannot be empty' if owner.nil? && name.nil? && branch.nil? && repos&.empty?
+    raise 'Need only owner, name and branch or repos' if (!owner.nil? || !name.nil? || !branch.nil?) && !repos.nil?
+    repos ||= [[owner, name, branch]]
+    requests =
+      repos.each_with_index.map do |(owner, name, branch), i|
+        <<~GRAPHQL
+          repo_#{i}: repository(owner: "#{owner}", name: "#{name}") {
             ref(qualifiedName: "#{branch}") {
               target {
                 ... on Commit {
@@ -115,10 +131,25 @@ class Fbe::Graph
               }
             }
           }
+        GRAPHQL
+      end
+    result = query("{\n#{requests.join("\n")}\n}")
+    if owner && name && branch
+      ref = result.repo_0&.ref
+      raise "Repository '#{owner}/#{name}' or branch '#{branch}' not found" unless ref&.target&.history
+      ref.target.history.total_count
+    else
+      repos.each_with_index.map do |(owner, name, branch), i|
+        ref = result.send(:"repo_#{i}")&.ref
+        raise "Repository '#{owner}/#{name}' or branch '#{branch}' not found" unless ref&.target&.history
+        {
+          'owner' => owner,
+          'name' => name,
+          'branch' => branch,
+          'total_commits' => ref.target.history.total_count
         }
-      GRAPHQL
-    )
-    result.repository.ref.target.history.total_count
+      end
+    end
   end
 
   # Gets the total number of issues and pull requests in a repository.
@@ -451,12 +482,28 @@ class Fbe::Graph
 
     # Returns mock total commit count.
     #
-    # @param [String] _owner Repository owner (ignored)
-    # @param [String] _name Repository name (ignored)
-    # @param [String] _branch Branch name (ignored)
-    # @return [Integer] Always returns 1484
-    def total_commits(_owner, _name, _branch)
-      1484
+    # @param [String] owner Repository owner
+    # @param [String] name Repository name
+    # @param [String] branch Branch name
+    # @param [Array<Array<String, String, String>> repos List of owner, name, branch
+    # @return [Integer, Array<Hash>] Returns 1484 for single repo or array of hashes
+    def total_commits(owner = nil, name = nil, branch = nil, repos: nil)
+      raise 'Need owner, name and branch or repos' if owner.nil? && name.nil? && branch.nil? && repos.nil?
+      raise 'Owner, name and branch is required' if (owner.nil? || name.nil? || branch.nil?) && repos.nil?
+      raise 'Repos list cannot be empty' if owner.nil? && name.nil? && branch.nil? && repos&.empty?
+      raise 'Need only owner, name and branch or repos' if (!owner.nil? || !name.nil? || !branch.nil?) && !repos.nil?
+      if owner && name && branch
+        1484
+      else
+        repos.each_with_index.map do |(owner, name, branch), _i|
+          {
+            'owner' => owner,
+            'name' => name,
+            'branch' => branch,
+            'total_commits' => 1484
+          }
+        end
+      end
     end
 
     # Returns mock issue type event data.

data/lib/fbe/iterate.rb

@@ -10,6 +10,7 @@ require_relative '../fbe'
 require_relative 'fb'
 require_relative 'if_absent'
 require_relative 'octo'
+require_relative 'over'
 require_relative 'overwrite'
 require_relative 'unmask_repos'
 
@@ -267,29 +268,19 @@ class Fbe::Iterate
     starts = before.dup
     values = {}
     loop do
-      if @quota_aware && oct.off_quota?(threshold: 100)
-        @loog.info("We are off GitHub quota, time to stop after #{started.ago}")
-        break
-      end
-      if @lifetime_aware && @options.lifetime && Time.now - @epoch > @options.lifetime * 0.9
-        @loog.debug("We ran out of lifetime (#{@epoch.ago} already), must stop here")
-        break
-      end
-      if @timeout_aware && @options.timeout && Time.now - @kickoff > @options.timeout * 0.9
-        @loog.debug("We've spent more than #{@kickoff.ago}, must stop here")
+      if Fbe.over?(
+        global: @global, options: @options, loog: @loog, epoch: @epoch, kickoff: @kickoff,
+        quota_aware: @quota_aware, lifetime_aware: @lifetime_aware, timeout_aware: @timeout_aware
+      )
+        @loog.info("Time to stop after #{started.ago}")
         break
       end
       repos.each do |repo|
-        if @quota_aware && oct.off_quota?(threshold: 100)
-          @loog.info("We are off GitHub quota, we must skip #{repo}")
-          break
-        end
-        if @lifetime_aware && @options.lifetime && Time.now - @epoch > @options.lifetime * 0.9
-          @loog.info("We are working for #{@epoch.ago} already, won't check repository ##{repo}")
-          next
-        end
-        if @timeout_aware && @options.timeout && Time.now - @kickoff > @options.timeout * 0.9
-          @loog.debug("We've spent more than #{@kickoff.ago}, won't check repository ##{repo}")
+        if Fbe.over?(
+          global: @global, options: @options, loog: @loog, epoch: @epoch, kickoff: @kickoff,
+          quota_aware: @quota_aware, lifetime_aware: @lifetime_aware, timeout_aware: @timeout_aware
+        )
+          @loog.info("Won't check repository ##{repo}")
           break
         end
         next if restarted.include?(repo)
@@ -335,16 +326,23 @@ class Fbe::Iterate
         break
       end
     end
-    repos.each do |repo|
-      next if before[repo] == starts[repo]
-      f =
-        Fbe.if_absent(fb: @fb, always: true) do |n|
-          n.what = 'iterate'
-          n.where = 'github'
-          n.repository = repo
-        end
-      Fbe.overwrite(f, @label, before[repo], fb: @fb)
-    end
     @loog.debug("Finished scanning #{repos.size} repos in #{@kickoff.ago}: #{seen.map { |k, v| "#{k}:#{v}" }.joined}")
+  rescue Fbe::OffQuota => e
+    @loog.info(e.message)
+  ensure
+    if defined?(repos) && !repos.nil? &&
+       defined?(before) && !before.nil? &&
+       defined?(starts) && !starts.nil?
+      repos.each do |repo|
+        next if before[repo] == starts[repo]
+        f =
+          Fbe.if_absent(fb: @fb, always: true) do |n|
+            n.what = 'iterate'
+            n.where = 'github'
+            n.repository = repo
+          end
+        Fbe.overwrite(f, @label, before[repo], fb: @fb)
+      end
+    end
   end
 end

data/lib/fbe/over.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+# SPDX-FileCopyrightText: Copyright (c) 2024-2025 Zerocracy
+# SPDX-License-Identifier: MIT
+
+require_relative '../fbe'
+require_relative 'octo'
+
+# Check GitHub API quota, lifetime, and timeout.
+#
+# @param [Hash] global Hash of global options
+# @param [Judges::Options] options The options available globally
+# @param [Loog] loog Logging facility
+# @param [Time] epoch When the entire update started
+# @param [Time] kickoff When the particular judge started
+# @param [Boolean] quota_aware Enable or disable check of GitHub API quota
+# @param [Boolean] lifetime_aware Enable or disable check of lifetime limitations
+# @param [Boolean] timeout_aware Enable or disable check of timeout limitations
+# @return [Boolean] check result
+def Fbe.over?(
+  global: $global, options: $options, loog: $loog,
+  epoch: $epoch || Time.now, kickoff: $kickoff || Time.now,
+  quota_aware: true, lifetime_aware: true, timeout_aware: true
+)
+  if quota_aware && Fbe.octo(loog:, options:, global:).off_quota?(threshold: 100)
+    loog.info('We are off GitHub quota, time to stop')
+    return true
+  end
+  if lifetime_aware && options.lifetime && Time.now - epoch > options.lifetime * 0.9
+    loog.info("We ran out of lifetime (#{epoch.ago} already), must stop here")
+    return true
+  end
+  if timeout_aware && options.timeout && Time.now - kickoff > options.timeout * 0.9
+    loog.info("We've spent more than #{kickoff.ago}, must stop here")
+    return true
+  end
+  false
+end

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.40.0' unless const_defined?(:VERSION)
+  VERSION = '0.41.1' unless const_defined?(:VERSION)
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fbe
 version: !ruby/object:Gem::Version
-  version: 0.40.0
+  version: 0.41.1
 platform: ruby
 authors:
 - Yegor Bugayenko
@@ -384,6 +384,7 @@ files:
 - lib/fbe/middleware/sqlite_store.rb
 - lib/fbe/middleware/trace.rb
 - lib/fbe/octo.rb
+- lib/fbe/over.rb
 - lib/fbe/overwrite.rb
 - lib/fbe/pmp.rb
 - lib/fbe/regularly.rb