+ Dfj1)Rt^RIHt^RIt^RIt^RIt^RIt^RIHtH t H t H t H t ^RI Ht] !RRR7t!RR4t!R R ]4tR R lt.R OtR#)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)boundcF]tRt^ tRtRRltRRltRRltRR ltR R lt R R lt RRlt RRlt RRlt RRltRRltRRltRRltRRlt]RRl4t]R R!l4tR2R#R$lltR%R&ltR'R(ltR)R*ltR+R,ltR-R.ltR/R0ltR1tR"#)3DirDBMz 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 V^8dQhRRRR/#)namebytesreturnNone)formats":/usr/lib/python3/dist-packages/twisted/persisted/dirdbm.py __annotate__DirDBM.__annotate__(s&&U&t&c \PPV4Vn\ V4VnVP P 4'gVP P4R#\P!VP PR4P4Fp\P!V4K \P!VP PR4P4pVF[pVRRp\PPV4'd\P!V4KE\P!W$4K] R#)z: @param name: Base path to use for the directory storage. z*.newz*.rplN) ospathabspathdnamer _dnamePathisdircreateDirectoryglobchildremoveexistsrename)selfrf replacementsolds&& r__init__DirDBM.__init__(sWW__T* "4.$$&& OO + + -YYt44W=BBC ! D99T__%:%:7%C%H%HIL!f77>>#&&IIaLIIa% "rc V^8dQhRRRR/#rkrrr)rs"rrrCsNNN5Nrc n\P!V4PRR4PRR4#)z/ Encode a key so it can be used as a filename.  _/-)base64 encodebytesreplacer'r/s&&r_encodeDirDBM._encodeCs/ !!!$,,UD9AA$MMrc V^8dQhRRRR/#r.r)rs"rrrJsNNN5Nrc n\P!VPRR4PRR44#)z# Decode a filename to get the key. r2r1r4r3)r5 decodebytesr7r8s&&r_decodeDirDBM._decodeJs-!!!))D%"8"@"@t"LMMrc V^8dQhRRRR/#)rrFilePath[AnyStr]rrr)rs"rrrPs.5rc VP4;_uu_4pVP4pRRR4V# +'giX#;i)zi Read in the contents of a file. Override in subclasses to e.g. provide transparently encrypted dirdbm. N)openread)r'rr(ss&& r _readFileDirDBM._readFilePs3 YY[[AA[s 4 A c$V^8dQhRRRRRR/#)rrrAdatarrrr)rs"rrrZs"/urc VPR4;_uu_4pVPV4VP4RRR4R# +'giR#;i)z_ Write data to a file. Override in subclasses to e.g. provide transparently encrypted dirdbm. wN)rCwriteflush)r'rrIr(s&&& r _writeFileDirDBM._writeFileZs3 YYs^^q GGDM GGI^^^s "A A cV^8dQhRR/#)rrintr)rs"rrrds...rc H\VPP44#)z6 @return: The number of key/value pairs in this Shelf )lenrlistdirr's&r__len__DirDBM.__len__ds4??**,--rc$V^8dQhRRRRRR/#)rr/rvrrr)rs"rrrjs!  U u  rc \V4\8Xg \R4h\V4\8Xg \R4hVPV4pVPP V4pVP 4'dVPR4pMVPR4pVPWB4VP 4'dVP4VPV4R# \dTP4hi;i)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) typer TypeErrorr9rr#r%siblingExtensionrNr$moveTo BaseException)r'r/rYr*news&&& r __setitem__DirDBM.__setitem__jsAw%67 7Aw%89 9 LLOoo##A& ::<<&&v.C&&v.C  OOC # zz|| JJsO   JJL  s %C//D c V^8dQhRRRR/#r.r)rs"rrrsUurc \V4\8Xg \R4hVPP VP V44pVP V4# \d \T4hi;i)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 r[) r\rr]rr#r9rFOSErrorKeyError)r'r/rs&& r __getitem__DirDBM.__getitem__seAw%67 7$$T\\!_5 >>$' ' 1+  s AA3c V^8dQhRRRR/#)rr/rrrr)rs"rrrs,,U,t,rc \V4\8Xg \R4hVPV4pVPP V4P 4R# \d\TPT44hi;i)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\rr]r9rr#r$rfrgr>r8s&&r __delitem__DirDBM.__delitem__skAw%67 7 LLO , OO ! !! $ + + - ,4<<?+ + ,s )A&BcV^8dQhRR/#rrzIterable[bytes]r)rs"rrrsPPoPrc \\VPVPP 4P 444#)z) @return: a L{list} of filenames (keys). )listmapr>r asBytesModerTrUs&rkeys DirDBM.keyss0C doo&A&A&C&K&K&MNOOrcV^8dQhRR/#ror)rs"rrrsrc j.pVP4pVFpVPW,4K V#)z/ @return: a L{list} of file-contents (values). rtappend)r'valsrtkeys& rvalues DirDBM.valuess1yy{C KK " rcV^8dQhRR/#)rrzIterable[tuple[bytes, bytes]]r)rs"rrrs4rc n.pVP4pVFpVPW0V,34K V#)z< @return: a L{list} of 2-tuples containing key/value pairs. rx)r'itemsrtr{s& rr DirDBM.itemss6yy{C LL#Cy) * rc V^8dQhRRRR/#rr{rrboolr)rs"rrrs 3 35 3T 3rc \V4\8Xg \R4hVPV4pVPP V4P 4#)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\rr]r9rr#isfiler'r{s&&rhas_keyDirDBM.has_keysHCyE!67 7ll3$$S)0022rc$V^8dQhRRRRRR/#)rr{rvaluerr)rs"rrrs!  e E e rc *W9dW V&V#W,#)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'r{rs&&&r setdefaultDirDBM.setdefaults ?ILyrc V^8dQhRRRR/#)rr{rrr)rs"rrrs  u  rc R#Nrrs&&rget DirDBM.get rc$V^8dQhRRRRRR/#)rr{rdefaultr rz bytes | _Tr)rs"rrrs!  u r j rc R#rrr'r{rs&&&rrrrrNc$V^8dQhRRRRRR/#)rr{rrz _T | Nonerzbytes | _T | Noner)rs"rrrs"  u y rFrNrVrbrhrlrtr|rrrrrrrrrrr__static_attributes__rrrr r s&6NN . D$,$P  3      ! &   rr c&]tRtRtRtRtRtRtR#)Shelfi9z 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 ^\P!V4p\PWV4R#)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 rb)r'r/rYs&&&rrbShelf.__setitem__As! LLO4A&rc T\P!\PW44#)z 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 rhr8s&&rrhShelf.__getitem__Ns||F..t788rrN)rrrrrrbrhrrrrrr9s ' 9rrc\V4#)z This is for 'anydbm' compatibility. @param file: The parameter to pass to the DirDBM constructor. @param flag: ignored @param mode: ignored )r )fileflagmodes&&&rrCrC\s $<r)NN)rCr r)r __future__rr5r"rrtypingrrrrrtwisted.python.filepathrr r rrC__all__rrrrsV # ??, TV V r 9F 9F  &r