Ubuntu-fr

Calimo

documentation python

Bonjour à tous,

Je débute en Python. J'ai lu plusieurs tutoriels, mais il me manque quelque chose : une bonne documentation (guide de référence), exhaustive, cherchable facilement et compréhensible par un être humain (moi ). Un peu du style perldoc.perl.org pour Perl...

En particulier une liste des fonctions (et/ou méthodes) me serait très très utile (notez le classement des fonctions par catégorie sur perldoc qui est très très très utile ).

Si vous avez ça sous le coude... merci !

PS : j'ai bien trouvé le manuel de référence Python, mais il n'est pas vraiment ce que j'appellerais "human-readable", c'est plutôt une spécification du langage... (ou alors j'ai pas compris comment il fonctionne, ce qui est parfaitement possible).
PPS : pas nécessairement besoin que ce soit en français.

Dernière modification par Calimo (Le 01/07/2007, à 17:25)

yaourt

Re : documentation python

Je te conseille apprendre à programmer en python qui est vraiment pas mal pour les débutants( ce qui n'est peut-être pas ton cas).

A+

---

314r.fr

Calimo

Re : documentation python

Salut !
Je n'ai peut-être pas été assez clair, je n'ai pas besoin d'un tutoriel (en plus, je l'avais déjà celui-ci, il est très bien d'ailleurs ),  ce que je cherche c'est vraiment un guide de référence complet...

Merci quand-même

PS : peut-être est-ce ma définition de "guide de référence" qui n'est pas clair ? Je ne sais pas trop comment l'exprimer, mais c'est selon moi une référence complète de tout ce qui est possible, au contraire d'un tutoriel qui avance pas par pas...

Dernière modification par Calimo (Le 01/07/2007, à 17:28)

aleph

Re : documentation python

> Calimo

J'ai vu sur ton CV que tu connais déjà la programmation. Dans ce cas, voici l'approche généralement conseillée pour découvrir et se familiariser avec ce langage.

1) Jeter un oeil sur le tutoriel. Etape indispensable, même pour un programmeur expérimenté, car c'est ce tutoriel qui montre ce qu'est Python. http://docs.python.org/tut/tut.html . Lire le tutoriel au complet et dans l'ordre. Il est fortement conseillé, pour ne pas dire obligatoire, d'ouvrir une console Python et de s'amuser avec les exemples du tutoriel ou ses propres exercices.

Arrivé au bout, tu connais le 100% du langage et tu comprends ceci

>>> print ('salut' if -1.5 <= 0 < 5 else 'au revoir')
salut
>>> li = [e for e in range(10) if e > 5]
>>> li
[6, 7, 8, 9]

Une lecture du tutoriel est importante car c'est la documentation officielle. Le tutoriel est mise à jour à chaque nouvelle version et présente implicitement les nouveautés.

2) La partie "Language Reference" n'est pas destinée aux débutants. Elle explique la sémantique du langage.
"This reference manual describes the Python programming language. It is not intended as a tutorial."

3) Ce que tu cherche est ici  http://docs.python.org/lib/lib.html et là http://docs.python.org/modindex.html .Classement par modules et non par fonctions.

4) La documentation officielle et complète est disponible et téléchargeable ici, http://docs.python.org/index.html . Consultable hors-ligne elle contient les docs cités plus haut. Elle existe sous différentes formes html, pdf, chm, ... la version la plus aisée à utiliser étant la version chm (index de recherche très complet).

5) Bien du plaisir.

Mon site, orienté Python http://spinecho.ze.cx/

Calimo

Re : documentation python

Effectivement, même si je ne suis pas vraiment programmeur, je suis assez à l'aise avec Perl, et j'ai envie de découvrir autre chose (en particulier l'"orienté objet" que beaucoup de monde semble apprécier un peu partout)... d'où Python.

3) Ce que tu cherche est ici  http://docs.python.org/lib/lib.html et là http://docs.python.org/modindex.html .Classement par modules et non par fonctions.

Merci, ça ressemble assez à ce que je cherche, je regarderai tout ça attentivement.
Pour le tutorial, justement, c'est en le suivant et en essayant de jouer autour que je cherche à faire ce que je fais avec un "redo" en Perl... d'où le besoin d'avoir une référence bien complète

Merci

Dernière modification par Calimo (Le 01/07/2007, à 20:57)