API du langage Python [fermé]
-
02-07-2019 - |
Question
Je commence avec Python venant de Java.
Je me demandais s'il existait quelque chose de similaire à l'API JavaDoc où je pouvais trouver la classe, ses méthodes et un exemple d'utilisation.
J'ai trouvé très utile d'utiliser aide (chose) à partir de Python (ligne de commande)
J'ai aussi trouvé ceci:
https://docs.python.org/2/py-modindex.html
Mais cela semble aider lorsque vous avez déjà le nom de la classe que vous recherchez. Dans JavaDoc API, toutes les classes sont disponibles. Par conséquent, si j’ai besoin de quelque chose, je fais défiler jusqu’à une classe qui ressemble à " ressemble à " Ce dont j'ai besoin. Parfois, il suffit de parcourir toutes les classes pour voir ce qu’elles font, et quand j’ai besoin d’une fonction, mon cerveau me rappelle Nous avons vu quelque chose de similaire dans le javadoc. Rappelez-vous!?
Mais je ne semble pas trouver la même chose en Python (pour le moment) et c’est pourquoi je publie cette question.
BTW, je sais que je finirai par lire ceci:
https://docs.python.org/2/library/
Mais bon, je pense que ce n'est pas aujourd'hui.
La solution
pydoc ?
Je ne suis pas sûr que vous recherchiez quelque chose de plus sophistiqué, mais c'est ce qui se passe.
Autres conseils
La bibliothèque standard Python est assez bien documentée. Essayez de vous lancer dans python et d'importer un module en disant "os". et en cours d'exécution:
import os
help(os)
Ceci lit les chaînes de documentation sur chacun des éléments du module et les affiche. C’est exactement ce que pydoc fera aussi.
EDIT: epydoc est probablement exactement ce que vous recherchez:
J'ai téléchargé Python 2.5 à partir de Python.org et ne contient pas pydoc.
Directorio de C:\Python25
9/23/2008 10:45 PM <DIR> .
9/23/2008 10:45 PM <DIR> ..
9/23/2008 10:45 PM <DIR> DLLs
9/23/2008 10:45 PM <DIR> Doc
9/23/2008 10:45 PM <DIR> include
9/25/2008 06:34 PM <DIR> Lib
9/23/2008 10:45 PM <DIR> libs
2/21/2008 01:05 PM 14,013 LICENSE.txt
2/21/2008 01:05 PM 119,048 NEWS.txt
2/21/2008 01:11 PM 24,064 python.exe
2/21/2008 01:12 PM 24,576 pythonw.exe
2/21/2008 01:05 PM 56,354 README.txt
9/23/2008 10:45 PM <DIR> tcl
9/23/2008 10:45 PM <DIR> Tools
2/21/2008 01:11 PM 4,608 w9xpopen.exe
6 archivos 242,663 bytes
Mais il a (le substitut je suppose) pydocgui ...
C:\Python25>dir Tools\Scripts\pydocgui.pyw
10/28/2005 07:06 PM 222 pydocgui.pyw
1 archivos 222 bytes
Ceci lance un serveur Web et montre ce que je cherchais. Tous les modules ainsi que toutes les classes fournies avec la plate-forme.
Le répertoire Doc contient la même chose que dans:
Merci beaucoup de me guider vers pydoc.
BTW je sais que je finirais par va lire ceci:
http://docs.python.org/lib/lib.html
Mais bon, je pense que ce n'est pas aujourd'hui.
Je suggère que vous faites une erreur. La bibliothèque doc a "la classe, ses méthodes et un exemple d'utilisation". C’est ce que vous recherchez.
J'utilise Java et Python tout le temps. Creusez dans la documentation de la bibliothèque, vous trouverez tout ce que vous cherchez.
Vous pouvez définir la variable d'environnement PYTHONDOCS de manière à indiquer l'emplacement d'installation de la documentation Python.
Sur mon système, il se trouve dans /usr/share/doc/python2.5
Vous pouvez donc définir cette variable dans votre profil de shell ou ailleurs, en fonction de votre système:
exportez PYTHONDOCS = / usr / share / doc / python2.5
Désormais, si vous ouvrez une console Python interactive, vous pouvez appeler le système d’aide. Par exemple:
>>> help(Exception) >>> Help on class Exception in module exceptions: >>> class Exception(BaseException) >>> | Common base class for all non-exit exceptions. >>> | >>> | Method resolution order: >>> | Exception
La documentation est ici:
Ici est une liste de tous les modules de Python. Vous n'êtes pas sûr que ce soit ce que vous êtes vraiment après.
Si vous travaillez sous Windows, ActiveState Python est fourni avec la documentation. , y compris la référence de la bibliothèque dans un fichier d’aide interrogeable.
Essayez aussi
pydoc -p 11111
Ensuite, saisissez le navigateur Web http: // localhost: 11111
.EDIT: vous pouvez bien sûr utiliser n'importe quelle autre valeur pour le numéro de port au lieu de 11111
Cela ne répond pas directement à votre question (je vais donc probablement être rétrogradé), mais vous pourriez être intéressé par Jython .
Jython est une implémentation du langage Python de haut niveau, dynamique et orienté objet, écrit en 100% Pure Java et intégré de manière transparente à la plate-forme Java. Il vous permet donc d’exécuter Python sur n’importe quelle plate-forme Java.
Puisque vous venez de Java, Jython peut vous aider à tirer parti de Python tout en vous permettant d'utiliser vos connaissances en Java.