third-party-package-patches

name	third-party-package-patches
description	Create or update GraalPy third-party package and Rust crate compatibility patches under graalpython/lib-graalpython/patches, including PyPI source preparation, Cargo crate autopatching, rebasing existing patches, metadata.toml updates, license checks, version-range validation, and verify_patches.py validation.

Third-Party Package Patches

Use this skill when creating or updating compatibility patches for packages installed by pip on GraalPy.

Key Files

• Source preparation: scripts/get_pypi_source.py
• Patch metadata: graalpython/lib-graalpython/patches/metadata.toml
• Patch directory: graalpython/lib-graalpython/patches/
• Cargo autopatcher: graalpython/lib-graalpython/modules/autopatch_cargo.py
• Crate patch metadata: graalpython/lib-graalpython/patches/crates/metadata.toml
• Metadata verifier: mx.graalpython/verify_patches.py

Workflow

1. Identify the package name and target version. Use the normalized package key used by PyPI/pip: lowercase with runs of -, _, and . normalized to -.

2. Prepare source with the repo helper:

python scripts/get_pypi_source.py package==version

The script prints Prepared source at: .... Use that directory as the working tree. It is already a temporary git repository with an initial commit, and it has already been processed by autopatch_capi.py and autopatch_cargo.py.

3. Inspect graalpython/lib-graalpython/patches/metadata.toml for existing entries.