为什么“点子帮助”列表没有--upgrade?

时间:2019-02-17 22:55:07

标签: pip

pip3的主要选项之一是--upgrade。那么,pip3 help为什么不描述呢?

  1. 进行网络搜索以查找如何使用pip3升级Python 3软件包。答案很丰富,包括但不限于How do I update a Python package?,所有答案都是通用形式:

    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一词在该选项列表中不存在。

只需确保:

  1. 键入pip3 help | grep upgrade结果:

    找到零个发生位置。

可能有一个原因将--upgrade排除在pip3的help中。

那是什么原因?

2 个答案:

答案 0 :(得分: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下的标志是常规选项。

答案 1 :(得分:0)

根据我的经验,“ pip”是与“ pip install”不同的命令。因此,“ pip --help”将不同于“ pip install --help”。

(如果有人找到,请添加引文。)

我使用Python2.7,并且选项相同,“ pip --help”中没有--upgrade。

  

`2019-02-18 10:02:09〜Utkarshs-MacBook-Pro-983位于〜○→python -V   Python 2.7.10

     

2019-02-18 10:02:24〜Utkarshs-MacBook-Pro-983〜〜→点-V点   18.0 from /Library/Python/2.7/site-packages/pip(python 2.7)

     

2019-02-18 10:02:29〜Utkarshs-MacBook-Pro-983在〜○→pip帮助

     

用法:点子[选项]

     

命令:install安装软件包。下载
  下载软件包。卸载卸载软件包。
  冻结需求中已安装的软件包   格式。列出已安装的软件包。节目   显示有关已安装软件包的信息。检查
  验证安装的软件包具有兼容的依赖性。 config
  管理本地和全局配置。搜索
  在PyPI中搜索软件包。车轮车轮   根据您的要求。哈希计算哈希   包档案。完成帮助程序命令   用于命令完成。帮助显示帮助   命令。

     

常规选项:-h,--help显示帮助。 - 孤立   在隔离模式下运行pip,忽略                                 环境变量和用户配置。 -v,--verbose提供更多输出。选项   是加性的,可以是                                 最多使用3次。 -V,--version显示版本并退出。 -q,--quiet减少输出。   选项是加性的,可以是                                 最多使用3次(对应于警告,                                 错误和关键日志记录级别)。 --log附加日志的路径。 --proxy以以下形式指定代理                                 [user:passwd @] proxy.server:port。 --retries每个连接应重试的最大次数                                 尝试(默认5次)。 --timeout设置套接字超时(默认15秒)。
  --exists-action路径已存在时的默认操作:                                 (s)巫婆,(i)忽略,(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:02:45〜Utkarshs-MacBook-Pro-983〜〜→点安装   -帮助

     

用法:pip install [选项]   [package-index-options] ... pip安装[options] -r [package-index-options] ... pip install [options] [-e] ... pip install [options] [-e] .. 。   pip install [选项] ...

     

说明:从以下位置安装软件包:

     
      
  • 使用需求说明符的PyPI(和其他索引)。
  •   
  • VCS项目网址。
  •   
  • 本地项目目录。
  •   
  • 本地或远程源档案。    pip还支持从“需求文件”进行安装,这提供了一种简单的方法来指定要安装的整个环境。
  •   
     

安装选项:-r,-requirement从给定安装   需求文件。此选项可以多次使用。 -C,   --constraint使用给定的约束文件约束版本。此选项可以多次使用。 --no-deps
  不要安装软件包依赖项。 --pre
  包括预发行和开发版本。默认情况下,仅点子   找到稳定的版本。 -e,--editable安装项目   在本地项目中以可编辑模式(即setuptools“开发模式”)   路径或VCS网址。 -t,--target将软件包安装到   。默认情况下,这不会替换现有的文件/文件夹   。使用--upgrade替换其中的现有软件包                                 新版本。 --user安装到您平台的Python用户安装目录。   在Windows上通常为〜/ .local /或%APPDATA%\ Python。 (请参阅Python   文件资料                                 有关站点的详细信息,请访问USER_BASE。)--root安装与此备用根目录相关的所有内容。 --prefix安装   放置lib,bin和其他顶级文件夹的前缀-b,   --build目录,用于将软件包解压缩并进行构建。请注意,初始构建仍在临时环境中进行   目录。临时位置                                 可以通过适当设置TMPDIR环境变量(在Windows上为TEMP)来控制目录。什么时候   通过,构建目录不是                                 清洗,以防出现故障。 --src目录,用于将可编辑项目签出。   virtualenv中的默认值为“ / src”。的默认值   全局安装为“ / src”。 -U,--upgrade将所有指定的软件包升级到最新的可用版本。的   依赖项的处理取决于所使用的升级策略。
  -升级策略                                 确定应如何处理依赖项升级[默认值:仅当需要时]。 “渴望”-依赖项   无论是否升级                                 当前安装的版本满足升级程序包的要求。 “仅在需要时”-是   仅当他们不满意时才升级                                 升级包的要求。 --force-reinstall即使所有软件包都是最新的,也要重新安装它们。 -I,--ignore-installed忽略已安装   软件包(改为重新安装)。 --ignore-requires-python忽略   Requires-Python信息。 --no-build-isolation禁用   建立现代源代码分发时需要隔离。建立   如果PEP 518指定的依赖项已经安装,   选项是                                 用过的。 --install-option提供给setup.py install命令的其他参数(使用   像--install-option =“-install-scripts = / usr / local / bin”)。采用   多                                 --install-option选项可将多个选项传递给setup.py安装。如果您使用带有   目录路径,请确保使用绝对路径                                 路径。 --global-option附加的全局选项将在   安装命令。 --compile编译Python源代码   文件转换为字节码--no-compile不编译Python   源文件到字节码--no-warn-script-location不警告   在PATH外部安装脚本时--no-warn-conflicts   不警告依赖项已损坏--no-binary                                 不要使用二进制包。可以多次提供,每次都增加到现有值。   接受:all:禁用所有二进制                                 软件包,:none:清空集合,或者一个或多个软件包名称之间用逗号隔开。注意一些   软件包难以编译,可能会失败                                 在他们上使用此选项时进行安装。 -仅二进制                                 不要使用源程序包。可以多次提供,每次都增加到现有值。   接受:all:禁用所有源                                 软件包,:none:清空集合,或者一个或多个软件包名称之间用逗号隔开。不含包装   二进制发行版将无法安装                                 在他们上使用此选项时。 --prefer-binary在新的源代码包中优先使用旧的二进制包。 --no-clean不清理构建   目录)。 --require-hash要求使用散列检查   针对可重复安装的每个要求。这个选项是   当需求文件中的任何软件包具有                                 --hash选项。 - 进度条                                 指定要显示的进度类型[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忽略软件包   索引(仅查看--find-links URL)。 -f,--find-links         如果是html文件的url或路径,则解析链接到   档案。如果是目录的本地路径或file:// url,请查看   用于存档                                 目录列表。 --process-dependency-links启用对依赖关系链接的处理。

     

常规选项:-h,--help显示帮助。 - 孤立   在隔离模式下运行pip,忽略环境变量和用户   组态。 -v,--verbose提供更多输出。选项   是添加剂,最多可使用3次。 -V,--version
  显示版本并退出。 -q,--quiet减少输出。   选件是添加剂,最多可以使用3次(对应于   警告,错误和严重日志记录级别)。 --log
  详细追加日志的路径。 --proxy指定   以[user:passwd @] proxy.server:port形式的代理。 -重试            每个连接应重试的最大次数   尝试(默认5次)。 --timeout设置   套接字超时(默认15秒)。 --exists-action
  路径已存在时的默认操作:(s)女巫,(i)忽略,(w)ipe,   (b)增收,(a)破产)。 --trusted-host将此主机标记为   即使没有有效或任何HTTPS,也可以信任。 -证书                  备用CA捆绑软件的路径。 --client-cert           SSL客户端证书的路径,单个文件包含   私钥和PEM格式的证书。 --cache-dir   将缓存数据存储在中。 --no-cache-dir禁用   缓存。 --disable-pip-version-check                                 不要定期检查PyPI以确定是否有新版本的pip可供下载。   暗示--no-index。 -无色抑制   彩色输出

     

2019-02-18 10:03:47〜Utkarshs-MacBook-Pro-983在〜○→`