62 lines
2.3 KiB
Python
62 lines
2.3 KiB
Python
"""
|
|
Wrapper for loading templates from the filesystem.
|
|
"""
|
|
|
|
from django.conf import settings
|
|
from django.template 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:
|
|
file = open(filepath)
|
|
try:
|
|
return (file.read().decode(settings.FILE_CHARSET), filepath)
|
|
finally:
|
|
file.close()
|
|
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
|
|
|
|
_loader = Loader()
|
|
|
|
def load_template_source(template_name, template_dirs=None):
|
|
# For backwards compatibility
|
|
import warnings
|
|
warnings.warn(
|
|
"'django.template.loaders.filesystem.load_template_source' is deprecated; use 'django.template.loaders.filesystem.Loader' instead.",
|
|
DeprecationWarning
|
|
)
|
|
return _loader.load_template_source(template_name, template_dirs)
|
|
load_template_source.is_usable = True
|