|
Server : Apache System : Linux cvar2.toservers.com 3.10.0-962.3.2.lve1.5.73.el7.x86_64 #1 SMP Wed Aug 24 21:31:23 UTC 2022 x86_64 User : njnconst ( 1116) PHP Version : 8.4.18 Disable Function : NONE Directory : /proc/self/root/lib/python2.7/site-packages/jinja2/ |
Upload File : |
�
-/�_c @ s| d Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l m Z d d l m Z d d l m
Z
d d l m Z d d l m
Z
d d l m Z d d
l m Z d d l m Z d d l m Z d
Z d e j e d � e j e j d d >e j d Bd � Z d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d S( s The optional bytecode cache system. This is useful if you have very
complex template situations and the compilation of all those templates
slows down your application too much.
Situations where this is useful are often forking web applications that
are initialized on the first request.
i����N( t sha1( t listdir( t pathi ( t BytesIO( t marshal_dump( t marshal_load( t pickle( t text_type( t open_if_existsi t j2i i i t Bucketc B sD e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z RS( su Buckets are used to store the bytecode for one template. It's created
and initialized by the bytecode cache and passed to the loading functions.
The buckets get an internal checksum from the cache assigned and use this
to automatically reject outdated cache material. Individual bytecode
cache subclasses don't have to care about cache invalidation.
c C s) | | _ | | _ | | _ | j � d S( N( t environmentt keyt checksumt reset( t selfR R R
( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyt __init__. s c C s
d | _ d S( s) Resets the bucket (unloads the bytecode).N( t Nonet code( R ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyR 4 s c C s� | j t t � � } | t k r/ | j � d St j | � } | j | k r[ | j � d Sy t | � | _ Wn% t t
t f k
r� | j � d SXd S( s/ Loads bytecode from a file or file like object.N( t readt lent bc_magicR R t loadR
R R t EOFErrort
ValueErrort TypeError( R t ft magicR
( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyt
load_bytecode8 s
c C sU | j d k r t d � � n | j t � t j | j | d � t | j | � d S( s; Dump the bytecode into the file or file like object passed.s can't write empty bucketi N( R R R t writeR R t dumpR
R ( R R ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyt write_bytecodeK s
c C s | j t | � � d S( s Load bytecode from a string.N( R R ( R t string( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyt bytecode_from_stringS s c C s t � } | j | � | j � S( s Return the bytecode as string.( R R t getvalue( R t out( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyt bytecode_to_stringW s
( t __name__t
__module__t __doc__R R R R R! R$ ( ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyR
% s t
BytecodeCachec B sP e Z d Z d � Z d � Z d � Z d d � Z d � Z d � Z d � Z
RS( s� To implement your own bytecode cache you have to subclass this class
and override :meth:`load_bytecode` and :meth:`dump_bytecode`. Both of
these methods are passed a :class:`~jinja2.bccache.Bucket`.
A very basic bytecode cache that saves the bytecode on the file system::
from os import path
class MyCache(BytecodeCache):
def __init__(self, directory):
self.directory = directory
def load_bytecode(self, bucket):
filename = path.join(self.directory, bucket.key)
if path.exists(filename):
with open(filename, 'rb') as f:
bucket.load_bytecode(f)
def dump_bytecode(self, bucket):
filename = path.join(self.directory, bucket.key)
with open(filename, 'wb') as f:
bucket.write_bytecode(f)
A more advanced version of a filesystem based bytecode cache is part of
Jinja.
c C s
t � � d S( s� Subclasses have to override this method to load bytecode into a
bucket. If they are not able to find code in the cache for the
bucket, it must not do anything.
N( t NotImplementedError( R t bucket( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyR { s c C s
t � � d S( s� Subclasses have to override this method to write the bytecode
from a bucket back to the cache. If it unable to do so it must not
fail silently but raise an exception.
N( R) ( R R* ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyt
dump_bytecode� s c C s d S( s� Clears the cache. This method is not used by Jinja but should be
implemented to allow applications to clear the bytecode cache used
by a particular environment.
N( ( R ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyt clear� s c C sf t | j d � � } | d k r\ d | } t | t � rL | j d � } n | j | � n | j � S( s3 Returns the unique hash key for this template name.s utf-8t |N( R t encodeR t
isinstanceR t updatet hexdigest( R t namet filenamet hash( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyt
get_cache_key� s
c C s t | j d � � j � S( s" Returns a checksum for the source.s utf-8( R R. R1 ( R t source( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyt get_source_checksum� s c C sD | j | | � } | j | � } t | | | � } | j | � | S( sw Return a cache bucket for the given template. All arguments are
mandatory but filename may be `None`.
( R5 R7 R
R ( R R R2 R3 R6 R R
R* ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyt
get_bucket� s
c C s | j | � d S( s Put the bucket into the cache.N( R+ ( R R* ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyt
set_bucket� s N( R% R& R' R R+ R, R R5 R7 R8 R9 ( ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyR( ^ s
t FileSystemBytecodeCachec B sJ e Z d Z d d d � Z d � Z d � Z d � Z d � Z d � Z RS( s� A bytecode cache that stores bytecode on the filesystem. It accepts
two arguments: The directory where the cache items are stored and a
pattern string that is used to build the filename.
If no directory is specified a default cache directory is selected. On
Windows the user's temp directory is used, on UNIX systems a directory
is created for the user in the system temp directory.
The pattern can be used to have multiple separate caches operate on the
same directory. The default pattern is ``'__jinja2_%s.cache'``. ``%s``
is replaced with the cache key.
>>> bcc = FileSystemBytecodeCache('/tmp/jinja_cache', '%s.cache')
This bytecode cache supports clearing of the cache using the clear method.
s __jinja2_%s.cachec C s1 | d k r | j � } n | | _ | | _ d S( N( R t _get_default_cache_dirt directoryt pattern( R R< R= ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyR � s c C s� d � } t j � } t j d k r( | St t d � sA | � n d t j � } t j j | | � } y t j | t j
� Wn+ t k
r� } | j t j
k r� � q� n Xys t j | t j
� t j | � } | j t j � k st j | j � st j | j � t j
k r | � n Wn+ t k
rK} | j t j
k rL� qLn Xt j | � } | j t j � k s�t j | j � s�t j | j � t j
k r�| � n | S( Nc S s t d � � d S( NsJ Cannot determine safe temp directory. You need to explicitly provide one.( t RuntimeError( ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyt _unsafe_dir� s t ntt getuids _jinja2-cache-%d( t tempfilet
gettempdirt osR2 t hasattrRA R t joint mkdirt statt S_IRWXUt OSErrort errnot EEXISTt chmodt lstatt st_uidt S_ISDIRt st_modet S_IMODE( R R? t tmpdirt dirnamet
actual_dirt et actual_dir_stat( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyR; � s:
c C s t j | j | j | j � S( N( R RF R< R= R ( R R* ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyt _get_cache_filename� s c C sJ t | j | � d � } | d k rF z | j | � Wd | j � Xn d S( Nt rb( R RX R R t close( R R* R ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyR � s
c C s; t | j | � d � } z | j | � Wd | j � Xd S( Nt wb( t openRX R RZ ( R R* R ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyR+ � s c C sx d d l m } t j t | j � | j d � } x? | D]7 } y | t j | j | � � Wq9 t k
ro q9 Xq9 Wd S( Ni����( t removet *(
RD R] t fnmatcht filterR R< R= R RF RJ ( R R] t filesR3 ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyR, s "
N(
R% R& R' R R R; RX R R+ R, ( ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyR: � s / t MemcachedBytecodeCachec B s2 e Z d Z d d e d � Z d � Z d � Z RS( s+ This class implements a bytecode cache that uses a memcache cache for
storing the information. It does not enforce a specific memcache library
(tummy's memcache or cmemcache) but will accept any class that provides
the minimal interface required.
Libraries compatible with this class:
- `cachelib <https://github.com/pallets/cachelib>`_
- `python-memcached <https://pypi.org/project/python-memcached/>`_
(Unfortunately the django cache interface is not compatible because it
does not support storing binary data, only unicode. You can however pass
the underlying cache client to the bytecode cache which is available
as `django.core.cache.cache._client`.)
The minimal interface for the client passed to the constructor is this:
.. class:: MinimalClientInterface
.. method:: set(key, value[, timeout])
Stores the bytecode in the cache. `value` is a string and
`timeout` the timeout of the key. If timeout is not provided
a default timeout or no timeout should be assumed, if it's
provided it's an integer with the number of seconds the cache
item should exist.
.. method:: get(key)
Returns the value for the cache key. If the item does not
exist in the cache the return value must be `None`.
The other arguments to the constructor are the prefix for all keys that
is added before the actual cache key and the timeout for the bytecode in
the cache system. We recommend a high (or no) timeout.
This bytecode cache does not support clearing of used items in the cache.
The clear method is a no-operation function.
.. versionadded:: 2.7
Added support for ignoring memcache errors through the
`ignore_memcache_errors` parameter.
s jinja2/bytecode/c C s( | | _ | | _ | | _ | | _ d S( N( t clientt prefixt timeoutt ignore_memcache_errors( R Rc Rd Re Rf ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyR @ s c C si y | j j | j | j � } Wn& t k
rH | j s? � n d } n X| d k re | j | � n d S( N( Rc t getRd R t ExceptionRf R R! ( R R* R ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyR L s
c C sy | j | j | j � f } | j d k r> | | j f 7} n y | j j | � Wn t k
rt | j su � qu n Xd S( N( Rd R R$ Re R Rc t setRh Rf ( R R* t args( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyR+ V s
N( R% R& R' R t TrueR R R+ ( ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyRb s +
( R' RK R_ RD RH t sysRB t hashlibR R R t _compatR R R R R t utilsR t
bc_versiont dumpst version_infoR t objectR
R( R: Rb ( ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/bccache.pyt <module> s* <9Ng