6.3 dircache -- Listati di directory memorizzati nella memoria cache

Il modulo dircache definisce una funzione per leggere i listati delle directory con l'aiuto di una memoria cache, che viene invalidata utilizzando il tempo di modifica (mtime) della directory. In aggiunta, il modulo definisce una funzione per marcare le directory, aggiungendovi una barra "/" alla fine.

Il modulo dircache definisce le seguenti funzioni:

listdir( path)
Restituisce la lista del contenuto della directory path, così come ottenuta da os.listdir(). Notate che finché path non viene modificato, ulteriori chiamate a listdir() non riesamineranno più la struttura della directory.

Notate che la lista restituita dovrebbe essere trattata come in sola lettura. (Forse è opportuno che una versione futura restituisca una tupla?)

opendir( path)
La stessa cosa di listdir(). Definita per compatibilità con le versioni precedenti.

annotate( head, list)
Assume che list sia una lista di percorsi relativi a head ed aggiunge, modificandone gli elementi, una barra "/" ad ogni percorso corrispondente ad una directory.

>>> import dircache
>>> a = dircache.listdir('/')
>>> a = a[:] # Copia il valore restituito, in modo da poter cambiare 'a'
>>> a
['bin', 'boot', 'cdrom', 'dev', 'etc', 'floppy', 'home', 'initrd', 'lib', 'lost+
found', 'mnt', 'proc', 'root', 'sbin', 'tmp', 'usr', 'var', 'vmlinuz']
>>> dircache.annotate('/', a)
>>> a
['bin/', 'boot/', 'cdrom/', 'dev/', 'etc/', 'floppy/', 'home/', 'initrd/', 'lib/
', 'lost+found/', 'mnt/', 'proc/', 'root/', 'sbin/', 'tmp/', 'usr/', 'var/', 'vm
linuz']
Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.