如何使用 conda MatchSpec？

Question

How to list package versions available with conda 有有用的答案，其中之一是https://stackoverflow.com/a/47795843/257924，它使用两个等号。 conda search -h 没有完全说明 MatchSpec 语法允许什么，只给出了一些例子。

例如，我想查看最新版本的python下存在哪些包，对于一个名为jedi的包。由于上述缺少 MatchSpec 语法的详细文档，我不得不通过实验和猜测来找到正确的语法。我最终得到：

$ condaw search 'jedi[build=py37*]' --json | grep '"build"' 
      "build": "py37_1",
      "build": "py37_0",
      "build": "py37_0",
      "build": "py37_0",
      "build": "py37_0",
$ 

使用上面的--json 选项只是为了找出诸如build 之类的关键字可能是语法的一部分。

那么，MatchSpec 语法在哪里正式且完整地记录在案，这样我就不必猜测了？我现在的结论是-h 输出是唯一的。

Answer 1

有some (possibly outdated) documentation in the conda-build docs。但是，我仍然认为他们代码中的文档更清晰。可以使用

从激活的 base env 中读取它

python -c "from conda.models.match_spec import MatchSpec; help(MatchSpec)"

或the GitHub repo。

从技术上讲，代码文档更多是关于将MatchSpec 对象序列化为字符串表示，而不是解析字符串的其他方向，但它涵盖了所有可能性。

---

MatchSpec 字符串

部分文档描述了类本身，但以下是类的字符串文字表示的相关部分：

规范的字符串表示一般可以表示为

(channel(/subdir):(namespace):)name(version(build))[key1=value1,key2=value2]

其中() 表示可选字段。构建规则 规范的字符串表示是：

1. name（即“包名”）是必需的，但它的值可以是“*”。它的位置总是在键值括号之外。
2. 如果version 是一个精确的版本，它会出现在键值括号之外，并在前面加上==。如果version 是一个“模糊”值 （例如1.11.*），它位于键值括号之外，带有 .* 离开并由 = 前置。否则 version 是 包含在键值括号内。
3. 如果version 是精确版本，而build 是精确值，则build 会超出以= 开头的键值括号。 否则，build 进入键值括号内。 build_string 是build 的别名。
4. namespace 职位正在为未来的 conda 功能保留。
5. 如果包含 channel 并且是精确值，则在 channel 和 name 之间使用 :: 分隔符。 channel 可以是 规范的频道名称或频道网址。在规范字符串中 表示，将始终使用规范的频道名称。
6. 如果channel 是一个精确值并且subdir 是一个精确值，则subdir 将附加到channel 并带有/ 分隔符。否则， subdir 包含在键值括号中。
7. 键值括号可以用逗号、空格或逗号+空格分隔。值可以选择用单或双包装 引号，但如果 value 包含逗号、空格或 等号。规范格式使用逗号分隔符和单 引号。
8. 从字符串构造 :class:MatchSpec 实例时，键值括号内给出的任何键值对都会覆盖任何 括号外给出的匹配参数。

---

支持的键

除了字符串中明确表示的字段外，还支持以下键：

• build_number
• track_features
• features
• url
• md5
• license
• license_family
• fn

_{注意： fn 代表 filename。}

示例

文档继续提供示例，展示如何使用 MatchSpec 类生成这些规范字符串：

>>> str(MatchSpec(name='foo', build='py2*', channel='conda-forge'))
'conda-forge::foo[build=py2*]'

>>> str(MatchSpec('foo 1.0 py27_0'))
'foo==1.0=py27_0'

>>> str(MatchSpec('foo=1.0=py27_0'))
'foo==1.0=py27_0'

>>> str(MatchSpec('conda-forge::foo[version=1.0.*]'))
'conda-forge::foo=1.0'

>>> str(MatchSpec('conda-forge/linux-64::foo>=1.0'))
"conda-forge/linux-64::foo[version='>=1.0']"

>>> str(MatchSpec('*/linux-64::foo>=1.0'))
"foo[subdir=linux-64,version='>=1.0']"