Альтернативные способы просмотра python api

Является ли это просто мной, или документация по стандартной библиотеке python чрезвычайно трудно просмотреть?

Java имеет свой блестящий Javadocs, Ruby имеет полезный Ruby-Docs, только в python. Я не могу найти хороший способ навигации по стандартной библиотечной документации.

Вот проект Epydoc, который выглядит красиво, но кто-нибудь знает, действительно ли он используется в стандартной библиотеке, поэтому мы все могут пройти через это? Если нет, то какие альтернативы люди используют для просмотра документации python.

Ответы

Ответ 1

Я обычно использую встроенный pydoc, если вы находитесь в окнах, он должен называться Document Docs, если вы используете Linux pydoc -p 8000 и подключиться через браузер.

Ответ 2

pydoc из командной строки, help() из приглашения интерактивного интерпретатора.

Ответ 3

pydoc -p 8080

Сообщество python является полу-враждебным к автоматически созданной документации, особенно если оно ориентировано на объект. Python не просто объектно ориентирован (это язык с несколькими парадигмами), поэтому разработчики Python обычно предпочитают документацию, написанную человеком. Иногда функции важны, иногда важна структура класса.

Ответ 4

вы можете перейти к здесь и загрузить версию chm версии Python 3.1. При этом поиск в документах должен быть легким.

Ответ 5

Раньше я использовал боковую панель python от Edgewall.

В эти дни я google для функции python (стандартные документы почти всегда отображаются как первая ссылка). Если я хочу просмотреть источник модуля (иногда полезно), я использую эту небольшую функцию оболочки, которую я написал.

epy () {
    cmd="import $1 as a ; print a.__file__.endswith('.pyc') and a.__file__[:-1] or a.__file__" 
    file=$(/usr/bin/env python -c $cmd) 
    echo $file
    emacsclient --no-wait $file
}

Ответ 6

Наверное, я собираюсь получить downvoted, но я не вижу ничего плохого в документах Sphinx, и я нахожу их намного лучше, чем альтернатива java.