h1)SrSSKJr SSKrSSKrSSKrSSKrSSKJrJ r J r J r J r SSK Jr \ "SSS9r"SS 5r"S S \5rSS jr/S Qrg)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)boundc\rSrSrSrSSjrSSjrSSjrSSjrSSjr S Sjr S!S jr SS jr S"S jr S#S jrS#S jrS$SjrS%SjrS&Sjr\S'Sj5r\S(Sj5rS)S*SjjrS%SjrS+SjrS,SjrS-SjrS-SjrS.SjrSrg)/DirDBM z 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[RRU5Ul[ U5UlUR R 5(dUR R5 g[R"UR RS5R5Hn[R"U5 M [R"UR RS5R5nUHZnUSSn[RRU5(a[R"U5 MD[R"X$5 M\ g)z: @param name: Base path to use for the directory storage. z*.newz*.rplN) ospathabspathdnamer _dnamePathisdircreateDirectoryglobchildremoveexistsrename)selfnamef replacementsolds _/root/1688_scrapy/alibaba-scraper/venv/lib/python3.13/site-packages/twisted/persisted/dirdbm.py__init__DirDBM.__init__(sWW__T* "4.$$&& OO + + -YYt44W=BBC ! D99T__%:%:7%C%H%HIL!f77>>#&&IIaLIIa% "cn[R"U5RSS5RSS5$)z/ Encode a key so it can be used as a filename.  _/-)base64 encodebytesreplacerks r"_encodeDirDBM._encodeCs/ !!!$,,UD9AA$MMr%cn[R"URSS5RSS55$)z# Decode a filename to get the key. r(r'r*r))r+ decodebytesr-r.s r"_decodeDirDBM._decodeJs-!!!))D%"8"@"@t"LMMr%c|UR5nUR5nSSS5 U$!,(df  W$=f)zi Read in the contents of a file. Override in subclasses to e.g. provide transparently encrypted dirdbm. N)openread)rrrss r" _readFileDirDBM._readFilePs1 YY[AA[s, ;cURS5nURU5 UR5 SSS5 g!,(df  g=f)z_ Write data to a file. Override in subclasses to e.g. provide transparently encrypted dirdbm. wN)r7writeflush)rrdatars r" _writeFileDirDBM._writeFileZs/ YYs^q GGDM GGI^^s "= A cH[URR55$)z6 @return: The number of key/value pairs in this Shelf )lenrlistdirrs r"__len__DirDBM.__len__ds4??**,--r%c[U5[:Xd [S5e[U5[:Xd [S5eURU5nURR U5nUR 5(aURS5nOURS5nURXB5 UR 5(aUR5 URU5 g![a UR5 ef=f)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 TypeErrorr0rrrsiblingExtensionrArmoveTo BaseException)rr/vr!news r" __setitem__DirDBM.__setitem__jsAw%67 7Aw%89 9 LLOoo##A& ::<<&&v.C&&v.C  OOC # zz|| JJsO   JJL  s "C**Dc[U5[:Xd [S5eURR UR U55nUR U5$![a [U5ef=f)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 rJ) rKrLrMrrr0r:OSErrorKeyError)rr/rs r" __getitem__DirDBM.__getitem__seAw%67 7$$T\\!_5 >>$' ' 1+  s AA1c[U5[:Xd [S5eURU5nURR U5R 5 g![a [URU55ef=f)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 rJN) rKrLrMr0rrrrVrWr4r.s r" __delitem__DirDBM.__delitem__skAw%67 7 LLO , OO ! !! $ + + - ,4<<?+ + ,s )A%Bc[[URURR 5R 555$)z) @return: a L{list} of filenames (keys). )listmapr4r asBytesModerErFs r"keys DirDBM.keyss0C doo&A&A&C&K&K&MNOOr%cb/nUR5nUHnURX5 M U$)z/ @return: a L{list} of file-contents (values). raappend)rvalsrakeys r"values DirDBM.valuess1yy{C KK " r%cf/nUR5nUHnURX0U45 M U$)z< @return: a L{list} of 2-tuples containing key/value pairs. rd)ritemsrargs r"rk DirDBM.itemss6yy{C LL#Cy) * r%c[U5[:Xd [S5eURU5nURR U5R 5$)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. rJ)rKrLrMr0rrisfilerrgs r"has_keyDirDBM.has_keysHCyE!67 7ll3$$S)0022r%c X;aX U'U$X$)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. )rrgvalues r" setdefaultDirDBM.setdefaults ?ILyr%cgNrsros r"get DirDBM.get r%cgrxrsrrgdefaults r"ryrzr{r%NcX;aX$U$)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)} rsr}s r"ryrzs ;9 Nr%c$URU5$)z @see: L{DirDBM.has_key} )rpros r" __contains__DirDBM.__contains__s||C  r%c>UR5H up#X0U'M g)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)rk)rotherrgvals r"update DirDBM.updates HCI&r%c[U5nX R:wdeURUR5nUR 5 UR 5H nXX4'M U$)z 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__rclearra)rrfpathdr/s r"copyTo DirDBM.copyTo sV''' NN5:: &  A7ADr%c6UR5HnX M g)z, Delete all key/value pairs in this dirdbm. N)rar.s r"r DirDBM.clearsAr%cg)z< Close this dbm: no-op, for dbm-style interface compliance. NrsrFs r"close DirDBM.close$sr%c[U5[:Xd [S5eURR UR U55nUR 5(aUR5$[U5e)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 rJ) rKrLrMrrr0rngetModificationTimerW)rrgrs r"rDirDBM.getModificationTime)s]CyE!67 7$$T\\#%67 ;;==++- -3- r%)rr)rrLreturnNone)r/rLrrL)rFilePath[AnyStr]rrL)rrr@rLrr)rint)r/rLrQrLrr)r/rLrr)rzIterable[bytes])rzIterable[tuple[bytes, bytes]])rgrLrbool)rgrLrtrLrrL)rgrLrrL)rgrLr~r rz bytes | _Trx)rgrLr~z _T | Nonerzbytes | _T | None)rzMapping[bytes, bytes]rr)rrLrr )rr)rgrLrfloat)__name__ __module__ __qualname____firstlineno____doc__r#r0r4r:rArGrSrXr[rarhrkrprurryrrrrrr__static_attributes__rsr%r"r r s&6NN . D$,$P  3      ! &  r%r c$\rSrSrSrSrSrSrg)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\[R"U5n[RXU5 g)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 rS)rr/rQs r"rSShelf.__setitem__As! LLO4A&r%cT[R"[RX55$)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 rXr.s r"rXShelf.__getitem__Ns||F..t788r%rsN)rrrrrrSrXrrsr%r"rr9s ' 9r%rc[U5$)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"r7r7\s $<r%)r7r r)NN)r __future__rr+rrrtypingrrrrrtwisted.python.filepathr r r rr7__all__rsr%r"rsV # ??, TV V r 9F 9F  &r%