CodeSampleX

示例

packaging 26.3: Check whether a version satisfies a requirement specifier in Python

已验证示例 — pypi packaging 26.3: Check whether a version satisfies a requirement specifier in Python. contract 在 python 3.12 · linux alpine/x64 · docker 上运行并通过.

sha256:45e2533fcb7653dca8198455b39aca51f65c0122bfe3026b03034516f955f76e

本网络只提供一件事：能构建的样本。它在沙箱中运行并保留签名回执。它不评级、不担保——同样的代码能否在你的环境构建，它没有测量过。 提交了通过的契约回执的不同签名密钥数量。为 1 表示只有作者；大于 1 表示还有其他人构建过。密钥是自行生成的，背后没有注册身份，因此计的是密钥而非人。 MIT-0

执行证据

声明的环境与签名的运行分开呈现，你可以看到这个样本究竟运行了什么、在哪里运行。

证据依据
签名契约通过
验证回执
2
构建过它的签名密钥
2
声明的环境 python 3.12 linux x64 python 3.12 python pip

验证运行环境

环境 契约 阶段 运行日期
python 3.12 · linux alpine/x64 · docker ed25519:a2ec939a4c60e243 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · python@1		 2026-08-13
python 3.12 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · python@1		 2026-08-17

案例

HOW
目标
Check whether a version satisfies a requirement specifier in Python
包
符号
  • SpecifierSet.contains
  • Version
环境
python 3.12
创建时间
2026-08-13T15:47:01Z

契约

  1. parse versions and specifier sets with packaging
  2. assert a version inside the range matches
  3. assert a prerelease is excluded from a plain range
  4. assert prereleases=True includes it

文件

  • csx.json
  • requirements.txt
  • src/__init__.py
  • src/compat.py
  • test/contract.py

下载源代码构件 (tar.gz)

源代码

csx.json
{"case":{"caseId":"case:sha256:7c9b0bfbe30dfbb7827c225b0241f69fd7fbe8d0cdc3b80010a46257ffbd8348","constraints":{"runtime":"python"},"contract":["parse versions and specifier sets with packaging","assert a version inside the range matches","assert a prerelease is excluded from a plain range","assert prereleases=True includes it"],"goal":"Check whether a version satisfies a requirement specifier in Python","kind":"HOW","packages":["pkg:pypi/packaging@26.3"],"schemaVersion":1,"symbols":["SpecifierSet.contains","Version"]},"contractCommand":["python","test/contract.py"],"environment":{"arch":"x64","ecosystem":"pypi","executionContext":"python","language":"python","os":"linux","packageManager":"pip","runtime":"python","runtimeVersion":"3.12","schemaVersion":1},"license":"MIT-0","packages":["pkg:pypi/packaging@26.3"],"schemaVersion":1,"symbols":["SpecifierSet.contains","Version"],"verifierAdapter":"python@1"}
requirements.txt
packaging==26.3
src/__init__.py
src/compat.py
"""Version range checks with packaging, the library pip itself uses."""

from packaging.specifiers import SpecifierSet
from packaging.version import Version


def fits(version, spec, allow_prerelease=False):
    """Report whether version satisfies spec.

    Prereleases are excluded from an ordinary specifier even when they fall
    numerically inside it — the single most surprising rule here, and the
    reason "1.13.0rc1" fails a ">=1.0,<2.0" check that "1.13.0" passes.
    Comparing version strings directly instead would order 1.9 above 1.10.
    """
    return SpecifierSet(spec, prereleases=allow_prerelease).contains(Version(version))


def newest(versions):
    """Return the highest version, ordered by PEP 440 rather than by string."""
    return str(max((Version(v) for v in versions)))
test/contract.py
import os
import sys

sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
from src.compat import fits, newest

assert fits("1.12.0", ">=1.0,<2.0")
assert not fits("2.0.0", ">=1.0,<2.0")

# The prerelease rule: excluded by default, included on request.
assert not fits("1.13.0rc1", ">=1.0,<2.0")
assert fits("1.13.0rc1", ">=1.0,<2.0", allow_prerelease=True)

# PEP 440 ordering, not lexicographic: 1.10 is newer than 1.9.
assert newest(["1.9.0", "1.10.0", "1.2.0"]) == "1.10.0"
assert newest(["2.0.0rc1", "2.0.0"]) == "2.0.0"

print("CONTRACT PASS: packaging applied PEP 440 ranges and ordering")

原始种子者

anonymous