|
Server : Apache System : Linux iad1-shared-b8-43 6.6.49-grsec-jammy+ #10 SMP Thu Sep 12 23:23:08 UTC 2024 x86_64 User : dh_edsupp ( 6597262) PHP Version : 8.2.26 Disable Function : NONE Directory : /lib/python3/dist-packages/trac/__pycache__/ |
Upload File : |
o
�k�`�' � @ s� d dl Z d dlmZ d dlmZmZ ddgZi Zdd� ZG dd � d e �Z
G d
d � d e
�Z G d d
� d
e
�Z ddd�Z
G dd� de�ZdS )� N)� Component)� ThreadLocal� threading� CacheManager�cachedc C sN | r
t | d �d> nd}| D ] }d| d@ t |�A }q|t| �N }| t|< |S )z(Return a hash of the given property key.r � iCB i���)�ord�len�
_id_to_key)�s�result�c� r �,/usr/lib/python3/dist-packages/trac/cache.py� key_to_id s r c @ � e Zd ZdZdd� Zdd� ZdS )�CachedPropertyBasez]Base class for cached property descriptors.
:since 1.0.2: inherits from `property`.
c C s || _ t�| |� d S �N)� retriever� functools�update_wrapper)�selfr r r r �__init__* s zCachedPropertyBase.__init__c C s@ | j j}|�� D ]}|j�|�| u r|} nqd|j|j|f S )Nz%s.%s.%s)r �__name__�mro�__dict__�get�
__module__)r �cls�attr�baser r r �make_key. s �zCachedPropertyBase.make_keyN)r r � __qualname__�__doc__r r! r r r r r $ s r c @ r )�CachedSingletonPropertya� Cached property descriptor for classes behaving as singletons
in the scope of one `~trac.env.Environment` instance.
This means there will be no more than one cache to monitor in the
database for this kind of cache. Therefore, using only "static"
information for the key is enough. For the same reason it is also
safe to store the corresponding id as a property of the descriptor
instance.
c C sT |d u r| S z| j }W n ty t| �|�� }| _ Y nw t|j��|| j|�S r )�id�AttributeErrorr r! r �envr r �r �instance�ownerr% r r r �__get__B s
�z CachedSingletonProperty.__get__c C sH z| j }W n ty t| �|j�� }| _ Y nw t|j��|� d S r )r% r& r r! � __class__r r' �
invalidate�r r) r% r r r �
__delete__K s
�z"CachedSingletonProperty.__delete__N)r r r" r# r+ r/ r r r r r$ 7 s
r$ c s0 e Zd ZdZ� fdd�Zdd� Zdd� Z� ZS )�CachedPropertya+ Cached property descriptor for classes having potentially
multiple instances associated to a single `~trac.env.Environment`
instance.
As we'll have potentially many different caches to monitor for this
kind of cache, the key needs to be augmented by a string unique to
each instance of the owner class. As the resulting id will be
different for each instance of the owner class, we can't store it
as a property of the descriptor class, so we store it back in the
attribute used for augmenting the key (``key_attr``).
c s t � �|� || _d S r )�superr �key_attr)r r r2 �r, r r r ` s
zCachedProperty.__init__c C s\ |d u r| S t || j�}t|t�r#t| �|�d | �}t|| j|� t|j�� || j
|�S �N�:) �getattrr2 �
isinstance�strr r! �setattrr r' r r r( r r r r+ d s
zCachedProperty.__get__c C sP t || j�}t|t�r t| �|j�d | �}t|| j|� t|j ��
|� d S r4 ) r6 r2 r7 r8 r r! r, r9 r r' r- r. r r r r/ m s
zCachedProperty.__delete__)r r r" r# r r+ r/ �
__classcell__r r r3 r r0 S s
r0 c s" t � d�r t� �S � fdd�}|S )a� Method decorator creating a cached attribute from a data
retrieval method.
Accessing the cached attribute gives back the cached value. The
data retrieval method is transparently called by the
`CacheManager` on first use after the program start or after the
cache has been invalidated. Invalidating the cache for this value
is done by ``del``\ eting the attribute.
Note that the cache validity is maintained using the `cache` table
in the database. Cache invalidation is performed within a
transaction block, and can be nested within another transaction
block.
When the decorator is used in a class for which instances behave
as singletons within the scope of a given `~trac.env.Environment`
(typically `~trac.core.Component` classes), the key used to
identify the attribute in the database is constructed from the
names of the containing module, class and retriever method::
class WikiSystem(Component):
@cached
def pages(self):
return {name for name, in self.env.db_query(
"SELECT DISTINCT name FROM wiki")}
Otherwise, when the decorator is used in non-"singleton" objects,
a string specifying the name of an attribute containing a string
unique to the instance must be passed to the decorator. This value
will be appended to the key constructed from module, class and
method name::
class SomeClass(object):
def __init__(self, env, name):
self.env = env
self.name = name
self._metadata_id = name
@cached('_metadata_id')
def metadata(self):
...
Note that in this case the key attribute is overwritten with a
hash of the key on first access, so it should not be used for any
other purpose.
In either case, this decorator requires that the object on which
it is used has an ``env`` attribute containing the application
`~trac.env.Environment`.
.. versionchanged:: 1.0
The data retrieval method used to be called with a single
argument ``db`` containing a reference to a database
connection. This is the same connection that can be retrieved
via the normal `~trac.env.Environment.db_query` or
`~trac.env.Environment.db_transaction`, so this is no longer
needed and is not supported.
�__call__c s
t | � �S r )r0 )�fn��
fn_or_attrr r � decorator� s
zcached.<locals>.decorator)�hasattrr$ )r> r? r r= r r u s
; c @ s4 e Zd ZdZdZdd� Zdd� Zdd� Zd d
� Zd S ) r zCache manager.Tc C s" i | _ td d d�| _t�� | _d S )N)�meta�cache)�_cacher �_localr �RLock�_lock�r r r r r � s zCacheManager.__init__c C s d | j _| j _dS )z!Reset per-request cache metadata.N)rD rA rB rG r r r �reset_metadata� s zCacheManager.reset_metadatac
C s� | j j}| j j}|du r#| j�d�}t|� | j _}| j�� | j _}|�|d�}z|| \}} | |kr7|W S W n t yA Y nw | jj��}
| j
�s z"| j| \}} ||< | |krl|W W d � W d � S W n t yx d} Y nw |
d|f�D ]\} nd}|| kr�|W d � W d � S ||�}||f ||< | j|< |||< |W d � W d � S 1 s�w Y W d � dS 1 s�w Y dS )z*Get cached or fresh data for the given id.Nz SELECT id, generation FROM cache����(SELECT generation FROM cache WHERE id=%s) rD rA rB r' �db_query�dictrC �copyr �KeyErrorrF ) r r% r r) �
local_meta� local_cacherA �
db_generation�data�
generation�dbr r r r � sX � �
�� �
�����"�zCacheManager.getc C s� | j j�V}| j�: |d|f� |d|f�s!|d|dt�|d�f� | j�|d� z| jj|= W n t t
fy: Y nw W d � n1 sEw Y W d � dS W d � dS 1 s]w Y dS )z(Invalidate cached data for the given id.z4UPDATE cache SET generation=generation+1 WHERE id=%srJ z%INSERT INTO cache VALUES (%s, %s, %s)r z <unknown>N) r' �db_transactionrF r
r rC �poprD rB rN � TypeError)r r% rT r r r r- � s(
� ��� ��"�zCacheManager.invalidateN) r r r" r# �requiredr rH r r- r r r r r � s 0r )r � trac.corer �trac.util.concurrencyr r �__all__r
r �propertyr r$ r0 r r r r r r �<module> s
"B