Найти тему
programmer's notes (python and more)

Программирование на Python. Базовый курс. Особенности комментирования программного кода

Оглавление

Доброго времени суток, читатели, зрители моего канала programmer's notes. Не забывайте подписываться и писать свои комментарии к моим статьям и видео.

А это ссылки на подборку по основному курсу по Python

Базовый курс программирования на Python | programmer's notes (python and more) | Дзен
Философия программирования | programmer's notes (python and more) | Дзен

Комментирование в программах на языке Python

Написав философское эссе по поводу комментирования программ, я вдруг вспомнил, что в базовом курсе у меня нет статьи о комментариях в языке Python. Для полноты изложения я решил добавить такую статью.

Простые комментарии

В Python для включения в программу комментария используется знак '#' (решётка).

  • Комментарий в отдельной строке
    # получить список файлов, содержащих списки сотрудников
    ls = lst()
  • Встроенный комментарий. Комментарий помещается в конце исполняемой строки
    A = B = C = 0 # инициализация переменных
  • Если нужно сделать многострочный комментарий, то каждая строка будет начинаться с '#'.

Строковая документация

В Python есть специальные многострочный комментарии. Обычно их используют для комментария функций или методов (строковая документация по функции). Такие комментарии выделяются с двух сторон тройными кавычками. Одинарными или двойными. Такой комментарий может быть в нескольких строках.

Если обычный комментарий игнорируется интерпретатором, то данный комментарий компилируется в результирующий байт-код.

На картинке представлена программа с таким комментарием.

Пример документированной функции
Пример документированной функции

Если выполнить в программе

help(proc1)

то будет выведено

Help on function proc1 in module __main__:

proc1()
   пример использования
   функции  
   globals

Более удобный вариант

print(proc1.__doc__)

Смысл такого комментария-документации заключается в том, что если у вас есть файл с текстом, состоящим из множества функций, то имея список функций можно получить по каждой из них помощь.

Конечно, комментарии с тройными кавычками могут быть размещены в любом месте программы, но обычно этим не пользуются.

Хорошего программирования. Оставляйте свои комментарии, не забывайте про лайки и подписывайтесь на мой канал programmer's notes.

Почему-то компилятору плевать на мои комментарии
Почему-то компилятору плевать на мои комментарии