classification
Title: Document BUILD_*_UNPACK opcodes
Type: behavior Stage: needs patch
Components: Documentation Versions: Python 3.7, Python 3.6, Python 3.5
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: Joshua.Landau, benjamin.peterson, berker.peksag, brett.cannon, docs@python, levkivskyi, neil.g, serhiy.storchaka, twouters
Priority: high Keywords:

Created on 2016-01-26 23:40 by brett.cannon, last changed 2017-02-22 13:32 by levkivskyi.

Pull Requests
URL Status Linked Edit
PR 238 open levkivskyi, 2017-02-22 13:32
Messages (4)
msg258985 - (view) Author: Brett Cannon (brett.cannon) * (Python committer) Date: 2016-01-26 23:40
Turns out the BUILD_TUPLE_UNPACK and BUILD_LIST_UNPACK opcodes are undocumented in the dis module.
msg258986 - (view) Author: Brett Cannon (brett.cannon) * (Python committer) Date: 2016-01-26 23:59
There are also BUILD_SET_UNPACK and BUILD_MAP_UNPACK as well.
msg268127 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2016-06-10 16:50
And BUILD_MAP_UNPACK_WITH_CALL.

All these opcodes were added in issue2292 for implementing PEP 448, but are not documented even in the PEP.
msg287605 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2017-02-11 15:34
At the same time the semantic of the BUILD_MAP opcode was changed. However the documentation was not updated and currently it doesn't match the implementation. This caused an issue in third-party projects that operate with bytecode.

See also issue28810 for documenting bytecode changes in 3.6.
History
Date User Action Args
2017-02-22 14:23:29serhiy.storchakalinkissue28810 dependencies
2017-02-22 13:32:54levkivskyisetpull_requests: + pull_request200
2017-02-22 09:14:17levkivskyisetnosy: + levkivskyi
2017-02-13 19:04:29berker.peksagsetnosy: + berker.peksag
2017-02-11 15:34:11serhiy.storchakasetpriority: low -> high
type: behavior
messages: + msg287605

versions: + Python 3.5, Python 3.7
2016-06-10 16:50:04serhiy.storchakasetnosy: + twouters, neil.g, serhiy.storchaka, Joshua.Landau
messages: + msg268127
2016-01-26 23:59:01brett.cannonsetmessages: + msg258986
title: Document BUILD_LIST_UNPACK & BUILD_TUPLE_UNPACK -> Document BUILD_*_UNPACK opcodes
2016-01-26 23:40:45brett.cannoncreate