git-maintain 0.11.0 → 0.13.0

data/lib/git-maintain/travis.rb

@@ -0,0 +1,179 @@
+# Main module for git-maintain repository maintenance tool.
+module GitMaintain
+    # CI adapter class for Travis CI integration.
+    class TravisCI < CI
+        # Base URL for Travis CI API.
+        TRAVIS_URL='https://api.travis-ci.com/'
+
+        # Initialize TravisCI adapter.
+        #
+        # @param repo [Repo] The Repo instance
+        def initialize(repo)
+            super(repo)
+            @url = TRAVIS_URL
+        end
+
+        private
+        # Get the Travis build status string for a specific commit SHA.
+        #
+        # @param sha1 [String] Commit SHA
+        # @param resp [Hash] API response payload containing branch builds
+        # @return [String] Build status string (e.g. 'passed', 'failed')
+        def getState(sha1, resp)
+            br = findBranch(sha1, resp)
+            return "not found" if br == nil
+
+            return br["state"]
+        end
+
+        # Fetch the build logs from Travis CI for a specific commit SHA.
+        #
+        # @param sha1 [String] Commit SHA
+        # @param resp [Hash] API response payload
+        # @return [String] Build log output text
+        # @raise [GitMaintainError] If no build is found for the commit
+        def getLog(sha1, resp)
+            br = findBranch(sha1, resp)
+            raise GitMaintainError.new("Travis build not found") if br == nil
+            job_id = br["job_ids"].last().to_s()
+            return getJson(@url, "travis_log_" + job_id, 'jobs/' + job_id + '/log', false)
+        end
+
+        # Get the Travis build timestamp for a specific commit SHA.
+        #
+        # @param sha1 [String] Commit SHA
+        # @param resp [Hash] API response payload
+        # @return [String] Build started-at timestamp string
+        # @raise [GitMaintainError] If no build is found for the commit
+        def getTS(sha1, resp)
+            br = findBranch(sha1, resp)
+            raise GitMaintainError.new("Travis build not found") if br == nil
+            return br["started_at"]
+        end
+
+        # Check if the build status string represents success.
+        #
+        # @param sha1 [String] Commit SHA
+        # @param resp [Hash] API response payload
+        # @return [Boolean] True if build passed
+        def checkState(sha1, resp)
+            return getState(sha1, resp) == "passed"
+        end
+
+        # Fetch validation branch builds JSON payload from Travis CI API.
+        #
+        # @return [Hash] JSON API response
+        # @raise [GitMaintainError] If API request fails
+        def getBrValidJson()
+            return getJson(@url, :travis_br_valid, 'repos/' + @repo.remote_valid + '/branches')
+        end
+
+        # Fetch stable branch builds JSON payload from Travis CI API.
+        #
+        # @return [Hash] JSON API response
+        # @raise [GitMaintainError] If API request fails
+        def getBrStableJson()
+            return getJson(@url, :travis_br_stable, 'repos/' + @repo.remote_stable + '/branches')
+        end
+
+        # Find the specific branch build matching the given commit SHA.
+        #
+        # @param sha1 [String] Commit SHA
+        # @param resp [Hash] API response branches payload
+        # @return [Hash, nil] Branch build dictionary, or nil if not found
+        # @raise [GitMaintainError] If API response is missing expected commit keys
+        def findBranch(sha1, resp)
+            log(:DEBUG_CI, "Looking for build for #{sha1}")
+            resp["branches"].each(){|br|
+                commit=resp["commits"].select(){|e| e["id"] == br["commit_id"]}.first()
+                raise GitMaintainError.new("Incomplete JSON received from Travis") if commit == nil
+                log(:DEBUG_CI, "Found entry for sha #{commit["sha"]}")
+                next if commit["sha"] != sha1
+                return br
+            }
+            return nil
+        end
+
+        public
+        # Retrieve the validation build state for a specific branch and commit.
+        #
+        # @param br [Branch] The Branch instance
+        # @param sha1 [String] Commit SHA
+        # @return [String] Build status string (e.g. 'passed')
+        def getValidState(br, sha1)
+            return getState(sha1, getBrValidJson())
+        end
+
+        # Check if the validation build is successful.
+        #
+        # @param br [Branch] The Branch instance
+        # @param sha1 [String] Commit SHA
+        # @return [Boolean] True if build passed
+        def checkValidState(br, sha1)
+            return checkState(sha1, getBrValidJson())
+        end
+
+        # Retrieve the validation build log.
+        #
+        # @param br [Branch] The Branch instance
+        # @param sha1 [String] Commit SHA
+        # @return [String] Build log output text
+        def getValidLog(br, sha1)
+            return getLog(sha1, getBrValidJson())
+        end
+
+        # Retrieve the validation build timestamp.
+        #
+        # @param br [Branch] The Branch instance
+        # @param sha1 [String] Commit SHA
+        # @return [String] Build timestamp
+        def getValidTS(br, sha1)
+            return getTS(sha1, getBrValidJson())
+        end
+
+        # Retrieve the stable build state for a specific branch and commit.
+        #
+        # @param br [Branch] The Branch instance
+        # @param sha1 [String] Commit SHA
+        # @return [String] Build status string (e.g. 'passed')
+        def getStableState(br, sha1)
+            return getState(sha1, getBrStableJson())
+        end
+
+        # Check if the stable build is successful.
+        #
+        # @param br [Branch] The Branch instance
+        # @param sha1 [String] Commit SHA
+        # @return [Boolean] True if build passed
+        def checkStableState(br, sha1)
+            return checkState(sha1, getBrStableJson())
+        end
+
+        # Retrieve the stable build log.
+        #
+        # @param br [Branch] The Branch instance
+        # @param sha1 [String] Commit SHA
+        # @return [String] Build log output text
+        def getStableLog(br, sha1)
+            return getLog(sha1, getBrStableJson())
+        end
+
+        # Retrieve the stable build timestamp.
+        #
+        # @param br [Branch] The Branch instance
+        # @param sha1 [String] Commit SHA
+        # @return [String] Build timestamp
+        def getStableTS(br, sha1)
+            return getTS(sha1, getBrStableJson())
+        end
+
+        # Check if the CI build status represents an error/failure.
+        #
+        # @param br [Branch] The Branch instance
+        # @param status [String] CI status string
+        # @return [Boolean] True if build errored or failed
+        def isErrored(br, status)
+            return status == "failed" || status == "errored"
+        end
+    end
+end

