Почему список "pip help" не обновляется?

Question

Один из ключевых параметров pip3 - --upgrade.Так почему же pip3 help не описывает это?

1. Выполните поиск в Интернете, чтобы найти, как использовать pip3 для обновления пакета Python 3.Существует множество ответов, включая, но не ограничиваясь, Как обновить пакет Python? , все в общем виде:

   sudo pip install [package_name] --upgrade

   Наблюдатьв этой командной строке наличие опции --upgrade.

2. Тип pip3 help ОТВЕТ:

Usage:   
  pip3 <command> [options]

Commands:
  install                     Install packages.
  download                    Download packages.
  uninstall                   Uninstall packages.
  freeze                      Output installed packages in requirements format.
  list                        List installed packages.
  show                        Show information about installed packages.
  check                       Verify installed packages have compatible dependencies.
  config                      Manage local and global configuration.
  search                      Search PyPI for packages.
  wheel                       Build wheels from your requirements.
  hash                        Compute hashes of package archives.
  completion                  A helper command used for command completion.
  help                        Show help for commands.

General Options:
  -h, --help                  Show help.
  --isolated                  Run pip in an isolated mode, ignoring environment variables and user
                              configuration.
  -v, --verbose               Give more output. Option is additive, and can be used up to 3 times.
  -V, --version               Show version and exit.
  -q, --quiet                 Give less output. Option is additive, and can be used up to 3 times
                              (corresponding to WARNING, ERROR, and CRITICAL logging levels).
  --log <path>                Path to a verbose appending log.
  --proxy <proxy>             Specify a proxy in the form [user:passwd@]proxy.server:port.
  --retries <retries>         Maximum number of retries each connection should attempt (default 5
                              times).
  --timeout <sec>             Set the socket timeout (default 15 seconds).
  --exists-action <action>    Default action when a path already exists: (s)witch, (i)gnore,
                              (w)ipe, (b)ackup, (a)bort).
  --trusted-host <hostname>   Mark this host as trusted, even though it does not have valid or any
                              HTTPS.
  --cert <path>               Path to alternate CA bundle.
  --client-cert <path>        Path to SSL client certificate, a single file containing the private
                              key and the certificate in PEM format.
  --cache-dir <dir>           Store the cache data in <dir>.
  --no-cache-dir              Disable the cache.
  --disable-pip-version-check
                              Don't periodically check PyPI to determine whether a new version of
                              pip is available for download. Implied with --no-index.
  --no-color                  Suppress colored output

ПРИМЕЧАНИЕ , что слово upgrade нигде в этом списке вариантов отсутствует.

Просто чтобы убедиться:

Тип pip3 help | grep upgrade. РЕЗУЛЬТАТ:

Обнаружены нулевые вхождения.

Возможно, причина в том, что --upgrade была исключена из help. * 1046 в pip3.*

Что это за причина?

Answer 1

По моему опыту, "pip" - это команда, отличная от "pip install".Таким образом, «pip --help» будет отличаться от «pip install --help».

(Просьба добавить цитату, если кто-то ее найдет.)

Я использую Python2.7, и параметры были одинаковыми, без --upgrade в "pip --help".

