ci: manual job for updating in-repo go mods; ci to warn if files changed

.github/workflows/go-mod-auto-bump.yml

@@ -0,0 +1,66 @@
+# This workflow is used in order to automatically update go.mod in case one of:
+# * osmoutils
+# * osmomath
+# * x/ibc-hooks
+# * x/epochs
+# is updated.
+# It is triggerred by a manual workflow:
+# https://github.com/osmosis/osmosis/actions/workflows/go-mod-auto-bump.yml
+
+name: Go Mod Auto Version Update
+on:
+  workflow_dispatch:
+    inputs:
+      target-branch:
+        description: 'Target Branch'
+        default: ''
+        required: true
+permissions:
+    contents: write
+
+jobs:
+  update_go_mod:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+        with: 
+          fetch-depth: 0
+
+      - name: Set GH config
+        run: |
+          git config user.email "[email protected]"
+          git config user.name "github-actions"
+
+      # Setup Go
+      - name: Setup Go
+        uses: actions/setup-go@v3
+        with:
+          go-version: '>=1.19.0'
+      - name: Fetch branches and checkout target
+        run: |
+         git fetch origin ${{ inputs.target-branch }}
+         git checkout ${{ inputs.target-branch }}
+         git fetch origin main
+
+      - name: Get latest commit on main branch
+        id: main_commit
+        run: |
+          echo "LATEST_MAIN_COMMIT=$(git rev-parse main)" >> $GITHUB_OUTPUT
+
+      - name: Run script
+        run: |
+          COMMIT_AFTER_PUSH=${{ github.event.after }}
+          bash ./scripts/update-go-mod.sh ${{ steps.main_commit.outputs.LATEST_MAIN_COMMIT }} $COMMIT_AFTER_PUSH
+
+      - name: Add Changes 
+        id: add_changes
+        run: |
+          git add .
+          echo ANY_CHANGES_ADDED=$(git diff --name-only --cached) >> $GITHUB_OUTPUT
+
+      - name: Commit and Push Changes
+        if: ${{ steps.add_changes.outputs.ANY_CHANGES_ADDED != '' }}
+        run: |
+          git commit -m "Auto: update go.mod after push to ${{ inputs.target-branch }} that modified dependencies locally"
+          git push origin ${{ inputs.target-branch }}

.github/workflows/go-mod-auto-update-instructions.yaml

@@ -0,0 +1,60 @@
+# Workflow: Go Mod Auto-Update Instructions
+#
+# Guides contributors when changes are made to our in-repo Go modules.
+# Links the manual GitHub action to run that updates the Go mods.
+#
+# Triggers: 
+# - Pull Request Opened, Synchronized, Reopened
+#
+# Secrets: 
+# GITHUB_TOKEN: Created automatically by GitHub, used for commenting on the PR
+
+name: Go Mod Auto-Update Instructions
+
+on:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - reopened
+    paths:
+      - 'osmomath/**'
+      - 'osmoutils/**'
+      - 'x/ibc-hooks/**'
+      - 'x/epochs/**'
+
+permissions: 
+  pull-requests: write 
+
+jobs:
+  comment:
+    runs-on: ubuntu-latest
+    steps:
+      - 
+        name: Checkout code
+        uses: actions/checkout@v3
+      - 
+        name: Comment on PR
+        uses: thollander/actions-comment-pull-request@v2
+        with:
+          message: |
+            **Important Notice** 
+
+            This PR modifies an in-repo Go module. It is one of:
+            - osmomath
+            - osmoutils
+            - x/ibc-hooks
+            - x/epochs
+
+            The dependent Go modules, especially the root one, will have to be
+            updated to reflect the changes. Failing to do so might cause e2e to fail.  
+
+            Please follow the instructions below:
+
+            1. Open https://github.com/osmosis/osmosis/actions/workflows/go-mod-auto-bump.yml
+            2. Provide the current branch name
+            3. On success, confirm if an automated commit corretly updated the go.mod and go.sum files
+
+            Please let us know if you need any help.
+          mode: upsert
+          comment_tag: instructions

scripts/update-go-mod.sh

@@ -0,0 +1,70 @@
+#!/bin/bash
+
+# Script for checking `git diff` between two commits and updating osmoutils, osmomath, epochs or ibc-hooks if any were changed between two commits
+# Used by Go Mod Auto Version Update workflow
+# First argument: sha of a first commit
+# Second argument: sha of a second commit
+
+is_updated() {
+	if [ "${1}" != "" ]
+	then
+		return 1
+	fi
+	return 0
+}
+
+commit_before=$1
+commit_after=$2
+
+changed_osmoutils=$(git diff --name-only $commit_before $commit_after | grep osmoutils)
+changed_osmomath=$(git diff --name-only $commit_before $commit_after | grep osmomath)
+changed_ibc_hooks=$(git diff --name-only $commit_before $commit_after | grep x/ibc-hooks)
+changed_epochs=$(git diff --name-only $commit_before $commit_after | grep x/epochs)
+
+is_updated $changed_osmoutils
+update_osmoutils=$?
+
+is_updated $changed_osmomath
+update_osmomath=$?
+
+is_updated $changed_ibc_hooks
+update_ibc_hooks=$?
+
+is_updated $changed_epochs
+update_epochs=$?
+
+if [ $update_osmoutils -eq 1 ]
+then 
+	go get github.com/osmosis-labs/osmosis/osmoutils@$commit_after
+
+    # x/epochs depends on osmoutils
+    cd x/epochs
+    go get github.com/osmosis-labs/osmosis/osmoutils@$commit_after
+    go mod tidy
+
+    # x/ibc-hooks depends on osmoutils
+    cd ../ibc-hooks
+    go get github.com/osmosis-labs/osmosis/osmoutils@$commit_after
+    go mod tidy
+
+    # return to root
+    cd ../..
+fi
+
+if [ $update_osmomath -eq 1 ]
+then 
+	go get github.com/osmosis-labs/osmosis/osmomath@$commit_after
+fi
+
+if [ $update_ibc_hooks -eq 1 ]
+then 
+	go get github.com/osmosis-labs/osmosis/x/ibc-hooks@$commit_after
+fi
+
+if [ $update_epochs -eq 1 ]
+then 
+	go get github.com/osmosis-labs/osmosis/x/epochs@$commit_after
+fi
+
+go mod tidy
+go work sync