CC q d Z ddlZddlZddlZddlmZ ddlmZ ddlmZ ddl m
Z
ddl m Z dd l m Z dd
l m
Z
dd lmZ dd lmZ dd
lmZ d Z G d de Z G d de Z G d de Z G d de Z G d de Z G d de Z G d d e Z G d d e Z G d d e Z dS )!zKAPI and implementations for loading templates from different data
sources.
N)sha1)path)
ModuleType )abcfspath) iteritems) string_types)TemplateNotFound) internalcode)open_if_existsc g }| d D ]f}t j |v s*t j rt j |v s|t j k rt | |r|dk r| | g|S )zSplit a path into segments and perform a sanity check. If it detects
'..' in the path it will raise a `TemplateNotFound` error.
/.)splitr sepaltseppardirr append)templatepiecespieces n/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/jinja2/loaders.pysplit_template_pathr s F $$ ! ! H
$ u 4 4 ##"8,, ,
!u|| MM% M c : e Zd ZdZdZd Zd Zedd ZdS )
BaseLoadera Baseclass for all loaders. Subclass this and override `get_source` to
implement a custom loading mechanism. The environment provides a
`get_template` method that calls the loader's `load` method to get the
:class:`Template` object.
A very basic example for a loader that looks up templates on the file
system could look like this::
from jinja2 import BaseLoader, TemplateNotFound
from os.path import join, exists, getmtime
class MyLoader(BaseLoader):
def __init__(self, path):
self.path = path
def get_source(self, environment, template):
path = join(self.path, template)
if not exists(path):
raise TemplateNotFound(template)
mtime = getmtime(path)
with file(path) as f:
source = f.read().decode('utf-8')
return source, path, lambda: mtime == getmtime(path)
Tc f | j s t d| j j z t | )a Get the template source, filename and reload helper for a template.
It's passed the environment and template name and has to return a
tuple in the form ``(source, filename, uptodate)`` or raise a
`TemplateNotFound` error if it can't locate the template.
The source part of the returned tuple must be the source of the
template as unicode string or a ASCII bytestring. The filename should
be the name of the file on the filesystem if it was loaded from there,
otherwise `None`. The filename is used by python for the tracebacks
if no loader extension is used.
The last item in the tuple is the `uptodate` function. If auto
reloading is enabled it's always called to check if the template
changed. No arguments are passed so the function must store the
old state somewhere (for example in a closure). If it returns `False`
the template will be reloaded.
z&%s cannot provide access to the source)has_source_access RuntimeError __class____name__r )self environmentr s r
get_sourcezBaseLoader.get_sourceG s> $ % 84>;RR
x(((r c t d )zIterates over all templates. If the loader does not support that
it should raise a :exc:`TypeError` which is the default behavior.
z-this loader cannot iterate over all templates) TypeErrorr$ s r list_templateszBaseLoader.list_templates_ s GHHHr Nc H d}|i }| || \ }}}|j }| | |||| } | j }|| ||| }|#| j || _ | | |j |||| S )ac Loads a template. This method looks up the template in the cache
or loads one by calling :meth:`get_source`. Subclasses should not
override this method as loaders working on collections of other
loaders (such as :class:`PrefixLoader` or :class:`ChoiceLoader`)
will not call this method but `get_source` directly.
N)r& bytecode_cache
get_bucketcodecompile
set_buckettemplate_class from_code)
r$ r% nameglobalsr. sourcefilenameuptodatebccbuckets
r loadzBaseLoader.loade s ?G &*__[$%G%G"( ( ?^^KxHHF;D < &&vtX>>D
?v{ 2 FK NN6 " " ")33 w
r N) r#
__module__ __qualname____doc__r r& r* r
r: r r r r & sg < ) ) )0I I I $
$
$
\$
$
$
r r c & e Zd ZdZddZd Zd ZdS ) FileSystemLoadera# Loads templates from the file system. This loader can find templates
in folders on the file system and is the preferred way to load them.
The loader takes the path to the templates as string, or if multiple
locations are wanted a list of them which is then looked up in the
given order::
>>> loader = FileSystemLoader('/path/to/templates')
>>> loader = FileSystemLoader(['/path/to/templates', '/other/path'])
Per default the template encoding is ``'utf-8'`` which can be changed
by setting the `encoding` parameter to something else.
To follow symbolic links, set the *followlinks* parameter to ``True``::
>>> loader = FileSystemLoader('/path/to/templates', followlinks=True)
.. versionchanged:: 2.8
The ``followlinks`` parameter was added.
utf-8Fc t |t j rt |t r|g}d |D | _ || _ || _ d S )Nc , g | ]}t | S r? r .0ps r
z-FileSystemLoader.__init__.. s 9996!99999r )
isinstancer Iterabler
searchpathencoding followlinks)r$ rK rL rM s r __init__zFileSystemLoader.__init__ sa *cl33 &z 8
8
& % J :9j999
&r c t | }| j D ]}t j |g|R t }|& | | j }| n# | w xY wt j fd}||fc S t | )Nc X t j k S # t $ r Y dS w xY wNFr getmtimeOSErrorr6 mtimes r r7 z-FileSystemLoader.get_source..uptodate ? ! =22e;; ! ! ! 55!
))) r rK r joinr readdecoderL closerS r )
r$ r% r r rK fcontentsr7 r6 rV s
@@r r& zFileSystemLoader.get_source s $X.. / 0 0Jy5f555H x((Ay
6688??4=99 M(++E
!
!
!
!
!
! Xx/ / / / x(((s ,BBc t }| j D ]}t j || j }|D ]\ }}}|D ]}t j || t | d t j j
t j j d }|d d dk r
|dd }||vr| | t | S )N)rM r ./)
setrK oswalkrM r rY lenstripr replaceaddsorted) r$ foundrK walk_dirdirpath_ filenamesr6 r s r r* z FileSystemLoader.list_templates s / , ,Jwzt7GHHHH)1
,
,%I ) , ,H Wh77J8I8IJ rw{++ c22
|t++#+ABB< u,, (+++ ,
, e}} r N)rB Fr# r< r= r> rN r& r* r? r r rA rA sP * ' ' ' ') ) ). r rA c & e Zd ZdZddZd Zd ZdS )
PackageLoadera, Load templates from python eggs or packages. It is constructed with
the name of the python package and the path to the templates in that
package::
loader = PackageLoader('mypackage', 'views')
If the package path is not given, ``'templates'`` is assumed.
Per default the template encoding is ``'utf-8'`` which can be changed
by setting the `encoding` parameter to something else. Due to the nature
of eggs it's only possible to reload templates if the package was loaded
from the file system and not a zip file.
templatesrB c ddl m} ddl m} ddl m} || }|| _ | | _ t
|| | _ || _ || _ d S )Nr )DefaultProvider) get_provider)ResourceManager)
pkg_resourcesrt ru rv rL managerrI filesystem_boundprovider package_path)r$ package_namer{ rL rt ru rv rz s r rN zPackageLoader.__init__ s 111111......111111 < --
&(( *8_ E E
(r c t | }d | j ft | z }| j | st
| d x}| j r:| j | j | t j fd}| j | j | }|
| j |fS )Nr c X t j k S # t $ r Y dS w xY wrQ rR rU s r r7 z*PackageLoader.get_source..uptodate rW rX )r rY r{ tuplerz has_resourcer ry get_resource_filenamerx r rS get_resource_stringr[ rL ) r$ r% r r rG r7 r5 r6 rV s @@r r& zPackageLoader.get_source s $X.. HHd')E&MM9 : :}))!,, -"8,, , ""8 !}::4<KKHM(++E
!
!
!
!
!
! 224<CC}}T]++Xx??r c j }|d d dk r |dd }n|dk rd}t | g fd | S )Nr` ra r c j | D ]`}| dz |z }j | r | 0 |d d ad S )Nr )rz resource_listdirresource_isdirr lstrip)r r6 fullname_walkoffsetresultsr$ s r r z+PackageLoader.list_templates.._walk s M : :4 @ @
B
B #:0=//99 BE(OOOONN8FGG#4#;#;C#@#@AAAA
B
Br )r{ re sort)r$ r r r r s ` @@@r r* z PackageLoader.list_templates
s 8t 8DD
S[[DT B B B B B B B B d r N)rr rB ro r? r r rq rq sS
)
)
)
)@ @ @, r rq c $ e Zd ZdZd Zd Zd ZdS )
DictLoadera Loads a template from a python dict. It's passed a dict of unicode
strings bound to template names. This loader is useful for unittesting:
>>> loader = DictLoader({'index.html': 'source here'})
Because auto reloading is rarely useful this is disabled per default.
c || _ d S r; )mapping)r$ r s r rN zDictLoader.__init__,
r c f j v r j d fdfS t )Nc @ j k S r; )r get)r$ r5 r s r z'DictLoader.get_source..2 s 4<3C3CH3M3M)M r )r r )r$ r% r r5 s ` `@r r& zDictLoader.get_source/ sI t| # #\(+F4!M!M!M!M!M!MM M x(((r c * t | j S r; )ri r r) s r r* zDictLoader.list_templates5 s dl###r Nro r? r r r r # sK ) ) ) $ $ $ $ $r r c e Zd ZdZd Zd ZdS )FunctionLoadera A loader that is passed a function which does the loading. The
function receives the name of the template and has to return either
an unicode string with the template source, a tuple in the form ``(source,
filename, uptodatefunc)`` or `None` if the template does not exist.
>>> def load_template(name):
... if name == 'index.html':
... return '...'
...
>>> loader = FunctionLoader(load_template)
The `uptodatefunc` is a function that is called if autoreload is enabled
and has to return `True` if the template is still up to date. For more
details have a look at :meth:`BaseLoader.get_source` which has the same
return value.
c || _ d S r; ) load_func)r$ r s r rN zFunctionLoader.__init__K s
"r c | | }|t | t |t r|d d fS |S r; )r r rI r )r$ r% r rvs r r& zFunctionLoader.get_sourceN sI
^^H
%
%
:"8,, ,
L
)
) "tT> ! r N)r# r< r= r> rN r& r? r r r r 9 s< "# # # r r c D e Zd ZdZd dZd Zd Zed
d Zd Z dS ) PrefixLoadera A loader that is passed a dict of loaders where each loader is bound
to a prefix. The prefix is delimited from the template by a slash per
default, which can be changed by setting the `delimiter` argument to
something else::
loader = PrefixLoader({
'app1': PackageLoader('mypackage.app1'),
'app2': PackageLoader('mypackage.app2')
})
By loading ``'app1/index.html'`` the file from the app1 package is loaded,
by loading ``'app2/index.html'`` the file from the second.
r c " || _ || _ d S r; )r delimiter)r$ r r s r rN zPrefixLoader.__init__f s "r c | | j d \ }}| j | }n$# t t f$ r t | w xY w||fS )Nr )r r r
ValueErrorKeyErrorr )r$ r prefixr3 loaders r
get_loaderzPrefixLoader.get_loaderj sf -#>>$.!< rN r r& r
r: r* r? r r r r W s # # # # - - - ) ) ) \) r r c < e Zd ZdZd Zd Zedd Zd ZdS ) ChoiceLoadera This loader works like the `PrefixLoader` just that no prefix is
specified. If a template could not be found by one loader the next one
is tried.
>>> loader = ChoiceLoader([
... FileSystemLoader('/path/to/user/templates'),
... FileSystemLoader('/path/to/system/templates')
... ])
This is useful if you want to allow users to override builtin templates
from a different location.
c || _ d S r; )loaders)r$ r s r rN zChoiceLoader.__init__ r r c | j D ]*} | || c S # t $ r Y 'w xY wt | r; )r r& r )r$ r% r r s r r& zChoiceLoader.get_source sb l F
((h?????#
x(((s #
00Nc | j D ]+} | ||| c S # t $ r Y (w xY wt | r; )r r: r )r$ r% r3 r4 r s r r: zChoiceLoader.load sb l F
{{;g>>>>>#
t$$$s $
11c t }| j D ])}| | *t | S r; )rb r updater* ri )r$ rj r s r r* zChoiceLoader.list_templates sI l 2 2F LL..00 1 1 1 1e}} r r; ) r# r< r= r> rN r& r
r: r* r? r r r r sk ) ) ) % % % \% r r c e Zd ZdZdS )_TemplateModulez9Like a normal module but with support for weak referencesN)r# r< r= r> r? r r r r s CCCCr r c ` e Zd ZdZdZd Zed Zed Ze dd Z
dS ) ModuleLoadera6 This loader loads templates from precompiled templates.
Example usage:
>>> loader = ChoiceLoader([
... ModuleLoader('/path/to/compiled/templates'),
... FileSystemLoader('/path/to/templates')
... ])
Templates can be precompiled with :meth:`Environment.compile_templates`.
Fc 6 dt | z t }t |t j rt |t
r|g}d |D |_ t j |fd t j
< || _ | _ d S )Nz_jinja2_module_templates_%xc , g | ]}t | S r? r rE s r rH z)ModuleLoader.__init__.. s 000aq 000r c D t j d S r; )sysmodulespop)xr| s r r z'ModuleLoader.__init__.. s 3;??<>> r )
idr rI r rJ r __path__weakrefproxyr r moduler| )r$ r modr| s @r rN zModuleLoader.__init__ s 4r$xx? l++$ -- D,1O1O 6D004000 $+M >>>>%
%
L! (r c p dt | d z S )Ntmpl_rB )r encode hexdigestr3 s r get_template_keyz ModuleLoader.get_template_key s- dkk' 2 233==????r c < t | dz S )Nz.py)r r r s r get_module_filenamez ModuleLoader.get_module_filename s ,,T22U::r Nc Z | | }| j d|}t | j |d }|R t |d d dg }n # t
$ r t
| w xY wt j |d |j
||j | S )Nr root)
r r| getattrr
__import__ ImportErrorr r r r r1 from_module_dict__dict__)r$ r% r3 r4 keyr r s r r: zModuleLoader.load s ##D)) - - -ss3dk6400 ;
- tfX>>
-
-
-&t,,,
-
KOOFD ) ) )):: w
s A A)r; ) r# r< r= r> r rN staticmethodr r r
r: r? r r r r s
) ) ), @ @ \@ ; ; \;
\
r r ) r> rc r r hashlibr r typesr _compatr r r
r
exceptionsr utilsr
r r objectr rA rq r r r r r r r? r r r s
! ! ! ! ! ! ( ( ( ( ( ( ! ! ! ! ! ! "d
d
d
d
d
d
d
d
NI I I I I z I I I XG G G G GJ G G GT$ $ $ $ $ $ $ $, Z <3 3 3 3 3: 3 3 3l& & & & & : & & & RD D D D Dj D D D>
>
>
>
>
: >
>
>
>
>
r