Merge 240a1b9a25 into 992f068900

.github/ISSUE_TEMPLATE/bug_report.md

@@ -7,7 +7,7 @@ assignees: ''
 
 ---
 
-<!--- Please direct any generic questions related to actions to our support community forum at https://github.com/orgs/community/discussions/categories/actions --->
+<!--- Please direct any generic questions related to actions to our support community forum at https://github.community/c/code-to-cloud/github-actions/41 --->
 <!--- Before opening up a new bug report, please make sure to check for similar existing issues -->
 
 **Description:**

.github/ISSUE_TEMPLATE/feature_request.md

@@ -5,7 +5,7 @@ title: ''
 labels: feature request, needs triage
 assignees: ''
 ---
-<!--- Please direct any generic questions related to actions to our support community forum at https://github.com/orgs/community/discussions/categories/actions --->
+<!--- Please direct any generic questions related to actions to our support community forum at https://github.community/c/code-to-cloud/github-actions/41 --->
 <!--- Before opening up a new feature request, please make sure to check for similar existing issues and pull requests -->
 
 **Description:**

.github/dependabot.yml

@@ -1,22 +0,0 @@
-# To get started with Dependabot version updates, you'll need to specify which
-# package ecosystems to update and where the package manifests are located.
-# Please see the documentation for all configuration options:
-# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
-
-version: 2
-updates:
-  # Enable version updates for npm
-  - package-ecosystem: 'npm'
-    # Look for `package.json` and `lock` files in the `root` directory
-    directory: '/'
-    # Check the npm registry for updates every day (weekdays)
-    schedule:
-      interval: 'weekly'
-
-  # Enable version updates for GitHub Actions
-  - package-ecosystem: 'github-actions'
-    # Workflow files stored in the default location of `.github/workflows`
-    # You don't need to specify `/.github/workflows` for `directory`. You can use `directory: "/"`.
-    directory: '/'
-    schedule:
-      interval: 'weekly'

.github/workflows/basic-validation.yml

@@ -14,5 +14,3 @@ jobs:
   call-basic-validation:
     name: Basic validation
     uses: actions/reusable-workflows/.github/workflows/basic-validation.yml@main
-    with:
-      node-version: '24.x'

.github/workflows/check-dist.yml

@@ -15,5 +15,3 @@ jobs:
   call-check-dist:
     name: Check dist/
     uses: actions/reusable-workflows/.github/workflows/check-dist.yml@main
-    with:
-      node-version: '24.x'

.github/workflows/publish-immutable-actions.yml

@@ -1,20 +0,0 @@
-name: 'Publish Immutable Action Version'
-
-on:
-  release:
-    types: [published]
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      id-token: write
-      packages: write
-
-    steps:
-      - name: Checking out
-        uses: actions/checkout@v6
-      - name: Publish
-        id: publish
-        uses: actions/publish-immutable-action@v0.0.4

.github/workflows/release-new-action-version.yml

@@ -22,7 +22,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Update the ${{ env.TAG_NAME }} tag
-        uses: actions/publish-action@v0.4.0
+        uses: actions/publish-action@v0.2.2
         with:
           source-tag: ${{ env.TAG_NAME }}
           slack-webhook: ${{ secrets.SLACK_WEBHOOK }}

.github/workflows/versions.yml

@@ -18,9 +18,9 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest, macos-latest-large]
+        os: [ubuntu-latest, windows-latest, macos-latest]
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v3
       - name: Setup Go Stable
         uses: ./
         with:
@@ -33,9 +33,9 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest, macos-latest-large]
+        os: [ubuntu-latest, windows-latest, macos-latest]
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v3
       - name: Setup Go oldStable
         uses: ./
         with:
@@ -48,16 +48,14 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest, macos-latest-large]
+        os: [ubuntu-latest, windows-latest, macos-latest]
         version: [stable, oldstable]
         architecture: [x64, x32]
         exclude:
           - os: macos-latest
             architecture: x32
-          - os: macos-latest-large
-            architecture: x32
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v3
       - name: Setup Go ${{ matrix.version }} ${{ matrix.architecture }}
         uses: ./
         with:
@@ -72,17 +70,11 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [macos-latest, windows-latest, ubuntu-latest, macos-latest-large]
-        go: [1.21.13, 1.22.8, 1.23.2]
-        include:
-          - os: windows-latest
-            go: 1.20.14
-        exclude:
-          - os: windows-latest
-            go: 1.23.2
+        os: [macos-latest, windows-latest, ubuntu-latest]
+        go: [1.17, 1.18, 1.19]
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v3
 
       - name: setup-go ${{ matrix.go }}
         uses: ./
@@ -98,10 +90,10 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest, macos-latest-large]
-        go-version: ['1.20', '1.21', '1.22', '1.23']
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        go-version: [1.16, 1.17]
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v3
       - name: Setup Go and check latest
         uses: ./
         with:
@@ -115,15 +107,15 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest, macos-latest-large]
+        os: [ubuntu-latest, windows-latest, macos-latest]
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v3
       - name: Setup Go and check latest
         uses: ./
         with:
           go-version-file: __tests__/data/go.mod
       - name: verify go
-        run: __tests__/verify-go.sh 1.20.14
+        run: __tests__/verify-go.sh 1.14
         shell: bash
 
   go-version-file-with-gowork:
@@ -131,59 +123,28 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest, macos-latest-large]
+        os: [ubuntu-latest, windows-latest, macos-latest]
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v3
       - name: Setup Go and check latest
         uses: ./
         with:
           go-version-file: __tests__/data/go.work
       - name: verify go
-        run: __tests__/verify-go.sh 1.21
-        shell: bash
-
-  go-version-file-with-tool-versions:
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest, macos-latest-large]
-    steps:
-      - uses: actions/checkout@v6
-      - name: Setup Go and check latest
-        uses: ./
-        with:
-          go-version-file: __tests__/data/.tool-versions
-      - name: verify go
-        run: __tests__/verify-go.sh 1.23.2
-        shell: bash
-
-  go-version-file-with-go-version:
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest, macos-latest-large]
-    steps:
-      - uses: actions/checkout@v6
-      - name: Setup Go from .go-version file
-        uses: ./
-        with:
-          go-version-file: __tests__/data/.go-version
-      - name: verify go
-        run: __tests__/verify-go.sh 1.22.4
+        run: __tests__/verify-go.sh 1.19
         shell: bash
 
   setup-versions-from-manifest:
+    name: Setup ${{ matrix.go }} ${{ matrix.os }}
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
-        os: [macos-latest, windows-latest, ubuntu-latest, macos-latest-large]
-        go: [1.20.14, 1.21.10, 1.22.8, 1.23.2]
+        os: [macos-latest, windows-latest, ubuntu-latest]
+        go: [1.12.16, 1.13.11, 1.14.3]
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v3
 
       - name: setup-go ${{ matrix.go }}
         uses: ./
@@ -195,15 +156,16 @@ jobs:
         shell: bash
 
   setup-versions-from-dist:
+    name: Setup ${{ matrix.go }} ${{ matrix.os }}
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
-        os: [windows-latest, ubuntu-latest, macos-latest-large]
-        go: [1.11.12]
+        os: [macos-latest, windows-latest, ubuntu-latest]
+        go: [1.9, 1.8.6]
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v3
 
       - name: setup-go ${{ matrix.go }}
         uses: ./
@@ -219,23 +181,14 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest, macos-latest-large]
-        go-version: [1.20.14, 1.21, 1.22, 1.23]
-        include:
-          - os: macos-latest
-            architecture: arm64
-          - os: ubuntu-latest
-            architecture: x64
-          - os: windows-latest
-            architecture: x64
-          - os: macos-latest-large
-            architecture: x64
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        go-version: [1.16, 1.17]
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v3
       - name: Setup Go and check latest
         uses: ./
         with:
           go-version: ${{ matrix.go-version }}
-          architecture: ${{ matrix.architecture }}
+          architecture: x64
       - name: Verify Go
         run: go version

.github/workflows/windows-validation.yml

@@ -1,136 +0,0 @@
-name: Validate Windows installation
-
-on:
-  push:
-    branches:
-      - main
-    paths-ignore:
-      - '**.md'
-  pull_request:
-    paths-ignore:
-      - '**.md'
-
-jobs:
-  create-link-if-not-default:
-    runs-on: windows-latest
-    name: 'Validate if symlink is created'
-    strategy:
-      matrix:
-        cache: [false, true]
-        go: [1.20.1]
-    steps:
-      - uses: actions/checkout@v6
-
-      - name: 'Setup ${{ matrix.cache }}, cache: ${{ matrix.go }}'
-        uses: ./
-        with:
-          go-version: ${{ matrix.go }}
-          cache: ${{ matrix.cache }}
-
-      - name: 'Drive C: should have zero size link'
-        run: |
-          du -m -s 'C:\hostedtoolcache\windows\go\${{ matrix.go }}\x64'
-          # make sure drive c: contains only a link
-          size=$(du -m -s 'C:\hostedtoolcache\windows\go\${{ matrix.go }}\x64'|cut -f1 -d$'\t')
-          if [ $size -ne 0 ];then
-            echo 'Size of the link created on drive c: must be 0'
-            exit 1
-          fi
-        shell: bash
-
-      # Drive D: is small, take care the action does not eat up the space
-      - name: 'Drive D: space usage should be below 1G'
-        run: |
-          du -m -s 'D:\hostedtoolcache\windows\go\${{ matrix.go }}\x64'
-          size=$(du -m -s 'D:\hostedtoolcache\windows\go\${{ matrix.go }}\x64'|cut -f1 -d$'\t')
-          # make sure archive does not take lot of space
-          if [ $size -gt 999 ];then
-            echo 'Size of installed on drive d: go is too big';
-            exit 1
-          fi
-        shell: bash
-
-      # make sure the Go installation has not been changed to the end user
-      - name: Test paths and environments
-        run: |
-          echo $PATH
-          which go
-          go version
-          go env
-          if [ $(which go) != '/c/hostedtoolcache/windows/go/${{ matrix.go }}/x64/bin/go' ];then
-            echo 'which go should return "/c/hostedtoolcache/windows/go/${{ matrix.go }}/x64/bin/go"'
-            exit 1
-          fi
-          if [ $(go env GOROOT) != 'C:\hostedtoolcache\windows\go\${{ matrix.go }}\x64' ];then
-            echo 'go env GOROOT should return "C:\hostedtoolcache\windows\go\${{ matrix.go }}\x64"'
-            exit 1
-          fi
-        shell: bash
-
-  find-default-go:
-    name: 'Find default go version'
-    runs-on: windows-latest
-    outputs:
-      version: ${{ steps.goversion.outputs.version }}
-    steps:
-      - run: |
-          version=`go env GOVERSION|sed s/^go//`
-          echo "default go version: $version"
-          echo "version=$version" >> "$GITHUB_OUTPUT"
-        id: goversion
-        shell: bash
-
-  dont-create-link-if-default:
-    name: 'Validate if symlink is not created for default go'
-    runs-on: windows-latest
-    needs: find-default-go
-    strategy:
-      matrix:
-        cache: [false, true]
-    steps:
-      - uses: actions/checkout@v6
-
-      - name: 'Setup default go, cache: ${{ matrix.cache }}'
-        uses: ./
-        with:
-          go-version: ${{ needs.find-default-go.outputs.version }}
-          cache: ${{ matrix.cache }}
-
-      - name: 'Drive C: should have Go installation, cache: ${{ matrix.cache}}'
-        run: |
-          size=$(du -m -s 'C:\hostedtoolcache\windows\go\${{ needs.find-default-go.outputs.version }}\x64'|cut -f1 -d$'\t')
-          if [ $size -eq 0 ];then
-            echo 'Size of the hosted go installed on drive c: must be above zero'
-            exit 1
-          fi
-        shell: bash
-
-      - name: 'Drive D: should not have Go installation, cache: ${{ matrix.cache }}'
-        run: |
-          if [ -e 'D:\hostedtoolcache\windows\go\${{ needs.find-default-go.outputs.version }}\x64' ];then
-            echo 'D:\hostedtoolcache\windows\go\${{ needs.find-default-go.outputs.version }}\x64 should not exist for hosted version of go';
-            exit 1
-          fi
-        shell: bash
-
-  hostedtoolcache:
-    name: 'Validate if hostedtoolcache works as expected'
-    runs-on: windows-latest
-    strategy:
-      matrix:
-        cache: [false]
-        go: [1.20.1]
-    steps:
-      - uses: actions/checkout@v6
-
-      - name: 'Setup ${{ matrix.go }}, cache: ${{ matrix.cache }}'
-        uses: ./
-        with:
-          go-version: ${{ matrix.go }}
-          cache: ${{ matrix.cache }}
-
-      - name: 'Setup ${{ matrix.go }}, cache: ${{ matrix.cache }} (from hostedtoolcache)'
-        uses: ./
-        with:
-          go-version: ${{ matrix.go }}
-          cache: ${{ matrix.cache }}

