[issue31799] Improve __spec__ discoverability

[Barry A. Warsaw]

Change by Barry A. Warsaw :


--
stage: patch review -> resolved
status: open -> closed
versions:  -Python 3.4, Python 3.5

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31799] Improve __spec__ discoverability

[Barry A. Warsaw]

Barry A. Warsaw  added the comment:


New changeset 858ea4354fafa36e57859d2dfd70f8a057984075 by Barry Warsaw (Miss 
Islington (bot)) in branch '3.6':
[3.6] bpo-31799: Make module.__spec__ more discoverable (GH-4010) (#4021)
https://github.com/python/cpython/commit/858ea4354fafa36e57859d2dfd70f8a057984075


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31799] Improve __spec__ discoverability

[Roundup Robot]

Change by Roundup Robot :


--
pull_requests: +3996

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31799] Improve __spec__ discoverability

[Barry A. Warsaw]

Barry A. Warsaw  added the comment:


New changeset 191e3138200906e43cba9347177914325b54843f by Barry Warsaw in 
branch 'master':
bpo-31799: Make module.__spec__ more discoverable (#4010)
https://github.com/python/cpython/commit/191e3138200906e43cba9347177914325b54843f


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31799] Improve __spec__ discoverability

[Barry A. Warsaw]

Change by Barry A. Warsaw :


--
keywords: +patch
pull_requests: +3984
stage:  -> patch review

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue31799] Improve __spec__ discoverability

[Barry A. Warsaw]

New submission from Barry A. Warsaw :

__spec__ is defined in PEP 451.  If you search for "__spec__" in the docs, you 
get a number of hits.

https://docs.python.org/3/search.html?q=__spec___keywords=yes=default

Click on the first link:

https://docs.python.org/3/reference/import.html?highlight=__spec__#__spec__

but that still leaves you scratching your head as to what exactly is in 
__spec__.  If you happen to scroll up a little bit though, you end up here:

https://docs.python.org/3/reference/import.html?highlight=__spec__#module-spec

and then if you follow the link to ModuleSpec, you finally get to here:

https://docs.python.org/3/library/importlib.html#importlib.machinery.ModuleSpec

and *that's* where the contents of __spec__ are defined.  Not very discoverable.

I propose just a couple of small documentation fixes to add "__spec__" in both 
of those locations so that a search lands you in a useful place.

--
assignee: barry
components: Documentation
messages: 304474
nosy: barry
priority: normal
severity: normal
status: open
title: Improve __spec__ discoverability
versions: Python 3.4, Python 3.5, Python 3.6, Python 3.7

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com