Alternative Möglichkeiten zum Durchsuchen der Python api

Question

Ist es nur ich, oder die Python-Standardbibliothek Dokumentation ist extrem schwierig zu durchsuchen?

• http://docs.python.org/3.1/library/index.html
• http://docs.python.org/3.1/modindex.html

Java hat seine brillante Javadocs, Ruby hat seine hilfreich Ruby-Docs, nur in Python kann ich nicht einen guten Weg finden, über die Standard-Bibliothek Dokumentation zu navigieren.

Es gibt das Projekt Epydoc, das nett aussieht, aber weiß jemand, ob es tatsächlich auf der Standardbibliothek verwendet wird, so dass wir alle durchgehen können? Falls nicht, welche Alternativen werden von Benutzern zum Durchsuchen der Python-Dokumentation verwendet?

Answer 1

Normalerweise verwende ich die integrierte pydoc, wenn Sie unter Windows sind, sollte es Module Docs aufgerufen werden, wenn Sie unter Linux pydoc -p 8000 verwenden und über den Browser verbinden.

Answer 2

können Sie gehen zu here und laden Sie die CHM-Version von Python 3.1. Die Suche in den Dokumenten sollte daher einfach sein.

Answer 3

pydoc von der Befehlszeile, help() von der interaktiven Interpreter-Eingabeaufforderung.

Answer 4

pydoc -p 8080

Die Python-Community ist semi-feindliche Dokumentation automatisch erzeugt, vor allem, wenn es Objektorientiert. Python ist nicht nur objektorientiert (es ist eine Sprache mit mehreren Paradigmen), so dass Python-Entwickler im Allgemeinen eine von Menschen geschriebene Dokumentation bevorzugen. Manchmal sind die Funktionen wichtig, manchmal ist die Klassenstruktur wichtig.

Answer 5

Früher habe ich die python sidebar von Edgewall verwendet.

In diesen Tagen google ich für die Python-Funktion (die Standard-Dokumentation fast immer als erster Link angezeigt). Wenn ich die Quelle des Moduls (nützlich manchmal) durchsuchen möchte, verwende ich diese kleine Shell-Funktion, die ich schrieb .

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 
} 

Answer 6

Ich glaube, ich werde downvoted zu bekommen, aber ich finde nichts falsch mit der Sphinx-Dokumentation und ich finde sie Art und Weise Art und Weise besser als die Java-Alternative.