Python создаёт много файлов, которые не должны попадать в коммит: скомпилированный байткод (__pycache__, .pyc), директории виртуального окружения, пакеты дистрибуции, отчёты покрытия и специфичные настройки IDE.
Этот шаблон объединяет официальные правила GitHub для Python с правилами VirtualEnv и типичными паттернами IDE/ОС. Он работает с pip, poetry, pipenv, conda, pytest, mypy и всеми основными Python-воркфлоу.
Как использовать
1. Просмотрите предвыбранные шаблоны ниже
2. Добавьте или удалите шаблоны под ваш проект (например, добавьте Django, Flask)
3. Нажмите «Копировать» или «Скачать» чтобы получить файл
4. Положите его в корень проекта
Часто задаваемые вопросы
Нужно ли коммитить виртуальное окружение?
Никогда. Виртуальные окружения (venv, .venv, env) могут быть огромными и специфичны для конкретной машины. Добавьте их в .gitignore и используйте requirements.txt или pyproject.toml чтобы воссоздать окружение.
Нужно ли игнорировать __pycache__ и .pyc файлы?
Да. Это скомпилированные файлы байткода, автоматически создаваемые Python. Они специфичны для машины и будут пересозданы при запуске кода.
Нужно ли коммитить чекпоинты Jupyter?
Нет. Директория .ipynb_checkpoints автоматически создаётся Jupyter и должна игнорироваться. Сами ноутбуки (.ipynb файлы) нужно коммитить.