rlcompleter — Функция дополнения для GNU readline

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

Модуль rlcompleter определяет функцию дополнения, подходящую для модуля readline, завершая допустимые идентификаторы и ключевые слова Python.

При импорте этого модуля на платформе Unix с доступным модулем readline, автоматически создаётся экземпляр класса Completer и его метод complete() устанавливается в качестве дополнителя readline.

Пример:

>>> import rlcompleter
>>> import readline
>>> readline.parse_and_bind("tab: complete")
>>> readline. <TAB PRESSED>
readline.__doc__          readline.get_line_buffer(  readline.read_init_file(
readline.__file__         readline.insert_text(      readline.set_completer(
readline.__name__         readline.parse_and_bind(
>>> readline.

Модуль rlcompleter предназначен для использования с интерактивным режимом Python интерактивный режим. Если Python не запущен с опцией -S, модуль автоматически импортируется и настраивается (см. Настройка readline).

На платформах без модуля readline, класс Completer из этого модуля всё ещё может использоваться для пользовательских целей.

Объекты Completer

Объекты Completer имеют следующий метод:

Completer.complete(text, state)

Возвращает state-е завершение для text.

Если вызывается для text, не содержащего символа точки ('.'), то завершение происходит из имен, текущих в __main__, builtins и ключевых слов (как определено модулем keyword).

Если вызывается для имени с точками, то оно попытается оценить всё без явных побочных эффектов (функции не будут вычисляться, но могут быть вызваны __getattr__()) до последней части, и найти совпадения для остальной части через функцию dir(). Любое исключение, поднятое во время вычисления выражения, перехватывается, подавляется, и возвращается None.