04.05 Стиль программирования, комментарии и строки документации
- Стиль
Задача_1: программа, к которой применять flake8 и pydocstyle
Взять Задачу_2 из https://uneex.org/LecturesCMC/PythonDevelopment2021/Prac/04_PublicRepositoryEvents (вы ведь наверняка её уже решили...)
- Оформить реализацию tkinter-приложения в виде класса.
Оформить вызов приложения в виде функии __main__()
Установка и использование flake8
лайфхак: pep8ify
Настройка .flake8 (в частности, длины строк)
Установка и использование pydocstyle
- Ах вот ты какая, каноническая строка документации
- Семестровый проект
- Посчитаться
- Для не-желающих выдумывать: написать «Демо для библиотеки»:
- Общее задание: примеры использования методов некоторого модуля python, с показом исходного кода этих примеров, небольшим пояснительным текстом как к примерам, так и к самим функциям, и возможностью запустить пример и посмотреть результаты его работы
- GUI:
- выбор примеров из списка
- небольшая помощь (на английском, потом будет перевод)
- просмотр кода
- окно для демонстрации примера
- кнопки управления
- Не обязательно использовать tkinter, можно что-нибудь другое
- Предусмотреть для каждого примера
- ввод входных данных для примеров (если данные простые)
- выбор из нескольких комплектов заранее подготовленных входных данных
- Всю логику вынести из GUI-модуля для того, чтобы была возможность проводить unit-тесты. В MVC модели этому соответствуют части Control и Model.
- … (что-то ещё, что возникнет по мере обсуждения)
Д/З
- Оформить логику приложения в виде отдельного модуля, а интерфейс — в виде другого или в виде основной программы.
- Добиться полного отсутствия претензий со стороны flake8/pydocstyle к Задаче_1, выложить её в отчётный репозиторий стандартным способом