\di'dZddlZddlZddlZddlZddlmZ en #e$re ZYnwxYwGddZ Gdde Z d dZ gd 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)FilePathceZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZddZdZdZdZdZdZdZdS)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. ctj||_t ||_|js|jdStj|j djD]}tj |tj|j dj}|D]U}|dd}tj |rtj |@tj ||VdS)zb @type name: str @param name: Base path to use for the directory storage. z*.newz*.rplN) ospathabspathdnamer _dnamePathisdircreateDirectoryglobchildremoveexistsrename)selfnamef replacementsolds 8lib/python3.11/site-packages/twisted/persisted/dirdbm.py__init__zDirDBM.__init__,s W__T** "4..$$&& & O + + - - - - -Yt44W==BCC   ! 9T_%:%:7%C%C%HIIL! & &f7>>#&&&IaLLLLIa%%%%  & &cztj|ddddS)z? Encode a key so it can be used as a filename.  _/-)base64 encodebytesreplacerks r_encodezDirDBM._encodeHs5 !!$$,,UD99AA$MMMrcztj|ddddS)z3 Decode a filename to get the key. rrr r)r! decodebytesr#r$s r_decodezDirDBM._decodeOs3!!))D%"8"8"@"@t"L"LMMMrct|jd5}|}dddn #1swxYwY|S)z Read in the contents of a file. Override in subclasses to e.g. provide transparently encrypted dirdbm. rbN)_openr read)rr rss r _readFilezDirDBM._readFileUsz 49d # # qA               s 7;;ct|jd5}|||ddddS#1swxYwYdS)zw Write data to a file. Override in subclasses to e.g. provide transparently encrypted dirdbm. wbN)r,r writeflush)rr datars r _writeFilezDirDBM._writeFile_s 49d # # q GGDMMM GGIII                  s*A  AAcNt|jS)zF @return: The number of key/value pairs in this Shelf )lenr listdirrs r__len__zDirDBM.__len__is 4?**,,---rclt|tkstdt|tkstd||}|j|}|r|d}n|d} ||||r| | |dS#t$r| wxYw)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 rrsiblingExtensionr5rmoveTo BaseException)rr%vrnews r __setitem__zDirDBM.__setitem__osAww%677 7Aww%899 9 LLOOo##A&& ::<< /&&v..CC&&v..C  OOC # # # zz||  JJsOOOOO     JJLLL  s >D D3ct|tkstd|j||} ||S#t$rt|wxYw)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 r<) r=r>r?r rr&r/OSErrorKeyError)rr%r s r __getitem__zDirDBM.__getitem__sAww%677 7$$T\\!__55 >>$'' '   1++  s A++Bc8t|tkstd||} |j|dS#t$r#t| |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 r<N) r=r>r?r&r rrrGrHr)r$s r __delitem__zDirDBM.__delitem__sAww%677 7 LLOO , O ! !! $ $ + + - - - - - , , ,4<<??++ + ,s ,A,,-Bctt|j|jS)z9 @return: a L{list} of filenames (keys). )listmapr)r asBytesModer8r9s rkeysz DirDBM.keyss8C do&A&A&C&C&K&K&M&MNNOOOrcrg}|}|D]}||||S)z? @return: a L{list} of file-contents (values). rPappend)rvalsrPkeys rvaluesz DirDBM.valuessCyy{{ # #C KKS " " " " rcvg}|}|D]}||||f |S)zL @return: a L{list} of 2-tuples containing key/value pairs. rR)ritemsrPrUs rrXz DirDBM.itemssHyy{{ + +C LL#tCy) * * * * rct|tkstd||}|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. r<)r=r>r?r&r risfilerrUs rhas_keyzDirDBM.has_keysWCyyE!!677 7ll3$$S))00222rc(||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. )rrUvalues r setdefaultzDirDBM.setdefaults% d??DILCyrNc||vr||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^)rrUdefaults rgetz DirDBM.gets $;;9 Nrc,||S)z) @see: L{DirDBM.has_key} )r\r[s r __contains__zDirDBM.__contains__s||C   rcD|D] \}}|||< dS)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)rX)rdictrUvals rupdatez DirDBM.updates4   HCDII  rct|}||jksJ||j}||D] }||||<|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. )rr __class__r clearrP)rr dr%s rcopyToz DirDBM.copyTo sm~~t&&&& NN49 % %    A7AaDDrc:|D]}||=dS)z< Delete all key/value pairs in this dirdbm. N)rPr$s rrlz DirDBM.clears.  AQ  rcdS)zL Close this dbm: no-op, for dbm-style interface compliance. Nr^r9s rclosez DirDBM.close%srct|tkstd|j||}|r|St|)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 r<) r=r>r?r rr&rZgetModificationTimerH)rrUr s rrszDirDBM.getModificationTime*ssCyyE!!677 7$$T\\#%6%677 ;;== ++-- -3-- r)N)__name__ __module__ __qualname____doc__rr&r)r/r5r:rErIrKrPrVrXr\r`rcrerirnrlrqrsr^rrrr$sh&&&8NNNNNN ...   D&,,,$PPP  3 3 3       !!!   (        rrceZdZdZdZdZdS)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. cftj|}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)pickledumpsrrE)rr%rCs rrEzShelf.__setitem__Bs/ LOO4A&&&&&rc\tjt||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 )r{loadsrrIr$s rrIzShelf.__getitem__Os$|F..tQ77888rN)rtrurvrwrErIr^rrryry:s< ' ' ' 9 9 9 9 9rryc 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)fileflagmodes ropenr]s $<<r)rrry)NN) rwr!rrr{twisted.python.filepathrr, NameErrorrrry__all__r^rrrs    ,,,,,, EE EEES S S S S S S S l 9 9 9 9 9F 9 9 9F     & % %s ''