Введение

Как проходить курс

Структура учебного проекта

Для удобства выполнения упражнений и организации файлов на своём компьютере, рекомендуется придерживаться следующей структуры папок:

Создай общую папку deproschool, в ней будут подпапки и файлы для разных упражнений.

Нажми на структуру папок ниже, чтобы увидеть рекомендуемую организацию файлов:

deproschool
ℹ️

Папки модулей начинаются с цифры (1_pizzacity, 2_counter-strike), чтобы они всегда отображались в правильном порядке в любом файловом менеджере, иначе они могут отображаться в алфавитном порядке, что может запутать.

ℹ️

Я вам рекомендую загружать код проекта (с имеющейся структурой папок) на GitHub, чтобы не потерять его и иметь доступ к нему с любого устройства. Если вы не знакомы с GitHub, это отличный повод начать его использовать - он очень полезный для управления кодом и проектами.

Установка зависимостей

Чтобы учиться работать с данными и запускать скрипты, нужно устанавливать необходимые библиотеки. Рекомендуется использовать виртуальное окружение для изоляции зависимостей проекта.

Все Python-зависимости устанавливайте в виртуальное окружение внутри вашей папки deproschool:

Находясь в папке deproschool, в терминале выполните следующие команды:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
pip install fire
  • python3 -m venv .venv создаёт виртуальное окружение в папке .venv.
  • source .venv/bin/activate активирует это окружение.
  • pip install fire устанавливает библиотеку fire для запуска функций из одного файла.

Если нужно установить другие библиотеки, добавляйте их командой pip install [название библиотеки] после активации .venv.

Как быстрее вводить команды (клавиша Tab)

Чтобы не печатать длинные пути вручную, используйте автодополнение через клавишу Tab. Начните вводить команду и нажмите Tab - терминал сам дополнит папку или файл.

cd dep<Tab>
# станет: cd deproschool
 
cd 2_co<Tab>
# станет: cd 2_counter-strike
 
python3 coun<Tab>
# станет: python counterstrike.py

Если терминал ничего не дополнил, нажмите Tab дважды, чтобы увидеть список подходящих вариантов.

Запуск скриптов

Перед запуском всегда переходите в deproschool и активируйте окружение:

cd deproschool
source .venv/bin/activate

Дальше переходите в папку конкретного модуля и запускайте файл:

cd 1_pizzacity
python3 read_csv.py

Запуск отдельных функций через fire

Если в одном .py файле несколько функций, удобнее запускать нужную функцию через библиотеку fire.

Пример файла example.py с несколькими функциями:

import fire
 
def first_function():
    print("This is the first function")
 
 
def second_function():
    print("This is the second function")
 
 
if __name__ == "__main__":
    fire.Fire()

Примеры запуска:

python3 example.py first_function
python3 example.py second_function

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

💡

Далее автор будет использовать команды для Linux и macOS в примерах, но если вы на Windows, просто заменяйте python3 на py и используйте команды для Windows, описанные выше.

IDE

Для прохождения курса понадобится IDE. Рекомендуется использовать VS Code (opens in a new tab). Можно использовать и другие IDE, но автор курса использует именно VS Code. Если вы не знаете, что такое IDE, то об этом можно почитать здесь (opens in a new tab).

Порог вхожденияСсылки