177 lines
19 KiB
Plaintext
177 lines
19 KiB
Plaintext
|
Ë
|
|||
|
|
LÀjí6 ã ó¶ — d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z
|
|||
|
|
ddl m Z ddl
|
|||
|
|
mZ ddlmZ e
|
|||
|
|
j" r ddlZddlmZ G d„ d ej, « Zd
|
|||
|
|
Zd ej2 ed « z ej2 ej4 d d
|
|||
|
|
z ej4 d z d « z Z G d„ d« Z G d„ d« Z G d„ de « Z G d„ de « Z y)a 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.
|
|||
|
|
é N)Úsha1)ÚBytesIO)ÚCodeTypeé )Ú Environmentc óR — e Zd Zdedefd„Z ddededej e ddfd„Z y) Ú_MemcachedClientÚkeyÚreturnc ó — y ©N© )Úselfr
|
|||
|
|
s úQ/home/antigravity/intellecton/venv/lib/python3.12/site-packages/jinja2/bccache.pyÚgetz_MemcachedClient.get ó � ó NÚvalueÚtimeoutc ó — y r
|
|||
|
|
r )r r
|
|||
|
|
r r s r Úsetz_MemcachedClient.set s € àr r
|
|||
|
|
)
|
|||
|
|
Ú__name__Ú
|
|||
|
|
__module__Ú __qualname__ÚstrÚbytesr ÚtÚOptionalÚintr r r r r r sC „ Ø-˜3Ð- 5Ó-ð FJñ Øð Ø#(ð Ø34·:±:¸c±?ð à
|
|||
|
|
ô r r é s j2é é c óš — e Zd ZdZdddededdfd„Zdd „Zd
|
|||
|
|
ej ddfd „Z d
|
|||
|
|
ej e ddfd „Z d
|
|||
|
|
e ddfd„Z
|
|||
|
|
de fd„Zy)ÚBucketau 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.
|
|||
|
|
Ú environmentr r
|
|||
|
|
Úchecksumr Nc óN — || _ || _ || _ | j « y r
|
|||
|
|
)r% r
|
|||
|
|
r& Úreset)r r% r
|
|||
|
|
r& s r Ú__init__zBucket.__init__7 s! € Ø&ˆÔ؈ŒØ ˆŒ
|
|||
|
|
Ø �
|
|||
|
|
‰
|
|||
|
|
� r c ó — d| _ y)z)Resets the bucket (unloads the bytecode).N)Úcode©r s r r( z Bucket.reset= s € à*.ˆ� r Úfc óh — |j t t « « }|t k7 r| j « yt j
|
|||
|
|
|« }| j |k7 r| j « y t j
|
|||
|
|
|« | _ y# t t t f$ r | j « Y yw xY w)z/Loads bytecode from a file or file like object.N) ÚreadÚlenÚbc_magicr( ÚpickleÚloadr& Úmarshalr+ ÚEOFErrorÚ
|
|||
|
|
ValueErrorÚ TypeError)r r- Úmagicr& s r Ú
|
|||
|
|
load_bytecodezBucket.load_bytecodeA s… € ð —‘”sœ8“}Ó%ˆØ ”HÒ Ø �J‰JŒLØ ä—;‘;˜q“>ˆØ �=‰=˜HÒ $Ø �J‰JŒLØ ð Ü Ÿ ™ Q›ˆD�IøÜœ*¤iÐ0ò Ø �J‰JŒLÙ ð ús Á/B
|
|||
|
|
Â
|
|||
|
|
$B1Â0B1c óÞ — | j € t d« ‚|j t « t j
|
|||
|
|
| j |d« t j
|
|||
|
|
| j |« y)z;Dump the bytecode into the file or file like object passed.Nzcan't write empty bucketr! )r+ r7 Úwriter1 r2 Údumpr& r4 )r r- s r Úwrite_bytecodezBucket.write_bytecodeT sJ € à �9‰9Ð ÜÐ 6Ó7Ð 7Ø �‰”ÔÜ� ‰ �D—M‘M 1 aÔ(Ü� ‰ �T—Y‘Y Õ"r Ústringc ó8 — | j t |« « y)zLoad bytecode from bytes.N)r9 r )r r> s r Úbytecode_from_stringzBucket.bytecode_from_string\ s € à ×Ñœ7 6›?Õ+r c óX — t « }| j |« |j « S )z Return the bytecode as bytes.)r r= Úgetvalue)r Úouts r Úbytecode_to_stringzBucket.bytecode_to_string` s# € ä‹iˆØ ×јCÔ Ø�|‰|‹~Ð r ©r N)r r r Ú__doc__r r) r( r ÚBinaryIOr9 ÚIOr r= r@ rD r r r r$ r$ . s~ „ ñð Mð ¸ð Àsð Ètó ó /ð˜qŸz™zð ¨dó ð&# §¡ U¡ ð #°ó #ð,¨5ð ,°Tó ,ð Eô r r$ c
|
|||
|
|
óÚ — e Zd ZdZdeddfd„Zdeddfd„Zdd„Z dded e j e j e defd
|
|||
|
|
„Z d edefd „Z
|
|||
|
|
d
|
|||
|
|
dded e j e d edef
|
|||
|
|
d„Zdeddfd„Zy)Ú
|
|||
|
|
BytecodeCacheaÞ 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.
|
|||
|
|
Úbucketr Nc ó — t « ‚)z¹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.
|
|||
|
|
©ÚNotImplementedError©r rK s r r9 zBytecodeCache.load_bytecode„ ó
|
|||
|
|
€ ô
|
|||
|
|
"Ó#Ð#r c ó — t « ‚)zÀ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.
|
|||
|
|
rM rO s r Ú
|
|||
|
|
dump_bytecodezBytecodeCache.dump_bytecode‹ rP r c ó — y)zº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.
|
|||
|
|
Nr r, s r ÚclearzBytecodeCache.clear’ r r ÚnameÚfilenamec óž — t |j d« « }|�"|j d|› �j « « |j « S )z3Returns the unique hash key for this template name.úutf-8ú|)r ÚencodeÚupdateÚ hexdigest)r rU rV Úhashs r Ú
|
|||
|
|
get_cache_keyzBytecodeCache.get_cache_key˜ sE € ô �D—K‘K Ó(Ó)ˆà Ð Ø �K‰K˜!˜H˜:˜×-Ñ-Ó/Ô 0à�~‰~Ó Ð r Úsourcec óR — t |j d« « j « S )z"Returns a checksum for the source.rX )r rZ r\ )r r_ s r Úget_source_checksumz!BytecodeCache.get_source_checksum£ s € ä�F—M‘M 'Ó*Ó+×5Ñ5Ó7Ð7r r% r c óˆ — | j ||« }| j |« }t |||« }| j |« |S )zwReturn a cache bucket for the given template. All arguments are
|
|||
|
|
mandatory but filename may be `None`.
|
|||
|
|
)r^ ra r$ r9 )r r% rU rV r_ r
|
|||
|
|
r& rK s r Ú
|
|||
|
|
get_bucketzBytecodeCache.get_bucket§ sG € ð × Ñ xÓ0ˆØ×+Ñ+¨FÓ3ˆÜ˜ S¨(Ó3ˆØ ×ј6Ô"؈
|
|||
|
|
r c ó& — | j |« y)z Put the bucket into the cache.N)rR rO s r Ú
|
|||
|
|
set_bucketzBytecodeCache.set_bucket· s € à ×ј6Õ"r rE r
|
|||
|
|
)r r r rF r$ r9 rR rT r r r ÚUnionr^ ra rc re r r r rJ rJ g sÉ „ ñð8$ Fð $¨tó $ð$ Fð $¨tó $ó ð ?Cñ Øð Ø#$§:¡:¨a¯g©g°c©lÑ#;ð à ó ð8¨#ð 8°#ó 8ðà"ðð ðð —*‘*˜S‘/ð ð
|
|||
|
|
ð ð
|
|||
|
|
ó
|
|||
|
|
ð # ð #¨Dô #r rJ c ó† — e Zd ZdZ d
|
|||
|
|
dej
|
|||
|
|
e deddfd„Zdefd„Zde defd „Z
|
|||
|
|
de ddfd
|
|||
|
|
„Z de ddfd „Z dd „Z
|
|||
|
|
y)ÚFileSystemBytecodeCacheaï 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.
|
|||
|
|
NÚ directoryÚpatternr c óD — |€| j « }|| _ || _ y r
|
|||
|
|
)Ú_get_default_cache_dirri rj )r ri rj s r r) z FileSystemBytecodeCache.__init__Î s& € ð Ð Ø ×3Ñ3Ó5ˆIØ"ˆŒØ ˆ� r c ó’ — dd„}t j « }t j dk( r|S t t d« s |« dt j
|
|||
|
|
« › �}t j j ||« } t j |t j « t j |t j « t j |« }|j t j
|
|||
|
|
« k7 sOt j" |j$ « r0t j& |j$ « t j k7 r |« t j |« }|j t j
|
|||
|
|
« k7 sOt j" |j$ « r0t j& |j$ « t j k7 r |« |S # t $ r)}|j t j k7 r‚ Y d }~�Œld }~ww xY w# t $ r(}|j t j k7 r‚ Y d }~Œïd }~ww xY w)Nc ó — t d« ‚)NzJCannot determine safe temp directory. You need to explicitly provide one.)Ú RuntimeErrorr r r Ú _unsafe_dirzCFileSystemBytecodeCache._get_default_cache_dir.<locals>._unsafe_dir× s € Ü ð2óð
|
|||
|
|
r ÚntÚgetuidz_jinja2-cache-)r z te.NoReturn)ÚtempfileÚ
|
|||
|
|
gettempdirÚosrU Úhasattrrr ÚpathÚjoinÚmkdirÚstatÚS_IRWXUÚOSErrorÚerrnoÚEEXISTÚchmodÚlstatÚst_uidÚS_ISDIRÚst_modeÚS_IMODE)r rp ÚtmpdirÚdirnameÚ
|
|||
|
|
actual_dirÚeÚactual_dir_stats r rl z.FileSystemBytecodeCache._get_default_cache_dirÖ s� € ó ô ×$Ñ$Ó&ˆô �7‰7�dŠ?؈MÜ”r˜8Ô$Ù ŒMà"¤2§9¡9£; -Ð0ˆÜ—W‘W—\‘\ &¨'Ó2ˆ
|
|||
|
|
ð Ü �H‰H�Z¤§ ¡ Ô .ð Ü �H‰H�Z¤§ ¡ Ô .Ü Ÿh™h zÓ 2ˆOà ×&Ñ&¬"¯)©)«+Ò5Ü—|‘| O×$;Ñ$;Ô<Ü—<‘< × 7Ñ 7Ó8¼D¿L¹LÒHá”
|
|||
|
|
ô
|
|||
|
|
Ÿ(™( :Ó.ˆà × "Ñ "¤b§i¡i£kÒ 1Ü—<‘< × 7Ñ 7Ô8Ü�|‰|˜O× 3Ñ 3Ó4¼¿ ¹ ÒDá ŒMàÐøô1 ò Ø�w‰wœ%Ÿ,™,Ò&Øõ 'ûð ûô ò Ø�w‰wœ%Ÿ,™,Ò&Øô 'ûð ús1 Á=$G Â"B0H Ç HÇ) H
|
|||
|
|
È
|
|||
|
|
HÈ IÈ IÉIrK c ó† — t j j | j | j |j
|
|||
|
|
fz « S r
|
|||
|
|
)ru rw rx ri rj r
|
|||
|
|
rO s r Ú_get_cache_filenamez+FileSystemBytecodeCache._get_cache_filename s* € Ü�w‰w�|‰|˜DŸN™N¨D¯L©L¸F¿J¹J¸=Ñ,HÓIÐIr c óÄ — | j |« } t |d« }|5 |j |« d d d « y # t t t f$ r Y y w xY w# 1 sw Y y xY w)NÚrb)r‹ ÚopenÚFileNotFoundErrorÚIsADirectoryErrorÚPermissionErrorr9 )r rK rV r- s r r9 z%FileSystemBytecodeCache.load_bytecode sn € Ø×+Ñ+¨FÓ3ˆð Ü�X˜tÓ$ˆAð ñ $Ø × Ñ Ô #÷ $ð $øô "Ô#4´oÐFò ñ
|
|||
|
|
ð ú÷
|
|||
|
|
$ð $ús “ < ¡A¼AÁAÁA c óæ ‡— | j |« }t j dt j j |« t j j
|
|||
|
|
|« dd¬« Šdˆfd„ } ‰5 |j ‰« d d d « t j ‰j |« y # 1 sw Y Œ+xY w# t $ r |« ‚ w xY w# t $ r
|
|||
|
|
|« Y y t $ r |« ‚ w xY w)NÚwbz.tmpF)ÚmodeÚdirÚprefixÚsuffixÚdeletec ód •— t j ‰ j « y # t $ r Y y w xY wr
|
|||
|
|
)ru ÚremoverU r| )r- s €r Ú
|
|||
|
|
remove_silentz<FileSystemBytecodeCache.dump_bytecode.<locals>.remove_silent$ s, ø€ ð
|
|||
|
|
Ü— ‘ ˜!Ÿ&™&Õ!øÜò
|
|||
|
|
ñ ð
|
|||
|
|
ús ƒ # £ /®/rE ) r‹ rs ÚNamedTemporaryFileru rw r† Úbasenamer= Ú
|
|||
|
|
BaseExceptionÚreplacerU r| )r rK rU r› r- s @r rR z%FileSystemBytecodeCache.dump_bytecode sÔ ø€ ð ×'Ñ'¨Ó/ˆÜ × 'Ñ 'ØÜ—‘—‘ Ó%Ü—7‘7×#Ñ# DÓ)ØØô
|
|||
|
|
ˆõ ð Øñ
|
|||
|
|
)Ø×%Ñ% aÔ(÷
|
|||
|
|
)ð Ü �J‰J�q—v‘v˜tÕ $÷
|
|||
|
|
)ð
|
|||
|
|
)ûä ò Ù ŒOØ ð ûô ò ñ
|
|||
|
|
ŽOÜ ò Ù ŒOØ ð ús6 Á.B8 Á0B,ÂB8 Â C
|
|||
|
|
Â,B5Â1B8 Â8C
|
|||
|
|
Ã
|
|||
|
|
C0Ã C0c ó — ddl m} t j t j | j
|
|||
|
|
« | j dz « }|D ]3 } |t j j | j
|
|||
|
|
|« « Œ5 y # t $ r Y ŒBw xY w)Nr )rš )Ú*)
|
|||
|
|
ru rš ÚfnmatchÚfilterÚlistdirri rj rw rx r| )r rš ÚfilesrV s r rT z FileSystemBytecodeCache.clear= sp € õ ä—‘œrŸz™z¨$¯.©.Ó 9¸4¿<¹<È&Ñ;PÓQˆØ ò ˆHð
|
|||
|
|
Ù”r—w‘w—|‘| D§N¡N°HÓ=Õ>ñ øô ò
|
|||
|
|
Ùð
|
|||
|
|
ús Á
|
|||
|
|
0B Â B Â B )Nz__jinja2_%s.cacherE )r r r rF r r r r) rl r$ r‹ r9 rR rT r r r rh rh ¼ s‚ „ ñð$ ATñ ØŸ™ C™ ð Ø:=ð à
|
|||
|
|
ó ð-¨ó -ð^J¨&ð J°Só Jð
|
|||
|
|
$ Fð
|
|||
|
|
$¨tó
|
|||
|
|
$ð $ Fð $¨tó $ôL r rh c ój — e Zd ZdZ d
|
|||
|
|
dddedej e defd„Z d e
|
|||
|
|
d
|
|||
|
|
dfd „Z d e
|
|||
|
|
d
|
|||
|
|
dfd „Z y)ÚMemcachedBytecodeCachea' 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>`_
|