"linecache" --- Random access to text lines#

Código fuente: Lib/linecache.py

======================================================================

The "linecache" module allows one to get any line from a Python source file, while attempting to optimize internally, using a cache, the common case where many lines are read from a single file. This is used by the "traceback" module to retrieve source lines for inclusion in the formatted traceback.

La función "tokenize.open()" se utiliza para abrir archivos. Esta función usa "tokenize.detect_encoding()" para obtener la codificación del archivo; en la ausencia de un token de codificación, la codificación del archivo es por defecto UTF-8.

The "linecache" module defines the following functions:

linecache.getline(filename, lineno, module_globals=None)

Obtiene la línea lineno del archivo llamado filename. Esta función nunca lanzará una excepción --- retornará "''" en los errores (el carácter de la nueva línea de terminación se incluirá para las líneas que se encuentren).

If filename indicates a frozen module (starting with "'<frozen '"), the function will attempt to get the real file name from "module_globals['file']" if module_globals is not "None".

Si un archivo llamado filename no se encuentra, la función primero verifica un "loader" en module_globals PEP 302. Si existe tal cargador y define un método "get_source", entonces eso determina las líneas de origen (si "get_source()" retorna "None", entonces se retorna "''"). Finalmente, si filename es un nombre de fichero relativo, se busca en relación a las entradas en la ruta de búsqueda del módulo, "sys.path".

Distinto en la versión 3.14: Support filename of frozen modules.

linecache.clearcache()

Borra el caché. Use esta función si ya no necesita las líneas de archivos leídos previamente usando "getline()".

linecache.checkcache(filename=None)

Comprueba la validez de la caché. Use esta función si los archivos de la caché pueden haber cambiado en disco y necesita la versión actualizada. Si se omite filename, comprobará todas las entradas en la caché.

linecache.lazycache(filename, module_globals)

Captura suficientes detalles sobre un módulo no basado en archivos para permitir obtener sus líneas más tarde a través de "getline()" incluso si module_globals es "None" en la llamada posterior. Esto evita hacer E/S hasta que una línea es realmente necesaria, sin tener que llevar los módulo globales indefinidamente.

Added in version 3.5.

Ejemplo:

import linecache linecache.getline(linecache.file, 8) 'import sys\n'