Зарегистрируйтесь для доступа к 15+ бесплатным курсам по программированию с тренажером

Poetry и управление зависимостями Python: Настройка окружения

Рассмотрим более подробно работу с зависимостями силами poetry. Заданием прошлого урока было создание проекта с именем hello, примеры из этого урока будут показаны применительно к этому проекту-примеру.

Добавление и удаление runtime-зависимостей

Добавим к проекту hello зависимость: пакет colorama — это популярная библиотека, позволяющая "раскрасить" выводимый в терминал текст. Это будет зависимость времени исполнения, а таковые добавляются следующим образом:

$ poetry add colorama
Using version ^0.4.4 for colorama

Updating dependencies
Resolving dependencies... (0.1s)

...

  • Installing colorama (0.4.4)

Если теперь взглянуть на секцию tool.poetry.dependencies файла pyproject.toml, то там окажется следующее:

[tool.poetry.dependencies]
python = "^3.6"
colorama = "^0.4.4"

Как видите, colorama не только была установлена в виртуальное окружение — это и pip умеет делать — но ещё и появилась в списке зависимостей проекта. Любой, кто захочет запускать ваш код, получит все зависимости, сделав poetry install — удобно!

Текст "^0.4.4" означает не одну лишь конкретную версию 0.4.4, но и все совместимые с указанной версией. Для "0.4.4" совместимыми будут считаться версии вплоть до "0.5.0". Так же версию можно указывать и строго конкретную, перечислить несколько конкретных допустимых версий или вручную указать диапазон. Всё это разнообразие описано здесь.

Удаляются зависимости командой poetry remove ИМЯ — из pyproject.toml удаляемые пакеты тоже убираются:

$ poetry remove colorama
...
  • Removing colorama (0.4.4)
$ # проверим, упоминается ли colorama в конфигурации:
$ grep colorama pyproject.toml || echo ":("
:(

Обновление зависимостей

Когда ваш проект просуществует какое-то время, вы, возможно, захотите обновить какие-то зависимости. Этим занимается команда poetry update.

Часто сам код менять не хочется, но есть желание получить только те самые "совместимые" свежие версии пакетов. Для такого сценария есть команда poetry update --lock. Она проверит, какие из новых версий подходят под указанные в конфигурации версии, обновит lock-файл с учётом новых версий и установит обновления в виртуальное окружение.

Так как описание зависимостей в pyproject.toml при выполнении poetry update --lock не меняется, такое обновление можно считать вполне безопасным — ваш код сломаться не должен. Зато совместимые обновления, наверняка, исправят какие-то ошибки или уязвимости в используемых библиотеках.

Установка инструментов для разработки

Многие инструменты, полезные при разработке Python-проектов, в свою очередь также написаны на Python. При этом для запуска кода они, как правило, не требуются.

Возьмём, к примеру, IPython — он очень удобен, когда вы пишете код. Но конечному пользователю вами написанной программы его навязывать было бы просто невежливо — этот пакет имеет довольно приличный список собственных зависимостей, а значит их получит и пользователь! Такой "довесок" из набора инструментов разработки, применяемых в большом проекте, может занимать приличное количество места.

На радость нам, Poetry позволяет описать нужду в таких пакетах в виде списка dev-зависимостей, каковые будут учтены при создании виртуального окружения, но к конечному пользователю не попадут.

Добавим IPython к проекту hello в качестве dev-зависимости:

$ poetry add --dev ipython
Using version ^7.22.0 for ipython

...

  • Installing ipython (7.22.0)

Когда будете пробовать выполнить команду самостоятельно, обратите внимание на то, сколько пакетов фактически будет установлено вместе с затребованным нами ipython!

Зато теперь можно запускать IPython вместо обычного REPL и наслаждаться всеми удобствами. Только нужно не забывать писать poetry run ipython вместо ipython — программа-то установлена в виртуальное окружение и снаружи "не видна"!

Стоит сказать, что poetry run запускает не только команды из виртуального окружения — запускаются любые программы, но в контексте виртуального окружения. Скажем, с помощью системной программы which можно узнать, где находится исполняемый файл IPython:

$ poetry run which ipython
/какой_там_у_вас_путь_до/hello/.venv/bin/ipython

Самостоятельная работа

  1. Добавьте colorama как обычную зависимость в ваш локальный проект hello.
  2. Добавьте ipython как dev-зависимость.
  3. Запустите IPython REPL.
  4. Выполните в REPL from colorama import Fore — импортирование должно пройти успешно.
  5. Попробуйте парочку примеров из описания пакета colorama.

Аватары экспертов Хекслета

Остались вопросы? Задайте их в разделе «Обсуждение»

Вам ответят команда поддержки Хекслета или другие студенты.

Ошибки, сложный материал, вопросы >
Нашли опечатку или неточность?

Выделите текст, нажмите ctrl + enter и отправьте его нам. В течение нескольких дней мы исправим ошибку или улучшим формулировку.

Что-то не получается или материал кажется сложным?

Загляните в раздел «Обсуждение»:

  • задайте вопрос. Вы быстрее справитесь с трудностями и прокачаете навык постановки правильных вопросов, что пригодится и в учёбе, и в работе программистом;
  • расскажите о своих впечатлениях. Если курс слишком сложный, подробный отзыв поможет нам сделать его лучше;
  • изучите вопросы других учеников и ответы на них. Это база знаний, которой можно и нужно пользоваться.
Об обучении на Хекслете

Для полного доступа к курсу нужен базовый план

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

Получить доступ
900
упражнений
2000+
часов теории
3200
тестов

Открыть доступ

Курсы программирования для новичков и опытных разработчиков. Начните обучение бесплатно.

  • 120 курсов, 2000+ часов теории
  • 900 практических заданий в браузере
  • 360 000 студентов
Отправляя форму, вы соглашаетесь c «Политикой конфиденциальности» и «Условиями оказания услуг»

Наши выпускники работают в компаниях:

Логотип компании Альфа Банк
Логотип компании Aviasales
Логотип компании Yandex
Логотип компании Tinkoff
Рекомендуемые программы

С нуля до разработчика. Возвращаем деньги, если не удалось найти работу.

Иконка программы Python-разработчик
Профессия
Разработка веб-приложений на Django
1 декабря 8 месяцев

Используйте Хекслет по максимуму!

  • Задавайте вопросы по уроку
  • Проверяйте знания в квизах
  • Проходите практику прямо в браузере
  • Отслеживайте свой прогресс

Зарегистрируйтесь или войдите в свой аккаунт

Отправляя форму, вы соглашаетесь c «Политикой конфиденциальности» и «Условиями оказания услуг»