Vh1)dZddlmZddlZddlZddlZddlZddlmZm Z m Z m Z m Z ddl mZe ddZGdd ZGd d eZdd Zgd Zy)aw A L{DirDBM} is a L{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. L{DirDBM}s 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! ) annotationsN)AnyStrIterableMappingTypeVaroverload)FilePath_T)boundceZdZdZddZddZddZddZddZddZ ddZ dd Z d d Z d!d Z d!d Zd"d Zd#dZd$dZed%dZed&dZd'd(dZd#dZd)dZd*dZd+dZd+dZd,dZy)-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. ctjj||_t ||_|j j s|j jytj|j jdjD]}tj|tj|j jdj}|D]R}|dd}tjj|rtj|=tj||Ty)zJ @param name: Base path to use for the directory storage. z*.newz*.rplN) ospathabspathdnamer _dnamePathisdircreateDirectoryglobchildremoveexistsrename)selfnamef replacementsolds H/home/dcms/DCMS/lib/python3.12/site-packages/twisted/persisted/dirdbm.py__init__zDirDBM.__init__(sWW__T* "4.$$& OO + + -YYt44W=BBC  !  99T__%:%:7%C%H%HIL! &f77>>#&IIaLIIa%  &cltj|jddjddS)z? Encode a key so it can be used as a filename.  _/-)base64 encodebytesreplacerks r!_encodezDirDBM._encodeCs/ !!!$,,UD9AA$MMr#cltj|jddjddS)z3 Decode a filename to get the key. r&r%r(r')r) decodebytesr+r,s r!_decodezDirDBM._decodeJs-!!!))D%"8"@"@t"LMMr#cr|j5}|j}ddd|S#1swYSxYw)z Read in the contents of a file. Override in subclasses to e.g. provide transparently encrypted dirdbm. N)openread)rrrss r! _readFilezDirDBM._readFilePs4 YY[ AA  s,6c|jd5}|j||jdddy#1swYyxYw)zw Write data to a file. Override in subclasses to e.g. provide transparently encrypted dirdbm. wN)r3writeflush)rrdatars r! _writeFilezDirDBM._writeFileZs: YYs^ q GGDM GGI   s "=AcHt|jjS)zF @return: The number of key/value pairs in this Shelf )lenrlistdirrs r!__len__zDirDBM.__len__ds4??**,--r#ct|tk(s tdt|tk(s td|j|}|jj |}|j r|jd}n|jd} |j|||j r|j|j|y#t$r|jwxYw)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.rrrsiblingExtensionr<rmoveTo BaseException)rr-vr news r! __setitem__zDirDBM.__setitem__jsAw%67 7Aw%89 9 LLOoo##A& ::<&&v.C&&v.C  OOC # zz| JJsO   JJL  s CC:ct|tk(s td|jj |j |} |j |S#t$r t|wxYw)z C{dirdbm[k]} Get the contents of a file in this directory as a string. @param k: key to lookup @return: The value associated with C{k} @raise KeyError: Raised when there is no such key rC) rDrErFrrr.r6OSErrorKeyError)rr-rs r! __getitem__zDirDBM.__getitem__seAw%67 7$$T\\!_5 >>$' ' 1+  s AA/ct|tk(s td|j|} |jj |j y#t$rt|j|wxYw)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 rCN) rDrErFr.rrrrNrOr1r,s r! __delitem__zDirDBM.__delitem__skAw%67 7 LLO , OO ! !! $ + + - ,4<<?+ + ,s )A$A>ctt|j|jj j S)z9 @return: a L{list} of filenames (keys). )listmapr1r asBytesModer?r@s r!keysz DirDBM.keyss0C doo&A&A&C&K&K&MNOOr#c`g}|j}|D]}|j|||S)z? @return: a L{list} of file-contents (values). rWappend)rvalsrWkeys r!valuesz DirDBM.valuess8yy{ #C KKS " # r#cdg}|j}|D]}|j|||f|S)zL @return: a L{list} of 2-tuples containing key/value pairs. rY)ritemsrWr\s r!r_z DirDBM.itemss=yy{ +C LL#tCy) * + r#ct|tk(s td|j|}|jj |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. rC)rDrErFr.rrisfilerr\s r!has_keyzDirDBM.has_keysHCyE!67 7ll3$$S)0022r#c"||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. )rr\values r! setdefaultzDirDBM.setdefaults# d?DILCyr#cyNrerbs r!getz DirDBM.get r#cyrirerr\defaults r!rjz DirDBM.getrkr#Nc||vr||S|S)z @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)} rerms r!rjz DirDBM.gets $;9 Nr#c$|j|S)z) @see: L{DirDBM.has_key} )rcrbs r! __contains__zDirDBM.__contains__s||C  r#c>|jD] \}}|||< y)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}. @param dict: A mapping of key/value pairs to add to this dirdbm. N)r_)rotherr\vals r!updatez DirDBM.updates&  HCDI r#ct|}||jk7sJ|j|j}|j |j D] }||||< |S)a! Copy the contents of this dirdbm to the dirdbm at C{path}. @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__rclearrW)rrfpathdr-s r!copyToz DirDBM.copyTo sa''' NN5:: &   A7AaD r#c4|jD]}||=y)z< Delete all key/value pairs in this dirdbm. N)rWr,s r!rxz DirDBM.clears  AQ r#cy)zL Close this dbm: no-op, for dbm-style interface compliance. Nrer@s r!closez DirDBM.close$sr#ct|tk(s td|jj |j |}|j r|jSt|)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 rC) rDrErFrrr.ragetModificationTimerO)rr\rs r!rzDirDBM.getModificationTime)s[CyE!67 7$$T\\#%67 ;;=++- -3- r#)rrEreturnNone)r-rErrE)rFilePath[AnyStr]rrE)rrr;rErr)rint)r-rErJrErr)r-rErr)rzIterable[bytes])rzIterable[tuple[bytes, bytes]])r\rErbool)r\rErfrErrE)r\rErrE)r\rErnr rz bytes | _Tri)r\rErnz _T | Nonerzbytes | _T | None)rszMapping[bytes, bytes]rr)rrErr )rr)r\rErfloat)__name__ __module__ __qualname____doc__r"r.r1r6r<rArLrPrRrWr]r_rcrgrrjrqrur{rxr~rrer#r!r r s&6NN . D$,$P  3      ! &  r#r ceZdZdZdZdZy)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\tj|}tj|||y)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 rL)rr-rJs r!rLzShelf.__setitem__As# LLO4A&r#cTtjtj||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 )rloadsr rPr,s r!rPzShelf.__getitem__Ns ||F..tQ788r#N)rrrrrLrPrer#r!rr9s ' 9r#rct|S)z This is for 'anydbm' compatibility. @param file: The parameter to pass to the DirDBM constructor. @param flag: ignored @param mode: ignored )r )fileflagmodes r!r3r3\s $<r#)r3r r)NN)r __future__rr)rrrtypingrrrrrtwisted.python.filepathr r r rr3__all__rer#r!rsV # ??, TV V r 9F 9F  &r#