# `rlcompleter` — Completion function for GNU readline

Вихідний код: Lib/rlcompleter.py

The `rlcompleter` module defines a completion function suitable to be passed to `set_completer()` in the `readline` module.

When this module is imported on a Unix platform with the `readline` module available, an instance of the `Completer` class is automatically created and its `complete()` method is set as the readline completer. The method provides completion of valid Python identifiers and keywords.

Приклад:

    >>> 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.

The `rlcompleter` module is designed for use with Python’s interactive mode. Unless Python is run with the `-S` option, the module is automatically imported and configured (see Конфігурація Readline).

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

class rlcompleter.Completer

  Повні об’єкти мають такий метод:

  complete(text, state)

    Return the next possible completion for text.

    When called by the `readline` module, this method is called successively with `state == 0, 1, 2, ...` until the method returns `None`.

    Якщо викликати текст, який не містить символ крапки (`'.''`), він завершуватиметься іменами, визначеними в `__main__`, `builtins` та ключовими словами (як визначено) за допомогою модуля `keyword`).

    If called for a dotted name, it will try to evaluate anything without obvious side-effects (functions will not be evaluated, but it can generate calls to `__getattr__()`) up to the last part, and find matches for the rest via the `dir()` function. Any exception raised during the evaluation of the expression is caught, silenced and `None` is returned.