From 4b4e38e7d4bd62f2b1cae187ff51428846b720b5 Mon Sep 17 00:00:00 2001 From: Brett Cannon Date: Sat, 25 May 2013 11:32:50 -0400 Subject: Mention __cached__ in the import ref. --- Doc/reference/import.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) 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 -- cgit v0.12