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'