`rlcompleter.md`

51 строк · 4.2 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.1/library/rlcompleter.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 16.6. `rlcompleter` – Функция автодополнения для GNU readline89Модуль `rlcompleter` определяет функцию автодополнения, подходящую для [`readline`](https://python-all.ru/3.1/library/readline.html#module-readline) модуля, дополняя корректные идентификаторы и ключевые слова Python.1011Когда этот модуль импортируется на платформе Unix с доступным модулем [`readline`](https://python-all.ru/3.1/library/readline.html#module-readline), автоматически создаётся экземпляр класса `Completer`, и его метод `complete()` устанавливается как функция автодополнения [`readline`](https://python-all.ru/3.1/library/readline.html#module-readline).1213Пример:1415```python16>>> import rlcompleter17>>> import readline18>>> readline.parse_and_bind("tab: complete")19>>> readline. <TAB PRESSED>20readline.__doc__          readline.get_line_buffer(  readline.read_init_file(21readline.__file__         readline.insert_text(      readline.set_completer(22readline.__name__         readline.parse_and_bind(23>>> readline.24```2526Модуль `rlcompleter` предназначен для использования в интерактивном режиме Python. Пользователь может добавить следующие строки в свой файл инициализации (определяемый переменной окружения [**PYTHONSTARTUP**](https://python-all.ru/3.1/using/cmdline.html#envvar-PYTHONSTARTUP)), чтобы получить автоматическое дополнение по `Tab`:2728```python29try:30    import readline31except ImportError:32    print("Module readline not available.")33else:34    import rlcompleter35    readline.parse_and_bind("tab: complete")36```3738На платформах без [`readline`](https://python-all.ru/3.1/library/readline.html#module-readline) класс `Completer`, определённый в этом модуле, всё ещё может использоваться для пользовательских целей.3940## 16.6.1. Объекты Completer4142Объекты Completer имеют следующий метод:4344#### `Completer.complete(text, state)`4546Возвращает *state*-е завершение для *text*.4748Если вызвана для *text*, не содержащего точку (`'.'`), то будет выполнять автодополнение из имён, определённых в [`__main__`](https://python-all.ru/3.1/library/__main__.html#module-__main__), [`builtins`](https://python-all.ru/3.1/library/builtins.html#module-builtins) и ключевых слов (как определено модулем [`keyword`](https://python-all.ru/3.1/library/keyword.html#module-keyword)).4950Если вызвана для имени с точкой, она попытается вычислить всё без очевидных побочных эффектов (функции не будут вычисляться, но могут генерироваться вызовы [`__getattr__()`](https://python-all.ru/3.1/reference/datamodel.html#object.__getattr__)) до последней части и найти совпадения для остального через функцию [`dir()`](https://python-all.ru/3.1/library/functions.html#dir). Любое исключение, возникшее при вычислении выражения, перехватывается, подавляется и возвращается [`None`](https://python-all.ru/3.1/library/constants.html#None).51