rlsbl v0.92.0 /rlsbl.commands.status
On this page

Status command that displays a project summary including current version, branch, last tag, and changelog coverage for unreleased work.

#rlsbl.commands.status

#rlsbl.commands.status

Status command that displays a project summary including current version, branch, last tag, and changelog coverage for unreleased work.

#_compare_versions

python
def _compare_versions(local, remote)

Compare two semver version strings.

Returns "AHEAD" if local > remote, "BEHIND" if local < remote, "SAME" if equal, or "ERROR" if either version cannot be parsed.

#_collect_status

python
def _collect_status(registry, target_path='.', *, tag_glob=None, ctx, project=None, flags=None)

Collect status data as a dict.

When tag_glob is set (monorepo mode), it is forwarded to _unreleased_range so coverage uses the correct scoped tag.

When project is set (monorepo mode), unreleased commits are filtered to only those touching the project's files (by path prefix or watch globs), so the count reflects actual project-specific changes.

When flags contains "registry": True, queries the package registry for the latest published version and computes drift.

Returns None and prints an error if the project does not exist.

#run_cmd

python
def run_cmd(registry, args, flags, ctx)

Status command handler.

Shows a quick 'where am I' summary: package info, git state, changelog, CI. With --json, outputs machine-readable JSON instead.