草庐IT

python - 为什么 pip 中有用的命令行选项未记录并明确隐藏?

coder 2023-08-22 原文

我在我的 .bashrc 中使用 export PIP_REQUIRE_VIRTUALENV=true; 来确保我在为我从事的各种项目安装包时不会意外污染我的全局环境。

我依稀记得这相当于在调用pip时在命令行添加一个--require-virtualenv

但是,除了 in the source code of pip 之外,我找不到关于此任何地方任何 文档,其中明确抑制了该功能的帮助(使用 SUPRESS_HELP)!有 11 个此类选项的帮助也已明确禁用(例如 --no-input)。

我查看了文件的历史记录,但没有发现任何关于为什么该功能被隐藏在提交消息中的提及。

这是不应依赖的实验性功能吗?我不应该使用(也不鼓励其他人使用)这些功能,还是有其他使用这些功能的方法?有人可以阐明这个难题吗?


更新: 我提出这个问题为 an issue on pip's Github page .

最佳答案

免责声明:我不是 pip 的撰稿人,这些都是推测,而不是 pip 作者或维护者的见解。

以下一项或多项可能导致作者隐藏选项:

  1. 有些选项实际上是无意义的,它们的存在是为了完整性和兼容性,但通常不会被阅读帮助的人使用。例如,默认启用的 --use-wheel

  2. 一些选项是过渡性的或已弃用的,不应使用,因为它们可能会在未来的版本中被删除。例如 --use-mirrors,它标有注释 TODO: Remove after 6.0

  3. 一些选项可能是实验性的,或者可能无法在所有环境中工作。对于希望软件跨平台的最终用户来说,这可能是个问题,并且作者没有经过测试环境和放置条件语句的麻烦——对于不常用的专用选项来说,这可能是一种不必要的复杂性。也许 --default-vcs 就是一个例子。

  4. 另一种可能性是,很少使用的选项的行为是非标准的或难以描述,因为它取决于外部变量或环境,在这种情况下,抑制帮助可能比提供帮助更容易令人困惑。

  5. 当我是 grep 的维护者时,我们最初有许多未记录的选项。这些选项的行为是非标准的(例如,不符合 POSIX),但由于历史原因存在并删除它们可能会破坏世界各地可能一直在使用它们的关键系统脚本。我不知道 pip 中是否存在任何此类选项,但为了完整起见,我想提及这一 pip ,作为某些选项可能被隐藏的原因。

关于python - 为什么 pip 中有用的命令行选项未记录并明确隐藏?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/28566349/

