diff --git a/docs/specifiers.rst b/docs/specifiers.rst index 87df4497..934d9f6f 100644 --- a/docs/specifiers.rst +++ b/docs/specifiers.rst @@ -30,6 +30,10 @@ Usage >>> combined_spec &= "!=1.1" >>> combined_spec =1.0,~=1.0')> + >>> # We can iterate over the SpecifierSet to recover the + >>> # individual specifiers + >>> sorted(combined_spec, key=str) + [, =1.0')>, ] >>> # Create a few versions to check for contains. >>> v1 = Version("1.0a5") >>> v2 = Version("1.0") diff --git a/packaging/specifiers.py b/packaging/specifiers.py index 840e0878..45738d24 100644 --- a/packaging/specifiers.py +++ b/packaging/specifiers.py @@ -823,6 +823,9 @@ def __iter__(self) -> Iterator[Specifier]: """ Returns an iterator over all the underlying :class:`Specifier` instances in this specifier set. + + >>> sorted(SpecifierSet(">=1.0.0,!=1.0.1"), key=str) + [, =1.0.0')>] """ return iter(self._specs)