- name: Run Python Script

run: pipenv run python test-pipenv.py

python-pip-dependencies-caching-with-pip-version:

name: Test pip (Python ${{ matrix.python-version}}, ${{ matrix.os }})

runs-on: ${{ matrix.os }}

strategy:

fail-fast: false

matrix:

os:

[

ubuntu-latest,

ubuntu-24.04-arm,

ubuntu-22.04,

ubuntu-22.04-arm,

windows-latest,

macos-latest,

macos-13

]

python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']

steps:

- uses: actions/checkout@v4

- name: Setup Python

uses: ./

with:

python-version: ${{ matrix.python-version }}

cache: 'pip'

pip-version: '25.0.1'

- name: Install dependencies

run: pip install numpy pandas requests

python-pip-dependencies-caching-path-with-pip-version:

name: Test pip (Python ${{ matrix.python-version}}, ${{ matrix.os }}, caching path)

runs-on: ${{ matrix.os }}

strategy:

fail-fast: false

matrix:

os:

[

ubuntu-latest,

ubuntu-24.04-arm,

ubuntu-22.04,

ubuntu-22.04-arm,

windows-latest,

macos-latest,

macos-13

]

python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']

steps:

- uses: actions/checkout@v4

- name: Setup Python

uses: ./

with:

python-version: ${{ matrix.python-version }}

cache: 'pip'

cache-dependency-path: __tests__/data/requirements.txt

pip-version: '25.0.1'

- name: Install dependencies

run: pip install numpy pandas requests

