Test macos-14-large x64 runner

Update e2e-cache.yml (test-macos-x64-runner)
Update e2e-cache-freethreaded.yml(test-macos-x64-runner)
2025-08-17 11:04:37 +07:00 · 2025-07-29 15:21:15 +05:30 · 2025-07-29 14:28:44 +05:30 · 2025-07-29 14:22:59 +05:30 · 2025-07-24 11:52:05 +05:30 · 2025-07-23 13:32:04 -05:00
14 changed files with 358 additions and 354 deletions
--- a/.github/workflows/e2e-cache-freethreaded.yml
+++ b/.github/workflows/e2e-cache-freethreaded.yml
@ -6,7 +6,7 @@ on:
      - '**.md'
  push:
    branches:
-      - main
+      - test-macos-x64-runner
      - releases/*
    paths-ignore:
      - '**.md'
@ -23,13 +23,7 @@ jobs:
      matrix:
        os:
          [
-            ubuntu-latest,
-            ubuntu-22.04,
-            ubuntu-24.04-arm,
-            ubuntu-22.04-arm,
-            windows-latest,
-            macos-latest,
-            macos-13
+            macos-14-large
          ]
        python-version: [3.13.0t, 3.13.1t, 3.13.2t]
    steps:
@ -50,15 +44,9 @@ jobs:
      matrix:
        os:
          [
-            ubuntu-latest,
-            ubuntu-24.04-arm,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            windows-latest,
-            macos-latest,
-            macos-13
+            macos-14-large
          ]
-        python-version: [3.13.0t, 3.13.1t, 3.13.2t]
+        python-version: [3.13.1t, 3.13.2t, 3.13.5t]
    steps:
      - uses: actions/checkout@v4
      - name: Setup Python
@ -80,13 +68,7 @@ jobs:
      matrix:
        os:
          [
-            ubuntu-latest,
-            ubuntu-22.04,
-            ubuntu-24.04-arm,
-            ubuntu-22.04-arm,
-            windows-latest,
-            macos-latest,
-            macos-13
+            macos-14-large
          ]
        python-version: [3.13.0, 3.13.1, 3.13.2]
    steps:
@ -112,13 +94,7 @@ jobs:
      matrix:
        os:
          [
-            ubuntu-latest,
-            ubuntu-22.04,
-            ubuntu-24.04-arm,
-            ubuntu-22.04-arm,
-            windows-latest,
-            macos-latest,
-            macos-13
+            macos-14-large
          ]
        python-version: [3.13.0t, 3.13.1t, 3.13.2t]
    steps:
@ -140,15 +116,9 @@ jobs:
      matrix:
        os:
          [
-            ubuntu-latest,
-            ubuntu-22.04,
-            ubuntu-24.04-arm,
-            ubuntu-22.04-arm,
-            windows-latest,
-            macos-latest,
-            macos-13
+            macos-14-large
          ]
-        python-version: [3.13.0t, 3.13.1t, 3.13.2t]
+        python-version: [3.13.1t, 3.13.2t, 3.13.5t]
    steps:
      - uses: actions/checkout@v4
      - name: Setup Python
@ -171,13 +141,7 @@ jobs:
      matrix:
        os:
          [
-            ubuntu-latest,
-            ubuntu-22.04,
-            ubuntu-24.04-arm,
-            ubuntu-22.04-arm,
-            windows-latest,
-            macos-latest,
-            macos-13
+            macos-14-large
          ]
        python-version: [3.13.0t, 3.13.1t, 3.13.2t]
    steps:
@ -199,13 +163,7 @@ jobs:
      matrix:
        os:
          [
-            ubuntu-latest,
-            ubuntu-22.04,
-            ubuntu-24.04-arm,
-            ubuntu-22.04-arm,
-            windows-latest,
-            macos-latest,
-            macos-13
+            macos-14-large
          ]
        python-version: [3.13.0t, 3.13.1t, 3.13.2t]
    steps:
--- a/.github/workflows/e2e-cache.yml
+++ b/.github/workflows/e2e-cache.yml
@ -6,7 +6,7 @@ on:
      - '**.md'
  push:
    branches:
-      - main
+      - test-macos-x64-runner
      - releases/*
    paths-ignore:
      - '**.md'
@ -23,13 +23,7 @@ jobs:
      matrix:
        os:
          [
-            ubuntu-latest,
-            ubuntu-24.04-arm,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            windows-latest,
-            macos-latest,
-            macos-13
+            macos-14-large
          ]
        python-version:
          [
@ -63,13 +57,7 @@ jobs:
      matrix:
        os:
          [
-            ubuntu-latest,
-            ubuntu-24.04-arm,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            windows-latest,
-            macos-latest,
-            macos-13
+            macos-14-large
          ]
        python-version:
          ['3.10', 'pypy-3.10-v7.x', '3.11', 'pypy-3.11-v7.x', '3.12', '3.13']
@ -120,13 +108,7 @@ jobs:
      matrix:
        os:
          [
-            ubuntu-latest,
-            ubuntu-24.04-arm,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            windows-latest,
-            macos-latest,
-            macos-13
+            macos-14-large
          ]
        python-version:
          [
@ -161,13 +143,7 @@ jobs:
      matrix:
        os:
          [
-            ubuntu-latest,
-            ubuntu-24.04-arm,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            windows-latest,
-            macos-latest,
-            macos-13
+            macos-14-large
          ]
        python-version:
          [
@ -202,13 +178,7 @@ jobs:
      matrix:
        os:
          [
-            ubuntu-latest,
-            ubuntu-24.04-arm,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            windows-latest,
-            macos-latest,
-            macos-13
+            macos-14-large
          ]
        python-version:
          ['3.10', 'pypy-3.10-v7.x', '3.11', 'pypy-3.11-v7.x', '3.12', '3.13']
@ -258,13 +228,7 @@ jobs:
      matrix:
        os:
          [
-            ubuntu-latest,
-            ubuntu-24.04-arm,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            windows-latest,
-            macos-latest,
-            macos-13
+            macos-14-large
          ]
        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
    steps:
@ -286,13 +250,7 @@ jobs:
      matrix:
        os:
          [
-            ubuntu-latest,
-            ubuntu-24.04-arm,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            windows-latest,
-            macos-latest,
-            macos-13
+            macos-14-large
          ]
        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
    steps:
--- a/.github/workflows/e2e-tests.yml
+++ b/.github/workflows/e2e-tests.yml
@ -3,7 +3,7 @@ name: e2e tests
 on:
  push:
    branches:
-      - main
+      - test-macos-x64-runner
    paths-ignore:
      - '**.md'
  pull_request:
@ -19,13 +19,7 @@ jobs:
      matrix:
        operating-system:
          [
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            ubuntu-latest,
-            ubuntu-24.04-arm,
-            macos-latest,
-            macos-13
+            macos-14-large
          ]
    steps:
      - name: Checkout
@ -38,7 +32,7 @@ jobs:
      - name: Verify 3.9.13
        run: python __tests__/verify-python.py 3.9.13

-      - name: Run with setup-python 3.9.13
+      - name: Run with setup-python 3.10.11
        uses: ./
        with:
          python-version: 3.10.11
@ -89,6 +83,7 @@ jobs:
          python-version: '<3.13'
      - name: Verify <3.13
        run: python __tests__/verify-python.py 3.12
+
      - name: Test Raw Endpoint Access
        run: |
          curl -L https://raw.githubusercontent.com/actions/python-versions/main/versions-manifest.json | jq empty
--- a/.github/workflows/test-graalpy.yml
+++ b/.github/workflows/test-graalpy.yml
@ -3,7 +3,7 @@ name: Validate GraalPy e2e
 on:
  push:
    branches:
-      - main
+      - test-macos-x64-runner
    paths-ignore:
      - '**.md'
  pull_request:
@ -20,12 +20,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            ubuntu-24.04-arm,
-            ubuntu-latest,
-            macos-13
+            macos-14-large
          ]
        graalpy:
          - 'graalpy-22.3'
@ -75,12 +70,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            ubuntu-24.04-arm,
-            ubuntu-latest,
-            macos-13
+            macos-14-large
          ]
        graalpy: ['graalpy22.3', 'graalpy23.0', 'graalpy23.1', 'graalpy24.1']

@ -106,7 +96,7 @@ jobs:
    strategy:
      fail-fast: false
      matrix:
-        os: [ubuntu-latest, macos-latest, macos-13]
+        os: [macos-14-large]
    steps:
      - uses: actions/checkout@v4
      - name: Setup GraalPy and check latest
--- a/.github/workflows/test-pypy.yml
+++ b/.github/workflows/test-pypy.yml
@ -3,7 +3,7 @@ name: Validate PyPy e2e
 on:
  push:
    branches:
-      - main
+      - test-macos-x64-runner
    paths-ignore:
      - '**.md'
  pull_request:
@ -22,13 +22,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            ubuntu-24.04-arm,
-            ubuntu-latest,
-            macos-13
+            macos-14-large
          ]
        pypy:
          - 'pypy-2.7'
@ -85,16 +79,7 @@ jobs:
      fail-fast: false
      matrix:
        os:
-          - macos-13
-          - macos-14
-          - macos-15
-          - windows-2019
-          - windows-2022
-          - windows-2025
-          - ubuntu-22.04
-          - ubuntu-24.04
-          - ubuntu-22.04-arm
-          - ubuntu-24.04-arm
+          - macos-14-large
        pypy: ['pypy-2.7', 'pypy-3.10', 'pypy-3.11']

    steps:
@ -139,13 +124,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            ubuntu-24.04-arm,
-            ubuntu-latest,
-            macos-13
+            macos-14-large
          ]
        pypy: ['pypy2.7', 'pypy3.9', 'pypy3.10-nightly', 'pypy3.11']

@ -173,13 +152,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            ubuntu-24.04-arm,
-            ubuntu-latest,
-            macos-13
+            macos-14-large
          ]
    steps:
      - uses: actions/checkout@v4
@ -215,13 +188,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            ubuntu-24.04-arm,
-            ubuntu-latest,
-            macos-13
+            macos-14-large
          ]
    steps:
      - uses: actions/checkout@v4
--- a/.github/workflows/test-python-freethreaded.yml
+++ b/.github/workflows/test-python-freethreaded.yml
@ -3,7 +3,7 @@ name: Validate Python e2e freethread
 on:
  push:
    branches:
-      - main
+      - test-macos-x64-runner
    paths-ignore:
      - '**.md'
  pull_request:
@ -22,13 +22,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            macos-13,
-            ubuntu-latest,
-            ubuntu-24.04-arm
+            macos-14-large
          ]
        python: [3.13.0t, 3.13.1t, 3.13.2t]
    steps:
@ -59,13 +53,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            macos-13,
-            ubuntu-latest,
-            ubuntu-24.04-arm
+            macos-14-large
          ]
        python: [3.13.0t, 3.13.1t, 3.13.2t]
    steps:
@ -99,13 +87,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            macos-13,
-            ubuntu-latest,
-            ubuntu-24.04-arm
+            macos-14-large
          ]
        python: [3.13.0t, 3.13.1t, 3.13.2t]
    steps:
@ -137,13 +119,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            macos-13,
-            ubuntu-latest,
-            ubuntu-24.04-arm
+            macos-14-large
          ]
        python: [3.13.0, 3.13.1, 3.13.2]
    steps:
@ -178,13 +154,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            macos-13,
-            ubuntu-latest,
-            ubuntu-24.04-arm
+            macos-14-large
          ]
        python: [3.13.0, 3.13.1, 3.13.2]
    steps:
@ -219,13 +189,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            macos-13,
-            ubuntu-latest,
-            ubuntu-24.04-arm
+            macos-14-large
          ]
        python: [3.13.0t, 3.13.1t, 3.13.2t, 3.14t-dev]
    steps:
@ -250,13 +214,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            macos-13,
-            ubuntu-latest,
-            ubuntu-24.04-arm
+            macos-14-large
          ]
    steps:
      - name: Checkout
@ -287,13 +245,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            ubuntu-24.04-arm,
-            ubuntu-latest,
-            macos-13
+            macos-14-large
          ]
    steps:
      - name: Checkout
@ -324,13 +276,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            ubuntu-24.04-arm,
-            ubuntu-latest,
-            macos-13
+            macos-14-large
          ]
    steps:
      - name: Checkout
@ -362,13 +308,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            macos-13,
-            ubuntu-latest,
-            ubuntu-24.04-arm
+            macos-14-large
          ]
        python: [3.13.0t, 3.13.1t, 3.13.2t]
    steps:
@ -395,13 +335,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            ubuntu-24.04-arm,
-            ubuntu-latest,
-            macos-13
+            macos-14-large
          ]
        python-version: [3.13t, 3.14t-dev]
    steps:
@ -422,13 +356,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            ubuntu-24.04-arm,
-            ubuntu-latest,
-            macos-13
+            macos-14-large
          ]
    steps:
      - uses: actions/checkout@v4
@ -451,13 +379,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            macos-13,
-            ubuntu-latest,
-            ubuntu-24.04-arm
+            macos-14-large
          ]
        python: [3.13.1, 3.13.2, 3.14-dev, 3.14.0-alpha.6]
    steps:
--- a/.github/workflows/test-python.yml
+++ b/.github/workflows/test-python.yml
@ -3,7 +3,7 @@ name: Validate Python e2e
 on:
  push:
    branches:
-      - main
+      - test-macos-x64-runner
    paths-ignore:
      - '**.md'
  pull_request:
@ -22,13 +22,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            macos-13,
-            ubuntu-latest,
-            ubuntu-24.04-arm
+            macos-14-large
          ]
        python: [3.9.13, 3.10.11, 3.11.9, 3.12.3, 3.13.2]
    steps:
@ -66,13 +60,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            macos-13,
-            ubuntu-latest,
-            ubuntu-24.04-arm
+            macos-14-large
          ]
        python: [3.9.13, 3.10.11, 3.11.9, 3.12.3, 3.13.2]
    steps:
@ -113,13 +101,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            macos-13,
-            ubuntu-latest,
-            ubuntu-24.04-arm
+            macos-14-large
          ]
        python: [3.9.13, 3.10.11, 3.11.9, 3.12.3, 3.13.2]
    steps:
@ -158,13 +140,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            macos-13,
-            ubuntu-latest,
-            ubuntu-24.04-arm
+            macos-14-large
          ]
        python: [3.9.13, 3.10.11, 3.11.9, '==3.12.3', 3.13.2]
    steps:
@ -208,13 +184,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            macos-13,
-            ubuntu-latest,
-            ubuntu-24.04-arm
+            macos-14-large
          ]
        python: [3.9.13, 3.10.11, 3.11.9, 3.12.3, 3.13.2]
    steps:
@ -258,13 +228,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            macos-13,
-            ubuntu-latest,
-            ubuntu-24.04-arm
+            macos-14-large
          ]
        python: [pypy3.11-7.3.18, graalpy-24.1.2, 3.13.2, 3.14-dev]
        exclude:
@ -292,13 +256,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            macos-13,
-            ubuntu-latest,
-            ubuntu-24.04-arm
+            macos-14-large
          ]
    steps:
      - name: Checkout
@ -335,13 +293,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            ubuntu-24.04-arm,
-            ubuntu-latest,
-            macos-13
+            macos-14-large
          ]
    steps:
      - name: Checkout
@ -372,13 +324,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            ubuntu-24.04-arm,
-            ubuntu-latest,
-            macos-13
+            macos-14-large
          ]
    steps:
      - name: Checkout
@ -410,13 +356,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            macos-13,
-            ubuntu-latest,
-            ubuntu-24.04-arm
+            macos-14-large
          ]
        python: ['3.9', '3.10', '3.11', '3.12', '3.13']
    steps:
@ -443,13 +383,7 @@ jobs:
      matrix:
        os:
          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            ubuntu-24.04-arm,
-            ubuntu-latest,
-            macos-13
+            macos-14-large
          ]
        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
    steps:
@ -475,14 +409,8 @@ jobs:
      fail-fast: false
      matrix:
        os:
-          [
-            macos-latest,
-            windows-latest,
-            ubuntu-22.04,
-            ubuntu-22.04-arm,
-            ubuntu-24.04-arm,
-            ubuntu-latest,
-            macos-13
+         [
+            macos-14-large
          ]
    steps:
      - uses: actions/checkout@v4
--- a/README.md
+++ b/README.md
@ -94,6 +94,8 @@ steps:

 >The requirements file format allows for specifying dependency versions using logical operators (for example chardet>=3.0.4) or specifying dependencies without any versions. In this case the pip install -r requirements.txt command will always try to install the latest available package version. To be sure that the cache will be used, please stick to a specific dependency version and update it manually if necessary.

+>The `setup-python` action does not handle authentication for pip when installing packages from private repositories. For help, refer [pip’s VCS support documentation](https://pip.pypa.io/en/stable/topics/vcs-support/) or visit the [pip repository](https://github.com/pypa/pip).
+
 See examples of using `cache` and `cache-dependency-path` for `pipenv` and `poetry` in the section: [Caching packages](docs/advanced-usage.md#caching-packages) of the [Advanced usage](docs/advanced-usage.md) guide.

 ## Advanced usage
--- a/tests/setup-python.test.ts
+++ b/tests/setup-python.test.ts
@ -0,0 +1,149 @@
+import * as core from '@actions/core';
+import * as fs from 'fs';
+import * as path from 'path';
+import {cacheDependencies} from '../src/setup-python';
+import {getCacheDistributor} from '../src/cache-distributions/cache-factory';
+
+jest.mock('fs', () => {
+  const actualFs = jest.requireActual('fs');
+  return {
+    ...actualFs,
+    promises: {
+      access: jest.fn(),
+      mkdir: jest.fn(),
+      copyFile: jest.fn(),
+      writeFile: jest.fn(),
+      appendFile: jest.fn()
+    }
+  };
+});
+jest.mock('@actions/core');
+jest.mock('../src/cache-distributions/cache-factory');
+
+const mockedFsPromises = fs.promises as jest.Mocked<typeof fs.promises>;
+const mockedCore = core as jest.Mocked<typeof core>;
+const mockedGetCacheDistributor = getCacheDistributor as jest.Mock;
+
+describe('cacheDependencies', () => {
+  const mockRestoreCache = jest.fn();
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+    process.env.GITHUB_ACTION_PATH = '/github/action';
+    process.env.GITHUB_WORKSPACE = '/github/workspace';
+
+    mockedCore.getInput.mockReturnValue('nested/deps.lock');
+
+    // Simulate file exists by resolving access without error
+    mockedFsPromises.access.mockImplementation(async p => {
+      const pathStr = typeof p === 'string' ? p : p.toString();
+      if (pathStr === '/github/action/nested/deps.lock') {
+        return Promise.resolve();
+      }
+      // Simulate directory doesn't exist to test mkdir
+      if (pathStr === path.dirname('/github/workspace/nested/deps.lock')) {
+        return Promise.reject(new Error('no dir'));
+      }
+      return Promise.resolve();
+    });
+
+    // Simulate mkdir success
+    mockedFsPromises.mkdir.mockResolvedValue(undefined);
+
+    // Simulate copyFile success
+    mockedFsPromises.copyFile.mockResolvedValue(undefined);
+
+    mockedGetCacheDistributor.mockReturnValue({restoreCache: mockRestoreCache});
+  });
+
+  it('copies the dependency file and resolves the path with directory structure', async () => {
+    await cacheDependencies('pip', '3.12');
+
+    const sourcePath = path.resolve('/github/action', 'nested/deps.lock');
+    const targetPath = path.resolve('/github/workspace', 'nested/deps.lock');
+
+    expect(mockedFsPromises.access).toHaveBeenCalledWith(
+      sourcePath,
+      fs.constants.F_OK
+    );
+    expect(mockedFsPromises.mkdir).toHaveBeenCalledWith(
+      path.dirname(targetPath),
+      {
+        recursive: true
+      }
+    );
+    expect(mockedFsPromises.copyFile).toHaveBeenCalledWith(
+      sourcePath,
+      targetPath
+    );
+    expect(mockedCore.info).toHaveBeenCalledWith(
+      `Copied ${sourcePath} to ${targetPath}`
+    );
+    expect(mockedCore.info).toHaveBeenCalledWith(
+      `Resolved cache-dependency-path: nested/deps.lock`
+    );
+    expect(mockRestoreCache).toHaveBeenCalled();
+  });
+
+  it('warns if the dependency file does not exist', async () => {
+    // Simulate file does not exist by rejecting access
+    mockedFsPromises.access.mockRejectedValue(new Error('file not found'));
+
+    await cacheDependencies('pip', '3.12');
+
+    expect(mockedCore.warning).toHaveBeenCalledWith(
+      expect.stringContaining('does not exist')
+    );
+    expect(mockedFsPromises.copyFile).not.toHaveBeenCalled();
+    expect(mockRestoreCache).toHaveBeenCalled();
+  });
+
+  it('warns if file copy fails', async () => {
+    // Simulate copyFile failure
+    mockedFsPromises.copyFile.mockRejectedValue(new Error('copy failed'));
+
+    await cacheDependencies('pip', '3.12');
+
+    expect(mockedCore.warning).toHaveBeenCalledWith(
+      expect.stringContaining('Failed to copy file')
+    );
+    expect(mockRestoreCache).toHaveBeenCalled();
+  });
+
+  it('skips path logic if no input is provided', async () => {
+    mockedCore.getInput.mockReturnValue('');
+
+    await cacheDependencies('pip', '3.12');
+
+    expect(mockedFsPromises.copyFile).not.toHaveBeenCalled();
+    expect(mockedCore.warning).not.toHaveBeenCalled();
+    expect(mockRestoreCache).toHaveBeenCalled();
+  });
+
+  it('does not copy if dependency file is already inside the workspace but still sets resolved path', async () => {
+    // Simulate cacheDependencyPath inside workspace
+    mockedCore.getInput.mockReturnValue('deps.lock');
+
+    // Override sourcePath and targetPath to be equal
+    const actionPath = '/github/workspace'; // same path for action and workspace
+    process.env.GITHUB_ACTION_PATH = actionPath;
+    process.env.GITHUB_WORKSPACE = actionPath;
+
+    // access resolves to simulate file exists
+    mockedFsPromises.access.mockResolvedValue();
+
+    await cacheDependencies('pip', '3.12');
+
+    const sourcePath = path.resolve(actionPath, 'deps.lock');
+    const targetPath = sourcePath; // same path
+
+    expect(mockedFsPromises.copyFile).not.toHaveBeenCalled();
+    expect(mockedCore.info).toHaveBeenCalledWith(
+      `Dependency file is already inside the workspace: ${sourcePath}`
+    );
+    expect(mockedCore.info).toHaveBeenCalledWith(
+      `Resolved cache-dependency-path: deps.lock`
+    );
+    expect(mockRestoreCache).toHaveBeenCalled();
+  });
+});
--- a/dist/setup/index.js
+++ b/dist/setup/index.js
@ -95875,7 +95875,7 @@ function findPyPyVersion(versionSpec, architecture, updateEnvironment, checkLate
            core.addPath(pythonLocation);
            core.addPath(_binDir);
        }
-        core.setOutput('python-version', 'pypy' + resolvedPyPyVersion);
+        core.setOutput('python-version', `pypy${resolvedPythonVersion}-${resolvedPyPyVersion}`);
        core.setOutput('python-path', pythonPath);
        return { resolvedPyPyVersion, resolvedPythonVersion };
    });
@ -96103,11 +96103,32 @@ function useCpythonVersion(version, architecture, updateEnvironment, checkLatest
            if (utils_1.IS_WINDOWS) {
                // Add --user directory
                // `installDir` from tool cache should look like $RUNNER_TOOL_CACHE/Python/<semantic version>/x64/
-                // So if `findLocalTool` succeeded above, we must have a conformant `installDir`
+                // Extract version details
                const version = path.basename(path.dirname(installDir));
                const major = semver.major(version);
                const minor = semver.minor(version);
-                const userScriptsDir = path.join(process.env['APPDATA'] || '', 'Python', `Python${major}${minor}`, 'Scripts');
+                const basePath = process.env['APPDATA'] || '';
+                let versionSuffix = `${major}${minor}`;
+                // Append '-32' for x86 architecture if Python version is >= 3.10
+                if (architecture === 'x86' &&
+                    (major > 3 || (major === 3 && minor >= 10))) {
+                    versionSuffix += '-32';
+                }
+                else if (architecture === 'arm64') {
+                    versionSuffix += '-arm64';
+                }
+                // Append 't' for freethreaded builds
+                if (freethreaded) {
+                    versionSuffix += 't';
+                    if (architecture === 'x86-freethreaded') {
+                        versionSuffix += '-32';
+                    }
+                    else if (architecture === 'arm64-freethreaded') {
+                        versionSuffix += '-arm64';
+                    }
+                }
+                // Add user Scripts path
+                const userScriptsDir = path.join(basePath, 'Python', `Python${versionSuffix}`, 'Scripts');
                core.addPath(userScriptsDir);
            }
            // On Linux and macOS, pip will create the --user directory and add it to PATH as needed.
@ -96844,6 +96865,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
    return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.cacheDependencies = void 0;
 const core = __importStar(__nccwpck_require__(7484));
 const finder = __importStar(__nccwpck_require__(6843));
 const finderPyPy = __importStar(__nccwpck_require__(2625));
@ -96862,10 +96884,50 @@ function isGraalPyVersion(versionSpec) {
 function cacheDependencies(cache, pythonVersion) {
    return __awaiter(this, void 0, void 0, function* () {
        const cacheDependencyPath = core.getInput('cache-dependency-path') || undefined;
-        const cacheDistributor = (0, cache_factory_1.getCacheDistributor)(cache, pythonVersion, cacheDependencyPath);
+        let resolvedDependencyPath = undefined;
+        if (cacheDependencyPath) {
+            const actionPath = process.env.GITHUB_ACTION_PATH || '';
+            const workspace = process.env.GITHUB_WORKSPACE || process.cwd();
+            const sourcePath = path.resolve(actionPath, cacheDependencyPath);
+            const relativePath = path.relative(actionPath, sourcePath);
+            const targetPath = path.resolve(workspace, relativePath);
+            try {
+                const sourceExists = yield fs_1.default.promises
+                    .access(sourcePath, fs_1.default.constants.F_OK)
+                    .then(() => true)
+                    .catch(() => false);
+                if (!sourceExists) {
+                    core.warning(`The resolved cache-dependency-path does not exist: ${sourcePath}`);
+                }
+                else {
+                    if (sourcePath !== targetPath) {
+                        const targetDir = path.dirname(targetPath);
+                        // Create target directory if it doesn't exist
+                        yield fs_1.default.promises.mkdir(targetDir, { recursive: true });
+                        // Copy file asynchronously
+                        yield fs_1.default.promises.copyFile(sourcePath, targetPath);
+                        core.info(`Copied ${sourcePath} to ${targetPath}`);
+                    }
+                    else {
+                        core.info(`Dependency file is already inside the workspace: ${sourcePath}`);
+                    }
+                    resolvedDependencyPath = path
+                        .relative(workspace, targetPath)
+                        .replace(/\\/g, '/');
+                    core.info(`Resolved cache-dependency-path: ${resolvedDependencyPath}`);
+                }
+            }
+            catch (error) {
+                core.warning(`Failed to copy file from ${sourcePath} to ${targetPath}: ${error}`);
+            }
+        }
+        // Pass resolvedDependencyPath if available, else fallback to original input
+        const dependencyPathForCache = resolvedDependencyPath !== null && resolvedDependencyPath !== void 0 ? resolvedDependencyPath : cacheDependencyPath;
+        const cacheDistributor = (0, cache_factory_1.getCacheDistributor)(cache, pythonVersion, dependencyPathForCache);
        yield cacheDistributor.restoreCache();
    });
 }
+exports.cacheDependencies = cacheDependencies;
 function resolveVersionInputFromDefaultFile() {
    const couples = [
        ['.python-version', utils_1.getVersionsInputFromPlainFile]
--- a/docs/advanced-usage.md
+++ b/docs/advanced-usage.md
@ -412,7 +412,7 @@ steps:
 - run: pip install -e .
  # Or pip install -e '.[test]' to install test dependencies
 ```
-
+Note: cache-dependency-path supports files located outside the workspace root by copying them into the workspace to enable proper caching.
 # Outputs and environment variables

 ## Outputs
--- a/src/find-pypy.ts
+++ b/src/find-pypy.ts
@ -96,7 +96,10 @@ export async function findPyPyVersion(
    core.addPath(pythonLocation);
    core.addPath(_binDir);
  }
-  core.setOutput('python-version', 'pypy' + resolvedPyPyVersion);
+  core.setOutput(
+    'python-version',
+    `pypy${resolvedPythonVersion}-${resolvedPyPyVersion}`
+  );
  core.setOutput('python-path', pythonPath);

  return {resolvedPyPyVersion, resolvedPythonVersion};
--- a/src/find-python.ts
+++ b/src/find-python.ts
@ -71,8 +71,8 @@ export async function useCpythonVersion(
    // Use the freethreaded version if it was specified in the input, e.g., 3.13t
    freethreaded = true;
  }
-  core.debug(`Semantic version spec of ${version} is ${semanticVersionSpec}`);

+  core.debug(`Semantic version spec of ${version} is ${semanticVersionSpec}`);
  if (freethreaded) {
    // Free threaded versions use an architecture suffix like `x64-freethreaded`
    core.debug(`Using freethreaded version of ${semanticVersionSpec}`);
@ -176,15 +176,36 @@ export async function useCpythonVersion(
    if (IS_WINDOWS) {
      // Add --user directory
      // `installDir` from tool cache should look like $RUNNER_TOOL_CACHE/Python/<semantic version>/x64/
-      // So if `findLocalTool` succeeded above, we must have a conformant `installDir`
+      // Extract version details
      const version = path.basename(path.dirname(installDir));
      const major = semver.major(version);
      const minor = semver.minor(version);

+      const basePath = process.env['APPDATA'] || '';
+      let versionSuffix = `${major}${minor}`;
+      // Append '-32' for x86 architecture if Python version is >= 3.10
+      if (
+        architecture === 'x86' &&
+        (major > 3 || (major === 3 && minor >= 10))
+      ) {
+        versionSuffix += '-32';
+      } else if (architecture === 'arm64') {
+        versionSuffix += '-arm64';
+      }
+      // Append 't' for freethreaded builds
+      if (freethreaded) {
+        versionSuffix += 't';
+        if (architecture === 'x86-freethreaded') {
+          versionSuffix += '-32';
+        } else if (architecture === 'arm64-freethreaded') {
+          versionSuffix += '-arm64';
+        }
+      }
+      // Add user Scripts path
      const userScriptsDir = path.join(
-        process.env['APPDATA'] || '',
+        basePath,
        'Python',
-        `Python${major}${minor}`,
+        `Python${versionSuffix}`,
        'Scripts'
      );
      core.addPath(userScriptsDir);
--- a/src/setup-python.ts
+++ b/src/setup-python.ts
@ -22,13 +22,62 @@ function isGraalPyVersion(versionSpec: string) {
  return versionSpec.startsWith('graalpy');
 }

-async function cacheDependencies(cache: string, pythonVersion: string) {
+export async function cacheDependencies(cache: string, pythonVersion: string) {
  const cacheDependencyPath =
    core.getInput('cache-dependency-path') || undefined;
+  let resolvedDependencyPath: string | undefined = undefined;
+
+  if (cacheDependencyPath) {
+    const actionPath = process.env.GITHUB_ACTION_PATH || '';
+    const workspace = process.env.GITHUB_WORKSPACE || process.cwd();
+
+    const sourcePath = path.resolve(actionPath, cacheDependencyPath);
+    const relativePath = path.relative(actionPath, sourcePath);
+    const targetPath = path.resolve(workspace, relativePath);
+
+    try {
+      const sourceExists = await fs.promises
+        .access(sourcePath, fs.constants.F_OK)
+        .then(() => true)
+        .catch(() => false);
+
+      if (!sourceExists) {
+        core.warning(
+          `The resolved cache-dependency-path does not exist: ${sourcePath}`
+        );
+      } else {
+        if (sourcePath !== targetPath) {
+          const targetDir = path.dirname(targetPath);
+          // Create target directory if it doesn't exist
+          await fs.promises.mkdir(targetDir, {recursive: true});
+          // Copy file asynchronously
+          await fs.promises.copyFile(sourcePath, targetPath);
+          core.info(`Copied ${sourcePath} to ${targetPath}`);
+        } else {
+          core.info(
+            `Dependency file is already inside the workspace: ${sourcePath}`
+          );
+        }
+
+        resolvedDependencyPath = path
+          .relative(workspace, targetPath)
+          .replace(/\\/g, '/');
+        core.info(`Resolved cache-dependency-path: ${resolvedDependencyPath}`);
+      }
+    } catch (error) {
+      core.warning(
+        `Failed to copy file from ${sourcePath} to ${targetPath}: ${error}`
+      );
+    }
+  }
+
+  // Pass resolvedDependencyPath if available, else fallback to original input
+  const dependencyPathForCache = resolvedDependencyPath ?? cacheDependencyPath;
+
  const cacheDistributor = getCacheDistributor(
    cache,
    pythonVersion,
-    cacheDependencyPath
+    dependencyPathForCache
  );
  await cacheDistributor.restoreCache();
 }
Author	SHA1	Message	Date
Priyagupta108	09262e015b	Test macos-14-large x64 runner	2025-07-29 15:21:15 +05:30
Priya Gupta	06417d4504	Update e2e-cache.yml (test-macos-x64-runner)	2025-07-29 14:28:44 +05:30
Priya Gupta	d1bb3a8c04	Update e2e-cache-freethreaded.yml(test-macos-x64-runner)	2025-07-29 14:22:59 +05:30
Priya Gupta	ade6528851	Test macos x64 runner	2025-07-24 11:52:05 +05:30
priya-kinthali	3c6f142cc0	update documentation (#1156 )	2025-07-23 13:32:04 -05:00
Marc Mueller	88ffd4d597	Include python version in PyPy python-version output (#1110 )	2025-07-21 14:01:05 -05:00
aparnajyothi-y	532b046aaf	Add Architecture-Specific PATH Management for Python with --user Flag on Windows (#1122 ) * logic to update install oath with --user flg * format update * format update * update * test job to validate --user flag installtion * updated the script * updated the yaml * update the inputs * updated script * update the correct script file name * updated script and yaml * npm run format-check * fix-test failures * path update * check failure fix * updated test * update free threaded version * updated the comments	2025-07-03 12:09:25 -05:00
aparnajyothi-y	1264885983	Enhance cache-dependency-path handling to support files outside the workspace root (#1128 ) * ehnace cache dependency path handling * logic update * npm run format-check * update cacheDependencies tests to cover resolved paths and copy edge cases * check failure fix * depricate-windows-2019 * refactored the code * Check failure fix	2025-06-24 23:40:44 -05:00