3.10 linecache --- Accès aléatoire à des lignes de texte

Le module linecache permet d'accéder à n'importe quelle ligne de n'importe quel fichier, en essayant d'optimiser en interne, à l'aide d'un cache, le cas courant où beaucoup de lignes sont lues depuis un seul fichier. Ce module est utilisé par le module tracebackpour extraire les lignes de code source à inclure dans la trace formattée.

Le module linecache définit les fonctions suivantes:

getline(nomfichier, numligne)
Retourne la ligne numligne depuis le fichier nomfichier. Cette fonction ne déclenchera jamais d'exception - elle retourne '' en cas d'erreur (le caractère de fin de ligne sera inclus pour les lignes qui sont trouvées).

Si on ne trouve pas de fichier nommé nomfichier, la fonction le recherchera dans le chemin de recherche du module, sys.path.

clearcache()
Vide le cache. Appelez cette fonction si vous n'avez plus besoin des lignes lues précédemment par getline().

checkcache()
Vérifie la validité du cache. Utilisez cette fonction s'il se peut que les fichiers du cache aient changé sur le disque, et que vous ayez besoin de la version mise à jour.

Exemple:

>>> import linecache
>>> linecache.getline('/etc/passwd', 4)
'sys:x:3:3:sys:/dev:/bin/sh\012'