summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
Diffstat (limited to 'src')
-rw-r--r--src/pyramid/path.py28
1 files changed, 28 insertions, 0 deletions
diff --git a/src/pyramid/path.py b/src/pyramid/path.py
index d4909d412..5138344c7 100644
--- a/src/pyramid/path.py
+++ b/src/pyramid/path.py
@@ -1,4 +1,8 @@
+import atexit
+from contextlib import ExitStack
+import functools
from importlib.machinery import SOURCE_SUFFIXES
+import importlib.resources
import os
import pkg_resources
import sys
@@ -9,6 +13,30 @@ from pyramid.interfaces import IAssetDescriptor
init_names = ['__init__%s' % x for x in SOURCE_SUFFIXES]
+@functools.lru_cache(maxsize=None)
+def resource_filename(package, name):
+ """
+ Return a filename on the filesystem for the given resource. If the
+ resource does not exist in the filesystem (e.g. in a zipped egg), it will
+ be extracted to a temporary directory and cleaned up when the application
+ exits.
+
+ This function is equivalent to the now-deprecated
+ ``pkg_resources.resource_filename``.
+
+ This function is only included in order to provide legacy functionality;
+ use should be avoided. Instead prefer to use ``importlib.resource`` APIs
+ directly.
+
+ """
+ ref = importlib.resources.files(package) / name
+
+ manager = ExitStack()
+ atexit.register(manager.close)
+ path = manager.enter_context(importlib.resources.as_file(ref))
+ return str(path)
+
+
def caller_path(path, level=2):
if not os.path.isabs(path):
module = caller_module(level + 1)