rlcompleter — функция автодополнения для GNU readline

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

Модуль rlcompleter определяет функцию автодополнения, которую можно передать в set_completer() в модуле readline.

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

Пример:

>>> 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, определённый этим модулем, всё ещё можно использовать для собственных целей.

class rlcompleter.Completer

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

complete(text, state)

Возвращает следующий возможный вариант автодополнения для text.

При вызове модулем readline этот метод вызывается последовательно с state == 0, 1, 2, ..., пока не вернёт None.

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

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