.licensed.yml

@@ -12,5 +12,4 @@ allowed:
   - 0bsd
 
 reviewed:
-  npm:
-     - "@actions/http-client"
+  npm:

README.md

@@ -5,142 +5,262 @@ cbowREADME.md
 [![Basic validation](https://github.com/actions/setup-go/actions/workflows/basic-validation.yml/badge.svg)](https://github.com/actions/setup-go/actions/workflows/basic-validation.yml)
 [![Validate 'setup-go'](https://github.com/actions/setup-go/actions/workflows/versions.yml/badge.svg)](https://github.com/actions/setup-go/actions/workflows/versions.yml)
 
-This action sets up a Go environment for use in GitHub Actions by:
+This action sets up a go environment for use in actions by:
 
-- Optionally downloading and caching a version of Go by version and adding it to the PATH
-- Optionally caching Go modules and build outputs
-- Registering problem matchers for error output
+- Optionally downloading and caching a version of Go by version and adding to `PATH`.
+- Registering problem matchers for error output.
 
-## Breaking changes in V6
+# V4
 
-The V6 edition of the action includes:
-- **Upgraded Node.js runtime from node20 to node24**
-  > Make sure your runner is on version v2.327.1 or later to ensure compatibility with this release. See [Release Notes](https://github.com/actions/runner/releases/tag/v2.327.1)
+The V4 edition of the action offers:
 
-- **Go toolchain**
-  - Supports both `go` and `toolchain` directives in `go.mod`. If the `toolchain` directive is present, its version is used; otherwise, the action falls back to the `go` directive.
+ - Enabled caching by default
 
-- **Cache key update**
-  - By default, the cache key for Go modules is based on `go.mod`. To use `go.sum`, configure the `cache-dependency-path` input.
+The action will try to enable caching unless the `cache` input is explicitly set to false.
 
-See full release notes on the [releases page](https://github.com/actions/setup-go/releases).
+Please see "[Caching dependency files and build outputs](https://github.com/actions/setup-go#caching-dependency-files-and-build-outputs)" for more information.
 
-## Usage
+# V3
 
-See [action.yml](action.yml).
+The V3 edition of the action offers:
 
-<!-- start usage -->
-```yaml
-- uses: actions/setup-go@v6
-  with:
-    # Version or version range of Go to use
-    go-version: '1.23'
-    
-    # Path to go.mod, go.work, .go-version, or .tool-versions file
-    # Note: if both go-version and go-version-file are provided, go-version takes precedence.
-    go-version-file: 'go.mod'
-    
-    # Set this option if you want the action to check for the latest available version
-    # Default: false
-    check-latest: false
-    
-    # GitHub token for authentication
-    token: ${{ github.token }}
-    
-    # Used to specify whether caching is needed.
-    # Default: true
-    cache: true
-    
-    # Path to dependency files for caching
-    cache-dependency-path: 'go.sum'
-    
-    # Architecture to install (auto-detected if not specified)
-    architecture: 'x64'
-```
-<!-- end usage -->
+- Adds `GOBIN` to the `PATH`
+- Proxy support
+- Check latest version
+- Caching packages dependencies
+- stable and oldstable aliases
+- Bug Fixes (including issues around version matching and semver)
 
-**Basic:**
+The action will first check the local cache for a version match. If a version is not found locally, it will pull it from
+the `main` branch of the [go-versions](https://github.com/actions/go-versions/blob/main/versions-manifest.json)
+repository. On miss or failure, it will fall back to downloading directly
+from [go dist](https://storage.googleapis.com/golang). To change the default behavior, please use
+the [check-latest input](#check-latest-version).
+
+**Note:** The `setup-go` action uses executable binaries which are built by Golang side. The action does not build
+golang from source code.
+
+Matching by [semver spec](https://github.com/npm/node-semver):
 
 ```yaml
 steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
+  - uses: actions/checkout@v3
+  - uses: actions/setup-go@v4
     with:
-      go-version: '1.25' # The Go version to download (if necessary) and use.
+      go-version: '^1.13.1' # The Go version to download (if necessary) and use.
+  - run: go version
+```
+
+```yaml
+steps:
+  - uses: actions/checkout@v3
+  - uses: actions/setup-go@v4
+    with:
+      go-version: '>=1.17.0'
+  - run: go version
+```
+
+> **Note**: Due to the peculiarities of YAML parsing, it is recommended to wrap the version in single quotation marks:
+> 
+> ```yaml
+>   go-version: '1.20'
+>  ```
+>  
+> The recommendation is based on the YAML parser's behavior, which interprets non-wrapped values as numbers and, in the case of version 1.20, trims it down to 1.2, which may not be very obvious.
+Matching an unstable pre-release:
+
+```yaml
+steps:
+  - uses: actions/checkout@v3
+  - uses: actions/setup-go@v4
+    with:
+      go-version: '1.18.0-rc.1' # The Go version to download (if necessary) and use.
+  - run: go version
+```
+
+```yaml
+steps:
+  - uses: actions/checkout@v3
+  - uses: actions/setup-go@v4
+    with:
+      go-version: '1.16.0-beta.1' # The Go version to download (if necessary) and use.
+  - run: go version
+```
+
+# Usage
+
+See [action.yml](action.yml)
+
+## Basic
+
+```yaml
+steps:
+  - uses: actions/checkout@v3
+  - uses: actions/setup-go@v4
+    with:
+      go-version: '1.16.1' # The Go version to download (if necessary) and use.
   - run: go run hello.go
 ```
 
-**Version resolution behavior:**
+## Check latest version
 
-The action resolves the requested version in the following order:
-1. **Local cache** - Checks the local tool cache for a matching [semver](https://github.com/npm/node-semver#versions) version.
-2. **go-versions repository** - If the requested version isn’t available in the tool cache, it pulls the version manifest from the `main` branch of the [go-versions repository](https://github.com/actions/go-versions/blob/main/versions-manifest.json).
-3. **Direct download** - If that lookup misses or fails, it will fall back to downloading directly from the [official Go distribution site](https://go.dev/dl).
+The `check-latest` flag defaults to `false`. Use the default or set `check-latest` to `false` if you prefer stability
+and if you want to ensure a specific Go version is always used.
 
-To change the default behavior, please use
-the [check-latest input](docs/advanced-usage.md#check-latest-version).
+If `check-latest` is set to `true`, the action first checks if the cached version is the latest one. If the locally
+cached version is not the most up-to-date, a Go version will then be downloaded. Set `check-latest` to `true` if you
+want the most up-to-date Go version to always be used.
 
-> **Note**: The `setup-go` action uses executable binaries built by the Go team and does not build Go binaries from source code.
+> Setting `check-latest` to `true` has performance implications as downloading Go versions is slower than using cached
+> versions.
 
-## Supported version syntax
+```yaml
+steps:
+  - uses: actions/checkout@v3
+  - uses: actions/setup-go@v4
+    with:
+      go-version: '1.14'
+      check-latest: true
+  - run: go run hello.go
+```
+
+## Using stable/oldstable aliases
+
+If `stable` is provided, action will get the latest stable version from
+the [`go-versions`](https://github.com/actions/go-versions/blob/main/versions-manifest.json) repository manifest.
+
+If `oldstable` is provided, when current release is 1.19.x, action will resolve version as 1.18.x, where x is the latest
+patch release.
+
+**Note:** using these aliases will result in same version as using corresponding minor release with `check-latest` input
+set to `true`
+
+```yaml
+steps:
+  - uses: actions/checkout@v3
+  - uses: actions/setup-go@v4
+    with:
+      go-version: 'stable'
+  - run: go run hello.go
+```
+
+```yaml
+steps:
+  - uses: actions/checkout@v3
+  - uses: actions/setup-go@v4
+    with:
+      go-version: 'oldstable'
+  - run: go run hello.go
+```
+
+## Caching dependency files and build outputs:
+
+The action has a built-in functionality for caching and restoring go modules and build outputs. It
+uses [toolkit/cache](https://github.com/actions/toolkit/tree/main/packages/cache) under the hood but requires less configuration settings.
+The `cache` input is optional, and caching is turned on by default.
+
+The action defaults to search for the dependency file - go.sum in the repository root, and uses its hash as a part of
+the cache key. Use `cache-dependency-path` input for cases when multiple dependency files are used, or they are located
+in different subdirectories.
+
+If some problem that prevents success caching happens then the action issues the warning in the log and continues the execution of the pipeline. 
+
+**Caching in monorepos**
+
+```yaml
+steps:
+  - uses: actions/checkout@v3
+  - uses: actions/setup-go@v4
+    with:
+      go-version: '1.17'
+      check-latest: true
+      cache-dependency-path: subdir/go.sum
+  - run: go run hello.go
+  ```
+
+## Getting go version from the go.mod file
+
+The `go-version-file` input accepts a path to a `go.mod` file or a `go.work` file that contains the version of Go to be
+used by a project. As the `go.mod` file contains only major and minor (e.g. 1.18) tags, the action will search for the
+latest available patch version sequentially in the runner's directory with the cached tools, in
+the [versions-manifest.json](https://github.com/actions/go-versions/blob/main/versions-manifest.json) file or at the go
+servers.
+
+If both the `go-version` and the `go-version-file` inputs are provided then the `go-version` input is used.
+> The action will search for the `go.mod` file relative to the repository root
+
+```yaml
+steps:
+  - uses: actions/checkout@v3
+  - uses: actions/setup-go@v4
+    with:
+      go-version-file: 'path/to/go.mod'
+  - run: go version
+```
+
+## Matrix testing
+
+```yaml
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        go: [ '1.14', '1.13' ]
+    name: Go ${{ matrix.go }} sample
+    steps:
+      - uses: actions/checkout@v3
+      - name: Setup go
+        uses: actions/setup-go@v4
+        with:
+          go-version: ${{ matrix.go }}
+      - run: go run hello.go
+```
+
+### Supported version syntax
 
 The `go-version` input supports the following syntax:
 
-- Specific versions: `1.25`, `1.24.11`, `1.24.0-rc.1`, `1.23.0-beta.1`
-- SemVer version range syntax: `^1.25.1`, `~1.24.1`, `>=1.25.0-rc.1`, `<1.25.0`, `>=1.22.0 <1.24.0`
-- Aliases: `stable`, `oldstable`
-- Wildcards: `1.25.x`, `1.x`
+- Specific versions: `1.15`, `1.16.1`, `1.17.0-rc.2`, `1.16.0-beta.1`
+- SemVer's version range syntax: `^1.13.1`, `>=1.18.0-rc.1`
 
-For details on Semantic Versioning, see [the semver package documentation](https://github.com/npm/node-semver).
+For more information about semantic versioning, please refer to [semver](https://github.com/npm/node-semver)
+documentation.
 
-> **Note**: Due to the peculiarities of YAML parsing, it is recommended to wrap the version in single quotation marks:
->
-> ```yaml
->   go-version: '1.20'
-> ```
->
-> The recommendation is based on the YAML parser's behavior, which interprets non-wrapped values as numbers and, in the case of version `1.20`, trims it down to `1.2`, which may not be very obvious.
+## Using `setup-go` on GHES
 
-For more usage examples, please refer to the section: [Using go-version input](docs/advanced-usage.md#using-the-go-version-input) of the [Advanced usage](docs/advanced-usage.md) guide.
+`setup-go` comes pre-installed on the appliance with GHES if Actions is enabled. When dynamically downloading Go
+distributions, `setup-go` downloads distributions from [`actions/go-versions`](https://github.com/actions/go-versions)
+on github.com (outside of the appliance). These calls to `actions/go-versions` are made via unauthenticated requests,
+which are limited
+to [60 requests per hour per IP](https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting). If
+more requests are made within the time frame, then you will start to see rate-limit errors during downloading that looks
+like: `##[error]API rate limit exceeded for...`. After that error the action will try to download versions directly
+from https://storage.googleapis.com/golang, but it also can have rate limit so it's better to put token.
 
-## Recommended permissions
-
-When using the `setup-go` action in your GitHub Actions workflow, it is recommended to set the following permissions to ensure proper functionality:
+To get a higher rate limit, you
+can [generate a personal access token on github.com](https://github.com/settings/tokens/new) and pass it as the `token`
+input for the action:
 
 ```yaml
-permissions:
-  contents: read # access to check out code and install dependencies
+uses: actions/setup-go@v4
+with:
+  token: ${{ secrets.GH_DOTCOM_TOKEN }}
+  go-version: '1.18'
 ```
 
-## Caching dependency files and build outputs
+If the runner is not able to access github.com, any Go versions requested during a workflow run must come from the
+runner's tool cache.
+See "[Setting up the tool cache on self-hosted runners without internet access](https://docs.github.com/en/enterprise-server@3.2/admin/github-actions/managing-access-to-actions-from-githubcom/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access)"
+for more information.
 
-The action includes built-in caching and restoration for Go modules and build outputs. It uses
-[toolkit/cache](https://github.com/actions/toolkit/tree/main/packages/cache) under the hood, but requires less configuration.
-The `cache` input is optional, and caching is enabled by default. To disable caching, set `cache: false`.
+# License
 
-By default, the action looks for `go.mod` in the repository root and uses its hash as part of the cache key. Use the `cache-dependency-path` input when you have multiple dependency files, or when they’re located in different subdirectories. This input supports glob patterns.
+The scripts and documentation in this project are released under the [MIT License](LICENSE)
 
-If caching cannot be performed for any reason, the action logs a warning and continues workflow execution.
+# Contributions
 
-For examples of using `cache-dependency-path`, see the [Caching](docs/advanced-usage.md#caching) section of the [Advanced usage](docs/advanced-usage.md) guide.
-
-
-## Advanced usage
-
-- [Using the go-version input](docs/advanced-usage.md#using-the-go-version-input)
-- [Using the go-version-file input](docs/advanced-usage.md#using-the-go-version-file-input)
-- [Check latest version](docs/advanced-usage.md#check-latest-version)
-- [Caching](docs/advanced-usage.md#caching)
-- [Outputs](docs/advanced-usage.md#outputs)
-- [Using `setup-go` on GHES](docs/advanced-usage.md#using-setup-go-on-ghes)
-
-## License
-
-The scripts and documentation in this project are released under the [MIT License](LICENSE).
-
-## Contributions
-
-Contributions are welcome! See our [Contributor's Guide](docs/contributors.md).
+Contributions are welcome! See [Contributor's Guide](docs/contributors.md)
 
 ## Code of Conduct
 

__tests__/cache-restore.test.ts

@@ -1,83 +1,94 @@
 import * as cache from '@actions/cache';
 import * as core from '@actions/core';
 import * as glob from '@actions/glob';
-import fs from 'fs';
 
 import * as cacheRestore from '../src/cache-restore';
 import * as cacheUtils from '../src/cache-utils';
 import {PackageManagerInfo} from '../src/package-managers';
 
 describe('restoreCache', () => {
-  let hashFilesSpy: jest.SpyInstance;
-  let getCacheDirectoryPathSpy: jest.SpyInstance;
-  let restoreCacheSpy: jest.SpyInstance;
-  let infoSpy: jest.SpyInstance;
-  let setOutputSpy: jest.SpyInstance;
+  //Arrange
+  const hashFilesSpy = jest.spyOn(glob, 'hashFiles');
+  const getCacheDirectoryPathSpy = jest.spyOn(
+    cacheUtils,
+    'getCacheDirectoryPath'
+  );
+  const restoreCacheSpy = jest.spyOn(cache, 'restoreCache');
+  const infoSpy = jest.spyOn(core, 'info');
+  const setOutputSpy = jest.spyOn(core, 'setOutput');
 
   const versionSpec = '1.13.1';
   const packageManager = 'default';
   const cacheDependencyPath = 'path';
 
-  let originalWorkspace: string | undefined;
-
   beforeEach(() => {
-    originalWorkspace = process.env.GITHUB_WORKSPACE;
-    process.env.GITHUB_WORKSPACE = '/test/workspace';
-    //Arrange
-    hashFilesSpy = jest.spyOn(glob, 'hashFiles');
-    getCacheDirectoryPathSpy = jest.spyOn(cacheUtils, 'getCacheDirectoryPath');
-    restoreCacheSpy = jest.spyOn(cache, 'restoreCache');
-    infoSpy = jest.spyOn(core, 'info');
-    setOutputSpy = jest.spyOn(core, 'setOutput');
-
     getCacheDirectoryPathSpy.mockImplementation(
       (PackageManager: PackageManagerInfo) => {
-        return Promise.resolve([
-          'cache_directory_path',
-          'cache_directory_path'
-        ]);
+        return new Promise<string[]>(resolve => {
+          resolve(['cache_directory_path', 'cache_directory_path']);
+        });
       }
     );
   });
 
-  afterEach(() => {
-    process.env.GITHUB_WORKSPACE = originalWorkspace;
-    jest.restoreAllMocks();
-  });
-
   it('should throw if dependency file path is not valid', async () => {
-    // Arrange
-    hashFilesSpy.mockImplementation(() => Promise.resolve(''));
-    // Act + Assert
-    await expect(
-      cacheRestore.restoreCache(
+    //Arrange
+    hashFilesSpy.mockImplementation((somePath: string) => {
+      return new Promise<string>(resolve => {
+        resolve('');
+      });
+    });
+
+    //Act + Assert
+    await expect(async () => {
+      await cacheRestore.restoreCache(
         versionSpec,
         packageManager,
         cacheDependencyPath
-      )
-    ).rejects.toThrow(
+      );
+    }).rejects.toThrow(
       'Some specified paths were not resolved, unable to cache dependencies.'
     );
   });
 
-  it('should inform if cache hit is not occurred', async () => {
-    // Arrange
-    hashFilesSpy.mockImplementation(() => Promise.resolve('file_hash'));
-    restoreCacheSpy.mockImplementation(() => Promise.resolve(''));
-    // Act + Assert
+  it('should inform if cache hit is not occured', async () => {
+    //Arrange
+    hashFilesSpy.mockImplementation((somePath: string) => {
+      return new Promise<string>(resolve => {
+        resolve('file_hash');
+      });
+    });
+
+    restoreCacheSpy.mockImplementation(() => {
+      return new Promise<string>(resolve => {
+        resolve('');
+      });
+    });
+
+    //Act + Assert
     await cacheRestore.restoreCache(
       versionSpec,
       packageManager,
       cacheDependencyPath
     );
-    expect(infoSpy).toHaveBeenCalledWith('Cache is not found');
+    expect(infoSpy).toHaveBeenCalledWith(`Cache is not found`);
   });
 
-  it('should set output if cache hit is occurred', async () => {
-    // Arrange
-    hashFilesSpy.mockImplementation(() => Promise.resolve('file_hash'));
-    restoreCacheSpy.mockImplementation(() => Promise.resolve('cache_key'));
-    // Act + Assert
+  it('should set output if cache hit is occured', async () => {
+    //Arrange
+    hashFilesSpy.mockImplementation((somePath: string) => {
+      return new Promise<string>(resolve => {
+        resolve('file_hash');
+      });
+    });
+
+    restoreCacheSpy.mockImplementation(() => {
+      return new Promise<string>(resolve => {
+        resolve('cache_key');
+      });
+    });
+
+    //Act + Assert
     await cacheRestore.restoreCache(
       versionSpec,
       packageManager,
@@ -85,18 +96,4 @@ describe('restoreCache', () => {
     );
     expect(setOutputSpy).toHaveBeenCalledWith('cache-hit', true);
   });
-
-  it('should throw if dependency file is not found in workspace', async () => {
-    jest.spyOn(fs, 'readdirSync').mockReturnValue(['main.go'] as any);
-
-    await expect(
-      cacheRestore.restoreCache(
-        versionSpec,
-        packageManager
-        // No cacheDependencyPath
-      )
-    ).rejects.toThrow(
-      'Dependencies file is not found in /test/workspace. Supported file pattern: go.mod'
-    );
-  });
 });

__tests__/cache-utils.test.ts

@@ -47,7 +47,7 @@ describe('getPackageManagerInfo', () => {
     //Arrange
     const packageManagerName = 'default';
     const expectedResult = {
-      dependencyFilePattern: 'go.mod',
+      dependencyFilePattern: 'go.sum',
       cacheFolderCommandList: ['go env GOMODCACHE', 'go env GOCACHE']
     };
 
@@ -73,7 +73,7 @@ describe('getCacheDirectoryPath', () => {
   const getExecOutputSpy = jest.spyOn(exec, 'getExecOutput');
 
   const validPackageManager: PackageManagerInfo = {
-    dependencyFilePattern: 'go.mod',
+    dependencyFilePattern: 'go.sum',
     cacheFolderCommandList: ['go env GOMODCACHE', 'go env GOCACHE']
   };
 
@@ -209,41 +209,3 @@ describe('isCacheFeatureAvailable', () => {
     expect(warningSpy).toHaveBeenCalledWith(warningMessage);
   });
 });
-
-describe('isGhes', () => {
-  const pristineEnv = process.env;
-
-  beforeEach(() => {
-    jest.resetModules();
-    process.env = {...pristineEnv};
-  });
-
-  afterAll(() => {
-    process.env = pristineEnv;
-  });
-
-  it('returns false when the GITHUB_SERVER_URL environment variable is not defined', async () => {
-    delete process.env['GITHUB_SERVER_URL'];
-    expect(cacheUtils.isGhes()).toBeFalsy();
-  });
-
-  it('returns false when the GITHUB_SERVER_URL environment variable is set to github.com', async () => {
-    process.env['GITHUB_SERVER_URL'] = 'https://github.com';
-    expect(cacheUtils.isGhes()).toBeFalsy();
-  });
-
-  it('returns false when the GITHUB_SERVER_URL environment variable is set to a GitHub Enterprise Cloud-style URL', async () => {
-    process.env['GITHUB_SERVER_URL'] = 'https://contoso.ghe.com';
-    expect(cacheUtils.isGhes()).toBeFalsy();
-  });
-
-  it('returns false when the GITHUB_SERVER_URL environment variable has a .localhost suffix', async () => {
-    process.env['GITHUB_SERVER_URL'] = 'https://mock-github.localhost';
-    expect(cacheUtils.isGhes()).toBeFalsy();
-  });
-
-  it('returns true when the GITHUB_SERVER_URL environment variable is set to some other URL', async () => {
-    process.env['GITHUB_SERVER_URL'] = 'https://src.onpremise.fabrikam.com';
-    expect(cacheUtils.isGhes()).toBeTruthy();
-  });
-});

__tests__/data/.go-version

@@ -1 +0,0 @@
-1.22.4

__tests__/data/.tool-versions

@@ -1 +0,0 @@
-golang 1.23.2

__tests__/data/go.mod

@@ -1,6 +1,6 @@
 module example.com/mymodule
 
-go 1.20
+go 1.14
 
 require (
 	example.com/othermodule v1.2.3

__tests__/data/go.work

@@ -1,3 +1,3 @@
-go 1.21
+go 1.19
 
 use .

__tests__/setup-go.test.ts

@@ -3,11 +3,10 @@ import * as io from '@actions/io';
 import * as tc from '@actions/tool-cache';
 import fs from 'fs';
 import cp from 'child_process';
-import osm, {type} from 'os';
+import osm from 'os';
 import path from 'path';
 import * as main from '../src/main';
 import * as im from '../src/installer';
-import * as httpm from '@actions/http-client';
 
 import goJsonData from './data/golang-dl.json';
 import matchers from '../matchers.json';
@@ -17,8 +16,6 @@ const matcherRegExp = new RegExp(matcherPattern.regexp);
 const win32Join = path.win32.join;
 const posixJoin = path.posix.join;
 
-jest.setTimeout(10000);
-
 describe('setup-go', () => {
   let inputs = {} as any;
   let os = {} as any;
@@ -42,12 +39,9 @@ describe('setup-go', () => {
   let existsSpy: jest.SpyInstance;
   let readFileSpy: jest.SpyInstance;
   let mkdirpSpy: jest.SpyInstance;
-  let mkdirSpy: jest.SpyInstance;
-  let symlinkSpy: jest.SpyInstance;
   let execSpy: jest.SpyInstance;
   let getManifestSpy: jest.SpyInstance;
   let getAllVersionsSpy: jest.SpyInstance;
-  let httpmGetJsonSpy: jest.SpyInstance;
 
   beforeAll(async () => {
     process.env['GITHUB_ENV'] = ''; // Stub out Environment file functionality so we can verify it writes to standard out (toolkit is backwards compatible)
@@ -92,20 +86,12 @@ describe('setup-go', () => {
     getManifestSpy = jest.spyOn(tc, 'getManifestFromRepo');
     getAllVersionsSpy = jest.spyOn(im, 'getManifest');
 
-    // httm
-    httpmGetJsonSpy = jest.spyOn(httpm.HttpClient.prototype, 'getJson');
-
     // io
     whichSpy = jest.spyOn(io, 'which');
     existsSpy = jest.spyOn(fs, 'existsSync');
     readFileSpy = jest.spyOn(fs, 'readFileSync');
     mkdirpSpy = jest.spyOn(io, 'mkdirP');
 
-    // fs
-    mkdirSpy = jest.spyOn(fs, 'mkdir');
-    symlinkSpy = jest.spyOn(fs, 'symlinkSync');
-    symlinkSpy.mockImplementation(() => {});
-
     // gets
     getManifestSpy.mockImplementation(() => <tc.IToolRelease[]>goTestManifest);
 
@@ -129,9 +115,6 @@ describe('setup-go', () => {
   });
 
   afterEach(() => {
-    // clear out env var set during 'run'
-    delete process.env[im.GOTOOLCHAIN_ENV_VAR];
-
     //jest.resetAllMocks();
     jest.clearAllMocks();
     //jest.restoreAllMocks();
@@ -159,21 +142,6 @@ describe('setup-go', () => {
     );
   });
 
-  it('should return manifest from repo', async () => {
-    const manifest = await im.getManifest(undefined);
-    expect(manifest).toEqual(goTestManifest);
-  });
-
-  it('should return manifest from raw URL if repo fetch fails', async () => {
-    getManifestSpy.mockRejectedValue(new Error('Fetch failed'));
-    httpmGetJsonSpy.mockResolvedValue({
-      result: goTestManifest
-    });
-    const manifest = await im.getManifest(undefined);
-    expect(httpmGetJsonSpy).toHaveBeenCalled();
-    expect(manifest).toEqual(goTestManifest);
-  });
-
   it('can find 1.9 from manifest on linux', async () => {
     os.platform = 'linux';
     os.arch = 'x64';
@@ -288,7 +256,7 @@ describe('setup-go', () => {
     expect(logSpy).toHaveBeenCalledWith(`Setup go version spec 1.13.0`);
   });
 
-  it('does not export GOROOT for Go versions >=1.9', async () => {
+  it('does not export any variables for Go versions >=1.9', async () => {
     inputs['go-version'] = '1.13.0';
     inSpy.mockImplementation(name => inputs[name]);
 
@@ -301,7 +269,7 @@ describe('setup-go', () => {
     });
 
     await main.run();
-    expect(vars).not.toHaveProperty('GOROOT');
+    expect(vars).toStrictEqual({});
   });
 
   it('exports GOROOT for Go versions <1.9', async () => {
@@ -317,7 +285,9 @@ describe('setup-go', () => {
     });
 
     await main.run();
-    expect(vars).toHaveProperty('GOROOT', toolPath);
+    expect(vars).toStrictEqual({
+      GOROOT: toolPath
+    });
   });
 
   it('finds a version of go already in the cache', async () => {
@@ -389,7 +359,7 @@ describe('setup-go', () => {
 
     const expPath = path.win32.join(toolPath, 'bin');
     expect(dlSpy).toHaveBeenCalledWith(
-      'https://go.dev/dl/go1.13.1.windows-amd64.zip',
+      'https://storage.googleapis.com/golang/go1.13.1.windows-amd64.zip',
       'C:\\temp\\go1.13.1.windows-amd64.zip',
       undefined
     );
@@ -811,9 +781,6 @@ describe('setup-go', () => {
       getManifestSpy.mockImplementation(() => {
         throw new Error('Unable to download manifest');
       });
-      httpmGetJsonSpy.mockRejectedValue(
-        new Error('Unable to download manifest from raw URL')
-      );
       getAllVersionsSpy.mockImplementationOnce(() => undefined);
 
       dlSpy.mockImplementation(async () => '/some/temp/path');
@@ -866,9 +833,6 @@ exclude example.com/thismodule v1.3.0
 
 use .
 
-`;
-
-    const toolVersionsContents = `golang 1.23
 `;
 
     it('reads version from go.mod', async () => {
@@ -895,18 +859,6 @@ use .
       expect(logSpy).toHaveBeenCalledWith('matching 1.19...');
     });
 
-    it('reads version from .tool-versions', async () => {
-      inputs['go-version-file'] = '.tool-versions';
-      existsSpy.mockImplementation(() => true);
-      readFileSpy.mockImplementation(() => Buffer.from(toolVersionsContents));
-
-      await main.run();
-
-      expect(logSpy).toHaveBeenCalledWith('Setup go version spec 1.23');
-      expect(logSpy).toHaveBeenCalledWith('Attempting to download 1.23...');
-      expect(logSpy).toHaveBeenCalledWith('matching 1.23...');
-    });
-
     it('reads version from .go-version', async () => {
       inputs['go-version-file'] = '.go-version';
       existsSpy.mockImplementation(() => true);
@@ -961,7 +913,7 @@ use .
         const expectedUrl =
           platform === 'win32'
             ? `https://github.com/actions/go-versions/releases/download/${version}/go-${version}-${platform}-${arch}.${fileExtension}`
-            : `https://go.dev/dl/go${version}.${osSpec}-${arch}.${fileExtension}`;
+            : `https://storage.googleapis.com/golang/go${version}.${osSpec}-${arch}.${fileExtension}`;
 
         // ... but not in the local cache
         findSpy.mockImplementation(() => '');
@@ -1005,104 +957,4 @@ use .
       }
     );
   });
-
-  describe('go-version-file-toolchain', () => {
-    const goVersions = ['1.22.0', '1.21rc2', '1.18'];
-    const placeholderVersion = '1.19';
-    const buildGoMod = (
-      goVersion: string,
-      toolchainVersion: string
-    ) => `module example.com/mymodule
-
-go ${goVersion}
-
-toolchain go${toolchainVersion}
-
-require (
-	example.com/othermodule v1.2.3
-	example.com/thismodule v1.2.3
-	example.com/thatmodule v1.2.3
-)
-
-replace example.com/thatmodule => ../thatmodule
-exclude example.com/thismodule v1.3.0
-`;
-
-    const buildGoWork = (
-      goVersion: string,
-      toolchainVersion: string
-    ) => `go 1.19
-
-toolchain go${toolchainVersion}
-
-use .
-
-`;
-
-    goVersions.forEach(version => {
-      [
-        {
-          goVersionfile: 'go.mod',
-          fileContents: Buffer.from(buildGoMod(placeholderVersion, version)),
-          expected_version: version,
-          desc: 'from toolchain directive'
-        },
-        {
-          goVersionfile: 'go.work',
-          fileContents: Buffer.from(buildGoMod(placeholderVersion, version)),
-          expected_version: version,
-          desc: 'from toolchain directive'
-        },
-        {
-          goVersionfile: 'go.mod',
-          fileContents: Buffer.from(buildGoMod(placeholderVersion, version)),
-          gotoolchain_env: 'local',
-          expected_version: placeholderVersion,
-          desc: 'from go directive when GOTOOLCHAIN is local'
-        },
-        {
-          goVersionfile: 'go.work',
-          fileContents: Buffer.from(buildGoMod(placeholderVersion, version)),
-          gotoolchain_env: 'local',
-          expected_version: placeholderVersion,
-          desc: 'from go directive when GOTOOLCHAIN is local'
-        }
-      ].forEach(test => {
-        it(`reads version (${version}) in ${test.goVersionfile} ${test.desc}`, async () => {
-          inputs['go-version-file'] = test.goVersionfile;
-          if (test.gotoolchain_env !== undefined) {
-            process.env[im.GOTOOLCHAIN_ENV_VAR] = test.gotoolchain_env;
-          }
-          existsSpy.mockImplementation(() => true);
-          readFileSpy.mockImplementation(() => Buffer.from(test.fileContents));
-
-          await main.run();
-
-          expect(logSpy).toHaveBeenCalledWith(
-            `Setup go version spec ${test.expected_version}`
-          );
-          expect(logSpy).toHaveBeenCalledWith(
-            `Attempting to download ${test.expected_version}...`
-          );
-          expect(logSpy).toHaveBeenCalledWith(
-            `matching ${test.expected_version}...`
-          );
-        });
-      });
-    });
-  });
-
-  it('exports GOTOOLCHAIN and sets it in current process env', async () => {
-    inputs['go-version'] = '1.21.0';
-    inSpy.mockImplementation(name => inputs[name]);
-
-    const vars: {[key: string]: string} = {};
-    exportVarSpy.mockImplementation((name: string, val: string) => {
-      vars[name] = val;
-    });
-
-    await main.run();
-    expect(vars).toStrictEqual({GOTOOLCHAIN: 'local'});
-    expect(process.env).toHaveProperty('GOTOOLCHAIN', 'local');
-  });
 });

__tests__/utils.test.ts

@@ -1,52 +0,0 @@
-import {isSelfHosted} from '../src/utils';
-
-describe('utils', () => {
-  describe('isSelfHosted', () => {
-    let AGENT_ISSELFHOSTED: string | undefined;
-    let RUNNER_ENVIRONMENT: string | undefined;
-
-    beforeEach(() => {
-      AGENT_ISSELFHOSTED = process.env['AGENT_ISSELFHOSTED'];
-      delete process.env['AGENT_ISSELFHOSTED'];
-      RUNNER_ENVIRONMENT = process.env['RUNNER_ENVIRONMENT'];
-      delete process.env['RUNNER_ENVIRONMENT'];
-    });
-
-    afterEach(() => {
-      if (AGENT_ISSELFHOSTED === undefined) {
-        delete process.env['AGENT_ISSELFHOSTED'];
-      } else {
-        process.env['AGENT_ISSELFHOSTED'] = AGENT_ISSELFHOSTED;
-      }
-      if (RUNNER_ENVIRONMENT === undefined) {
-        delete process.env['RUNNER_ENVIRONMENT'];
-      } else {
-        process.env['RUNNER_ENVIRONMENT'] = RUNNER_ENVIRONMENT;
-      }
-    });
-
-    it('isSelfHosted should be true if no environment variables set', () => {
-      expect(isSelfHosted()).toBeTruthy();
-    });
-
-    it('isSelfHosted should be true if environment variable is not set to denote GitHub hosted', () => {
-      process.env['RUNNER_ENVIRONMENT'] = 'some';
-      expect(isSelfHosted()).toBeTruthy();
-    });
-
-    it('isSelfHosted should be true if environment variable set to denote Azure Pipelines self hosted', () => {
-      process.env['AGENT_ISSELFHOSTED'] = '1';
-      expect(isSelfHosted()).toBeTruthy();
-    });
-
-    it('isSelfHosted should be false if environment variable set to denote GitHub hosted', () => {
-      process.env['RUNNER_ENVIRONMENT'] = 'github-hosted';
-      expect(isSelfHosted()).toBeFalsy();
-    });
-
-    it('isSelfHosted should be false if environment variable is not set to denote Azure Pipelines self hosted', () => {
-      process.env['AGENT_ISSELFHOSTED'] = 'some';
-      expect(isSelfHosted()).toBeFalsy();
-    });
-  });
-});

__tests__/windows-toolcache.test.ts

@@ -1,62 +0,0 @@
-import fs from 'fs';
-import * as io from '@actions/io';
-import * as tc from '@actions/tool-cache';
-import path from 'path';
-
-describe('Windows performance workaround', () => {
-  let mkdirSpy: jest.SpyInstance;
-  let symlinkSpy: jest.SpyInstance;
-  let statSpy: jest.SpyInstance;
-  let readdirSpy: jest.SpyInstance;
-  let writeFileSpy: jest.SpyInstance;
-  let rmRFSpy: jest.SpyInstance;
-  let mkdirPSpy: jest.SpyInstance;
-  let cpSpy: jest.SpyInstance;
-
-  let runnerToolCache: string | undefined;
-  beforeEach(() => {
-    mkdirSpy = jest.spyOn(fs, 'mkdir');
-    symlinkSpy = jest.spyOn(fs, 'symlinkSync');
-    statSpy = jest.spyOn(fs, 'statSync');
-    readdirSpy = jest.spyOn(fs, 'readdirSync');
-    writeFileSpy = jest.spyOn(fs, 'writeFileSync');
-    rmRFSpy = jest.spyOn(io, 'rmRF');
-    mkdirPSpy = jest.spyOn(io, 'mkdirP');
-    cpSpy = jest.spyOn(io, 'cp');
-
-    // default implementations
-    // @ts-ignore - not implement unused methods
-    statSpy.mockImplementation(() => ({
-      isDirectory: () => true
-    }));
-    readdirSpy.mockImplementation(() => []);
-    writeFileSpy.mockImplementation(() => {});
-    mkdirSpy.mockImplementation(() => {});
-    symlinkSpy.mockImplementation(() => {});
-    rmRFSpy.mockImplementation(() => Promise.resolve());
-    mkdirPSpy.mockImplementation(() => Promise.resolve());
-    cpSpy.mockImplementation(() => Promise.resolve());
-
-    runnerToolCache = process.env['RUNNER_TOOL_CACHE'];
-  });
-  afterEach(() => {
-    jest.clearAllMocks();
-    process.env['RUNNER_TOOL_CACHE'] = runnerToolCache;
-  });
-  // cacheWindowsToolkitDir depends on implementation of tc.cacheDir
-  // with the assumption that target dir is passed by RUNNER_TOOL_CACHE environment variable
-  // Make sure the implementation has not been changed
-  it('addExecutablesToCache should depend on env[RUNNER_TOOL_CACHE]', async () => {
-    process.env['RUNNER_TOOL_CACHE'] = '/faked-hostedtoolcache1';
-    const cacheDir1 = await tc.cacheDir('/qzx', 'go', '1.2.3', 'arch');
-    expect(cacheDir1).toBe(
-      path.join('/', 'faked-hostedtoolcache1', 'go', '1.2.3', 'arch')
-    );
-
-    process.env['RUNNER_TOOL_CACHE'] = '/faked-hostedtoolcache2';
-    const cacheDir2 = await tc.cacheDir('/qzx', 'go', '1.2.3', 'arch');
-    expect(cacheDir2).toBe(
-      path.join('/', 'faked-hostedtoolcache2', 'go', '1.2.3', 'arch')
-    );
-  });
-});

action.yml

@@ -5,7 +5,7 @@ inputs:
   go-version:
     description: 'The Go version to download (if necessary) and use. Supports semver spec and ranges. Be sure to enclose this option in single quotation marks.'
   go-version-file:
-    description: 'Path to the go.mod, go.work, .go-version, or .tool-versions file.'
+    description: 'Path to the go.mod or go.work file.'
   check-latest:
     description: 'Set this option to true if you want the action to always check for the latest available version that satisfies the version spec'
     default: false
@@ -16,7 +16,7 @@ inputs:
     description: Used to specify whether caching is needed. Set to true, if you'd like to enable caching.
     default: true
   cache-dependency-path:
-    description: 'Used to specify the path to a dependency file (e.g., go.mod, go.sum)'
+    description: 'Used to specify the path to a dependency file - go.sum'
   architecture:
     description: 'Target architecture for Go to use. Examples: x86, x64. Will use system architecture by default.'
 outputs:
@@ -25,7 +25,7 @@ outputs:
   cache-hit:
     description: 'A boolean value to indicate if a cache was hit'
 runs:
-  using: 'node24'
+  using: 'node16'
   main: 'dist/setup/index.js'
   post: 'dist/cache-save/index.js'
   post-if: success()

docs/adrs/0000-caching-dependencies.md

@@ -4,7 +4,7 @@ Date: 2022-04-13
 Status: Accepted
 
 # Context
-`actions/setup-go` is the one of the most popular action related to Golang in GitHub Actions. Many customers use it in conjunction with [actions/cache](https://github.com/actions/cache) to speed up dependency installation process.
+`actions/setup-go` is the one of the most popular action related to Golang in GitHub Actions. Many customers use it in conjunction with [actions/cache](https://github.com/actions/cache) to speed up dependency installation process.  
 See more examples on proper usage in [actions/cache documentation](https://github.com/actions/cache/blob/main/examples.md#go---modules).
 
 # Goals & Anti-Goals
@@ -16,7 +16,7 @@ Integration of caching functionality into `actions/setup-go` action will bring t
 We don't pursue the goal to provide wide customization of caching in scope of `actions/setup-go` action. The purpose of this integration is covering ~90% of basic use-cases. If user needs flexible customization, we should advice them to use `actions/cache` directly.
 
 # Decision
-- Add `cache` input parameter to `actions/setup-go`. For now, input will accept the following values:
+- Add `cache` input parameter to `actions/setup-go`. For now, input will accept the following values: 
   - `true` - enable caching for go dependencies
   - `false`- disable caching for go dependencies. This value will be set as default value
 - Cache feature will be disabled by default to make sure that we don't break existing customers. We will consider enabling cache by default in next major releases
@@ -32,7 +32,7 @@ We don't pursue the goal to provide wide customization of caching in scope of `a
 
 ```yml
 steps:
-- uses: actions/checkout@v4
+- uses: actions/checkout@v3
 - uses: actions/setup-go@v3
   with:
     go-version: '18'
@@ -43,7 +43,7 @@ steps:
 
  ```yml
 steps:
-- uses: actions/checkout@v4
+- uses: actions/checkout@v3
 - uses: actions/setup-go@v3
   with:
     go-version: '18'
@@ -53,7 +53,7 @@ steps:
 
  ```yml
 steps:
-- uses: actions/checkout@v4
+- uses: actions/checkout@v3
 - uses: actions/setup-go@v3
   with:
     go-version: '18'
@@ -66,4 +66,4 @@ steps:
 # Release process
 
 As soon as functionality is implemented, we will release minor update of action. No need to bump major version since there are no breaking changes for existing users.
-After that, we will update [starter-workflows](https://github.com/actions/starter-workflows/blob/main/ci/go.yml)
+After that, we will update [starter-workflows](https://github.com/actions/starter-workflows/blob/main/ci/go.yml)

docs/advanced-usage.md

@@ -1,444 +0,0 @@
-# Advanced Usage
-- [Using the go-version input](advanced-usage.md#using-the-go-version-input)
-  - [Specifying a go version](advanced-usage.md#specifying-a-go-version)
-  - [Matrix testing](advanced-usage.md#matrix-testing)
-- [Using the go-version-file input](advanced-usage.md#using-the-go-version-file-input)
-- [Check latest version](advanced-usage.md#check-latest-version)
-- [Caching](advanced-usage.md#caching)
-  - [Caching in monorepos](advanced-usage.md#caching-in-monorepos)
-  - [Caching in multi-module repositories](advanced-usage.md#caching-in-multi-module-repositories)
-  - [Multi-target builds](advanced-usage.md#multi-target-builds)
-  - [Cache invalidation on source changes](advanced-usage.md#cache-invalidation-on-source-changes)
-  - [Restore-only caches](advanced-usage.md#restore-only-caches)
-  - [Parallel builds](advanced-usage.md#parallel-builds)
-- [Outputs](advanced-usage.md#outputs)
-- [Using `setup-go` on GHES](advanced-usage.md#using-setup-go-on-ghes)
-
-## Using the `go-version` input
-
-### Specifying a Go version
-
-For repeatable builds, specify the **exact major, minor, and patch version** (such as `1.25.5`):
-
-```yaml
-steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version: '1.25.5'
-  - run: go run hello.go
-```
-
-- The only downside is that setup may take a little longer. If the exact version is not already installed on the runner due to more recent versions, the exact version will have to be downloaded.
-
-You can specify **only a major and minor version** if you are okay with the most recent patch version being used:
-
-```yaml
-steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version: '1.25'
-  - run: go run hello.go
-```
-
-- There will be a single patch version already installed on each runner for every minor version of Go that is supported.
-- The preinstalled patch version is generally the latest available. When a new patch is released, it replaces the previously preinstalled version on the runner.
-- Using the most recent patch version speeds up setup because the required Go version is already installed on the runner and no download is needed.
-
-To try a **pre-release**:
-Download and use beta or RC Go versions as needed.
-
-```yaml
-# RC version
-steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version: '1.25.0-rc.2'
-  - run: go version
-```
-
-```yaml
-# Beta version
-steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version: '1.19.0-beta.1'
-  - run: go version
-```
-
-Using **stable/oldstable aliases**:
-
-If `stable` is provided, the action will get the latest stable version from the [`go-versions`](https://github.com/actions/go-versions/blob/main/versions-manifest.json) repository manifest.
-
-If `oldstable` is provided, the action resolves it to the latest patch release of the previous stable Go minor version (for example, if the latest stable is `1.25.x`, `oldstable` resolves to `1.24.x`, where `x` is the latest patch release).
-
-**Note:** Using these aliases will result in the same version as when using the corresponding minor release with the `check-latest` input set to `true`.  
-
-```yaml
-steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version: 'stable'
-  - run: go run hello.go
-```
-
-```yaml
-steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version: 'oldstable'
-  - run: go run hello.go
-```
-
-You can also use **SemVer's version range syntax**, for instance:
-
-```yaml
-steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version: '^1.25.1'
-  - run: go version
-```
-
-```yaml
-steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version: '>=1.24.0-rc.1'
-  - run: go version
-```
-
-### Matrix testing
-
-Using `setup-go` it's possible to use the [matrix syntax](https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix) to install several versions of Go:
-
-```yaml
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        go: [ '1.24', '1.25' ]
-    name: Go ${{ matrix.go }} sample
-    steps:
-      - uses: actions/checkout@v6
-      - name: Setup go
-        uses: actions/setup-go@v6
-        with:
-          go-version: ${{ matrix.go }}
-      - run: go run hello.go
-```
-
-Exclude a specific Go version:
-
-```yaml
-jobs:
-  build:
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-        go: [ '1.22', '1.24', '1.25']
-        exclude:
-          - os: macos-latest
-            go: '1.22'
-          - os: windows-latest
-            go: '1.25'
-    steps:
-      - uses: actions/checkout@v6
-      - name: Setup go
-        uses: actions/setup-go@v6
-        with:
-          go-version: ${{ matrix.go }}
-      - run: go run hello.go
-```
-
-## Using the `go-version-file` input
-
-`setup-go` action can read the Go version from a version file. `go-version-file` input is used for specifying the path to the version file. If the file supplied to the `go-version-file` input doesn't exist, the action will fail with an error. This input supports go.mod, go.work, .go-version, and .tool-versions files.
-
-If both the `go-version` and the `go-version-file` inputs are provided then the `go-version` input is used. The `.tool-versions` file supports version specifications in accordance with asdf standards, adhering to Semantic Versioning ([semver](https://semver.org)).
-
-```yaml
-steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version-file: 'path/to/go.mod'  # Read Go version from go.mod
-  - run: go version
-```
-
-- Uses the `toolchain` directive if present, otherwise the action falls back to the `go` directive.
-
-- The `go` directive in `go.mod` can specify a patch version or omit it altogether (e.g., `go 1.25.0` or `go 1.25`). If a patch version is specified, that specific patch version will be used. If no patch version is specified, it will search for the latest available patch version in the cache,
-[versions-manifest.json](https://github.com/actions/go-versions/blob/main/versions-manifest.json), and the
-[official Go language website](https://go.dev/dl/?mode=json&include=all), in that order.
-
-> The action will search for the `go.mod` file relative to the repository root.
-
-```yaml
-steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version-file: '.go-version' # Read Go version from .go-version
-  - run: go version
-```
-
-```yaml
-steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version-file: '.tool-versions' # Read Go version from .tool-versions
-  - run: go version
-```
-
-```yaml
-steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version-file: 'go.work' # Read Go version from go.work
-  - run: go version
-```
-
-## Check latest version
-
-The `check-latest` flag defaults to `false`. Use the default or set `check-latest` to `false` if you prefer stability
-and if you want to ensure a specific Go version is always used.
-
-If `check-latest` is set to `true`, the action first checks if the cached version is the latest one. If the locally
-cached version is not the most up-to-date, a Go version will then be downloaded. Set `check-latest` to `true` if you
-want the most up-to-date Go version to always be used. It supports major (e.g., "1") and major.minor (e.g., "1.25") version selectors, always resolving to the latest matching patch release.
-
-> Setting `check-latest` to `true` has performance implications as downloading Go versions is slower than using cached
-> versions.
-
-```yaml
-steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version: '1.25'
-      check-latest: true
-  - run: go run hello.go
-```
-
-## Caching
- 
-### Caching in monorepos
-
-```yaml
-steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version: '1.25'
-      cache-dependency-path: subdir/go.sum
-  - run: go run hello.go
-```
-
-### Caching in multi-module repositories
-
-`cache-dependency-path` input accepts glob patterns and multi-line values:
-
-```yaml
-steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version: '1.25'
-      cache-dependency-path: '**/go.sum'
-  - run: go run hello.go
-```
-
-```yaml
-steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version: '1.25'
-      cache-dependency-path: |
-        subdir/go.sum
-        tools/go.sum
-  - run: go run hello.go
-```
-
-### Multi-target builds
-
-`cache-dependency-path` isn’t limited to dependency files (like `go.sum`). It can also include files that capture build settings (for example, `GOOS`/`GOARCH`). This allows separate caches per target platform (OS/architecture) and helps avoid reusing caches across incompatible builds.
-
-```yaml
-env:
-  GOOS: ...
-  GOARCH: ...
-
-steps:
-  - run: echo "$GOOS $GOARCH" > env.txt
-
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version: '1.25'
-      cache-dependency-path: |
-        go.sum
-        env.txt
-  - run: go run hello.go    
-```
-
-### Cache invalidation on source changes
-
-Besides dependencies, the action can also cache build outputs (the [`GOCACHE`](https://pkg.go.dev/cmd/go#hdr-Build_and_test_caching) directory). By default, this cache is not updated based on source changes to help avoid unpredictable and frequent cache invalidation. To invalidate the cache when source files change, include source files in the `cache-dependency-path` input.
-
-> **Note:** Including patterns like `**/*.go` can create new caches on many commits, increasing cache storage and potentially slowing workflows due to more frequent uploads/downloads.
-
-```yaml
-steps:
-  - uses: actions/checkout@v6
-  - uses: actions/setup-go@v6
-    with:
-      go-version: '1.25'
-      cache-dependency-path: |
-        go.sum
-        **/*.go
-  - run: go run hello.go
-```
-
-### Restore-only caches
-
-Restore caches without saving new entries. This can help reduce cache writes and storage usage in workflows that only need to read from the cache:
-
-```yaml
-jobs:
-  build:
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-    steps:
-      - uses: actions/checkout@v6
-      - name: Setup go
-        id: setup-go
-        uses: actions/setup-go@v6
-        with:
-          go-version: '1.25.5'
-          cache: false
-      # Capture Go cache locations
-      - name: Set Go cache variables (Linux/macOS)
-        if: runner.os != 'Windows'
-        run: |
-          echo "GO_MOD_CACHE=$(go env GOMODCACHE)" >> $GITHUB_ENV
-          echo "GO_BUILD_CACHE=$(go env GOCACHE)" >> $GITHUB_ENV
-      - name: Set Go cache variables (Windows)
-        if: runner.os == 'Windows'
-        shell: pwsh
-        run: |
-          echo "GO_MOD_CACHE=$(go env GOMODCACHE)" | Out-File $env:GITHUB_ENV -Append
-          echo "GO_BUILD_CACHE=$(go env GOCACHE)"   | Out-File $env:GITHUB_ENV -Append
-      # Normalize runner.arch to lowercase to ensure consistent cache keys
-      - name: Normalize runner architecture (Linux/macOS)
-        if: runner.os != 'Windows'
-        shell: bash
-        run: echo "ARCH=$(echo '${{ runner.arch }}' | tr '[:upper:]' '[:lower:]')" >> $GITHUB_ENV
-      - name: Normalize runner architecture (Windows)
-        if: runner.os == 'Windows'
-        shell: pwsh
-        run: |
-          $arch = "${{ runner.arch }}".ToLower()
-          echo "ARCH=$arch" | Out-File $env:GITHUB_ENV -Append
-      - name: Set cache OS suffix for Linux
-        if: runner.os == 'Linux'
-        shell: bash
-        run: echo "CACHE_OS_SUFFIX=$ImageOS-" >> $GITHUB_ENV
-      - name: Restore Go cache
-        id: go-cache
-        uses: actions/cache/restore@v5
-        with:
-          path: |
-            ${{ env.GO_MOD_CACHE }}
-            ${{ env.GO_BUILD_CACHE }}
-          key: setup-go-${{ runner.os }}-${{ env.ARCH }}-${{ env.CACHE_OS_SUFFIX }}go-${{ steps.setup-go.outputs.go-version }}-${{ hashFiles('**/go.mod') }}
-      - name: Download modules
-        run: go mod download
-      - name: Build
-        run: go build ./...
-```
-
-> If there are several builds on the same repo, it may make sense to create a cache in one build and use it in others. The action [actions/cache/restore](https://github.com/actions/cache/tree/main/restore#only-restore-cache)
-should be used in this case.
-
-### Parallel builds
-
-To avoid race conditions during parallel builds, either use distinct cache keys with [actions/cache](https://github.com/actions/cache/blob/main/examples.md#go---modules), or create the cache in only one build and [restore](#restore-only-caches) it in the other builds.
-
-## Outputs
-
-### `go-version`
-
-Using **go-version** output, it's possible to get the precise Go version installed by the action. This output is useful when the input `go-version` is given as a range, but down the line you need to operate (such as in an `if:` statement) with the exact installed version (e.g. 1.24.11). 
-
-```yaml
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/setup-go@v6
-        id: go124
-        with:
-          go-version: '^1.24'
-      - run: echo "Installed Go version: ${{ steps.go124.outputs.go-version }}"
-```
-
-### `cache-hit`
-
-**cache-hit** output is available with a boolean value that indicates whether a cache hit occurred on the primary key:
-
-```yaml
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/setup-go@v6
-        id: go124
-        with:
-          go-version: '1.24'
-          cache: true
-      - run: echo "Was the Go cache restored? ${{ steps.go124.outputs.cache-hit }}" # true if cache-hit occurred
-```
-
-## Using `setup-go` on GHES
-
-### Avoiding rate limit issues
-
-`setup-go` comes pre-installed on the appliance with GHES if Actions is enabled.
-When dynamically downloading Go distributions, `setup-go` downloads distributions from [`actions/go-versions`](https://github.com/actions/go-versions) on github.com (outside of the appliance).
-
-These calls to `actions/go-versions` are made via unauthenticated requests, which are limited to [60 requests per hour per IP](https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting).
-If more requests are made within the time frame, then the action leverages the `raw API` to retrieve the version-manifest. This approach does not impose a rate limit and hence facilitates unrestricted consumption. This is particularly beneficial for GHES runners, which often share the same IP, to avoid the quick exhaustion of the unauthenticated rate limit.
-If that fails as well the action will try to download versions directly from [go.dev](https://go.dev/dl).
-
-If that fails as well you can get a higher rate limit with [generating a personal access token on github.com](https://github.com/settings/tokens/new) and passing it as the `token` input to the action:
-
-```yaml
-uses: actions/setup-go@v6
-with:
-  token: ${{ secrets.GH_DOTCOM_TOKEN }}
-  go-version: '1.25'
-```
-
-### No access to github.com
-
-If the runner is not able to access github.com, any Go versions requested during a workflow run must come from the runner's tool cache.
-See "[Setting up the tool cache on self-hosted runners without internet access](https://docs.github.com/en/enterprise-server@3.2/admin/github-actions/managing-access-to-actions-from-githubcom/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access)"
-for more information.

docs/contributors.md

@@ -6,13 +6,13 @@ We have prepared a short guide so that the process of making your contribution i
 
 ## How can I contribute...
 
-* [Contribute Documentation :green_book:](#contribute-documentation)
+* [Contribute Documentation:green_book:](#contribute-documentation)
 
 * [Contribute Code :computer:](#contribute-code)
 
-* [Provide Support on Issues :pencil:](#provide-support-on-issues)
+* [Provide Support on Issues:pencil:](#provide-support-on-issues)
 
-* [Review Pull Requests :mag:](#review-pull-requests)
+* [Review Pull Requests:mag:](#review-pull-requests)
 
 ## Contribute documentation
 
@@ -113,4 +113,4 @@ Another great way to contribute is pull request reviews. Please, be extra kind:
 - Make sure you're familiar with the code or documentation is updated, unless it's a minor change (spellchecking, minor formatting, etc.)
 - Review changes using the GitHub functionality. You can ask a clarifying question, point out an error or suggest an alternative. 
 > Note: You may ask for minor changes - "nitpicks", but consider whether they are real blockers to merging or not
-- Submit your review, which may include comments, an approval, or a changes request
+- Submit your review, which may include comments, an approval, or a changes request

package.json

@@ -1,12 +1,9 @@
 {
   "name": "setup-go",
-  "version": "6.2.0",
+  "version": "4.0.0",
   "private": true,
   "description": "setup go action",
   "main": "lib/setup-go.js",
-  "engines": {
-    "node": ">=24.0.0"
-  },
   "scripts": {
     "build": "tsc && ncc build -o dist/setup src/setup-go.ts && ncc build -o dist/cache-save src/cache-save.ts",
     "format": "prettier --no-error-on-unmatched-pattern --config ./.prettierrc.js --write \"**/*.{ts,yml,yaml}\"",
@@ -28,31 +25,31 @@
   "author": "GitHub",
   "license": "MIT",
   "dependencies": {
-    "@actions/cache": "^5.0.1",
-    "@actions/core": "^1.11.1",
-    "@actions/exec": "^1.1.1",
-    "@actions/glob": "^0.5.0",
-    "@actions/http-client": "^2.2.1",
+    "@actions/cache": "^3.2.1",
+    "@actions/core": "^1.10.0",
+    "@actions/exec": "^1.1.0",
+    "@actions/glob": "^0.2.0",
+    "@actions/http-client": "^2.0.1",
     "@actions/io": "^1.0.2",
-    "@actions/tool-cache": "^2.0.2",
-    "semver": "^7.7.3"
+    "@actions/tool-cache": "^1.5.5",
+    "semver": "^6.1.1"
   },
   "devDependencies": {
-    "@types/jest": "^29.5.14",
-    "@types/node": "^24.1.0",
-    "@types/semver": "^7.7.1",
-    "@typescript-eslint/eslint-plugin": "^8.31.1",
-    "@typescript-eslint/parser": "^8.35.1",
-    "@vercel/ncc": "^0.38.1",
-    "eslint": "^8.57.0",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-jest": "^29.0.1",
+    "@types/jest": "^27.0.2",
+    "@types/node": "^16.11.25",
+    "@types/semver": "^6.0.0",
+    "@typescript-eslint/eslint-plugin": "^5.54.0",
+    "@typescript-eslint/parser": "^5.54.0",
+    "@vercel/ncc": "^0.33.4",
+    "eslint": "^8.35.0",
+    "eslint-config-prettier": "^8.6.0",
+    "eslint-plugin-jest": "^27.2.1",
     "eslint-plugin-node": "^11.1.0",
-    "jest": "^29.7.0",
-    "jest-circus": "^29.7.0",
+    "jest": "^27.2.5",
+    "jest-circus": "^27.2.5",
     "nock": "^10.0.6",
     "prettier": "^2.8.4",
-    "ts-jest": "^29.3.2",
-    "typescript": "^5.8.3"
+    "ts-jest": "^27.0.5",
+    "typescript": "^4.3.3"
   }
 }

src/cache-restore.ts

@@ -15,7 +15,6 @@ export const restoreCache = async (
 ) => {
   const packageManagerInfo = await getPackageManagerInfo(packageManager);
   const platform = process.env.RUNNER_OS;
-  const arch = process.arch;
 
   const cachePaths = await getCacheDirectoryPath(packageManagerInfo);
 
@@ -30,9 +29,7 @@ export const restoreCache = async (
     );
   }
 
-  const linuxVersion =
-    process.env.RUNNER_OS === 'Linux' ? `${process.env.ImageOS}-` : '';
-  const primaryKey = `setup-go-${platform}-${arch}-${linuxVersion}go-${versionSpec}-${fileHash}`;
+  const primaryKey = `setup-go-${platform}-go-${versionSpec}-${fileHash}`;
   core.debug(`primary key is ${primaryKey}`);
 
   core.saveState(State.CachePrimaryKey, primaryKey);
@@ -55,8 +52,8 @@ const findDependencyFile = (packageManager: PackageManagerInfo) => {
   const workspace = process.env.GITHUB_WORKSPACE!;
   const rootContent = fs.readdirSync(workspace);
 
-  const goModFileExists = rootContent.includes(dependencyFile);
-  if (!goModFileExists) {
+  const goSumFileExists = rootContent.includes(dependencyFile);
+  if (!goSumFileExists) {
     throw new Error(
       `Dependencies file is not found in ${workspace}. Supported file pattern: ${dependencyFile}`
     );

src/cache-save.ts

@@ -12,20 +12,9 @@ process.on('uncaughtException', e => {
   core.info(`${warningPrefix}${e.message}`);
 });
 
-// Added early exit to resolve issue with slow post action step:
-// - https://github.com/actions/setup-node/issues/878
-// https://github.com/actions/cache/pull/1217
-
-export async function run(earlyExit?: boolean) {
+export async function run() {
   try {
-    const cacheInput = core.getBooleanInput('cache');
-    if (cacheInput) {
-      await cachePackages();
-
-      if (earlyExit) {
-        process.exit(0);
-      }
-    }
+    await cachePackages();
   } catch (error) {
     let message = 'Unknown error!';
     if (error instanceof Error) {
@@ -39,6 +28,11 @@ export async function run(earlyExit?: boolean) {
 }
 
 const cachePackages = async () => {
+  const cacheInput = core.getBooleanInput('cache');
+  if (!cacheInput) {
+    return;
+  }
+
   const packageManager = 'default';
 
   const state = core.getState(State.CacheMatchedKey);
@@ -91,4 +85,4 @@ function logWarning(message: string): void {
   core.info(`${warningPrefix}${message}`);
 }
 
-run(true);
+run();

src/cache-utils.ts

@@ -63,13 +63,7 @@ export function isGhes(): boolean {
   const ghUrl = new URL(
     process.env['GITHUB_SERVER_URL'] || 'https://github.com'
   );
-
-  const hostname = ghUrl.hostname.trimEnd().toUpperCase();
-  const isGitHubHost = hostname === 'GITHUB.COM';
-  const isGitHubEnterpriseCloudHost = hostname.endsWith('.GHE.COM');
-  const isLocalHost = hostname.endsWith('.LOCALHOST');
-
-  return !isGitHubHost && !isGitHubEnterpriseCloudHost && !isLocalHost;
+  return ghUrl.hostname.toUpperCase() !== 'GITHUB.COM';
 }
 
 export function isCacheFeatureAvailable(): boolean {

src/installer.ts

@@ -6,20 +6,10 @@ import * as httpm from '@actions/http-client';
 import * as sys from './system';
 import fs from 'fs';
 import os from 'os';
-import {StableReleaseAlias, isSelfHosted} from './utils';
-import {Architecture} from './types';
-
-export const GOTOOLCHAIN_ENV_VAR = 'GOTOOLCHAIN';
-export const GOTOOLCHAIN_LOCAL_VAL = 'local';
-const MANIFEST_REPO_OWNER = 'actions';
-const MANIFEST_REPO_NAME = 'go-versions';
-const MANIFEST_REPO_BRANCH = 'main';
-const MANIFEST_URL = `https://raw.githubusercontent.com/${MANIFEST_REPO_OWNER}/${MANIFEST_REPO_NAME}/${MANIFEST_REPO_BRANCH}/versions-manifest.json`;
+import {StableReleaseAlias} from './utils';
 
 type InstallationType = 'dist' | 'manifest';
 
-const GOLANG_DOWNLOAD_URL = 'https://go.dev/dl/?mode=json&include=all';
-
 export interface IGoVersionFile {
   filename: string;
   // darwin, linux, windows
@@ -44,7 +34,7 @@ export async function getGo(
   versionSpec: string,
   checkLatest: boolean,
   auth: string | undefined,
-  arch: Architecture = os.arch() as Architecture
+  arch = os.arch()
 ) {
   let manifest: tc.IToolRelease[] | undefined;
   const osPlat: string = os.platform();
@@ -124,9 +114,9 @@ export async function getGo(
         `Received HTTP status code ${err.httpStatusCode}.  This usually indicates the rate limit has been exceeded`
       );
     } else {
-      core.info((err as Error).message);
+      core.info(err.message);
     }
-    core.debug((err as Error).stack ?? '');
+    core.debug(err.stack);
     core.info('Falling back to download directly from Go');
   }
 
@@ -156,7 +146,7 @@ async function resolveVersionFromManifest(
   versionSpec: string,
   stable: boolean,
   auth: string | undefined,
-  arch: Architecture,
+  arch: string,
   manifest: tc.IToolRelease[] | undefined
 ): Promise<string | undefined> {
   try {
@@ -170,75 +160,10 @@ async function resolveVersionFromManifest(
     return info?.resolvedVersion;
   } catch (err) {
     core.info('Unable to resolve a version from the manifest...');
-    core.debug((err as Error).message);
+    core.debug(err.message);
   }
 }
 
-// for github hosted windows runner handle latency of OS drive
-// by avoiding write operations to C:
-async function cacheWindowsDir(
-  extPath: string,
-  tool: string,
-  version: string,
-  arch: string
-): Promise<string | false> {
-  if (os.platform() !== 'win32') return false;
-
-  // make sure the action runs in the hosted environment
-  if (isSelfHosted()) return false;
-
-  const defaultToolCacheRoot = process.env['RUNNER_TOOL_CACHE'];
-  if (!defaultToolCacheRoot) return false;
-
-  if (!fs.existsSync('d:\\') || !fs.existsSync('c:\\')) return false;
-
-  const actualToolCacheRoot = defaultToolCacheRoot
-    .replace('C:', 'D:')
-    .replace('c:', 'd:');
-  // make toolcache root to be on drive d:
-  process.env['RUNNER_TOOL_CACHE'] = actualToolCacheRoot;
-
-  const actualToolCacheDir = await tc.cacheDir(extPath, tool, version, arch);
-
-  // create a link from c: to d:
-  const defaultToolCacheDir = actualToolCacheDir.replace(
-    actualToolCacheRoot,
-    defaultToolCacheRoot
-  );
-  fs.mkdirSync(path.dirname(defaultToolCacheDir), {recursive: true});
-  fs.symlinkSync(actualToolCacheDir, defaultToolCacheDir, 'junction');
-  core.info(`Created link ${defaultToolCacheDir} => ${actualToolCacheDir}`);
-
-  const actualToolCacheCompleteFile = `${actualToolCacheDir}.complete`;
-  const defaultToolCacheCompleteFile = `${defaultToolCacheDir}.complete`;
-  fs.symlinkSync(
-    actualToolCacheCompleteFile,
-    defaultToolCacheCompleteFile,
-    'file'
-  );
-  core.info(
-    `Created link ${defaultToolCacheCompleteFile} => ${actualToolCacheCompleteFile}`
-  );
-
-  // make outer code to continue using toolcache as if it were installed on c:
-  // restore toolcache root to default drive c:
-  process.env['RUNNER_TOOL_CACHE'] = defaultToolCacheRoot;
-  return defaultToolCacheDir;
-}
-
-async function addExecutablesToToolCache(
-  extPath: string,
-  info: IGoVersionInfo,
-  arch: string
-): Promise<string> {
-  const tool = 'go';
-  const version = makeSemver(info.resolvedVersion);
-  return (
-    (await cacheWindowsDir(extPath, tool, version, arch)) ||
-    (await tc.cacheDir(extPath, tool, version, arch))
-  );
-}
-
 async function installGoVersion(
   info: IGoVersionInfo,
   auth: string | undefined,
@@ -261,10 +186,14 @@ async function installGoVersion(
   }
 
   core.info('Adding to the cache ...');
-  const toolCacheDir = await addExecutablesToToolCache(extPath, info, arch);
-  core.info(`Successfully cached go to ${toolCacheDir}`);
-
-  return toolCacheDir;
+  const cachedDir = await tc.cacheDir(
+    extPath,
+    'go',
+    makeSemver(info.resolvedVersion),
+    arch
+  );
+  core.info(`Successfully cached go to ${cachedDir}`);
+  return cachedDir;
 }
 
 export async function extractGoArchive(archivePath: string): Promise<string> {
@@ -280,85 +209,15 @@ export async function extractGoArchive(archivePath: string): Promise<string> {
   return extPath;
 }
 
-function isIToolRelease(obj: any): obj is tc.IToolRelease {
-  return (
-    typeof obj === 'object' &&
-    obj !== null &&
-    typeof obj.version === 'string' &&
-    typeof obj.stable === 'boolean' &&
-    Array.isArray(obj.files) &&
-    obj.files.every(
-      (file: any) =>
-        typeof file.filename === 'string' &&
-        typeof file.platform === 'string' &&
-        typeof file.arch === 'string' &&
-        typeof file.download_url === 'string'
-    )
-  );
-}
-
-export async function getManifest(
-  auth: string | undefined
-): Promise<tc.IToolRelease[]> {
-  try {
-    const manifest = await getManifestFromRepo(auth);
-    if (
-      Array.isArray(manifest) &&
-      manifest.length &&
-      manifest.every(isIToolRelease)
-    ) {
-      return manifest;
-    }
-
-    let errorMessage =
-      'An unexpected error occurred while fetching the manifest.';
-    if (
-      typeof manifest === 'object' &&
-      manifest !== null &&
-      'message' in manifest
-    ) {
-      errorMessage = (manifest as {message: string}).message;
-    }
-    throw new Error(errorMessage);
-  } catch (err) {
-    core.debug('Fetching the manifest via the API failed.');
-    if (err instanceof Error) {
-      core.debug(err.message);
-    }
-  }
-  return await getManifestFromURL();
-}
-
-function getManifestFromRepo(
-  auth: string | undefined
-): Promise<tc.IToolRelease[]> {
-  core.debug(
-    `Getting manifest from ${MANIFEST_REPO_OWNER}/${MANIFEST_REPO_NAME}@${MANIFEST_REPO_BRANCH}`
-  );
-  return tc.getManifestFromRepo(
-    MANIFEST_REPO_OWNER,
-    MANIFEST_REPO_NAME,
-    auth,
-    MANIFEST_REPO_BRANCH
-  );
-}
-
-async function getManifestFromURL(): Promise<tc.IToolRelease[]> {
-  core.debug('Falling back to fetching the manifest using raw URL.');
-
-  const http: httpm.HttpClient = new httpm.HttpClient('tool-cache');
-  const response = await http.getJson<tc.IToolRelease[]>(MANIFEST_URL);
-  if (!response.result) {
-    throw new Error(`Unable to get manifest from ${MANIFEST_URL}`);
-  }
-  return response.result;
+export async function getManifest(auth: string | undefined) {
+  return tc.getManifestFromRepo('actions', 'go-versions', auth, 'main');
 }
 
 export async function getInfoFromManifest(
   versionSpec: string,
   stable: boolean,
   auth: string | undefined,
-  arch: Architecture = os.arch() as Architecture,
+  arch = os.arch(),
   manifest?: tc.IToolRelease[] | undefined
 ): Promise<IGoVersionInfo | null> {
   let info: IGoVersionInfo | null = null;
@@ -384,14 +243,14 @@ export async function getInfoFromManifest(
 
 async function getInfoFromDist(
   versionSpec: string,
-  arch: Architecture
+  arch: string
 ): Promise<IGoVersionInfo | null> {
   const version: IGoVersion | undefined = await findMatch(versionSpec, arch);
   if (!version) {
     return null;
   }
 
-  const downloadUrl = `https://go.dev/dl/${version.files[0].filename}`;
+  const downloadUrl = `https://storage.googleapis.com/golang/${version.files[0].filename}`;
 
   return <IGoVersionInfo>{
     type: 'dist',
@@ -403,7 +262,7 @@ async function getInfoFromDist(
 
 export async function findMatch(
   versionSpec: string,
-  arch: Architecture = os.arch() as Architecture
+  arch = os.arch()
 ): Promise<IGoVersion | undefined> {
   const archFilter = sys.getArch(arch);
   const platFilter = sys.getPlatform();
@@ -411,8 +270,9 @@ export async function findMatch(
   let result: IGoVersion | undefined;
   let match: IGoVersion | undefined;
 
+  const dlUrl = 'https://golang.org/dl/?mode=json&include=all';
   const candidates: IGoVersion[] | null = await module.exports.getVersionsDist(
-    GOLANG_DOWNLOAD_URL
+    dlUrl
   );
   if (!candidates) {
     throw new Error(`golang download url did not return results`);
@@ -499,37 +359,19 @@ export function parseGoVersionFile(versionFilePath: string): string {
     path.basename(versionFilePath) === 'go.mod' ||
     path.basename(versionFilePath) === 'go.work'
   ) {
-    // for backwards compatibility: use version from go directive if
-    // 'GOTOOLCHAIN' has been explicitly set
-    if (process.env[GOTOOLCHAIN_ENV_VAR] !== GOTOOLCHAIN_LOCAL_VAL) {
-      // toolchain directive: https://go.dev/ref/mod#go-mod-file-toolchain
-      const matchToolchain = contents.match(
-        /^toolchain go(1\.\d+(?:\.\d+|rc\d+)?)/m
-      );
-      if (matchToolchain) {
-        return matchToolchain[1];
-      }
-    }
-
-    // go directive: https://go.dev/ref/mod#go-mod-file-go
-    const matchGo = contents.match(/^go (\d+(\.\d+)*)/m);
-    return matchGo ? matchGo[1] : '';
-  } else if (path.basename(versionFilePath) === '.tool-versions') {
-    const match = contents.match(/^golang\s+([^\n#]+)/m);
-    return match ? match[1].trim() : '';
+    const match = contents.match(/^go (\d+(\.\d+)*)/m);
+    return match ? match[1] : '';
   }
 
   return contents.trim();
 }
 
-async function resolveStableVersionDist(
-  versionSpec: string,
-  arch: Architecture
-) {
+async function resolveStableVersionDist(versionSpec: string, arch: string) {
   const archFilter = sys.getArch(arch);
   const platFilter = sys.getPlatform();
+  const dlUrl = 'https://golang.org/dl/?mode=json&include=all';
   const candidates: IGoVersion[] | null = await module.exports.getVersionsDist(
-    GOLANG_DOWNLOAD_URL
+    dlUrl
   );
   if (!candidates) {
     throw new Error(`golang download url did not return results`);

src/main.ts

@@ -8,7 +8,6 @@ import {isCacheFeatureAvailable} from './cache-utils';
 import cp from 'child_process';
 import fs from 'fs';
 import os from 'os';
-import {Architecture} from './types';
 
 export async function run() {
   try {
@@ -17,15 +16,14 @@ export async function run() {
     // If not supplied then problem matchers will still be setup.  Useful for self-hosted.
     //
     const versionSpec = resolveVersionInput();
-    setGoToolchain();
 
     const cache = core.getBooleanInput('cache');
     core.info(`Setup go version spec ${versionSpec}`);
 
-    let arch = core.getInput('architecture') as Architecture;
+    let arch = core.getInput('architecture');
 
     if (!arch) {
-      arch = os.arch() as Architecture;
+      arch = os.arch();
     }
 
     if (versionSpec) {
@@ -76,7 +74,7 @@ export async function run() {
           cacheDependencyPath
         );
       } catch (error) {
-        core.warning(`Restore cache failed: ${(error as Error).message}`);
+        core.warning(`Restore cache failed: ${error.message}`);
       }
     }
 
@@ -94,7 +92,7 @@ export async function run() {
     core.info(goEnv);
     core.endGroup();
   } catch (error) {
-    core.setFailed((error as Error).message);
+    core.setFailed(error.message);
   }
 }
 
@@ -162,20 +160,3 @@ function resolveVersionInput(): string {
 
   return version;
 }
-
-function setGoToolchain() {
-  // docs: https://go.dev/doc/toolchain
-  // "local indicates the bundled Go toolchain (the one that shipped with the go command being run)"
-  // this is so any 'go' command is run with the selected Go version
-  // and doesn't trigger a toolchain download and run commands with that
-  // see e.g. issue #424
-  // and a similar discussion: https://github.com/docker-library/golang/issues/472.
-  // Set the value in process env so any `go` commands run as child-process
-  // don't cause toolchain downloads
-  process.env[installer.GOTOOLCHAIN_ENV_VAR] = installer.GOTOOLCHAIN_LOCAL_VAL;
-  // and in the runner env so e.g. a user running `go mod tidy` won't cause it
-  core.exportVariable(
-    installer.GOTOOLCHAIN_ENV_VAR,
-    installer.GOTOOLCHAIN_LOCAL_VAL
-  );
-}

src/package-managers.ts

@@ -9,7 +9,7 @@ export interface PackageManagerInfo {
 
 export const supportedPackageManagers: SupportedPackageManagers = {
   default: {
-    dependencyFilePattern: 'go.mod',
+    dependencyFilePattern: 'go.sum',
     cacheFolderCommandList: ['go env GOMODCACHE', 'go env GOCACHE']
   }
 };

src/system.ts

@@ -1,5 +1,4 @@
 import os from 'os';
-import {Architecture} from './types';
 
 export function getPlatform(): string {
   // darwin and linux match already
@@ -16,7 +15,7 @@ export function getPlatform(): string {
   return plat;
 }
 
-export function getArch(arch: Architecture): string {
+export function getArch(arch: string): string {
   // 'arm', 'arm64', 'ia32', 'mips', 'mipsel', 'ppc', 'ppc64', 's390', 's390x', 'x32', and 'x64'.
 
   // wants amd64, 386, arm64, armv61, ppc641e, s390x