possible race-condition with python-doc
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- Python
- Sterne
- 77.2k
- Forks
- 35.9k
- PR-Merge-Kennzahlen
- PR-Kennzahlen ausstehend
Beschreibung
Bug report
Bug description:
While working on reproducible builds for openSUSE, I found that our python314 (and python311) doc sub-packages produce different html on 1-core-VMs and 4-core-VMs. This suggests that there is some race going on about what the correct content should be.
https://rb.zq1.de/other/python314-doc-compare.out has a diff
The interesting bit of it is
-<p class="audit-hook" id="audit_event_cpython_run_stdin_1">
+<p class="audit-hook" id="audit_event_cpython_run_stdin_2">
How to Reproduce
To test on openSUSE or Debian, use
osc checkout openSUSE:Factory/python314 && cd $_
for N in 1 14 ; do
osc build -M=doc --noservice --clean --vm-type=kvm -j$N --release=1.1 --keep-pkg=RPMS.$N standard
(cd RPMS.$N && unrpm python314-doc-3*.x86_64.rpm)
done
diff -ru RPMS.{1,14}/usr/
Environment Information
OS: openSUSE Tumbleweed 20250302
Sphinx-8.1.3
Sphinx extensions
Additional context
This bug was found while working on reproducible builds for openSUSE.
This was originally filed in https://github.com/sphinx-doc/sphinx/issues/13419 but apparently the Sphinx people think this is an issue in cpython.
CPython versions tested on:
3.11, 3.14, 3.13, 3.12
Operating systems tested on:
Linux
Linked PRs
- gh-136165
Beitragsleitfaden
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Beginne damit, die dokumentierte openSUSE-Build-Schleife mit -j1 und -j14 auszuführen, und vergleiche anschließend die extrahierten usr/-Verzeichnisbäume sowie die gemeldeten audit-hook-IDs. Verwende den verknüpften PR gh-136165 und den Diff des reproduzierbaren Builds als Kontext; abgeschlossen ist die Aufgabe, wenn wiederholte Dokumentations-Builds unabhängig von der Parallelität identisches HTML erzeugen.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- python
- Bereich
- documentation
- Issue-Typ
- Bug
- Schwierigkeit
- 4/5
- Geschätzter Aufwand
- 3-5 Tage
- Aktivitätsstatus
- Veraltet
- Klarheit
- Größtenteils klar
- Anfängerfreundlichkeit
- 35/100