This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Expand documentation about Any in the typing module
Type: Stage: resolved
Components: Documentation Versions: Python 3.6, Python 3.5
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: docs@python Nosy List: docs@python, gvanrossum, levkivskyi, matrixise, michael0x2a, python-dev
Priority: normal Keywords: patch

Created on 2016-08-05 03:37 by michael0x2a, last changed 2022-04-11 14:58 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
object-vs-any.patch michael0x2a, 2016-08-05 03:37 review
object-vs-any-v2.patch michael0x2a, 2016-08-05 17:29 review
Messages (4)
msg272009 - (view) Author: Michael Lee (michael0x2a) * Date: 2016-08-05 03:37
This patch updates the section about `Any` in the typing module. Previously, that section was relatively sparse and didn't seem to do a very good job of helping the reader understand what the distinction between `Any` and `object` is.

This patch expands that section and adds several examples borrowed from the mypy docs and PEP 484.
msg272045 - (view) Author: Michael Lee (michael0x2a) * Date: 2016-08-05 17:29
Here's revision two. The only change I didn't make was the one about the isinstance check. It isn't included in PEP 484, and after talking to Guido, he decided it wouldn't be appropriate to document it here.
msg272048 - (view) Author: Stéphane Wirtel (matrixise) * (Python committer) Date: 2016-08-05 18:01
I have reviewed your patch, and it compiles with sphinx. no issue with the content, but I am not a native speaker and not an expert of the type hinting of python 3.5
msg272110 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2016-08-06 20:48
New changeset cbcab1fb1b8a by Guido van Rossum in branch '3.5':
Better docs for typing.Any by Michael Lee. Fixes issue #27688.
https://hg.python.org/cpython/rev/cbcab1fb1b8a

New changeset f60e16663f6e by Guido van Rossum in branch 'default':
Better docs for typing.Any by Michael Lee. Fixes issue #27688. (Merge 3.5->3.6)
https://hg.python.org/cpython/rev/f60e16663f6e
History
Date User Action Args
2022-04-11 14:58:34adminsetgithub: 71875
2016-08-06 20:48:57gvanrossumsetstatus: open -> closed
resolution: fixed
stage: resolved
2016-08-06 20:48:24python-devsetnosy: + python-dev
messages: + msg272110
2016-08-05 18:01:32matrixisesetnosy: + matrixise
messages: + msg272048
2016-08-05 17:29:04michael0x2asetfiles: + object-vs-any-v2.patch

messages: + msg272045
2016-08-05 07:59:58levkivskyisetnosy: + levkivskyi
2016-08-05 03:37:04michael0x2acreate