✧ Готовим рабочее место ✧

🚀 Запускаем

Это урок про терминал на твоём компьютере: песочница курса тут не поможет, у неё нет доступа к сети и установке пакетов. Python уже установлен? Открой терминал (в Windows — PowerShell, в macOS и Linux — «Терминал») и проверь:

python --version

Если команда ответила чем-то вроде Python 3.12.4, всё готово. На macOS и Linux команда может называться python3. Дальше будем делать для проекта собственное «рабочее место»: так программы с разными зависимостями не мешают друг другу.

📜 Теория: окружение, пакеты, версии

Виртуальное окружение

python -m venv .venv                 # создать окружение в папке .venv

.venv\Scripts\activate               # Windows (PowerShell)
source .venv/bin/activate            # macOS и Linux

deactivate                           # выйти из окружения

Пакеты, которые ты ставишь, по умолчанию попадают в один общий Python. Когда у двух проектов разные требования (одному нужна версия 1, другому версия 2), они начинают конфликтовать. Виртуальное окружение — отдельная копия Python для одного проекта: пакеты ставятся внутрь и на другие проекты не влияют. После активации в начале строки терминала появляется (.venv). Заводи окружение для каждого проекта: привычка быстро окупается.

pip: установка пакетов

pip install requests                 # поставить пакет
pip install "requests==2.32.3"       # поставить определённую версию
pip list                             # что установлено
pip freeze > requirements.txt        # записать версии в файл
pip install -r requirements.txt      # поставить всё из файла
pip uninstall requests               # удалить

pip скачивает пакеты из общего каталога PyPI (pypi.org). Файл requirements.txt — список того, что нужно проекту: друг, у которого этого нет, ставит всё одной командой. Прежде чем ставить пакет, проверь, что это именно тот, кто тебе нужен: на PyPI встречаются подделки с похожими названиями, поэтому смотри на число скачиваний, ссылку на репозиторий и дату последнего обновления.

Git: история изменений

git init                              # начать следить за папкой
git status                            # что изменилось
git add main.py                       # отметить файл в следующий снимок
git commit -m "Добавил расчёт смолы"  # сделать снимок с подписью
git log --oneline                     # история снимков

Git хранит историю проекта как цепочку снимков (коммитов): можно вернуться к любому, посмотреть, что и когда менялось, откатить неудачную правку. Если код когда-нибудь сломается, ты всегда найдёшь последнюю рабочую версию. Коммит лучше делать, когда сделал одну законченную вещь, и подписывать так, чтобы через месяц было понятно, о чём он.

Чтобы Git не следил за лишним, создай файл .gitignore и перечисли в нём то, что хранить не надо:

.venv/
__pycache__/
*.log
.env

Папку окружения, служебные файлы Python, журналы и файл с секретами в репозиторий не кладут. Выкладывать код на GitHub можно позже, когда освоишь основы: команды git remote add и git push об этом.

Минимальный порядок в проекте

mkdir resin-helper
cd resin-helper
python -m venv .venv
.venv\Scripts\activate
git init
echo .venv/ > .gitignore

Пять команд — и у проекта есть своя папка, своё окружение и история. Осталось добавить main.py, README.md и requirements.txt, и это уже полноценный проект.

🧪 Попробуй сам

✅ Что мы узнали

Для каждого проекта заводят виртуальное окружение (python -m venv .venv), чтобы пакеты разных проектов не конфликтовали. Пакеты ставит pip, а список требований хранится в requirements.txt. История правок живёт в Git: add, commit, log, а лишнее исключает .gitignore.

Ошибки, файлы, модули и инструменты теперь есть. Дальше будем описывать мир не набором функций, а объектами: пора знакомиться с классами.

⟵ Ведём журнал Описываем героя классом ⟶