summaryrefslogtreecommitdiff
path: root/lib/python2.7/site-packages/django/template/loaders/filesystem.py
diff options
context:
space:
mode:
Diffstat (limited to 'lib/python2.7/site-packages/django/template/loaders/filesystem.py')
-rw-r--r--lib/python2.7/site-packages/django/template/loaders/filesystem.py46
1 files changed, 46 insertions, 0 deletions
diff --git a/lib/python2.7/site-packages/django/template/loaders/filesystem.py b/lib/python2.7/site-packages/django/template/loaders/filesystem.py
new file mode 100644
index 0000000..1a7f0d2
--- /dev/null
+++ b/lib/python2.7/site-packages/django/template/loaders/filesystem.py
@@ -0,0 +1,46 @@
+"""
+Wrapper for loading templates from the filesystem.
+"""
+
+from django.conf import settings
+from django.template.base import TemplateDoesNotExist
+from django.template.loader import BaseLoader
+from django.utils._os import safe_join
+
+class Loader(BaseLoader):
+ is_usable = True
+
+ def get_template_sources(self, template_name, template_dirs=None):
+ """
+ Returns the absolute paths to "template_name", when appended to each
+ directory in "template_dirs". Any paths that don't lie inside one of the
+ template dirs are excluded from the result set, for security reasons.
+ """
+ if not template_dirs:
+ template_dirs = settings.TEMPLATE_DIRS
+ for template_dir in template_dirs:
+ try:
+ yield safe_join(template_dir, template_name)
+ except UnicodeDecodeError:
+ # The template dir name was a bytestring that wasn't valid UTF-8.
+ raise
+ except ValueError:
+ # The joined path was located outside of this particular
+ # template_dir (it might be inside another one, so this isn't
+ # fatal).
+ pass
+
+ def load_template_source(self, template_name, template_dirs=None):
+ tried = []
+ for filepath in self.get_template_sources(template_name, template_dirs):
+ try:
+ with open(filepath, 'rb') as fp:
+ return (fp.read().decode(settings.FILE_CHARSET), filepath)
+ except IOError:
+ tried.append(filepath)
+ if tried:
+ error_msg = "Tried %s" % tried
+ else:
+ error_msg = "Your TEMPLATE_DIRS setting is empty. Change it to point to at least one template directory."
+ raise TemplateDoesNotExist(error_msg)
+ load_template_source.is_usable = True