Skip builds if commit only includes CHANGELOG changes (#68)

Author: stevebachmeier

CHANGELOG.rst

@@ -1,3 +1,7 @@
+**2.0.12 - 10/22/2025**
+
+  - Skip Jenkins builds for CHANGELOG-only commits
+
 **2.0.11 - 10/7/2025**
 
   - Stop cacheing secondary uv pip install

vars/is_changelog_only_commit.groovy

@@ -0,0 +1,26 @@
+def call() {
+    // Check if the latest commit only contains changelog changes
+    def changedFiles = sh(
+        script: "git diff --name-only HEAD~1 HEAD || echo ''",
+        returnStdout: true
+    ).trim()
+    
+    // If no files are found (i.e. it's an empty commit), return false because
+    // we are likely pushing an empty commit to trigger a build
+    if (changedFiles == '') {
+        return false
+    }
+
+    // Check if all changed files in the latest commit are CHANGELOG files
+    def hasNonChangelogChanges = sh(
+        script: """
+            git diff --name-only HEAD~1 HEAD |
+            grep -v '^CHANGELOG' |
+            wc -l || echo '0'
+        """,
+        returnStdout: true
+    ).trim().toInteger() > 0
+    
+    // Return true if there is only changes to the changelog in the latest commit
+    return !hasNonChangelogChanges
+}

vars/reusable_pipeline.groovy

@@ -85,6 +85,7 @@ def call(Map config = [:]){
         // time we run pip, poetry, etc.
         ACTIVATE_BASE = "source ${CONDA_BIN_PATH}/activate &> /dev/null"
         IS_DOC_ONLY_CHANGE = "${is_doc_only_change()}"
+        IS_CHANGELOG_ONLY_COMMIT = "${is_changelog_only_commit()}"
     }
 
     agent { label "coordinator" }
@@ -154,8 +155,15 @@ def call(Map config = [:]){
       }
 
       stage("Python Versions") {
+        // Skip builds if this commit only contains changelog changes
+        when {
+          not {
+            environment name: 'IS_CHANGELOG_ONLY_COMMIT', value: 'true'
+          }
+        }
         steps {
           script {
+            
             def buildStages = build_stages()
 
             def parallelPythonVersions = [:]