/usr/lib/python3/dist-packages/twisted/persisted/__pycache__
Edit: /usr/lib/python3/dist-packages/twisted/persisted/__pycache__/dirdbm.cpython-310.pyc (10032B)
o
bi' @ s d Z ddlZddlZddlZddlZddlmZ ze W n ey' e ZY nw G dd dZ
G dd de
Z d dd Z g d
Z dS ) a
DBM-style interface to a directory.
Each key is stored as a single file. This is not expected to be very fast or
efficient, but it's good for easy debugging.
DirDBMs are *not* thread-safe, they should only be accessed by one thread at
a time.
No files should be placed in the working directory of a DirDBM save those
created by the DirDBM itself!
Maintainer: Itamar Shtull-Trauring
N)FilePathc @ s e Zd ZdZdd Zdd Zdd Zdd Zd
d Zd d
Z dd Z
dd Z dd Z dd Z
dd Zdd Zdd Zd d Zd-d d Zd!d" Zd#d$ Zd%d& Zd'd( Zd)d* Zd+d, Zd S ).DirDBMz
A directory with a DBM interface.
This class presents a hash-like interface to a directory of small,
flat files. It can only use strings as keys or values.
c C s t j|| _t|| _| j s| j dS t| j djD ]}t
| q"t| j dj}|D ]}|dd }t j |rJt
| q6t || q6dS )zb
@type name: str
@param name: Base path to use for the directory storage.
z*.newz*.rplN)
ospathabspathdnamer
_dnamePathisdircreateDirectoryglobchildremoveexistsrename)selfnamef replacementsold r :/usr/lib/python3/dist-packages/twisted/persisted/dirdbm.py__init__, s
zDirDBM.__init__c C s t |ddddS )z?
Encode a key so it can be used as a filename.
_ / -)base64 encodebytesreplacer kr r r _encodeH s zDirDBM._encodec C s t |ddddS )z3
Decode a filename to get the key.
r r r r )r decodebytesr r r r r _decodeO zDirDBM._decodec C s: t |jd
}| }W d |S 1 sw Y |S )z
Read in the contents of a file.
Override in subclasses to e.g. provide transparently encrypted dirdbm.
rbN)_openr read)r r r sr r r _readFileU s
zDirDBM._readFilec C sD t |jd}|| | W d dS 1 sw Y dS )zw
Write data to a file.
Override in subclasses to e.g. provide transparently encrypted dirdbm.
wbN)r' r writeflush)r r datar r r r
_writeFile_ s
"zDirDBM._writeFilec C s t | j S )zF
@return: The number of key/value pairs in this Shelf
)lenr listdirr r r r __len__i s zDirDBM.__len__c C s t |tks
tdt |tkstd| |}| j|}| r)|d}n|d}z| || W n t yB |
w | rK|
| | dS )z
C{dirdbm[k] = v}
Create or modify a textfile in this directory
@type k: bytes
@param k: key to set
@type v: bytes
@param v: value to associate with C{k}
DirDBM key must be byteszDirDBM value must be bytesz.rplz.newN) typebytes TypeErrorr" r r
r siblingExtensionr/
BaseExceptionr moveTo)r r! vr newr r r __setitem__o s$
zDirDBM.__setitem__c C sJ t |tks
td| j| |}z| |W S ty$ t|w )a
C{dirdbm[k]}
Get the contents of a file in this directory as a string.
@type k: bytes
@param k: key to lookup
@return: The value associated with C{k}
@raise KeyError: Raised when there is no such key
r4 ) r5 r6 r7 r r
r" r* OSErrorKeyError)r r! r r r r __getitem__ s zDirDBM.__getitem__c C sR t |tks
td| |}z | j| W dS ty( t| |w )z
C{del dirdbm[foo]}
Delete a file in this directory.
@type k: bytes
@param k: key to delete
@raise KeyError: Raised when there is no such key
r4 N)
r5 r6 r7 r" r r
r r> r? r$ r r r r __delitem__ s
zDirDBM.__delitem__c C s t t| j| j S )z9
@return: a L{list} of filenames (keys).
)listmapr$ r asBytesModer1 r2 r r r keys r% z DirDBM.keysc C s( g }| }|D ] }|| | q|S )z?
@return: a L{list} of file-contents (values).
rE append)r valsrE keyr r r values s
z
DirDBM.valuesc C s, g }| }|D ] }||| | f q|S )zL
@return: a L{list} of 2-tuples containing key/value pairs.
rF )r itemsrE rI r r r rK s
z DirDBM.itemsc C s. t |tks
td| |}| j| S )z
@type key: bytes
@param key: The key to test
@return: A true value if this dirdbm has the specified key, a false
value otherwise.
r4 )r5 r6 r7 r" r r
isfiler rI r r r has_key s
zDirDBM.has_keyc C s || vr
|| |< |S | | S )z
@type key: bytes
@param key: The key to lookup
@param value: The value to associate with key if key is not already
associated with a value.
r )r rI valuer r r
setdefault s zDirDBM.setdefaultNc C s || v r| | S |S )z
@type key: bytes
@param key: The key to lookup
@param default: The value to return if the given key does not exist
@return: The value associated with C{key} or C{default} if not
L{DirDBM.has_key(key)}
r )r rI defaultr r r get s
z
DirDBM.getc C s
| |S )z)
@see: L{DirDBM.has_key}
)rN rM r r r __contains__ s
zDirDBM.__contains__c C s | D ]\}}|| |< qdS )z
Add all the key/value pairs in L{dict} to this dirdbm. Any conflicting
keys will be overwritten with the values from L{dict}.
@type dict: mapping
@param dict: A mapping of key/value pairs to add to this dirdbm.
N)rK )r dictrI valr r r update s
z
DirDBM.updatec C sH t |}|| jks J | |j}| | D ]}| | ||< q|S )a<
Copy the contents of this dirdbm to the dirdbm at C{path}.
@type path: L{str}
@param path: The path of the dirdbm to copy to. If a dirdbm
exists at the destination path, it is cleared first.
@rtype: C{DirDBM}
@return: The dirdbm this dirdbm was copied to.
)r r __class__r clearrE )r r dr! r r r copyTo
s z
DirDBM.copyToc C s | D ]}| |= qdS )z<
Delete all key/value pairs in this dirdbm.
N)rE r r r r rX s z DirDBM.clearc C s dS )zL
Close this dbm: no-op, for dbm-style interface compliance.
Nr r2 r r r close% s z DirDBM.closec C s> t |tks
td| j| |}| r| S t|)z
Returns modification time of an entry.
@return: Last modification date (seconds since epoch) of entry C{key}
@raise KeyError: Raised when there is no such key
r4 ) r5 r6 r7 r r
r" rL getModificationTimer? )r rI r r r r r\ * s zDirDBM.getModificationTime)N)__name__
__module__ __qualname____doc__r r" r$ r* r/ r3 r= r@ rA rE rJ rK rN rP rR rS rV rZ rX r[ r\ r r r r r $ s.
"
r c @ s e Zd ZdZdd Zdd ZdS )Shelfz
A directory with a DBM shelf interface.
This class presents a hash-like interface to a directory of small,
flat files. Keys must be strings, but values can be any given object.
c C s t |}t| || dS )z
C{shelf[foo] = bar}
Create or modify a textfile in this directory.
@type k: str
@param k: The key to set
@param v: The value to associate with C{key}
N)pickledumpsr r= )r r! r; r r r r= B s
zShelf.__setitem__c C s t t| |S )a
C{dirdbm[foo]}
Get and unpickle the contents of a file in this directory.
@type k: bytes
@param k: The key to lookup
@return: The value associated with the given key
@raise KeyError: Raised if the given key does not exist
)rb loadsr r@ r r r r r@ O s zShelf.__getitem__N)r] r^ r_ r` r= r@ r r r r ra : s
ra c C s t | S )z
This is for 'anydbm' compatibility.
@param file: The parameter to pass to the DirDBM constructor.
@param flag: ignored
@param mode: ignored
)r )fileflagmoder r r open] s rh )rh r ra )NN)
r` r r r rb twisted.python.filepathr r' NameErrorrh r ra __all__r r r r
s"
#