Skip to content

versions

List all available versions of a package, with options to limit results, filter by PEP 440 specifier, or show only yanked versions.

Usage

peeq versions <package> [options]

Arguments

Argument Description
package Package name. Required.

Options

Option Type Default Description
--limit integer 40 Maximum number of versions to show.
--all flag off Show all versions (no limit).
--offset integer 0 Skip the first N versions before applying --limit.
--yanked flag off Show only yanked versions with their yank reasons.
--matching string -- PEP 440 version specifier to filter versions (e.g., ">=2.0,<3").
--pre, --prerelease flag off Include pre-release versions when using --matching.

Option interaction rules

  • --all and --limit cannot be used together.
  • --limit must be non-negative.
  • --offset must be non-negative. Applied after filtering (--matching, --yanked), before --limit. Can combine with --all to skip N versions and show the rest.
  • --pre requires --matching. Pre-release filtering only applies when a specifier is active.

PEP 440 specifiers

The --matching option accepts standard PEP 440 version specifiers. Multiple constraints can be combined with commas:

Specifier Meaning
>=2.0 Version 2.0 or later
<3 Below version 3
>=2.0,<3 Between 2.0 (inclusive) and 3 (exclusive)
~=2.28 Compatible release: >=2.28,<3.0
!=2.32.1 Exclude a specific version

Examples

List versions with default limit

$ peeq versions requests
requests versions (showing 40 of 156):
  - 2.33.1 (2026-03-30) (latest)
  - 2.33.0 (2026-03-25)
  - 2.32.5 (2025-08-18)
  - 2.32.4 (2025-06-09)
  - 2.32.3 (2024-05-29)
  - 2.32.2 (2024-05-21)
  - 2.32.1 (2024-05-20) (yanked: Yanked due to conflicts with CVE-2024-35195 mitigation )
  - 2.32.0 (2024-05-20) (yanked: Yanked due to conflicts with CVE-2024-35195 mitigation)
  - 2.31.0 (2023-05-22)
  - 2.30.0 (2023-05-03)
...

By default, the 40 most recent versions are shown. Use --all to show every version, or --limit N to set a custom limit.

List recent versions

$ peeq versions requests --limit 5
requests versions (showing 5 of 156):
  - 2.33.1 (2026-03-30) (latest)
  - 2.33.0 (2026-03-25)
  - 2.32.5 (2025-08-18)
  - 2.32.4 (2025-06-09)
  - 2.32.3 (2024-05-29)

Paginate with offset

$ peeq versions requests --limit 5 --offset 5
requests versions (showing 6–10 of 156):
  - 2.32.3 (2024-05-29)
  - 2.32.2 (2024-05-21)
  - 2.32.1 (2024-05-20) (yanked: Yanked due to conflicts with CVE-2024-35195 mitigation )
  - 2.32.0 (2024-05-20) (yanked: Yanked due to conflicts with CVE-2024-35195 mitigation)
  - 2.31.0 (2023-05-22)

Use --offset to skip results and paginate through the version list. The header shows the current range (e.g., "showing 6–10 of 156").

Filter with a version specifier

$ peeq versions requests --matching ">=2.30,<2.33"
requests versions (8 of 156 matching >=2.30,<2.33):
  - 2.32.5 (2025-08-18) (latest)
  - 2.32.4 (2025-06-09)
  - 2.32.3 (2024-05-29)
  - 2.32.2 (2024-05-21)
  - 2.32.1 (2024-05-20) (yanked: Yanked due to conflicts with CVE-2024-35195 mitigation )
  - 2.32.0 (2024-05-20) (yanked: Yanked due to conflicts with CVE-2024-35195 mitigation)
  - 2.31.0 (2023-05-22)
  - 2.30.0 (2023-05-03)

Yanked versions appear in the output with their yank reason when they match the specifier. They are included in the count but are not considered "latest."

Show only yanked versions

$ peeq versions requests --yanked
requests yanked versions (2):
  - 2.32.1 (2024-05-20) (latest) (yanked: Yanked due to conflicts with CVE-2024-35195 mitigation )
  - 2.32.0 (2024-05-20) (yanked: Yanked due to conflicts with CVE-2024-35195 mitigation)

See also

  • info — include a version list as part of a broader package report with --versions.