python-docs-fr/CONTRIBUTING-CORE.rst

Nouvelle branche upstream

Lorsque cpython crée une nouvelle branche, il debient possible de la traduire :

git switch -c 3.13
python .scripts/merge.py --cpython_repo ../cpython/ origin/3.13
make check-all -j 8

Il faut mettre à jour la variable BRANCH dans le Makefile.

Maintenance

Dans certains cas on a besoin de propager des traductions d'une branche à l'autre :

• d'une ancienne branche vers une nouvelle branche : lors du passage d'une version à l'autre de CPython, lorsque quelqu'un a une PR sur une ancienne version (forward porting) ;
• d'une nouvelle branche vers des anciennes branches : pour propager de temps en temps le travail sur d'anciennes versions (rétroportage ou backporting).

Pour forward-porter un ou plusieurs commits, il vaut mieux utiliser git cherry-pick -x LE_SHA, ça garde l'auteur, le sha1 d'origine, et toutes les modifications.

Pour rétroporter « en gros » on utilise pomerge : on le fait lire sur une branche, puis écrire sur une autre, par exemple pour copier de la 3.8 à la 3.7 :

git fetch
git checkout 3.8
git reset --hard upstream/3.8
pomerge --from-files *.po */*.po
git checkout --branch back-porting upstream/3.7
pomerge  --no-overwrite --to-files *.po */*.po
powrap --modified
git add --patch
git commit --message="Backporting from 3.8"
git push --set-upstream origin HEAD

Notes :

- j'utilise git fetch au début pour avoir upstream/3.7 et

upstream/3.8 à jour localement, ainsi je peux travailler sans

toucher au réseau jusqu'au git push, mais chacun fait comme il veut ;

- j'utilise *.po */*.po et pas **/*.po, car si vous avez un

venv dans l'arborescence il va vous trouver des traductions de Sphinx et peut-être d'autres paquets dans .venv/lib/python*/ (et mettre beaucoup plus de temps) ;

- j'utilise pomerge --no-overwrite, ça indique à pomerge de

n'écrire que si le msgstr est vide, donc de ne pas modifier l'existant, ainsi il est impossible de casser quelque chose. On peut le tenter sans --no-overwrite, attention, ça fait des bêtises, ça nécessite une relecture attentive : certaines traductions, comme example: sont en parfois traduites en français avec une majuscule, et parfois non, en fonction du contexte, pomerge uniformiserait ça, ce n'est pas bien ;

- attention, si vous testez sans --no-overwrite, il est peut-être

bon de vider la mémoire de pomerge avant la lecture, pour éviter de lui faire écrire des choses lues lors des sessions précédentes, via un rm -f ~/.pomerge.json ;

- j'utilise git add --patch (ou -p) car j'aime bien relire quand même,

en général, je n'ajoute pas les différences d'ordre dans les entêtes, mais un git add --update irait très bien ;

• attention au fichier dict auquel il peut manquer des lignes.