Skip to content

Versions

All the xtr packages have the same version number. A release publishes each package, also a package that did not change. Thus, two xtr packages with the same version always work together.

Version numbers

The version number has three parts: MAJOR.MINOR.PATCH, for example 7.1.0.

Part When it changes
MAJOR A release changes an API in a way that can break your code.
MINOR A release adds a feature. Your code continues to work.
PATCH A release repairs a defect. Your code continues to work.

Dependencies between packages

A package requires each other xtr package by its major version. For example, xtr-messenger 7.1.0 requires xtr-logging-contracts>=7.0,<8. Thus, uv can install any version 7 of the packages together.

Require the xtr packages in your application in the same way:

dependencies = [
    "xtr-cache>=7.0,<8",
    "xtr-messenger>=7.0,<8",
]

The xtr-cli templates and the xtr-recipes tool write the requirements in this format.

Python versions

Each package needs Python 3.14.4 or a later version. The tests of each package run on Python 3.14.4 and on the latest release of Python 3.14.

The packages do not support Python 3.14.0, 3.14.1, 3.14.2 or 3.14.3. In those releases, the folding of some email headers never stops.

Where to find a release

Each package is on the package index with its own name, for example xtr-cache. Each release has a git tag in the repository.