python / python/cpython

The docstring of `str()` should show the default values for object, encoding and errors and should say `bytes-like object`

Ouverte
#137,112 6 commentaires 0 réactions 1 personne assignée Voir sur GitHub

@terryjreedy y travaille déjà.

Depuis le 26/7/2025.

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

Description

The docstring of str() doesn't show the default values for object, encoding and errors and does say bytes_or_buffer as shown below:

print(help(str))
# class str(object)
#  |  str(object='') -> str
#  |  str(bytes_or_buffer[, encoding[, errors]]) -> str

So, the docstring of str() should show the default values for object, encoding and errors and should say bytes-like object as shown below:

print(help(str))
# class str(object)
#  |  str(object='') -> str
#  |  str(object=b'', encoding='utf-8', errors='strict') -> str # Here
#  |  str(bytes-like object[, encoding[, errors]]) -> str
          # Here
Linked PRs
  • gh-142650

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.

Évaluation

Cette issue n'a pas encore été évaluée.

Recevez les nouvelles issues par e-mail

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