doc Be explicit about mock_open created mocks not supporting __iter__

[andresdelfino]

BPO	34077
Nosy	@berkerpeksag, @andresdelfino
PRs	bpo-34077: Mention that mock_open mocks don't support __iter__ #8203

^{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 2018-07-09.16:18:04.709>
created_at = <Date 2018-07-09.15:57:57.490>
labels = ['3.8', 'type-feature', '3.7', 'docs']
title = 'doc Be explicit about mock_open created mocks not supporting __iter__'
updated_at = <Date 2018-07-09.16:33:31.003>
user = 'https://github.com/andresdelfino'

bugs.python.org fields:

activity = <Date 2018-07-09.16:33:31.003>
actor = 'berker.peksag'
assignee = 'docs@python'
closed = True
closed_date = <Date 2018-07-09.16:18:04.709>
closer = 'berker.peksag'
components = ['Documentation']
creation = <Date 2018-07-09.15:57:57.490>
creator = 'adelfino'
dependencies = []
files = []
hgrepos = []
issue_num = 34077
keywords = ['patch']
message_count = 3.0
messages = ['321327', '321333', '321335']
nosy_count = 3.0
nosy_names = ['docs@python', 'berker.peksag', 'adelfino']
pr_nums = ['8203']
priority = 'normal'
resolution = 'rejected'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue34077'
versions = ['Python 3.6', 'Python 3.7', 'Python 3.8']

[andresdelfino]

I've been bitten by this one, and while the docs are clear in what the created mock objects support, I think something explicit about __iter__ will help.

[berkerpeksag]

-1. We can't document every non-existent feature in the stdlib documentation.

There is an already open issue for adding __iter__ support to mock_open(): bpo-21258

[berkerpeksag]

There is also bpo-32933.