summaryrefslogtreecommitdiffstats
path: root/Doc/reference
diff options
context:
space:
mode:
authorBrett Cannon <brett@python.org>2013-05-25 15:32:50 (GMT)
committerBrett Cannon <brett@python.org>2013-05-25 15:32:50 (GMT)
commit4b4e38e7d4bd62f2b1cae187ff51428846b720b5 (patch)
tree808ac7978a6a5819bfd7fedf1c46a30e006dca7c /Doc/reference
parent533f1ed3346a00b35894f84e5d8a193b547b60f0 (diff)
downloadcpython-4b4e38e7d4bd62f2b1cae187ff51428846b720b5.zip
cpython-4b4e38e7d4bd62f2b1cae187ff51428846b720b5.tar.gz
cpython-4b4e38e7d4bd62f2b1cae187ff51428846b720b5.tar.bz2
Mention __cached__ in the import ref.
Diffstat (limited to 'Doc/reference')
-rw-r--r--Doc/reference/import.rst6
1 files changed, 5 insertions, 1 deletions
diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst
index 5874606..eb497a1 100644
--- a/Doc/reference/import.rst
+++ b/Doc/reference/import.rst
@@ -353,7 +353,11 @@ Loaders must satisfy the following requirements:
* The loader may set the ``__file__`` attribute of the module. If set, this
attribute's value must be a string. The loader may opt to leave
``__file__`` unset if it has no semantic meaning (e.g. a module loaded from
- a database).
+ a database). If ``__file__`` is set, it may also be appropriate to set the
+ ``__cached__`` attribute which is the path to any compiled version of the
+ code (e.g. byte-compiled file). The file does not need to exist to set this
+ attribute; the path can simply point to whether the compiled file would
+ exist (see :pep:`3147`).
* The loader may set the ``__name__`` attribute of the module. While not
required, setting this attribute is highly recommended so that the