По этой причине приложение никогда не должно обрабатывать временные метки без часового пояса. Оно должно вызывать ошибку, если часовой пояс не предоставлен, или же явно указывать, какой часовой пояс используется по умолчанию, — например, распространенной практикой считается выставлять UTC.
Фактически Sphinx — это стандарт документирования проектов на Python.
Разработка через тестирование — это очень эффективный способ написания библиотек, особенно для Python, потому что он заставляет разработчика с самого начала рассматривать программу и с точки зрения пользователя, что в итоге улучшает дизайн и удобство использования.
Если вы с самого начала будете разрабатывать приложение как библиотеку, а затем уже использовать ее для решения своей задачи, то это гарантирует, что код будет организован в логические блоки, а также будет удобен для тестирования.
Я также обнаружил, что написание документации к библиотеке до написания кода позволяет более ясно представить возможности и требования к ней, без продумывания деталей реализации. Это сообщает пользователю о намерениях, которыми я руководствовался при проектировании библиотеки.
установка flake8-import-order (командой pip install flake8-import-order) расширит flake8 так, что он проверит расположение всех строк import вашего кода в алфавитном порядке
Используйте четыре пробела на каждый уровень отступа.
• Ограничьте длину строки максимум 79 символами.
• Отделяйте функции верхнего уровня и определения классов двумя пустыми строками.
• Кодируйте файлы с помощью ASCII или UTF-8
Декоратор — это функция, которая принимает другую функцию в качестве аргумента и заменяет ее новой, модифицированной. Основное назначение декораторов — факторизация кода, который должен быть вызван до, после или вокруг других функций.