*j- S r SSKrSSKrSSKrSSKrSS/r Sr
\ r " S S\R R 5 rS S jrg)
a A dumb and slow but simple dbm clone.
For database spam, spam.dir contains the index (a text file),
spam.bak *may* contain a backup of the index (also a text file),
while spam.dat contains the data (a binary file).
XXX TO DO:
- seems to contain a bug when updating...
- reclaim free space (currently, space once occupied by deleted or expanded
items is never reused)
- support concurrent access (currently, if two processes take turns making
updates, they can mess up the index)
- support efficient access to large databases (currently, the whole index
is read when the database is opened, and some updates rewrite the whole index)
- support opening for read-only (flag = 'm')
Nerroropeni c \ rS rSr\r\rSS jrS rS rS r \ r
S r S r S r
S rS
rS rS rS
rS rS rS r\rS rS r\rS rS rS r Sr g) _Database# c U R R U5 nX l US:H U l US- U l US- U l US- U l S U l U R U5 U R U5 g )Nrs .dirs .dats .bak)
_osfsencode_mode _readonly_dirfile_datfile_bakfile_index_create_update)self filebasenamemodeflags //opt/alt/python313/lib64/python3.13/dbm/dumb.py__init___Database.__init__0 sq xx(( 6
#+ %w.
%w.
$w.
T T c US:X aA U R U R U R 4 H n [ R " U5 M [ R " U R SSS9nUR 5 g ! [
a M] f = f! [
a` US; a e [ R " U R SSS9 nU R U R 5 S S S 5 g ! , ( d f g = ff = f)Nnr Latin-1encodingcr w)
r r r r
removeOSError_ior close_chmod)r r filenamefs r r _Database._createJ s 3; !]]DMM4== IJJx( J i@A
GGI
+:%$--yAQ DMM* BAAA +s; A: B :
BB 1C5< C"C5"
C1 ,C51C5c SU l 0 U l [ R " U R SSS9nU U HJ nUR 5 n[ R " U5 u pEUR S5 nXPR U' ML S S S 5 g ! , ( d f g = f! [ ae US; a e U R R U R SSS9 nU R U R 5 S S S 5 g ! , ( d f g = ff = f)NFr r r r! r# ) _modifiedr r& r r rstrip_ast literal_evalencoder% r( )r r r* linekeypos_and_siz_pairs r r _Database._update] s
8 i@A D ;;=D,0,=,=d,C)C **Y/C'7KK$
+:% t}}cI F! DMM* GFFF +s5 B AB
B 6D C9/D 9
D D D c U R b U R ( d g U R R U R 5 U R R
U R U R 5 U R R U R SSS9 nU R U R 5 U R R 5 H/ u p#UR S5 < SU< S3nUR U5 M1 S S S 5 SU l g ! [
a Nf = f! [
a Nf = f! , ( d f N6= f)Nr# r r ,
F)r r- r
unlinkr r% renamer r& r r( itemsdecodewrite)r r* r3 r4 entrys r _commit_Database._commitr s ;; dnn HHOODMM * HHOODMM4== 9 XX]]4==# ]
Ba KK
&)-):):)<% '*jj&;=MN *= C
C
Bs0 %D 0D% A)D5
D"!D"%
D21D25
Ec 4 U R c [ S5 eg N"DBM object has already been closed)r r r s r _verify_open_Database._verify_open s ;; <= = r c P [ U[ 5 ( a UR S5 nU R 5 U R U u p#[
R " U R S5 nUR U5 UR U5 nS S S 5 U$ ! , ( d f W$ = f)Nutf-8rb)
isinstancestrr1 rE r r& r r seekread)r r3 possizr* dats r __getitem___Database.__getitem__ s c3 **W%C ;;s#
XXdmmT
*a
FF3K&&+C +
+
*
s )#B
B%c n [ R " U R S5 nUR SS5 [ UR 5 5 nU[ - S-
[ - [ - nUR SXC-
- 5 UnUR U5 S S S 5 W[ U5 4$ ! , ( d f N= f)Nrb+r ) r& r r rL inttell
_BLOCKSIZEr= len)r valr* rN nposs r _addval_Database._addval s
XXdmmU
+q
FF1aLaffh-C:%)j8JFD
GGE48$ %C
GGCL
, SX ,
+s A/B&&
B4c [ R " U R S5 nUR U5 UR U5 S S S 5 U[ U5 4$ ! , ( d f N= f)NrT )r& r r rL r= r[ )r rN r\ r* s r _setval_Database._setval sJ
XXdmmU
+q
FF3K
GGCL , SX ,
+s #A
A(c X R U' [ R " U R SSS9 nU R U R 5 UR UR
S5 < SU< S35 S S S 5 g ! , ( d f g = f)Nar r r7 r8 )r r& r r r( r= r< )r r3 r4 r* s r _addkey_Database._addkey s[ + C
XXdmmS9
= KK
&
GG#**Y"79IJ K >
=
=s AA<<
B
c U R ( a [ S5 e[ U[ 5 ( a UR S5 nO&[ U[
[ 45 ( d [ S5 e[ U[ 5 ( a UR S5 nO&[ U[
[ 45 ( d [ S5 eU R 5 SU l XR ; a! U R XR U5 5 g U R U u p4U[ - S-
[ - n[ U5 [ - S-
[ - nXe:: a U R X25 U R U' g U R U5 U R U' g )N'The database is opened for reading onlyrH z keys must be bytes or stringsz values must be bytes or stringsTrV )r
r rJ rK r1 bytes bytearray TypeErrorrE r- r re r^ rZ r[ ra )r r3 r\ rN rO oldblocks newblockss r __setitem___Database.__setitem__ s- >>AB B c3 **W%CC%!344 ;< < c3 **W%CC%!344 => > kk ! LLll3 / 0 {{3'HC z)A-*>AB B c3 **W%C KK
r c b [ U R 5 $ ! [ a
[ S5 S ef = frB )listr rk r rD s r keys_Database.keys 6 H $ $ H<=4 G H .c U R 5 U R R 5 Vs/ s H oX 4PM
sn$ s snf N)rE r rv rq s r r; _Database.items s: ,0KK,<,<,>?,>Sdi ,>???s ?c [ U[ 5 ( a UR S5 n XR ; $ ! [ a U R c [ S5 S ee f = f)NrH rC )rJ rK r1 r rk r rq s r __contains___Database.__contains__ sY c3 **W%C ++% % {{" @AtK s
6 %Ac b [ U R 5 $ ! [ a
[ S5 S ef = frB )iterr rk r rD s r iterkeys_Database.iterkeys rx ry c b [ U R 5 $ ! [ a
[ S5 S ef = frB )r[ r rk r rD s r __len___Database.__len__
s6 Ht{{# # H<=4 G Hry c U R 5 S =U l =U l =U l U l g ! S =U l =U l =U l U l f = fr{ )r? r r r r rD s r r' _Database.close sJ O LLNJN NDK N$- N$-$-$ NDK N$- N$-$-s / A
c N U R R XR 5 g r{ )r
chmodr )r files r r( _Database._chmod s tZZ(r c U $ r{ rD s r __enter___Database.__enter__ s r c $ U R 5 g r{ )r' )r argss r __exit___Database.__exit__! s
r )r r r r r r- r
N)r" ) __name__
__module__ __qualname____firstlineno__r
r& r r r r? syncrE rQ r^ ra re rn rr rv r; r~ r __iter__r r' __del__r( r r __static_attributes__r r r r r # s C
C4&8* 4 D> L 5J
H @ H
HH O G)r r c [ R " S5 n[ R " U5 X#) - nUS; a [ S5 e[ XUS9$ ! [ a N'f = f)a! Open the database file, filename, and return corresponding object.
The flag argument, used to control how the database is opened in the
other DBM implementations, supports only the semantics of 'c' and 'n'
values. Other values will default to the semantics of 'c' value:
the database will always opened for update and will be created if it
does not exist.
The optional mode argument is the UNIX mode of the file, used only when
the database has to be created. It defaults to octal code 0o666 (and
will be modified by the prevailing umask).
r )r r# r" r z)Flag must be one of 'r', 'w', 'c', or 'n')r )r
umaskAttributeError
ValueErrorr )r r r ums r r r % s`
YYq\ "
s| ''DEE Td ++
s ,A
AA)r" i )__doc__astr/ ior& osr
collections.abc collections__all__rZ r% r abcMutableMappingr r r r r r sJ . F
.. D,r