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

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

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

Функция tokenize.open() используется для открытия файлов. Эта функция использует tokenize.detect_encoding() для получения кодировки файла; при отсутствии маркера кодировки кодировка файла по умолчанию — UTF-8.

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

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

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

Если файл с именем filename не найден, функция сначала проверяет наличие PEP 302 __loader__ в module_globals. Если такой загрузчик существует и определяет метод get_source, то он определяет строки исходного кода (если get_source() возвращает None, то возвращается ''). Наконец, если filename — относительное имя файла, оно ищется относительно записей в пути поиска модуля sys.path.

linecache.clearcache()

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

linecache.checkcache(filename=None)

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

linecache.lazycache(filename, module_globals)

Захватить достаточно подробных сведений о модуле, не основанном на файлах, чтобы разрешить получение его строк позже через getline(), даже если module_globals None в последующем вызове. Это позволяет избежать ввода-вывода до тех пор, пока строка фактически не понадобится, без необходимости постоянного переноса глобальных переменных модуля.

Добавлен в версии 3.5.

Пример:

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