‡Ζ Nφ9csΙdZydklZlZWn&ej odklZlZnXydklZWn ej odklZnXdfd„ƒYZdefd„ƒYZ defd„ƒYZ d d „Z d S( s£Manage shelves of pickled objects. A "shelf" is a persistent, dictionary-like object. The difference with dbm databases is that the values (not the keys!) in a shelf can be essentially arbitrary Python objects -- anything that the "pickle" module can handle. This includes most class instances, recursive data types, and objects containing lots of shared sub-objects. The keys are ordinary strings. To summarize the interface (key is a string, data is an arbitrary object): import shelve d = shelve.open(filename) # open, with (g)dbm filename -- no suffix d[key] = data # store data at key (overwrites old data if # using an existing key) data = d[key] # retrieve data at key (raise KeyError if no # such key) del d[key] # delete data stored at key (raises KeyError # if no such key) flag = d.has_key(key) # true if the key exists list = d.keys() # a list of all existing keys (slow!) d.close() # close it Dependent on the implementation, closing a persistent dictionary may or may not be necessary to flush changes to disk. (sPicklers Unpickler(sStringIOsShelfcsndZd„Zd„Zd„Zd„Zed„Zd„Zd„Zd„Z d „Z d „Z d „Z RS( s΄Base class for shelf implementations. This is initialized with a dictionary-like object. See the module's __doc__ string for an overview of the interface. cs ||_dS(N(sdictsself(sselfsdicts#/mit/python/lib/python2.0/shelve.pys__init__3scs|iiƒSdS(N(sselfsdictskeys(sselfs#/mit/python/lib/python2.0/shelve.pyskeys6scst|iƒSdS(N(slensselfsdict(sselfs#/mit/python/lib/python2.0/shelve.pys__len__9scs|ii|ƒSdS(N(sselfsdictshas_keyskey(sselfskeys#/mit/python/lib/python2.0/shelve.pyshas_key<scs'|ii|ƒo ||Sn|SdS(N(sselfsdictshas_keyskeysdefault(sselfskeysdefaults#/mit/python/lib/python2.0/shelve.pysget?s cs't|i|ƒ}t|ƒiƒSdS(N(sStringIOsselfsdictskeysfs Unpicklersload(sselfskeysfs#/mit/python/lib/python2.0/shelve.pys __getitem__Dscs9tƒ}t|ƒ}|i|ƒ|iƒ|i|dZd„Zd„Zd„Zd„Zd„Zd„ZRS(sΞShelf implementation using the "BSD" db interface. This adds methods first(), next(), previous(), last() and set_location() that have no counterpart in [g]dbm databases. The actual database must be opened using one of the "bsddb" modules "open" routines (i.e. bsddb.hashopen, bsddb.btopen or bsddb.rnopen) and passed to the constructor. See the module's __doc__ string for an overview of the interface. csti||ƒdS(N(sShelfs__init__sselfsdict(sselfsdicts#/mit/python/lib/python2.0/shelve.pys__init__mscs>|ii|ƒ\}}t|ƒ}|t|ƒiƒfSdS(N( sselfsdicts set_locationskeysvaluesStringIOsfs Unpicklersload(sselfskeysvaluesfs#/mit/python/lib/python2.0/shelve.pys set_locationps cs;|iiƒ\}}t|ƒ}|t|ƒiƒfSdS(N( sselfsdictsnextskeysvaluesStringIOsfs Unpicklersload(sselfskeysvaluesfs#/mit/python/lib/python2.0/shelve.pysnextus cs;|iiƒ\}}t|ƒ}|t|ƒiƒfSdS(N( sselfsdictspreviousskeysvaluesStringIOsfs Unpicklersload(sselfskeysvaluesfs#/mit/python/lib/python2.0/shelve.pyspreviouszs cs;|iiƒ\}}t|ƒ}|t|ƒiƒfSdS(N( sselfsdictsfirstskeysvaluesStringIOsfs Unpicklersload(sselfskeysvaluesfs#/mit/python/lib/python2.0/shelve.pysfirsts cs;|iiƒ\}}t|ƒ}|t|ƒiƒfSdS(N( sselfsdictslastskeysvaluesStringIOsfs Unpicklersload(sselfskeysvaluesfs#/mit/python/lib/python2.0/shelve.pyslast„s (s__doc__s__init__s set_locationsnextsprevioussfirstslast(s#/mit/python/lib/python2.0/shelve.pys BsdDbShelf`s      sDbfilenameShelfcsdZdd„ZRS(sΦShelf implementation using the "anydbm" generic dbm interface. This is initialized with the filename for the dbm database. See the module's __doc__ string for an overview of the interface. cs)dk}ti||i||ƒƒdS(N(sanydbmsShelfs__init__sselfsopensfilenamesflag(sselfsfilenamesflagsanydbms#/mit/python/lib/python2.0/shelve.pys__init__‘s sc(s__doc__s__init__(s#/mit/python/lib/python2.0/shelve.pysDbfilenameShelfŠscst||ƒSdS(sΐOpen a persistent dictionary for reading and writing. Argument is the filename for the dbm database. See the module's __doc__ string for an overview of the interface. N(sDbfilenameShelfsfilenamesflag(sfilenamesflags#/mit/python/lib/python2.0/shelve.pysopen–sscN( s__doc__scPicklesPicklers Unpicklers ImportErrorspickles cStringIOsStringIOsShelfs BsdDbShelfsDbfilenameShelfsopen(s#/mit/python/lib/python2.0/shelve.pys?s4*