From 38a83495d767711cede4f86f58916410f914a98d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Filipe=20La=C3=ADns?= Date: Fri, 21 May 2021 15:31:19 +0100 Subject: [PATCH] bpo-44164: document the semantic value of module resources MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Filipe Laíns --- Doc/library/importlib.rst | 4 ++++ .../Documentation/2021-05-21-15-33-03.bpo-44164.dUYTnM.rst | 1 + 2 files changed, 5 insertions(+) create mode 100644 Misc/NEWS.d/next/Documentation/2021-05-21-15-33-03.bpo-44164.dUYTnM.rst diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst index 50297e0d73e7c8..a99506b510c095 100644 --- a/Doc/library/importlib.rst +++ b/Doc/library/importlib.rst @@ -851,6 +851,10 @@ Resources are roughly akin to files inside directories, though it's important to keep in mind that this is just a metaphor. Resources and packages **do not** have to exist as physical files and directories on the file system. +Resources have no semantics associated with them, they are an abstract concept +implemented by the module loader. Generally, in a file-system context, resources +are considered the child files in a module directory. + .. note:: This module provides functionality similar to `pkg_resources diff --git a/Misc/NEWS.d/next/Documentation/2021-05-21-15-33-03.bpo-44164.dUYTnM.rst b/Misc/NEWS.d/next/Documentation/2021-05-21-15-33-03.bpo-44164.dUYTnM.rst new file mode 100644 index 00000000000000..1be333601f0e7e --- /dev/null +++ b/Misc/NEWS.d/next/Documentation/2021-05-21-15-33-03.bpo-44164.dUYTnM.rst @@ -0,0 +1 @@ +Document the semantic value of module resources.