Commentaire d'un bloc de code Python

Question

Est-il un mécanisme pour commenter les gros blocs de code Python?

Maintenant, la seule façon que je peux voir de commenter le code, soit de commencer chaque ligne avec un #, ou de placer le code entre guillemets triples: """.

Le problème avec ces derniers est que l'insertion d' # devant chaque ligne est lourd et """ rend la chaîne que je veux utiliser comme un commentaire apparaître dans la documentation générée.

Après avoir lu tous les commentaires, la réponse semble être "Non".

Answer 1

Python n'a pas un tel mécanisme. Ajouter un # pour chaque ligne de bloc de commentaire. Pour plus d'informations, voir la PEP 8. La plupart Python IDEs de soutenir un mécanisme pour faire le bloc-commentaires-avec-livre-des signes automatiquement pour vous. Par exemple, à la position de RALENTI sur ma machine, c'est Alt+3 et Alt+4.

N'utilisez pas de triple-citations; comme vous l'avez découvert, c'est pour la documentation des chaînes de ne pas bloquer les commentaires, bien qu'il dispose d'un effet similaire. Si vous êtes juste de commenter les choses temporairement, c'est très bien comme une mesure temporaire.

Answer 2

Masquer le triple guillemets dans un contexte qui ne sera pas confondu avec une docstring, par exemple:

'''
...statements...
''' and None

ou:

if False: '''
...statements...
'''

Answer 3

Le seul remède que je sais c'est un bon éditeur. Désolé.

Answer 4

La seule façon vous pouvez le faire sans triple guillemets est pour ajouter un:

if False:

Et puis tiret tout votre code. Notez que le code aura toujours besoin d'avoir une syntaxe correcte.

---

De nombreux Python IDEs pouvez ajouter # pour vous sur chaque ligne sélectionnée, et de les supprimer lors de la décommentant trop. De même, si vous utilisez le vi ou Emacs , vous pouvez créer une macro pour le faire pour vous pour un bloc de code.

Answer 5

M-x commentaire-région, dans Emacs' Python mode.