RustPython/.github/workflows/upgrade-pylib.md

description, on, timeout-minutes, permissions, network, engine, runtimes, tools, safe-outputs, cache, env

description	on	timeout-minutes	permissions	network	engine	runtimes	tools	safe-outputs	cache	env
Pick an out-of-sync Python library from the todo list and upgrade it by running `scripts/update_lib quick`, then open a pull request.	workflow_dispatch inputs name description required type Module name to upgrade (leave empty to auto-pick) false string	45	contents issues pull-requests read read read	allowed defaults rust python	copilot	python version 3.15	bash edit github :* toolsets read-only repos issues pull_requests true	create-pull-request title-prefix labels draft expires Update pylib-sync false 30	key path cpython-lib-${{ env.PYTHON_VERSION }} cpython	PYTHON_VERSION ISSUE_ID v3.15.0 6839

Upgrade Python Library

You are an automated maintenance agent for RustPython, a Python 3 interpreter written in Rust. Your task is to upgrade one out-of-sync Python standard library module from CPython.

Step 1: Set up the environment

The CPython source may already be cached. Check if the cpython directory exists and has the correct version:

if [ ! -e "cpython" ]; then
    git clone --depth 1 --branch "$PYTHON_VERSION" https://github.com/python/cpython.git cpython
elif [ ! -d "cpython/.git" ] || [ ! -d "cpython/Lib" ] ||
    [ "$(git -C cpython rev-parse HEAD)" != "$(git -C cpython rev-parse --verify "$PYTHON_VERSION^{commit}" 2>/dev/null)" ] ||
    [ -n "$(git -C cpython status --porcelain)" ]; then
    echo "ERROR: cpython must be a clean checkout of $PYTHON_VERSION. Move the existing directory aside and rerun." >&2
    exit 1
else
    echo "CPython $PYTHON_VERSION source already present."
fi

Step 2: Determine module name

Run this script to determine the module name:

MODULE_NAME="${{ github.event.inputs.name }}"
if [ -z "$MODULE_NAME" ]; then
    echo "No module specified, running todo to find one..."
    python3 scripts/update_lib todo
    echo "Pick one module from the list above that is marked [ ], has no unmet deps, and has a small Δ number."
    echo "Do NOT pick: opcode, datetime, random, hashlib, tokenize, pdb, _pyrepl, concurrent, asyncio, multiprocessing, ctypes, idlelib, tkinter, shutil, tarfile, email, unittest"
else
    echo "Module specified by user: $MODULE_NAME"
fi

If the script printed "Module specified by user: ...", use that exact name. If it printed the todo list, pick one suitable module from it.

Step 3: Run the upgrade

Run the quick upgrade command. This will copy the library from CPython, migrate test files preserving RustPython markers, auto-mark test failures, and create a git commit:

python3 scripts/update_lib quick <module_name>

This takes a while because it builds RustPython (cargo build --release) and runs tests to determine which ones pass or fail.

If the command fails, report the error and stop. Do not try to fix Rust code or modify test files manually.

Step 4: Verify the result

After the script succeeds, check what changed:

git log -1 --stat
git diff HEAD~1 --stat

Make sure the commit was created with the correct message format: Update <name> from <version>.

Step 5: Create the pull request

Create a pull request. Reference issue #${{ env.ISSUE_ID }} in the body but do NOT use keywords that auto-close issues (Fix, Close, Resolve).

Use this format for the PR body:

## Summary

Upgrade `<module_name>` from CPython $PYTHON_VERSION.

Part of #$ISSUE_ID

## Changes

- Updated `Lib/<module_name>` from CPython
- Migrated test files preserving RustPython markers
- Auto-marked test failures with `@expectedFailure`