Modi alternativi per esplorare python api

Question

È solo per me, o la documentazione della libreria standard Python è estremamente difficile da consultare?

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

Java ha la sua brillante Javadocs, Ruby ha il suo utile Ruby-Docs, solo in pitone non riesco a trovare un buon modo per navigare attraverso la documentazione libreria standard.

C'è il progetto Epydoc, che sembra bello, ma qualcuno sa se è effettivamente utilizzato nella libreria standard, quindi possiamo esaminarlo? In caso contrario, quali sono le alternative che le persone stanno utilizzando per consultare la documentazione di Python.

Answer 1

Io di solito uso il pydoc integrato, se si è su Windows dovrebbe essere chiamato Module Docs se si utilizza linux pydoc -p 8000 e connettersi tramite browser.

Answer 2

si può andare a here e scaricare la versione chm di Python 3.1. Con questo, la ricerca attraverso i documenti dovrebbe essere facile.

Answer 3

pydoc dalla riga di comando, help() dal prompt dell'interprete interattivo.

Answer 4

pydoc -p 8080

La comunità pitone è semi-ostile a generare automaticamente la documentazione, soprattutto se è orientata agli oggetti. Python non è solo orientato agli oggetti (è un linguaggio multi-paradigma), quindi gli sviluppatori Python generalmente preferiscono la documentazione scritta da umani. A volte le funzioni sono importanti, a volte la struttura della classe è importante.

Answer 5

Ho usato il python sidebar da Edgewall molto tempo fa.

In questi giorni, io google per la funzione python (i documenti standard vengono visualizzati quasi sempre come il primo link). Se desidero sfogliare il codice sorgente del modulo (utile a volte), utilizzo questa piccola funzione di shell che ho scritto .

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

immagino che ho intenzione di ottenere downvoted ma trovo niente di sbagliato con i documenti Sfinge e li trovo modo il modo migliore di Java alternativo.