Comments on: Les docstrings en Python http://sametmax.com/les-docstrings/ Deux développeurs en vadrouille qui se sortent les doigts du code Wed, 05 Feb 2014 12:15:31 +0000 hourly 1 http://wordpress.org/?v=3.3.1 By: Luigi http://sametmax.com/les-docstrings/#comment-8884 Luigi Wed, 15 May 2013 11:26:14 +0000 http://sametmax.com/?p=570#comment-8884 Plutôt que de passer des heures sur le web à chercher les conventions, un petit tour sur S&M et c'est du tout cuit. Encore merci les gars ! Plutôt que de passer des heures sur le web à chercher les conventions, un petit tour sur S&M et c’est du tout cuit.

Encore merci les gars !

]]> By: Sam http://sametmax.com/les-docstrings/#comment-6774 Sam Sat, 09 Mar 2013 09:24:57 +0000 http://sametmax.com/?p=570#comment-6774 La description générale, c'est au niveau du module. Dans la description de la classe, tu trouveras des instructions spécifiques à la classe. Mais on est pas en java, en Python y a pas forcément une classe par module. Je dirais même qu'architecturalement, c'est pas idéal de tout mettre dans une seule classe. La description générale, c’est au niveau du module.

Dans la description de la classe, tu trouveras des instructions spécifiques à la classe.

Mais on est pas en java, en Python y a pas forcément une classe par module. Je dirais même qu’architecturalement, c’est pas idéal de tout mettre dans une seule classe.

]]> By: Réchèr http://sametmax.com/les-docstrings/#comment-6769 Réchèr Sat, 09 Mar 2013 08:20:32 +0000 http://sametmax.com/?p=570#comment-6769 Pas compris le dernier commentaire de Max. Par conséquent, je requiers un tampon kamoulox. Dans la plupart des cas, on a un module, avec une seule classe dedans. La description générale de ce que ça fait, il vaut mieux la mettre dans une docstring au niveau module, ou au niveau classe ? (J'ai lu en diagonale le PEP256, je n'ai pas trouvé de convention à ce sujet.) Pas compris le dernier commentaire de Max. Par conséquent, je requiers un tampon kamoulox.

Dans la plupart des cas, on a un module, avec une seule classe dedans. La description générale de ce que ça fait, il vaut mieux la mettre dans une docstring au niveau module, ou au niveau classe ?

(J’ai lu en diagonale le PEP256, je n’ai pas trouvé de convention à ce sujet.)

]]> By: Max http://sametmax.com/les-docstrings/#comment-6720 Max Thu, 07 Mar 2013 13:33:02 +0000 http://sametmax.com/?p=570#comment-6720 allez-y madame la machine...allez-y allez-y madame la machine…allez-y

]]> By: kontre http://sametmax.com/les-docstrings/#comment-6714 kontre Thu, 07 Mar 2013 10:03:19 +0000 http://sametmax.com/?p=570#comment-6714 Après test, le :Example: n'est pas une commande spéciale dans sphinx, on peut mettre n'importe quoi entre :: et ça fait une section. Le .. todo:: n'est pas actif par défaut dans sphinx, d'ailleurs, ça rejoint ton avis ! ;) Perso je l'utilise quand même parce que je fais surtout de la doc pour dev. Après test, le :Example: n’est pas une commande spéciale dans sphinx, on peut mettre n’importe quoi entre :: et ça fait une section.
Le .. todo:: n’est pas actif par défaut dans sphinx, d’ailleurs, ça rejoint ton avis ! ;) Perso je l’utilise quand même parce que je fais surtout de la doc pour dev.

]]> By: Sam http://sametmax.com/les-docstrings/#comment-6713 Sam Thu, 07 Mar 2013 09:38:12 +0000 http://sametmax.com/?p=570#comment-6713 Mon enfance vient d'être violée. Mon enfance vient d’être violée.

]]> By: Recher http://sametmax.com/les-docstrings/#comment-6711 Recher Thu, 07 Mar 2013 07:59:52 +0000 http://sametmax.com/?p=570#comment-6711 Wouah, je savais pas qu'il y avait toutes ces conventions et syntaxes dans les docstrings. Pour vous remercier, voici une <a href="http://www.costumesupercenter.com/sexy+costumes-tv+movie/FW102744-adult-sexy-olive-oyl-costume.html" rel="nofollow">Olive Oil</a>, qui sera certainement ravie d'aider à effectuer le todo sus-mentionné. Wouah, je savais pas qu’il y avait toutes ces conventions et syntaxes dans les docstrings.

Pour vous remercier, voici une Olive Oil, qui sera certainement ravie d’aider à effectuer le todo sus-mentionné.

]]> By: Sam http://sametmax.com/les-docstrings/#comment-6707 Sam Wed, 06 Mar 2013 23:05:32 +0000 http://sametmax.com/?p=570#comment-6707 @Etienne : au final, c'est toujours la faute de Max. C'est son rôle dans l'équipe. @Etienne : au final, c’est toujours la faute de Max. C’est son rôle dans l’équipe.

]]> By: Sam http://sametmax.com/les-docstrings/#comment-6706 Sam Wed, 06 Mar 2013 23:03:17 +0000 http://sametmax.com/?p=570#comment-6706 Je vois que monsieur est un connaisseur. Je vois que monsieur est un connaisseur.

]]> By: JEEK http://sametmax.com/les-docstrings/#comment-6704 JEEK Wed, 06 Mar 2013 22:18:33 +0000 http://sametmax.com/?p=570#comment-6704 Aaaaah The Glitch Mob, excellent choix... ...z'êtes bien éclectiques les loulous ! ;-) Du même groupe, je conseille aussi <a href="http://www.youtube.com/watch?v=axveyzma3mA&list=UUvHzs2C_iK8VLV41JgQPyug&index=13" rel="nofollow">Palace of the innocents</a> et <a href="http://www.youtube.com/watch?annotation_id=annotation_534130&feature=iv&src_vid=axveyzma3mA&v=-lszdEZ0-74" rel="nofollow">Warrior concerto</a> : ça pousse bien ! \o/ Aaaaah The Glitch Mob, excellent choix…
…z’êtes bien éclectiques les loulous !
;-)

Du même groupe, je conseille aussi Palace of the innocents et Warrior concerto : ça pousse bien !
\o/

]]>