python_pd/07_import/05_pip.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "source": [
    "# `pip`\r\n",
    "\r\n",
    "`pip` это система управления пакетами, которая используется для\r\n",
    "установки и управлениями программными пакетами, написанными на Python. \r\n",
    "Версия дистрибутива Python 3.4+ уже содержит пакет `pip` по умолчанию.\r\n",
    "\r\n",
    "Запросить справку по всем командам можно используя команду `help`:\r\n",
    "\r\n",
    "```bash\r\n",
    "> python -m pip help\r\n",
    "```\r\n",
    "\r\n",
    "Для просмотра установленных пакетов и их версий можно \r\n",
    "использовать команду `list`:\r\n",
    "\r\n",
    "```bash\r\n",
    "> python -m pip list\r\n",
    "```\r\n",
    "\r\n",
    "Используя команду `show` можно просмотреть информацию об установленном\r\n",
    "пакете:\r\n",
    "\r\n",
    "```bash\r\n",
    "> python -m pip show numpy\r\n",
    "```\r\n",
    "\r\n",
    "Поиск пакетов по PyPI осуществляет команда `search`. Она также\r\n",
    "показывает, какой пакет (его текущую версию и последнюю доступную) из\r\n",
    "результатов поиска был установлен.\r\n",
    "\r\n",
    "```bash\r\n",
    "> python -m pip search numpy\r\n",
    "```\r\n",
    "\r\n",
    "Для установки пакета используется команда `install` и `uninstall` для\r\n",
    "удаления. Также существует возможность обновить пакет с помощью опции\r\n",
    "`--upgrade` или короткого варианта `–U` (`pip install numpy --upgrade`).\r\n",
    "При установке можно указать либо определенную версию, либо минимальную\r\n",
    "версию, используя `==` и `>=` соответственно.\r\n",
    "\r\n",
    "```bash\r\n",
    "> pip install numpy>=1.16\r\n",
    "```\r\n",
    "\r\n",
    "Используя команду `install`, установка пакета будет произведена в\r\n",
    "глобальное  окружение в директорию `Lib\\site-packages`. Для\r\n",
    "предотвращения этого нужно использовать опцию `--user`, тогда пакет\r\n",
    "будет установлен в `Lib\\site-packages` текущего пользователя.\r\n",
    "\r\n",
    "Существует возможность узнать, для каких из установленных пакетов \r\n",
    "вышли новые версии:\r\n",
    "\r\n",
    "```bash\r\n",
    "> pip list -o\r\n",
    "```\r\n",
    "\r\n",
    "Подробнее ознакомиться о `pip` можно в\r\n",
    "[официальной документации](https://pip.pypa.io/en/stable/).\r\n",
    "\r\n",
    "# `requirements.txt`\r\n",
    "\r\n",
    "В больших проектах с десятками зависимостей держать в голове весь список\r\n",
    "и их версий бывает трудно. Также при развертывании таких проектов совсем\r\n",
    "не хочется писать множество команд `pip install ...`. Для автоматизации\r\n",
    "процесса установки множества зависимостей, а также для удобного контроля\r\n",
    "их версий `pip` предоставляет возможность установки пакетов, указанных в\r\n",
    "специальном файле `requirements.txt`. Ниже приведен пример содержимого\r\n",
    "такого файла.\r\n",
    "\r\n",
    "```\r\n",
    "Django>=3.1.2\r\n",
    "geopy>=2.0.0\r\n",
    "numpy==1.20.2\r\n",
    "plotly\r\n",
    "pandas\r\n",
    "scipy\r\n",
    "```\r\n",
    "\r\n",
    "Создать файл `requirements.txt` можно с помощью команды `freeze`:\r\n",
    "\r\n",
    "```bash\r\n",
    "> pip freeze > requirements.txt\r\n",
    "```\r\n",
    "\r\n",
    "Автоматическая установка всех пакетов из этого файла осуществляется\r\n",
    "одной командой:\r\n",
    "\r\n",
    "```bash\r\n",
    "> pip install -r requirements.txt\r\n",
    "```"
   ],
   "metadata": {}
  },
  {
   "cell_type": "markdown",
   "source": [
    "# Аналоги менеджера пакетов `pip`\r\n",
    "\r\n",
    "## `pipenv`\r\n",
    "\r\n",
    "[Инструмент `pipenv`](https://pipenv.pypa.io/en/latest/), объединяет\r\n",
    "`pip` и `virtualenv`. Позволяет не только устанавливать пакеты, но и\r\n",
    "управлять виртуальными окружениями. В отличии от `pip` автоматически\r\n",
    "ведет учет зависимостей в файлах `Pipfile` и `Pipfile.lock`, учитывая\r\n",
    "граф зависимостей, который можно просмотреть командой `graph`.\r\n",
    "\r\n",
    "Установка пакета осуществляется просто:\r\n",
    "\r\n",
    "```bash\r\n",
    "> pipenv install requests\r\n",
    "```\r\n",
    "\r\n",
    "`pipenv` умеет отдельно вести список dev-зависимостей. Это очень\r\n",
    "полезный функционал, который позволяет уменьшить размер окружения. По\r\n",
    "умолчанию `pipenv` устанавливает пакет как основную зависимость. Что бы\r\n",
    "указать, что зависимость нужна только для разработки нужно добавить\r\n",
    "флаг `--dev`:\r\n",
    "\r\n",
    "```bash\r\n",
    "> pipenv install --dev flake8\r\n",
    "```\r\n",
    "\r\n",
    "Поддерживается возможность установки пакетов из `requirements.txt` с\r\n",
    "автоматическим обновлением файлов зависимостей. Также можно легко\r\n",
    "экспортировать как основные зависимостей, так и dev:\r\n",
    "\r\n",
    "```bash\r\n",
    "> pipenv lock -r > requirements.txt\r\n",
    "> pipenv lock -r --dev-only > dev-requirements.txt\r\n",
    "```\r\n",
    "\r\n",
    "Обладает дополнительным функционалом автоматизации сборки и публикации\r\n",
    "проекта.\r\n",
    "\r\n",
    "Подробнее о проекте читайте в\r\n",
    "[документации](https://pipenv.pypa.io/en/latest/).\r\n",
    "\r\n",
    "## `Poetry`\r\n",
    "\r\n",
    "`Poetry` это еще один из инструментов, позволяющих автоматизировать\r\n",
    "управление зависимостями проекта. Возможности этого инструмента\r\n",
    "довольно обширны:\r\n",
    "- создание виртуального окружения\r\n",
    "- установка пакетов\r\n",
    "- отслеживание зависимостей устанавливаемых пакетов\r\n",
    "- автоматизация сборки и публикации\r\n",
    "- разделение зависимостей на основные и dev \r\n",
    "- и др.\r\n",
    "\r\n",
    "Установить `Poetry` довольно просто:\r\n",
    "\r\n",
    "```bash\r\n",
    "> pip install poetry\r\n",
    "```\r\n",
    "\r\n",
    "Добавление пакета к текущему окружению осуществляется командой `add`:\r\n",
    "\r\n",
    "```bash\r\n",
    "> poetry add requests\r\n",
    "```\r\n",
    "\r\n",
    "Мы рассмотрим этот инструмент подробнее в следующем параграфе о\r\n",
    "виртуальных окружениях."
   ],
   "metadata": {}
  },
  {
   "cell_type": "markdown",
   "source": [
    "# Полезные ссылки\r\n",
    "\r\n",
    "- [pip (package manager)](https://en.wikipedia.org/wiki/Pip_(package_manager))\r\n",
    "- [Зачем использовать `python -m pip`](https://habr.com/ru/company/otus/blog/475392/)\r\n",
    "- [`pip` documentation](https://pip.pypa.io/en/stable/)\r\n",
    "- [Installing Python Modules](https://docs.python.org/3/installing/index.html)\r\n",
    "- [`pipenv`](https://pipenv.pypa.io/en/latest/)\r\n",
    "- [`poetry`](https://python-poetry.org/)\r\n",
    "- [What is the difference between venv, pyvenv, pyenv, virtualenv, virtualenvwrapper, pipenv, etc?](https://stackoverflow.com/questions/41573587/what-is-the-difference-between-venv-pyvenv-pyenv-virtualenv-virtualenvwrappe)"
   ],
   "metadata": {}
  }
 ],
 "metadata": {
  "orig_nbformat": 4,
  "language_info": {
   "name": "python",
   "version": "3.9.0",
   "mimetype": "text/x-python",
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "pygments_lexer": "ipython3",
   "nbconvert_exporter": "python",
   "file_extension": ".py"
  },
  "kernelspec": {
   "name": "python3",
   "display_name": "Python 3.9.0 64-bit ('.venv': venv)"
  },
  "interpreter": {
   "hash": "178cad48488a45b94c2e1acb3bfd8ec03d0e926b0801a270a439a0363b59c19a"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}