Полное пошаговое руководство по настройке виртуальных сред Python с пакетом venv и использованию его в ноутбуках Jupyter с VS Code в Windows

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

Как создать виртуальную среду Python? Как использовать виртуальную среду в ноутбуке Jupyter? Как использовать ноутбук Jupyter с виртуальной средой в VS Code?

Не волнуйтесь, в этом пошаговом руководстве я отвечу на все ваши сомнения и объясню:

1. Как легко создать виртуальную среду на Python с помощью пакета venv в Windows.

2. Как установить ядро ​​IPython, чтобы виртуальную среду можно было использовать в блокнотах Jupyter.

3. Как использовать Jupyter Notebooks и недавно созданную виртуальную среду в Visual Studio Code.

1. Как создать виртуальную среду Python с помощью пакета venv

В Python 3.3 появился модуль стандартной библиотеки под названием venv, который я предпочитаю для работы с виртуальными средами. В этом разделе я пошагово объясню, как создать виртуальную среду с конкретной версией Python и как установить нужные пакеты с помощью установщика пакетов pip. .

  1. Загрузите и установите нужную версию Python, чтобы она была совместима с библиотеками, которые вы установите в виртуальной среде.
  2. Откройте Командную строку и перейдите в каталог, в который вы хотите установить виртуальную среду:
cd "C:\Users\Giorgio\Documents"

3. Создайте папку, в которой будут храниться все ваши виртуальные среды:

mkdir venvs && cd venvs

4. Создайте виртуальную среду:

py -m venv env_name
  • Замените env_name именем, которое вы хотите дать виртуальной среде.
  • Например: py -m venv scrap37 (в этом примере я создаю виртуальную среду для парсинг-проекта с использованием Python 3.7).

Команда py вызовет версию python, указанную в системном PATH.

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

"C:\Users\Giorgio\Python\Python310\python.exe" -m venv env_name

5. Активируйте новую среду:

.\env_name\Scripts\activate && cd .\env_name\Scripts

6. Установите VirtualEnvWrapper-win с помощью pip:

pip install virtualenvwrapper-win

7. Убедитесь, что pip, setuptools и wheel обновлены:

py -m pip install --upgrade pip setuptools wheel

8. (Необязательно) Установите Инструменты сборки Visual Studio.

9. (Необязательно) Установите autopep8.

autopep8 автоматически форматирует код Python в соответствии с руководством по стилю «PEP 8. — PyPI-страница autopep8

pip install -U autopep8

10. Установите все интересующие вас библиотеки/пакеты.

Вы можете установить последнюю версию с помощью:

py -m pip install "Project"

Вы можете установить конкретную версию:

py -m pip install "Project==1.4"

И вы можете обновить пакет с помощью:

pip install --upgrade "Project"

2. Как установить IPython для использования виртуальной среды в ноутбуке Jupyter.

Если вы хотите использовать только что созданную виртуальную среду в Jupyter Notebook (в VS Code или Jupyter), вам необходимо выполнить дополнительные действия.

  1. Внутри папки env_name\Scripts\ установите IPython:
pip install ipython

2. Установите ядро IPython:

Ядро IPython действует как серверная часть выполнения Python в Jupyter.

pip install ipykernel

3. Создайте ядро ​​для запуска команд Jupyter Notebook в виртуальной среде:

ipython kernel install --user --name=kernel_name

Где параметр — name будет именем, под которым появится ядро, когда мы перейдем к его выбору в VS Code или Jupyter.

3. Настройка VS Code для использования виртуальной среды в блокноте Jupyter.

В этом последнем разделе я объясню, как настроить VS Code, чтобы Jupyter Notebook мог работать с использованием только что созданной нами виртуальной среды.

  1. Откройте VS Code и установите Расширение Python и Расширение Jupyter.
  2. Откройте или создайте Блокнот с помощью комбинации клавиш CTRL + Shift + P, а затем нажмите Create: New Jupyter Notebook.
  3. Выберите Интерпретатор:
  • Нажмите комбинацию клавиш CTRL + Shift + P.
  • Нажмите Python: Select Interpreter.
  • Нажмите + Enter Interpreter Path.
  • Нажмите Find.
  • Перейдите к папке env_name\Scripts\Virtual Environment и выберите файл python.exe.
  • Нажмите еще раз комбинацию клавиш CTRL + Shift + P, Python: Select Interpreter и выберите нового интерпретатора.
  • Интерпретаторы, связанные с виртуальными средами, легко распознаются, поскольку справа от них вы увидите синее слово «Venv», а в скобках указано имя, которое мы дали виртуальной среде.

5. Перезапустите VS Code.

6. Последний шаг: выберите ядро:

  • Нажмите кнопку Select Kernel в правом верхнем углу экрана VS Code:

  • Выберите ядро ​​Jupyter, связанное с только что созданной виртуальной средой, имя которой будет указано при создании ядра Jupyter:

7. Получайте удовольствие!

Заключение

Поздравляем! Вы только что узнали, как настроить виртуальную среду Python с пакетом venv и использовать ее в ноутбуках Jupyter с VS Code.

Надеюсь, эта статья была вам полезна.

Спасибо за чтение!

Вы можете связаться со мной на LinkedIn, GitHubили посетив мой веб-сайт.

Подпишитесь на меня на Medium, чтобы быть в курсе моих последних статей о науке о данных и технологиях.

Дополнительные материалы на PlainEnglish.io. Подпишитесь на нашу бесплатную еженедельную рассылку новостей. Подпишитесь на нас в Twitter, LinkedIn, YouTube,и Discord. Заинтересованы в Взлом роста? Ознакомьтесь с разделом Схема.