Гайд по установке и запуску Python софтов используя консоль и git

Эта статья создана, чтобы помочь вам научиться правильно устанавливать софты и в дальнейшем использовать их. Несмотря на то, что сам процесс для всех операционных систем практически идентичный, для вашего же удобства последовательность действий описана отдельно для Windows и отдельно для MacOS (чтобы не захламлять голову лишней информацией и командами). Приступим!

1. Установка Python

• Переходим по ссылке -> *тык*
• Выбираем нужную версию в колонке Release version (мы всегда указываем её в README-файле)

• Выбираем нужный нам installer в колонке Version, в зависимости от операционной системы.

• Открываем скачанный файл, обязательно нажимаем на галочку Add Python x.x to PATH, после чего жмем Install Now и ждем конца установки

• Готово!
• Видео-гайд, если понадобится -> *тык*

2. Установка Git (только для Windows)

На MacOS уже предустановлен git, поэтому данная глава посвящается узникам пользователям Windows

• Переходим по ссылке -> *тык*
• Жмем на кнопку Download for Windows

• Далее открываем загруженный файл, много раз жмем Next и в конце жмем Install
• Готово!
• Видео-гайд, если понадобится -> *тык*

3. Загрузка и первый запуск софта

Буду рассказывать на примере нашего софта -> zerion_dna_helper

3.1. Общая часть

• Открываем страницу репозитория на github'е
• Нажимаем на зеленую кнопку Code
• Открываем вкладку Local
• Далее открываем вкладку HTTPS
• Находим специальную ссылку на репозиторий, запоминаем где она, оставляем вкладку открытой, так как в дальнейшем нам нужно будет её скопировать

• Готово!

3.2. Windows

• Открываем папку, в которую хотим установить репозиторий
• Копируем адрес (путь до папки) как текст (в моем случае это C:\Users\rol\Desktop\python_soft)
• Далее открываем командную строку (cmd в поиске), после ввода каждой последующей команды нужно будет нажимать Enter для её применения, а после ждать полного выполнения
• Пишем cd и рядом вставляем скопированный путь до папки (чтобы в нее перейти, в моем случае это cd C:\Users\rol\Desktop\python_soft)
• Теперь пишем git clone и вставляем ссылку на репозиторий, которую мы нашли в прошлой главе статьи (чтобы установить репозиторий в выбранную папку, в моем случае это git clone https://github.com/XardMoney/zerion_dna_helper.git)
• В нашей папке появилась новая папка (это сам репозиторий), копируем путь до неё (в моем случае это C:\Users\rol\Desktop\python_soft\zerion_dna_helper)
• Пишем cd и рядом вставляем скопированный путь до репозитория (в моем случае это cd C:\Users\rol\Desktop\python_soft\zerion_dna_helper)
• Создаем виртуальное окружение, для этого вставляем команду python -m venv .venv
• После чего вставляем команду .venv\Scripts\activate.bat (активируем виртуальное окружение)
• Используем команду pip install -r requirements.txt, чтобы установить необходимые библиотеки в созданное виртуальное окружение
• Не закрывая командную строку, заходим в папку и настраиваем софт, заполняем все данные
• Наконец, можно запускать софт, написав python main.py
• Готово!

3.3. MacOS

• Открываем папку, в которую хотим установить репозиторий
• Копируем адрес (путь до папки, в моем случае это /Users/rol/Desktop/python_soft)
• Далее открываем терминал (ищем в Spotlight), после ввода каждой последующей команды нужно будет нажимать Enter для её применения, а после ждать полного выполнения
• Пишем cd и рядом вставляем скопированный путь до папки (чтобы в нее перейти, в моем случае это cd /Users/rol/Desktop/python_soft)
• Теперь пишем git clone и вставляем ссылку на репозиторий, которую мы нашли в прошлой главе статьи (чтобы установить репозиторий в выбранную папку, в моем случае это git clone https://github.com/XardMoney/zerion_dna_helper.git)
• В нашей папке появилась новая папка (это сам репозиторий), копируем путь до неё (в моем случае это /Users/rol/Desktop/python_soft/zerion_dna_helper)
• Пишем cd и рядом вставляем скопированный путь до репозитория (в моем случае это cd /Users/rol/Desktop/python_soft/zerion_dna_helper)
• Создаем виртуальное окружение, для этого вставляем команду python3 -m venv .venv
• После чего вставляем команду source .venv/bin/activate (активируем виртуальное окружение)
• Используем команду pip3 install -r requirements.txt, чтобы установить необходимые библиотеки в созданное виртуальное окружение
• Не закрывая терминал, заходим в папку и настраиваем софт, заполняем все данные
• Наконец, можно запускать софт, написав python3 main.py
• Готово!

4. Повторный запуск софта

При повторном запуске уже не придется выполнять столько действий, как при первом (повторный запуск = закрыли командную строку/терминал после установки и открываете его заново)

4.1. Windows

• Копируем адрес (путь до папки) ранее установленного репозитория как текст
• Открываем командную строку (cmd в поиске)
• Пишем cd и вставляем скопированный путь до репозитория (в моем случае это cd C:\python_soft\zerion_dna_helper)
• Далее вставляем уже знакомые команды (по очереди) - .venv\Scripts\activate.bat и python main.py
• Готово!

4.2. MacOS

• Копируем адрес (путь до папки) ранее установленного репозитория (в моем случае это /Users/rol/Desktop/python_soft/zerion_dna_helper)
• Открываем терминал (ищем в Spotlight)
• Пишем cd и вставляем скопированный путь до репозитория (в моем случае это cd /Users/rol/Desktop/python_soft/zerion_dna_helper)
• Далее вставляем уже знакомые команды (по очереди) - source .venv/bin/activate и python3 main.py
• Готово!