#rlsbl.commands.pre_push_check

#rlsbl.commands.pre_push_check

Pre-push-check command that verifies CHANGELOG.md contains an entry for the current version before allowing a git push to proceed.

#_get_release_branches

def _get_release_branches()

Return the configured release-branch list.

Reads release_branches from .rlsbl/config.json if present; falls back to ["main", "master"] when the key is absent.

Raises :class:ValueError if the key is present but malformed (empty list or non-list value). An empty list would silently disable the manual-release-push warning, which is almost never what the user wants; require explicit removal of the key instead.

#_warn_if_manual_release_push

def _warn_if_manual_release_push(stdin_lines)

Print a warning when a manual push targets a release branch.

Fires only when RLSBL_RELEASE_PUSH is NOT set (i.e. the push didn't originate from rlsbl release/rlsbl undo). Inspects the pushed refs and warns on any branch matching the configured release-branch list. Never blocks -- the warning is purely advisory.

#_detect_version

def _detect_version(dir_path='.')

Detect version using registry adapters.

Returns (version_string, registry_name) or (None, None) if undetectable.

#_check_gitignore_guard

def _check_gitignore_guard(dir_path)

Check that rlsbl-managed files are not gitignored.

Returns an error string listing gitignored paths, or None if all clear.

#_get_commit_files

def _get_commit_files(sha)

Get the list of files changed by a single commit.

Returns a list of file paths relative to the repo root, or None on error.

#_filter_commits_for_project

def _filter_commits_for_project(commits, project)

Filter commits to only those that touch files belonging to a project.

Takes a set of commit SHAs and a project dict. For each commit, gets its changed files and checks whether any file matches the project (by path prefix or watch globs).

Returns the subset of commits where at least one file belongs to the project.

#_check_jsonl_changelog

def _check_jsonl_changelog(dir_path, refs, pushed_commits=None)

Check JSONL changelog coverage for commits being pushed.

Verifies that every commit in the push range exists in at least one unreleased.jsonl entry's commits list.

When pushed_commits is provided, uses that set directly instead of calling _get_pushed_commits(refs). This allows callers (e.g. monorepo check) to pass a pre-filtered set of commits.

Returns None on success, or an error message string on failure.

#_get_pushed_commits

def _get_pushed_commits(refs)

Get the set of commit SHAs being pushed.

Returns a set of full 40-char SHAs, or None on error.

#_read_stdin_lines

def _read_stdin_lines()

Read raw pre-push hook stdin lines.

Returns a list of non-empty lines, or None if stdin is not readable or empty.

#_has_version_tag_push

def _has_version_tag_push(stdin_lines)

Check whether any stdin line is pushing a version tag.

Version tags match refs/tags/v* (single-project) or refs/tags/@v (monorepo scoped tags like [email protected]).

Returns True if at least one line pushes a version tag.

#_parse_stdin_refs

def _parse_stdin_refs(stdin_lines=None)

Parse pre-push hook stdin to extract (local_sha, remote_sha) pairs.

Each line is:

When stdin_lines is provided (a list of raw lines), parses those directly instead of reading stdin. When omitted, reads stdin via _read_stdin_lines().

Returns a list of (local_sha, remote_sha) tuples, or None if the input is empty or unreadable.

#_get_changed_files

def _get_changed_files(refs)

Get the list of files changed across all pushed refs.

Returns a set of file paths relative to the repo root.

#_file_matches_project

def _file_matches_project(filepath, project)

Check whether a file path belongs to a project.

A file belongs to a project if:

• It starts with the project's path prefix, OR
• It matches any of the project's watch globs

#_affected_projects

def _affected_projects(changed_files, projects)

Determine which projects are affected by the changed files.

Returns a list of project dicts that have at least one changed file.

#_run_monorepo_check

def _run_monorepo_check(workspace_root, projects, changed_files, refs=None)

Check changelogs for all affected monorepo projects.

Filters pushed commits per project so that a commit touching only one project does not require changelog coverage in other projects.

Returns exit code 0 on success, 1 if any project fails.

#run_cmd

def run_cmd(registry, args, flags)

Check that CHANGELOG.md has an entry for the current project version.

In monorepo mode (when a workspace root is detected), parses the pushed ref range from stdin to determine which projects are affected, then checks each affected project's changelog independently.

In single-project mode, checks the current directory's changelog.

Exits 1 if any changelog entry is missing; exits 0 silently on success.