[issue29716] Python 3 Module doc still sounds like __init__.py is required
New submission from James O: PEP 420 says "Allowing implicit namespace packages means that the requirement to provide an __init__.py file can be dropped completely..." (as described here: http://stackoverflow.com/questions/37139786/is-init-py-not-required-for-pack...) The documentation for modules <https://docs.python.org/3/tutorial/modules.html> doesn't seem to reflect this change. My "enhancement suggestion" is that a sentence (and perhaps an example) be added that explicitly states or shows an import from another directory. (P.S. This is my first Python bug submission, so if it's silly, let me know. Thanks!) ---------- assignee: docs@python components: Documentation messages: 288932 nosy: James O, docs@python priority: normal severity: normal status: open title: Python 3 Module doc still sounds like __init__.py is required type: enhancement versions: Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue29716> _______________________________________
James O added the comment: Ah, I didn't realize some tools depended on it. Should I set the status to closed? (like I said, I'm new to this) ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue29716> _______________________________________
INADA Naoki added the comment: I think so. namespace package is topic for packaging ecosystem developers, like setuptools and pip. Normal python programmer shouldn't omit __init__.py. Python tutorial is for people who want to be normal python programmer. 2017/03/04 午後1:53 "James O" <report@bugs.python.org>:
James O added the comment:
Ah, I didn't realize some tools depended on it. Should I set the status to closed? (like I said, I'm new to this)
----------
_______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue29716> _______________________________________
---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue29716> _______________________________________
Changes by Marco Buttu <marco.buttu@gmail.com>: ---------- nosy: +marco.buttu _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue29716> _______________________________________
Brett Cannon added the comment: I've gone ahead and closed this. Thanks for taking the time to check in on this, James! ---------- nosy: +brett.cannon resolution: -> not a bug stage: -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue29716> _______________________________________
participants (4)
-
Brett Cannon
-
INADA Naoki
-
James O
-
Marco Buttu