data/lib/git-maintain.rb

@@ -0,0 +1,2 @@
+require_relative 'git-maintain/error'
+require_relative 'git-maintain/common'

metadata

@@ -1,15 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: git-maintain
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Nicolas Morey-Chaisemartin
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-04-15 00:00:00.000000000 Z
+date: 2026-09-09 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: cli_class_tool
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.0
 - !ruby/object:Gem::Dependency
   name: octokit
   requirement: !ruby/object:Gem::Requirement
@@ -38,19 +51,23 @@ files:
 - README.md
 - bin/git-maintain
 - git-maintain-completion.sh
-- lib/addons/RDMACore.rb
-- lib/addons/git-maintain.rb
-- lib/azure.rb
-- lib/branch.rb
-- lib/ci.rb
-- lib/common.rb
-- lib/repo.rb
-- lib/travis.rb
+- lib/git-maintain.rb
+- lib/git-maintain/addons/RDMACore.rb
+- lib/git-maintain/addons/git-maintain.rb
+- lib/git-maintain/addons/healthd.rb
+- lib/git-maintain/addons/hpc-testing.rb
+- lib/git-maintain/azure.rb
+- lib/git-maintain/branch.rb
+- lib/git-maintain/branch_iterator.rb
+- lib/git-maintain/ci.rb
+- lib/git-maintain/common.rb
+- lib/git-maintain/error.rb
+- lib/git-maintain/repo.rb
+- lib/git-maintain/travis.rb
 homepage: https://github.com/nmorey/git-maintain
 licenses:
 - GPL-3.0
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -65,8 +82,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.33
-signing_key: 
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Your ultimate script for maintaining stable branches and releasing your project.
 test_files: []

