Стиль программирования, комментарии и строки документации

Про стиль, оформление и т. п. есть целое сообщество: PyCQA

О дисциплине разработки:

Оформление кода

pep-0008 — рекомендации к оформлению кода.

pep-0257 — рекомендации к оформлению строк документации

Анализаторы кода (см. сайт PyCQA):

Регламент или стандарт?

“A foolish consistency is the hobgoblin of little minds, adored by little statesmen and philosophers and divines. With consistency a great soul has simply nothing to do. He may as well concern himself with his shadow on the wall. Speak what you think now in hard words, and to-morrow speak what to-morrow thinks in hard words again, though it contradict every thing you said to-day. — 'Ah, so you shall be sure to be misunderstood.' — Is it so bad, then, to be misunderstood? Pythagoras was misunderstood, and Socrates, and Jesus, and Luther, and Copernicus, and Galileo, and Newton, and every pure and wise spirit that ever took flesh. To be great is to be misunderstood.”

Из личных наблюдений

Что (почти) не покажут анализаторы кода

Комментарии

Аннотирование

Напомню:

Д/З

  1. Зарегистрировать свой совместный проект

    • Создать публичный репозиторий
    • Повесить заявку с названием проекта здесь. В заявке указать

      • Ссылку на git-репозиторий с проектом
      • Имена (ФИО, группа) участников
      • Ники, под которыми они коммитят в проект
  2. Разработать и опубликовать в репозитории постановку задачи

    • Проще всего описать её в README-файле

  3. Разработать и опубликовать в репозитории интерфейсную модель будущего приложения
    • Смысл модели — в том, чтобы я мог оценить объём работ (и мысленно поделить его на количество участников)
    • Если вы разрабатываете не GUI-приложение, какая-то модель всё равно должна быть — проект API, описание каких-то составных частей и их взаимодействия и т. п. Ещё один смысл модели — в том, чтобы вы заранее представляли, что именно будете делать ☺

  4. Привести имеющийся код проекта в соответствие с требованиям по стилю

    • Создать настроечный файл, в котором изменить умолчания, если они не соответствуют принятой вами дисциплине разработки

LecturesCMC/PythonDevelopment2021/07_Style (последним исправлял пользователь FrBrGeorge 2021-04-01 11:51:54)