__bytes__ not documented

[yak]

BPO	13259
Nosy	@pitrou

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2011-10-25.04:07:22.612>
created_at = <Date 2011-10-24.22:49:05.905>
labels = ['docs']
title = '__bytes__ not documented'
updated_at = <Date 2011-10-25.04:07:22.603>
user = 'https://bugs.python.org/yak'

bugs.python.org fields:

activity = <Date 2011-10-25.04:07:22.603>
actor = 'python-dev'
assignee = 'docs@python'
closed = True
closed_date = <Date 2011-10-25.04:07:22.612>
closer = 'python-dev'
components = ['Documentation']
creation = <Date 2011-10-24.22:49:05.905>
creator = 'yak'
dependencies = []
files = []
hgrepos = []
issue_num = 13259
keywords = []
message_count = 3.0
messages = ['146334', '146336', '146342']
nosy_count = 4.0
nosy_names = ['pitrou', 'docs@python', 'yak', 'python-dev']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue13259'
versions = ['Python 3.2', 'Python 3.3']

[yak]

It looks like Python 3 supports the __bytes__ magic method (called by bytes(obj)). However, it's not documented anywhere.

Also, I could not find any reference to BDFL accepting it but it looks like it got in anyway.

Here are some posts back from 2007 where he argues against it:
http://mail.python.org/pipermail/python-3000/2007-August/009375.html

[pitrou]

Indeed. I didn't even remember we had that. There are tests, however, in Lib/test/test_bytes.py.
This was added in issue bpo-2415, by the way.

[python-dev]

New changeset 199d9e3fe0ce by Benjamin Peterson in branch '3.2':
document __bytes__ special method (closes bpo-13259)
http://hg.python.org/cpython/rev/199d9e3fe0ce

New changeset 4128de054937 by Benjamin Peterson in branch 'default':
merge 3.2 (bpo-13259)
http://hg.python.org/cpython/rev/4128de054937