[New-bugs-announce] [issue45722] documentation missing information on objects in submodules

[Jens Rapp]

New submission from Jens Rapp <rapp.jens at googlemail.com>:

Documentation 5.4.2. Submodules tells what happens to modules which are imported inside __init__.py of a package>


from .foo import Foo
from .bar import Bar

then executing the following puts a name binding to foo and bar in the spam module:
>>>

>>> import spam
>>> spam.foo
<module 'spam.foo' from '/tmp/imports/spam/foo.py'>
>>> spam.bar
<module 'spam.bar' from '/tmp/imports/spam/bar.py'>

I miss information on what happes to Foo and Bar. 
is it directly usable under spam.Bar() or does one have to use spam.bar.Bar()?

To my mind, that example should tell this.

----------
assignee: docs at python
components: Documentation
messages: 405769
nosy: docs at python, rapp.jens
priority: normal
severity: normal
status: open
title: documentation missing information on objects in submodules
type: enhancement

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue45722>
_______________________________________