Первый блокнот Python: запустить, сохранить, повторить

После истории с выручкой Бран просит не цифру, а расчёт, который можно перепроверить без тебя. Часть такой работы в SQL не помещается: проверка теста, график, отчёт, который сам собирается по понедельникам. Ким разворачивает к тебе ноутбук.

В прошлом уроке правило расчёта получило имя в базе. Теперь подготовь место для расчётов вне базы. Сегодня не подключаем выгрузку и не изучаем библиотеки анализа: сначала запусти две строки и научись получать тот же результат с чистого старта.

Вот весь первый расчёт. Пока посмотри на него; место для запуска подготовишь ниже.

print("Хроники Пограничья")
print(120 + 30)

Он выведет название игры, а под ним число 150.

Python считает, Jupyter хранит рассказ

Python исполняет написанные тобой команды. Программа, которая читает и выполняет код Python, называется интерпретатором.

JupyterLab открывает в браузере рабочую страницу: там рядом живут код, результаты и пояснения. Такой документ называется блокнотом. Jupyter не заменяет Python: он передаёт твой код отдельному процессу Python, который считает ответ.

Представь рабочую тетрадь и калькулятор. Блокнот хранит записи, а калькулятор выполняет вычисления. Закрытая тетрадь не считает сама.

В обычном файле main.py команды идут сверху вниз за один запуск. Блокнот делится на ячейки: ты можешь запускать каждую отдельно. Так удобно исследовать данные, но за порядком запусков придётся следить.

Подготовь отдельное окружение

Понадобится установленный Python 3.11 или новее. Если Python ещё нет, возьми установщик с официальной страницы. На Windows установи и средство запуска py, если установщик предлагает этот пункт.

Открой терминал операционной системы. На macOS это приложение Terminal, на Linux терминал твоего рабочего стола, на Windows PowerShell. Следующие команды вводятся туда, а не в ячейку блокнота.

Создай папку для учебной работы и перейди в неё:

mkdir chronicles-python
cd chronicles-python

mkdir создаёт папку, cd делает её текущей. В командах ниже относительные пути считаются от этой папки. Если папка уже есть, повторять mkdir не нужно: перейди в неё через cd.

Виртуальное окружение отделит инструменты «Хроник» от остальных проектов. Назовём его папку .venv.

На macOS или Linux:

python3 --version
python3 -m venv .venv
source .venv/bin/activate

На Windows в PowerShell:

py --version
py -m venv .venv
.\.venv\Scripts\Activate.ps1

Первая команда показывает версию. Вторая создаёт окружение. В записи -m venv ключ -m просит Python запустить встроенный инструмент venv. Третья команда активирует окружение в текущем терминале.

Если PowerShell запрещает выполнение Activate.ps1, не меняй политику безопасности компьютера ради урока. Открой обычную командную строку Windows (cmd), перейди в ту же папку и выполни:

.venv\Scripts\activate.bat

На Linux сообщение об отсутствии venv означает, что для твоей установки Python нужен системный пакет с поддержкой venv. Его название и команду установки проверь в документации дистрибутива. На рабочем компьютере с ограничениями попроси администратора установить Python и этот пакет.

После активации имя .venv обычно видно в начале приглашения терминала. Теперь команда python должна указывать на Python этого окружения. Установи инструменты и запусти Jupyter:

python --version
python -m pip install jupyterlab ipykernel
python -m jupyter lab

pip устанавливает пакеты, то есть дополнительные инструменты для Python. Запись python -m pip связывает установку с выбранным Python, а не со случайным pip из другой установки. Тем же способом python -m jupyter lab запускает JupyterLab из этого окружения.

Версии пакетов здесь не зафиксированы. В долгом рабочем проекте к командам добавляют список точных версий, а сегодня задача скромнее: не смешать разные установки Python.

Не закрывай этот терминал, пока работаешь в Jupyter. Команда запустит локальный сервер и обычно откроет браузер. Если браузер не открылся, перейди по адресу, который напечатан в терминале. Адрес с токеном доступа не пересылай другим людям.