linecache — Случайный доступ к строкам текста

Исходный код: Lib/linecache.py

Модуль linecache позволяет получить любую строку из любого файла, при этом он оптимизирован для случая, когда из одного файла считывается много строк, используя кеш. Он используется модулем traceback для извлечения строк исходного кода для включения в отформатированную трассировку стека.

Модуль linecache определяет следующие функции:

linecache.getline(filename, lineno[, module_globals])

Получение строки lineno из файла с именем filename. Эта функция никогда не вызывает исключение — она возвращает '' при ошибках (включая завершающий символ новой строки для найденных строк).

Если файл с именем filename не найден, функция будет искать его в пути поиска модулей, sys.path, сначала проверив наличие PEP 302 __loader__ в module_globals, если модуль был импортирован из архива zipfile или другого источника импорта, не являющегося файловой системой.

В версии 2.5: Параметр module_globals был добавлен.

linecache.clearcache()

Очистка кеша. Используйте эту функцию, если вам больше не нужны строки из файлов, ранее считанные с помощью getline().

linecache.checkcache([filename])

Проверка кеша на актуальность. Используйте эту функцию, если файлы в кеше могли измениться на диске, и вам требуется обновлённая версия. Если filename опущен, будет проверена вся информация в кеше.

Пример:

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