The docstring of `str()` should show the default values for object, encoding and errors and should say `bytes-like object`
Open
@terryjreedy is already working on this.
Since Jul 26, 2025.
docs
interpreter-core
triaged
- Dominant language
- Python
- Stars
- 77.2k
- Forks
- 35.9k
- PR merge metrics
- PR metrics pending
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
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.