Υπάρχει κάποιος μηχανισμός για να σχολιάζετε μεγάλα τμήματα κώδικα Python;
Αυτή τη στιγμή, οι μόνοι τρόποι που μπορώ να δω για να σχολιάσω κώδικα είναι είτε να ξεκινάω κάθε γραμμή με ένα #
, είτε να περικλείω τον κώδικα σε τριπλά εισαγωγικά: """"
.
Το πρόβλημα με αυτούς τους τρόπους είναι ότι η εισαγωγή του #
πριν από κάθε γραμμή είναι δυσκίνητη και το """"
κάνει τη συμβολοσειρά που θέλω να χρησιμοποιήσω ως σχόλιο να εμφανίζεται στην παραγόμενη τεκμηρίωση.
Αφού διάβασα όλα τα σχόλια, η απάντηση φαίνεται να είναι "Όχι".
Η Python δεν διαθέτει τέτοιο μηχανισμό. Προσθέστε ένα #
σε κάθε γραμμή για να μπλοκάρετε το σχόλιο. Για περισσότερες πληροφορίες ανατρέξτε στο PEP 8. Τα περισσότερα IDEs της Python υποστηρίζουν έναν μηχανισμό που κάνει το block-commenting-with-pound-signs αυτόματα για εσάς. Για παράδειγμα, στο IDLE στον υπολογιστή μου, είναι Alt+3 και Alt+4.
Μην χρησιμοποιείτε τριπλά εισαγωγικά; όπως ανακαλύψατε, αυτό είναι για συμβολοσειρές τεκμηρίωσης και όχι για σχόλια μπλοκ, αν και έχει παρόμοιο αποτέλεσμα. Αν'απλά σχολιάζετε πράγματα προσωρινά, αυτό είναι μια χαρά ως προσωρινό μέτρο.
Ο μόνος τρόπος για να το κάνετε αυτό χωρίς τριπλά εισαγωγικά είναι να προσθέσετε ένα:
if False:
Και στη συνέχεια να κάνετε εσοχή σε όλο τον κώδικά σας. Σημειώστε ότι ο κώδικας θα πρέπει και πάλι να έχει σωστή σύνταξη.
Πολλά IDEs της Python μπορούν να προσθέσουν #
για εσάς σε κάθε επιλεγμένη γραμμή και να τα αφαιρέσουν όταν αποσύρετε τον σχολιασμό. Ομοίως, αν χρησιμοποιείτε το vi ή το Emacs μπορείτε να δημιουργήσετε μια μακροεντολή που θα το κάνει αυτό για εσάς για ένα μπλοκ κώδικα.