1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55
|
Process for upgrading the stdlib to a new cpython version
==========================================================
.. note::
overly detailed
0. make sure your working dir is clean
1. check out this branch
2. upgrade the files there
2a. `rm -rf lib-python/3/*`
2b. copy the files from the cpython repo
2c. copy to `lib_pypy`
- `Modules/_ctypes/_ctypes_test.c`
- `Modules/_testcapimodule.c`
- `Modules/_testcapi_feature_macros.inc`
- `Modules/_testmultiphase.c`
- `Modules/clinic/_testmultiphase.c.h`
2d. `git add lib-python/3/`
2e. show copied files in cpython repo by running appropriate git commands
2f. fix copies / renames manually
2g. Do not delete the CPython token.py, it is needed for app_main tests
3. update stdlib-version.txt with the output of `git status` from the cpython repo
4. commit
5. update to py3.11
6. create a integration branch for the new stdlib
(just git branch stdlib-$version)
7. merge vendor/stdlib or vendor/stdlib-3-*
8. commit
10. fix issues. Note especially changes in datetime.py, venv/__init__.py, and others.
11. commit --close-branch
14. update version numbers in sys/version.py and cpyext/include/patch_level.h
Process for updating a point release if the diff is small
=========================================================
In cpython, do `git diff -r <current> -r <newer> Lib > <outfile>`
so for instance `git diff -r v3.9.7 -r v3.9.9 Lib > /tmp/patch3.9.9`
In pypy, cd into `lib-python/3`
Then do
patch -p2 -i <outfile>
If patch asks about reversed patches, reply "no" and apply anyway "yes"
Carefully note the failures in the *.rej files and try to resolve the conflicts.
Delete all the *.orig files, and look for files that should be added to version control
Look for removed files that should be deleted from version control
Then update sys/version.py, cpyext/include/patchlevel.h, and ./stdlib-version.txt
Make sure binary files (especially pip and setuptools wheels) were copied
correctly. On at least one occasion they were empty after this process.
Make sure binary files (especially pip and setuptools wheels) were copied
correctly. On at least one occasion they were empty after this process.
|