Litestar releases#

Version numbering#

Litestar follows the Semantic Versioning standard, using the <major>.<minor>.<patch> schema, increasing the version numbers as follows:

Major

Backwards incompatible changes have been made

Minor

Functionality was added, in a backwards compatible manner

Patch

Bugfixes were applied, in a backwards compatible manner

Pre-release versions#

A major release may be preceded by a number of pre-releases. The pre-release identifier will be appended to the major version number and follow the schema <release type><release number>. The resulting version number will have the schema <major>.<minor>.<patch><release type><release number>, for example 2.0.0alpha1.

The release types are:

alpha

A developmental release, equivalent to the current status of the development branch. At this point, new features can still be added and breaking changes introduced. These releases should be considered very unstable and are intended for early developer feedback.

beta

A more stable development release. New features might be added at this point, but no major breaking changes are to be expected

rc

“Release candidate”. This is the first release after the feature freeze before a new major release. No new features and breaking changes will be introduced at this point, only bugfixes will be added at this point. This release is suitable for testing migration to the upcoming major release. Each major version will be preceded by at least one release candidate.

Release schedule#

Litestar follows a non-strict release schedule, targeting 4 weeks between minor versions and about 1 year between major versions. For major versions, this is to be interpreted as a lower bound.

About major version#

Starting with version 2.0, Litestar’s major releases are generally backwards compatible and usually won’t include major breaking changes. They can be seen as maintenance releases that offer the opportunity to make some backwards incompatible changes.

Due to the frequency of major releases, Litestar evolves gradually over time and there won’t be sweeping changes that require a complete rewrite of an application or major migration efforts when upgrading to a new major version.

Supported versions#

Current version

The current version is the last release of the most recent major version. This version is under active development and will receive bugfixes as well as feature updates in minor releases (see Version numbering)

Maintenance versions

When a new major version is released, the last minor version before it enters maintenance mode. It will receive bugfixes and other critical patches during the next two release cycles

In practice this means that, at any given time, there may be up to 3 currently supported releases: The current version and the two major versions preceding it.

Deprecation policy#

If a feature of Litestar is to be removed, a deprecation warning will be added in a minor release. Deprecated features will still be supported throughout every release of the respective major release. In practice this means that if a deprecation warning is added in 1.x, the feature will continue to work for every 1. release, and be removed in the 2.0 release.