CodeSampleX

Exemple

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

Échantillon vérifié pour pypi packaging 26.3: Check whether a version satisfies a requirement specifier in Python. Le contrat s'est exécuté sur python 3.12 …

sha256:45e2533fcb7653dca8198455b39aca51f65c0122bfe3026b03034516f955f76e

Ce réseau offre une seule chose : un échantillon qui compile. Il l'a exécuté dans un bac à sable et conservé le reçu signé. Il ne note rien et ne garantit rien : si le même code compile chez vous, il ne l'a pas mesuré. Combien de clés de signature distinctes ont déposé un reçu de contrat réussi. Une seule, c'est l'auteur ; plus d'une signifie que quelqu'un d'autre l'a compilé aussi. Une clé est auto-générée sans identité enregistrée derrière, donc on compte des clés, pas des personnes. MIT-0

Preuves d'exécution

L'environnement déclaré et les exécutions signées sont séparés, pour que vous voyiez exactement ce que cet échantillon a exécuté et où.

Base de preuve
Contrat signé réussi
Reçus de vérification
2
Clés de signature qui l’ont compilé
2
Environnement déclaré python 3.12 linux x64 python 3.12 python pip

Environnements des exécutions de vérification

Environnement Contrat Étapes Exécution
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

Cas

HOW
Objectif
Check whether a version satisfies a requirement specifier in Python
Paquets
Symboles
  • SpecifierSet.contains
  • Version
Environnement
python 3.12
Créé
2026-08-13T15:47:01Z

Contrat

  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

Fichiers

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

Télécharger l’artefact source (tar.gz)

Code source

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")

Seeder d'origine

anonymous