Функция help() в Python

Функция help() в Python используется для получения документации по указанному модулю, классу, функции, переменным и т. д. Этот метод обычно используется в консоли интерпретатора Python для получения подробной информации о объектах Python.

Функция help() в Python

Синтаксис функции help() в Python следующий:

help([object])

Если аргумент не указан, интерактивная система справки запускается в консоли интерпретатора. В консоли справки Python мы можем указать имена модуля, класса, функции для получения их документации справки. Некоторые из них:

help> True

help> collections

help> builtins

help> modules

help> keywords

help> symbols

help> topics

help> LOOPING

Если вы хотите выйти из консоли справки, введите quit. Мы также можем получить документацию справки непосредственно из консоли Python, передав параметр функции help().

>>> help('collections')

>>> help(print)

>>> help(globals)

Давайте посмотрим, что выводит функция help() для функции globals().

>>> help('builtins.globals')

Help on built-in function globals in builtins:

builtins.globals = globals()
    Return the dictionary containing the current scope's global variables.
    
    NOTE: Updates to this dictionary *will* affect name lookups in the current global scope and vice-versa.

Определение help() для пользовательских классов и функций

Мы можем определить вывод функции help() для наших пользовательских классов и функций, определив docstring (строку документации). По умолчанию первая строка комментария в теле метода используется как его docstring. Он заключен в три двойных кавычки. Допустим, у нас есть файл python python_help_examples.py с следующим кодом.

def add(x, y):
    """
    This function adds the given integer arguments
    :param x: integer
    :param y: integer
    :return: integer
    """
    return x + y


class Employee:
    """
    Employee class, mapped to "employee" table in Database
    """
    id = 0
    name = ''

    def __init__(self, i, n):
        """
        Employee object constructor
        :param i: integer, must be positive
        :param n: string
        """
        self.id = i
        self.name = n

Обратите внимание, что мы определили docstring для функции, класса и его методов. Вы должны следовать определенному формату для документации, я сгенерировал часть из них автоматически с помощью среды разработки PyCharm. Руководство по документированию NumPy – хорошее место, чтобы получить представление о правильном способе документирования помощи. Давайте посмотрим, как получить этот docstring в качестве документации помощи в консоли Python. Прежде всего, нам нужно выполнить этот скрипт в консоли, чтобы загрузить нашу функцию и определение класса. Мы можем сделать это с помощью команды exec().

>>> exec(open("python_help_examples.py").read())

Мы можем проверить, что функции и определения классов присутствуют, используя команду globals().

>>> globals()
{'__name__': '__main__', '__doc__': None, '__package__': None, '__loader__': <class '_frozen_importlib.BuiltinImporter'>, '__spec__': None, '__annotations__': {}, '__builtins__': <module 'builtins' (built-in)>, '__warningregistry__': {'version': 0}, 'add': <function add at 0x100dda1e0>, 'Employee': <class '__main__.Employee'>}

Обратите внимание, что «Employee» и «add» присутствуют в глобальном словаре области видимости. Теперь мы можем получить документацию помощи с помощью функции help(). Давайте рассмотрим некоторые примеры.

>>> help('python_help_examples')

>>> help('python_help_examples.add')

Help on function add in python_help_examples:

python_help_examples.add = add(x, y)
    This function adds the given integer arguments
    :param x: integer
    :param y: integer
    :return: integer
(END)

>>> help('python_help_examples.Employee')

>>> help('python_help_examples.Employee.__init__')


Help on function __init__ in python_help_examples.Employee:

python_help_examples.Employee.__init__ = __init__(self, i, n)
    Employee object constructor
    :param i: integer, must be positive
    :param n: string
(END)

Сводка

Функция help() в Python очень полезна для получения подробной информации о модулях, классах и функциях. Всегда лучше всего определять докстринги для пользовательских классов и функций, чтобы объяснить их использование.

Вы можете ознакомиться с полным скриптом на Python и большим количеством примеров на Python в нашем репозитории GitHub.

Ссылка: Официальная документация