python / python/cpython

warnings.catch_warnings docs: dubious mention of sys.stdout

Ouverte
#129,846 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

docs
Langage dominant
Python
Étoiles
77.2k
Forks
35.9k
Métriques de merge des PR
Métriques de PR en attente

Description

https://docs.python.org/3/library/warnings.html#warnings.catch_warnings reads:

If record is True, a list is returned that is progressively populated with objects as seen by a custom showwarning() function (which also suppresses output to sys.stdout).

Was it meant to say sys.stderr instead?
Otherwise, I don't understand why it mentions stdout specifically. I don't see anything about stdout elsewhere in the module docs or in the implementation.

Linked PRs
  • gh-130768

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Commencez par la section consacrée à warnings.catch_warnings dans docs.python.org/library/warnings.html et comparez ce qu’elle affirme au sujet de sys.stdout avec l’implémentation du module warnings. Vérifiez d’abord la PR liée gh-130768 ; c’est terminé lorsque la documentation décrit correctement le flux de sortie et que la modification de documentation qui en résulte est cohérente avec l’implémentation.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
python
Domaine
documentation
Type d'issue
Documentation
Difficulté
1/5
Temps estimé
Moins d'une heure
Activité
À l'abandon
Clarté
Clairement spécifiée
Accessibilité débutants
35/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.