有关python - 为什么 pip 中有用的命令行选项未记录并明确隐藏?的更多相关文章

  1. ruby - 为什么我可以在 Ruby 中使用 Object#send 访问私有(private)/ protected 方法? - 2

    类classAprivatedeffooputs:fooendpublicdefbarputs:barendprivatedefzimputs:zimendprotecteddefdibputs:dibendendA的实例a=A.new测试a.foorescueputs:faila.barrescueputs:faila.zimrescueputs:faila.dibrescueputs:faila.gazrescueputs:fail测试输出failbarfailfailfail.发送测试[:foo,:bar,:zim,:dib,:gaz].each{|m|a.send(m)resc

  2. python - 如何使用 Ruby 或 Python 创建一系列高音调和低音调的蜂鸣声? - 2

    关闭。这个问题是opinion-based.它目前不接受答案。想要改进这个问题?更新问题,以便editingthispost可以用事实和引用来回答它.关闭4年前。Improvethisquestion我想在固定时间创建一系列低音和高音调的哔哔声。例如:在150毫秒时发出高音调的蜂鸣声在151毫秒时发出低音调的蜂鸣声200毫秒时发出低音调的蜂鸣声250毫秒的高音调蜂鸣声有没有办法在Ruby或Python中做到这一点?我真的不在乎输出编码是什么(.wav、.mp3、.ogg等等),但我确实想创建一个输出文件。

  3. ruby-on-rails - Rails - 子类化模型的设计模式是什么? - 2

    我有一个模型:classItem项目有一个属性“商店”基于存储的值,我希望Item对象对特定方法具有不同的行为。Rails中是否有针对此的通用设计模式?如果方法中没有大的if-else语句,这是如何干净利落地完成的? 最佳答案 通常通过Single-TableInheritance. 关于ruby-on-rails-Rails-子类化模型的设计模式是什么?,我们在StackOverflow上找到一个类似的问题: https://stackoverflow.co

  4. ruby - 什么是填充的 Base64 编码字符串以及如何在 ruby​​ 中生成它们? - 2

    我正在使用的第三方API的文档状态:"[O]urAPIonlyacceptspaddedBase64encodedstrings."什么是“填充的Base64编码字符串”以及如何在Ruby中生成它们。下面的代码是我第一次尝试创建转换为Base64的JSON格式数据。xa=Base64.encode64(a.to_json) 最佳答案 他们说的padding其实就是Base64本身的一部分。它是末尾的“=”和“==”。Base64将3个字节的数据包编码为4个编码字符。所以如果你的输入数据有长度n和n%3=1=>"=="末尾用于填充n%

  5. ruby - 解析 RDFa、微数据等的最佳方式是什么,使用统一的模式/词汇(例如 schema.org)存储和显示信息 - 2

    我主要使用Ruby来执行此操作,但到目前为止我的攻击计划如下:使用gemsrdf、rdf-rdfa和rdf-microdata或mida来解析给定任何URI的数据。我认为最好映射到像schema.org这样的统一模式,例如使用这个yaml文件,它试图描述数据词汇表和opengraph到schema.org之间的转换:#SchemaXtoschema.orgconversion#data-vocabularyDV:name:namestreet-address:streetAddressregion:addressRegionlocality:addressLocalityphoto:i

  6. ruby - 在 Ruby 中编写命令行实用程序 - 2

    我想用ruby​​编写一个小的命令行实用程序并将其作为gem分发。我知道安装后,Guard、Sass和Thor等某些gem可以从命令行自行运行。为了让gem像二进制文件一样可用,我需要在我的gemspec中指定什么。 最佳答案 Gem::Specification.newdo|s|...s.executable='name_of_executable'...endhttp://docs.rubygems.org/read/chapter/20 关于ruby-在Ruby中编写命令行实用程序

  7. ruby - 为什么 4.1%2 使用 Ruby 返回 0.0999999999999996?但是 4.2%2==0.2 - 2

    为什么4.1%2返回0.0999999999999996?但是4.2%2==0.2。 最佳答案 参见此处:WhatEveryProgrammerShouldKnowAboutFloating-PointArithmetic实数是无限的。计算机使用的位数有限(今天是32位、64位)。因此计算机进行的浮点运算不能代表所有的实数。0.1是这些数字之一。请注意,这不是与Ruby相关的问题,而是与所有编程语言相关的问题,因为它来自计算机表示实数的方式。 关于ruby-为什么4.1%2使用Ruby返

  8. ruby - ruby 中的 TOPLEVEL_BINDING 是什么? - 2

    它不等于主线程的binding,这个toplevel作用域是什么?此作用域与主线程中的binding有何不同?>ruby-e'putsTOPLEVEL_BINDING===binding'false 最佳答案 事实是,TOPLEVEL_BINDING始终引用Binding的预定义全局实例,而Kernel#binding创建的新实例>Binding每次封装当前执行上下文。在顶层,它们都包含相同的绑定(bind),但它们不是同一个对象,您无法使用==或===测试它们的绑定(bind)相等性。putsTOPLEVEL_BINDINGput

  9. ruby - Infinity 和 NaN 的类型是什么? - 2

    我可以得到Infinity和NaNn=9.0/0#=>Infinityn.class#=>Floatm=0/0.0#=>NaNm.class#=>Float但是当我想直接访问Infinity或NaN时:Infinity#=>uninitializedconstantInfinity(NameError)NaN#=>uninitializedconstantNaN(NameError)什么是Infinity和NaN?它们是对象、关键字还是其他东西? 最佳答案 您看到打印为Infinity和NaN的只是Float类的两个特殊实例的字符串

  10. ruby-on-rails - 如果 Object::try 被发送到一个 nil 对象,为什么它会起作用? - 2

    如果您尝试在Ruby中的nil对象上调用方法,则会出现NoMethodError异常并显示消息:"undefinedmethod‘...’fornil:NilClass"然而,有一个tryRails中的方法,如果它被发送到一个nil对象,它只返回nil:require'rubygems'require'active_support/all'nil.try(:nonexisting_method)#noNoMethodErrorexceptionanymore那么try如何在内部工作以防止该异常? 最佳答案 像Ruby中的所有其他对象

随机推荐