`2019-02-18 10:02:09 ⌚ Utkarshs-MacBook-Pro-983 в ~ ○ → python -V Python 2.7.10

2019-02-1810:02:24 t Utkarshs-MacBook-Pro-983 в ~ ○ → pip -V pip 18.0 из /Library/Python/2.7/site-packages/pip (python 2.7)

2019-02-1810:02:29 ⌚ Utkarshs-MacBook-Pro-983 в ~ ○ → справка по pip

Использование: pip [опции]

Команды: установка пакетов установки.скачать
Скачать пакеты.удалить Удаление пакетов.
freeze Вывод установленных пакетов в формате требований.список Список установленных пакетов.show Показать информацию об установленных пакетах.check
Убедитесь, что установленные пакеты имеют совместимые зависимости.config
Управление локальной и глобальной конфигурацией.search
Поиск пакетов PyPI.Колесо Сборка колес по вашим требованиям.hash Вычислить хэши архивов пакетов.завершение Вспомогательная команда, используемая для завершения команды.help Показать справку для команд.

Общие параметры: -h, --help Показать справку.--isolated Запустить pip в изолированном режиме, игнорируя переменные среды и конфигурацию пользователя.-v, --verbose Дать больше вывода.Вариант является аддитивным и может использоваться до 3 раз.-V, --version Показать версию и выйти.-q, --quiet Дайте меньше вывода.Опция является аддитивной и может использоваться до 3 раз (соответствует уровням ВНИМАНИЕ, ОШИБКА и КРИТИЧЕСКИЙ).--log Путь к подробному журналу добавления.--proxy Укажите прокси в форме [user: passwd @] proxy.server: порт.--retries Максимальное количество повторов, которое должно предприниматься каждым соединением (по умолчанию 5 раз).--timeout Установить время ожидания сокета (по умолчанию 15 секунд).
--exists-action Действие по умолчанию, когда путь уже существует: (s) witch, (i) gnore, (w) ipe, (b) ackup, (а) Борт).--trusted-host Пометить этот хост как надежный, даже если у него нет действительного или какого-либо HTTPS.--cert Путь к альтернативному комплекту CA.--client-cert Путь к клиентскому сертификату SSL, отдельный файл, содержащий закрытый ключ и сертификат в формате PEM.--cache-dir Сохранить данные кеша в.--no-cache-dir Отключить кеш.--disable-pip-version-check Не периодически проверять PyPI, чтобы определить, доступна ли для скачивания новая версия pip.Подразумевается с --no-index.--no-color Подавить цветной вывод

2019-02-18 10:02:45 ⌚ Utkarshs-MacBook-Pro-983 в ~ ○ → pip install --help

Использование: pipустановить [параметры] [пакет-индекс-опции] ... pip установить [параметры] -r [пакет-индекс-опции] ... pip установить [параметры] [-e] ... pip установить [параметры] [-e] ... pip install [options] ...

Описание: Установить пакеты из:

• PyPI (и других индексов) с использованием спецификаторов требований.
• URL проекта VCS.
• Локальные каталоги проекта.
• Локальный или удаленныйИсходные архивы.pip также поддерживает установку из «файлов требований», которые предоставляют простой способ указать целую среду для установки.

Параметры установки: -r, --requirement Установить из указанного файла требований.Эта опция может быть использована несколько раз.-c, --constraint Ограничить версии, используя заданный файл ограничений.Эта опция может быть использована несколько раз.--no-deps
Не устанавливать зависимости пакетов.--pre
Включить предварительные версии и версии для разработчиков.По умолчанию pip находит только стабильные версии.-e, --editable Установить проект в редактируемом режиме (т. е. setuptools «режим разработки») из локального пути проекта или URL VCS.-t, --target Установить пакеты в.По умолчанию это не заменит существующие файлы / папки в.Используйте --upgrade для замены существующих пакетов новыми версиями.--user Установить в каталог установки пользователя Python для вашей платформы.Обычно ~ / .local / или% APPDATA% \ Python для Windows.(Более подробную информацию смотрите в документации по Python для site.USER_BASE.) --Root Установить все, что связано с этим альтернативным корневым каталогом.--prefix Установочный префикс, в котором находятся папки lib, bin и другие папки верхнего уровня. -b, --build Каталог для распаковки и сборки пакетов. Обратите внимание, что первоначальная сборка все еще происходит во временном каталоге.Расположение временных каталогов может контролироваться путем установки соответствующей переменной среды TMPDIR (TEMP в Windows).При пропуске каталоги сборки не очищаются в случае сбоев.--src Каталог для проверки редактируемых проектов.По умолчанию в virtualenv используется "/ src".По умолчанию для глобальных установок используется "/ src".-U, --upgrade Обновить все указанные пакеты до последней доступной версии.Обработка зависимостей зависит от используемой стратегии обновления.
--upgrade-стратегии Определяет, как следует обновлять зависимости [по умолчанию: только при необходимости].«eager» - зависимости обновляются независимо от того, удовлетворяет ли текущая установленная версия требованиям обновленных пакетов.«только при необходимости» - обновляются только в том случае, если они не удовлетворяют требованиям обновленных пакетов.--force-reinstall Переустановите все пакеты, даже если они уже обновлены.-I, --ignore-install Игнорировать установленные пакеты (вместо этого переустановить).--ignore-require-python Игнорировать информацию Требуется-Python.--no-build-изоляция Отключить изоляцию при сборке современного исходного кода.Зависимости сборки, указанные в PEP 518, должны быть уже установлены, если используется эта опция.--install-option Дополнительные аргументы, предоставляемые команде установки setup.py (используйте, например, --install-option = "- install-scripts = / usr / local / bin").Используйте несколько опций --install-option, чтобы передать несколько опций в setup.py install.Если вы используете опцию с путем к каталогу, обязательно используйте абсолютный путь.--global-option Дополнительные глобальные параметры, предоставляемые вызову setup.py перед командой установки.--compile Компилировать исходные файлы Python в байт-код --no-compile Не компилировать исходные файлы Python в байт-код --no-warn-script-location Не предупреждать при установке сценариев вне PATH --no-warn-конфликтов Не предупреждать онарушенные зависимости --no-binary Не использовать двоичные пакеты.Может быть предоставлено несколько раз, и каждый раз добавляет к существующему значению.Принимает либо: all: для отключения всех двоичных пакетов,: none: для очистки набора, либо одно или несколько имен пакетов с запятыми между ними.Обратите внимание, что некоторые пакеты сложны для компиляции и могут не быть установлены при использовании этой опции на них.--only-binary Не использовать пакеты с исходным кодом.Может быть предоставлено несколько раз, и каждый раз добавляет к существующему значению.Принимает либо: all: для отключения всех исходных пакетов,: none: для очистки набора, либо одно или несколько имен пакетов с запятыми между ними.Пакеты без бинарных дистрибутивов не будут установлены при использовании этой опции на них.--prefer-binary Предпочитать более старые двоичные пакеты более новым исходным пакетам.--no-clean Не очищать каталоги сборки).--require-hashes Требуется хэш для проверки каждого требования на предмет повторяющихся установок.Эта опция подразумевается, когда любой пакет в файле требований имеет опцию --hash.--progress-bar Укажите тип прогресса, который будет отображаться [on | ascii | off | pretty | emoji] (по умолчанию: on)

Параметры индекса пакета: -i, --index-url Базовый URL-адрес PythonИндекс пакета (по умолчанию https://pypi.org/simple). Это должно указывать на хранилище, совместимое с PEP 503 (простой API хранилища) или локальный каталог, оформленный в том же формате. --Extra-index-url Дополнительные URL-адреса индексов пакетов дляиспользуйте в дополнение к --index-url. Должны следовать тем же правилам, что и --index-url. --no-index Игнорировать индекс пакета (вместо этого просматривается только URL --find-links). -f, --find-ссылки Если URL-адрес или путь к html-файлу разбираются на наличие ссылок на архивы. Если локальный путь или файл: // url - это каталог, ищите архивы в списке каталогов. --process-dependency-links Включитьобработка ссылок на зависимости.

Общие параметры: -h, --help Показать справку. --isolated Запустить pip в изолированном режиме, игнорируя переменные среды и конфигурацию пользователя. -v, --verbose Дать больше выходных данных.Вариант аддитивен, иможно использовать до 3 раз.-V, --version
Показать версию и выйти.-q, --quiet Дайте меньше вывода.Опция является аддитивной и может использоваться до 3 раз (соответствует уровням ВНИМАНИЕ, ОШИБКА и КРИТИЧЕСКИЙ).--log
Путь к подробному добавляемому журналу.--proxy Укажите прокси в форме [user: passwd @] proxy.server: порт.--retries Максимальное количество повторов, которое должно предприниматься каждым соединением (по умолчанию 5 раз).--timeout Установить время ожидания сокета (по умолчанию 15 секунд).--exists-action
Действие по умолчанию, когда путь уже существует: (s) witch, (i) gnore, (w) ipe, (b) ackup, (a) bort).--trusted-host Пометить этот хост как надежный, даже если у него нет действительного или какого-либо HTTPS.--cert Путь к альтернативному комплекту CA.--client-cert Путь к клиентскому сертификату SSL, отдельный файл, содержащий закрытый ключ и сертификат в формате PEM.--cache-dir Сохранить данные кеша в.--no-cache-dir Отключить кеш.--disable-pip-version-check Не периодически проверять PyPI, чтобы определить, доступна ли для скачивания новая версия pip.Подразумевается с --no-index.--no-color Подавить цветной вывод

2019-02-18 10:03:47 ⌚ Utkarshs-MacBook-Pro-983 в ~ ○ → `

Answer 2

Он указан под pip install --help:

$ pip install --help | grep upgrade
                              <dir>. Use --upgrade to replace existing
  -U, --upgrade               Upgrade all specified packages to the newest
                              depends on the upgrade-strategy used.
  --upgrade-strategy <upgrade_strategy>
                              dependencies are upgraded regardless of whether
                              requirements of the upgraded package(s). "only-
                              if-needed" -  are upgraded only when they do not
                              satisfy the requirements of the upgraded

Флаги под pip --help являются общими параметрами.