- [Using `setup-python` with a self-hosted runner](docs/advanced-usage.md#using-setup-python-with-a-self-hosted-runner)

- [Using `setup-python` on GHES](docs/advanced-usage.md#using-setup-python-on-ghes)

- [Allow pre-releases](docs/advanced-usage.md#allow-pre-releases)

- [Using the pip-version input](docs/advanced-usage.md#using-the-pip-version-input)

freethreaded:

description: "When 'true', use the freethreaded version of Python."

default: false

pip-version:

description: "Used to specify the version of pip to install with the Python. Supported format: major[.minor][.patch]."

outputs:

python-version:

description: "The installed Python or PyPy version. Useful when given a version range as input."

const installer = __importStar(__nccwpck_require__(1919));

const core = __importStar(__nccwpck_require__(7484));

const tc = __importStar(__nccwpck_require__(3472));

const exec = __importStar(__nccwpck_require__(5236));

// Python has "scripts" or "bin" directories where command-line tools that come with packages are installed.

// This is where pip is, along with anything that pip installs.

// There is a separate directory for `pip install --user`.

return path.join(installDir, 'bin');

}

}

<<<<<<< HEAD

async function useCpythonVersion(version, architecture, updateEnvironment, checkLatest, allowPreReleases, freethreaded) {

let manifest = null;

const { version: desugaredVersionSpec, freethreaded: versionFreethreaded } = desugarVersion(version);

if (resolvedVersion) {

semanticVersionSpec = resolvedVersion;

core.info(`Resolved as '${semanticVersionSpec}'`);

=======

function installPip(pythonLocation) {

return __awaiter(this, void 0, void 0, function* () {

const pipVersion = core.getInput('pip-version');

// Validate pip-version format: major[.minor][.patch]

const versionRegex = /^\d+(\.\d+)?(\.\d+)?$/;

if (pipVersion && !versionRegex.test(pipVersion)) {

throw new Error(`Invalid pip-version "${pipVersion}". Please specify a version in the format major[.minor][.patch].`);

}

if (pipVersion) {

core.info(`pip-version input is specified. Installing pip version ${pipVersion}`);

yield exec.exec(`${pythonLocation}/python -m pip install --upgrade pip==${pipVersion} --disable-pip-version-check --no-warn-script-location`);

}

});

}

function useCpythonVersion(version, architecture, updateEnvironment, checkLatest, allowPreReleases, freethreaded) {

return __awaiter(this, void 0, void 0, function* () {

var _a;

let manifest = null;

const { version: desugaredVersionSpec, freethreaded: versionFreethreaded } = desugarVersion(version);

let semanticVersionSpec = pythonVersionToSemantic(desugaredVersionSpec, allowPreReleases);

if (versionFreethreaded) {

// Use the freethreaded version if it was specified in the input, e.g., 3.13t

freethreaded = true;

>>>>>>> e9c40fb (Add support for `pip-version` (#1129))

}

else {

core.info(`Failed to resolve version ${semanticVersionSpec} from manifest`);

const userScriptsDir = path.join(process.env['APPDATA'] || '', 'Python', `Python${major}${minor}`, 'Scripts');

core.addPath(userScriptsDir);

}

<<<<<<< HEAD

// On Linux and macOS, pip will create the --user directory and add it to PATH as needed.

}

const installed = versionFromPath(installDir);

core.setOutput('python-version', pythonVersion);

core.setOutput('python-path', pythonPath);

return { impl: 'CPython', version: pythonVersion };

=======

if (!installDir) {

const osInfo = yield (0, utils_1.getOSInfo)();

const msg = [

`The version '${version}' with architecture '${architecture}' was not found for ${osInfo

? `${osInfo.osName} ${osInfo.osVersion}`

: 'this operating system'}.`

];

if (freethreaded) {

msg.push(`Free threaded versions are only available for Python 3.13.0 and later.`);

}

msg.push(`The list of all available versions can be found here: ${installer.MANIFEST_URL}`);

throw new Error(msg.join(os.EOL));

}

const _binDir = binDir(installDir);

const binaryExtension = utils_1.IS_WINDOWS ? '.exe' : '';

const pythonPath = path.join(utils_1.IS_WINDOWS ? installDir : _binDir, `python${binaryExtension}`);

if (updateEnvironment) {

core.exportVariable('pythonLocation', installDir);

core.exportVariable('PKG_CONFIG_PATH', installDir + '/lib/pkgconfig');

core.exportVariable('pythonLocation', installDir);

// https://cmake.org/cmake/help/latest/module/FindPython.html#module:FindPython

core.exportVariable('Python_ROOT_DIR', installDir);

// https://cmake.org/cmake/help/latest/module/FindPython2.html#module:FindPython2

core.exportVariable('Python2_ROOT_DIR', installDir);

// https://cmake.org/cmake/help/latest/module/FindPython3.html#module:FindPython3

core.exportVariable('Python3_ROOT_DIR', installDir);

core.exportVariable('PKG_CONFIG_PATH', installDir + '/lib/pkgconfig');

if (utils_1.IS_LINUX) {

const libPath = process.env.LD_LIBRARY_PATH

? `:${process.env.LD_LIBRARY_PATH}`

: '';

const pyLibPath = path.join(installDir, 'lib');

if (!libPath.split(':').includes(pyLibPath)) {

core.exportVariable('LD_LIBRARY_PATH', pyLibPath + libPath);

}

}

core.addPath(installDir);

core.addPath(_binDir);

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`

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');

core.addPath(userScriptsDir);

}

// On Linux and macOS, pip will create the --user directory and add it to PATH as needed.

}

const installed = versionFromPath(installDir);

let pythonVersion = installed;

if (freethreaded) {

// Add the freethreaded suffix to the version (e.g., 3.13.1t)

pythonVersion += 't';

}

core.setOutput('python-version', pythonVersion);

core.setOutput('python-path', pythonPath);

const binaryPath = utils_1.IS_WINDOWS ? installDir : _binDir;

yield installPip(binaryPath);

return { impl: 'CPython', version: pythonVersion };

});

>>>>>>> e9c40fb (Add support for `pip-version` (#1129))

}

/* Desugar free threaded and dev versions */

function desugarVersion(versionSpec) {

- [macOS](advanced-usage.md#macos)

- [Using `setup-python` on GHES](advanced-usage.md#using-setup-python-on-ghes)

- [Allow pre-releases](advanced-usage.md#allow-pre-releases)

- [Using the pip-version input](advanced-usage.md#using-the-pip-version-input)

The version of Pip should be specified in the format `major`, `major.minor`, or `major.minor.patch` (for example: 25, 25.1, or 25.0.1).

import * as core from '@actions/core';

import * as tc from '@actions/tool-cache';

import * as exec from '@actions/exec';

}

async function installPip(pythonLocation: string) {

const pipVersion = core.getInput('pip-version');

// Validate pip-version format: major[.minor][.patch]

const versionRegex = /^\d+(\.\d+)?(\.\d+)?$/;

if (pipVersion && !versionRegex.test(pipVersion)) {

throw new Error(

`Invalid pip-version "${pipVersion}". Please specify a version in the format major[.minor][.patch].`

);

}

if (pipVersion) {

core.info(

`pip-version input is specified. Installing pip version ${pipVersion}`

);

await exec.exec(

`${pythonLocation}/python -m pip install --upgrade pip==${pipVersion} --disable-pip-version-check --no-warn-script-location`

);

}

export async function useCpythonVersion(

version: string,

architecture: string,

core.setOutput('python-version', pythonVersion);

core.setOutput('python-path', pythonPath);

const binaryPath = IS_WINDOWS ? installDir : _binDir;

await installPip(binaryPath);

return {impl: 'CPython', version: pythonVersion};