Skip to content

Pequeñas mejoras al proceso de construcción #2874

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Nov 15, 2024

Conversation

rtobar
Copy link
Collaborator

@rtobar rtobar commented Nov 13, 2024

Éstos son pequeños cambios que mejoran ligeramente el proceso de la construcción de la documentación, y hacen más mantenible el código a futuro.

Primero, la lista de rutas relativas que hay que arreglar en los .rst de cpython ha sido simplificada, removiendo entradas innecesarias, y actualizando sólo los archivos que haga falta (en vez de ejecturas cada actualización sobre todos los archivos cada vez).

Segundo, el target build del Makefile fue separado en sus sub-partes constituyentes, de tal modo que ahora en el step de CI donde antes teníamos una copia de los comandos sed ahora hay sólo una invocación a make fix_relative_paths.

Finalmente, el PR que envié a sphinx-intl para realizar updates en paralelo ya está aceptado y una nueva versión ya fue publicada, por lo que la lista de requisitos ahora está actualizada para usar esa última versión (y así hacer más rápido el proceso de actualización a 3.13).

Doing so means we now can reuse the logic that fixes the include::
directives in the cpython documentation in our CI job, avoiding
repeating ourselves, making maintenance easier and avoiding subtle bugs.

Being able to reuse the rest of the steps (do_build, pospell, etc)
requires more care, as the Makefile is constrained to requiring a
virtual environment (which we don't create on CI), and also doesn't
allow us to pass command-line arguments to list specific files to check.

Signed-off-by: Rodrigo Tobar <rtobar@icrar.org>
Some of these replacements didn't exist anymore, while others seemed
like accidental duplicates that might or might not have been needed to
begin with.

Signed-off-by: Rodrigo Tobar <rtobar@icrar.org>
Signed-off-by: Rodrigo Tobar <rtobar@icrar.org>
This version performs .po file updates in parallel, thus speeding up the
process of moving to new versions of Python and updating our translation
files.

Signed-off-by: Rodrigo Tobar <rtobar@icrar.org>
@cmaureir cmaureir closed this Nov 15, 2024
@cmaureir cmaureir reopened this Nov 15, 2024
@rtobar rtobar merged commit 88c4f4c into python:3.12 Nov 15, 2024
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants