Будучи разработчиком perl, я знаю утилиту perldoc. Я новичок в python, и я искал то же самое и нашел pydoc. Но проблема с pydoc заключается в том, что он также выполняет мой скрипт, в то время как я хочу видеть только документ, написанный внутри тройных кавычек. Любая помощь будет оценена по достоинству.
Вероятно, лучший способ - работать в Python (вместо командной строки). В качестве примера возьмем модуль sys
. Сначала импортируйте свой модуль, а затем используйте help()
, например:
import sys
help(sys)
Если вы хотите увидеть docstrings:
print(sys.__doc__)
Для модулей, которые вы разрабатываете самостоятельно, вы можете создать защитную оболочку, чтобы модуль не выполнялся, как описано в документации:
Примечание. Чтобы найти объекты и их документацию, pydoc импортирует модули (модули) для документирования. Поэтому в этом случае будет выполнен любой код на уровне модуля. Используйте
if __name__ == '__main__':
guard только для выполнения кода, когда файл вызывается как скрипт, а не только импортируется.