crossbar._codename

Crossbar.io release codenames.

Each Crossbar.io CalVer release series (year.month) carries a maintainer-chosen codename, e.g. 26.6.x is “Resistance Is Futile”. The codename is purely additive metadata surfaced in the product title / CLI banner; it does not affect versioning.

A new codename is assigned per year.month series at release-prep time (see the prep-release recipe in the justfile), alongside the version bump and the new release signing key.

Attributes

Functions

get_codename(→ Optional[str])

Look up the release codename for a Crossbar.io CalVer version string.

get_codename_suffix(→ str)

Return the codename as a title/banner suffix, e.g. ``" — Resistance Is

Module Contents

_CODENAMES: Dict[Tuple[int, int], str][source]
get_codename(version: str | None = None) str | None[source]

Look up the release codename for a Crossbar.io CalVer version string.

Parameters:

version – CalVer version string like "26.6.1" or "26.6.1.dev1". Defaults to the running crossbar.__version__.

Returns:

The codename for the version’s (year, month) series, or None if no codename is assigned (e.g. a development build, or a release that has not been named yet). Never raises.

get_codename_suffix(version: str | None = None) str[source]

Return the codename as a title/banner suffix, e.g. " Resistance Is Futile", or the empty string when no codename is assigned.

Parameters:

version – see get_codename().