2012-02-20 2 views
1

Мне нужно что-то, что принимает все мои установленные яйца (скорее всего, с помощью pip) и, как и gem server, запускает локальный сервер, который показывает документацию (если таковые имеются) для установленных пакетов.Является ли что-то вроде «gem server» для яиц python (например, «pip server»)

Это, вероятно, трудно сделать в общем случае, потому что есть разные способы документировать яйца питона. Я хотел бы что-то, что:

  • Использование setuptools/распространение для извлечения документации о пакете.
  • Интеграция со сфинксами.
  • По умолчанию проверяется модуль пакета (снова полученный с помощью setuptools).

С уважением, Manuel.

ответ

0

Существует pydoc, но он не использует setuptools и не интегрируется с Sphinx.

Но в стандартной библиотеке и слишком прост в установке:

$ python -m pydoc -p 8080 

Откройте браузер на http://localhost:8080 и посмотреть на себя.

PS: Причина, по которой я решил использовать python -m pydoc вместо pydoc, заключается в том, что по умолчанию он не будет ловить пакеты, установленные в virtualenv. См. Этот старый выпуск: https://bugs.launchpad.net/virtualenv/+bug/315990