data/lib/azure.rb

@@ -1,98 +0,0 @@
-module GitMaintain
-    class AzureCI < CI
-        AZURE_URL='https://dev.azure.com/'
-
-        def initialize(repo, stable='', valid='')
-            super(repo)
-            @url = AZURE_URL
-            @stable_org=stable
-            @valid_org=valid
-        end
-
-        private
-        def getState(sha1, resp)
-            br = findBranch(sha1, resp)
-            return "not found" if br == nil
-            return "started" if br["result"] == nil
-            return br["result"].to_s()
-        end
-        def getLog(sha1, resp)
-            str=""
-            # br = findBranch(sha1, resp)
-            # raise("Travis build not found") if br == nil
-            # job_id = br["id"].to_s()
-            # logs= getJson(@url, "azure_log_list" + job_id,
-            #               @repo.name + "/_apis/build/builds/#{job_id}/logs?api-version=5.1")
-            # 1.upto(logs["count"]) { |x|
-            #     log(:DEBUG_CI, "Downloading log file #{x}/#{logs["count"]}")
-            #      nzstr = getJson(@url, "azure_log_" + job_id + '_' + x.to_s(),
-            #               @repo.name + "/_apis/build/builds/#{job_id}/logs/#{x}?api-version=5.1", false)
-            # # This is zipped. We need to extract it
-            # }
-            return str
-        end
-        def getTS(sha1, resp)
-            br = findBranch(sha1, resp)
-            raise("Travis build not found") if br == nil
-            return br["startTime"]
-        end
-        def checkState(sha1, resp)
-            st = getState(sha1, resp)
-            return  st == "passed"  || st == "succeeded"
-        end
-
-        def getBrValidJson()
-            raise("Validation organisation not provided") if @valid_org == ''
-            return getJson(@url + @valid_org + '/',
-                           :azure_br_valid, @repo.name + '/_apis/build/builds?api-version=5.1')
-        end
-        def getBrStableJson()
-            raise("Stable organisation not provided") if @stable_org == ''
-            return getJson(@url + @stable_org + '/',
-             :azure_br_stable, @repo.name + '/_apis/build/builds?api-version=5.1')
-        end
-        def findBranch(sha1, resp)
-            log(:DEBUG_CI, "Looking for build for #{sha1}")
-            resp["value"].each(){|br|
-                commit= br["sourceVersion"]
-                raise("Incomplete JSON received from Travis") if commit == nil
-                log(:DEBUG_CI, "Found entry for sha #{commit}")
-                next if commit != sha1
-                return br
-            }
-            return nil
-        end
-
-        public
-        def getValidState(br, sha1)
-            return getState(sha1, getBrValidJson())
-        end
-        def checkValidState(br, sha1)
-            return checkState(sha1, getBrValidJson())
-        end
-        def getValidLog(br, sha1)
-            return getLog(sha1, getBrValidJson())
-        end
-        def getValidTS(br, sha1)
-            return getTS(sha1, getBrValidJson())
-        end
-
-        def getStableState(br, sha1)
-            return getState(sha1, getBrStableJson())
-        end
-        def checkStableState(br, sha1)
-            return checkState(sha1, getBrStableJson())
-        end
-        def getStableLog(br, sha1)
-            return getLog(sha1, getBrStableJson())
-        end
-        def getStableTS(br, sha1)
-            return getTS(sha1, getBrStableJson())
-        end
-        def isErrored(br, status)
-            # https://docs.microsoft.com/en-us/rest/api/azure/devops/build/builds/list?
-            # view=azure-devops-rest-5.1#buildresult
-            return status == "failed"
-        end
-    end
-end