Skip to content
zoryn/ maintainer-assistant

zoryn check

Pre-submit and pre-build checks. The spec and packages checks run automatically from zoryn up, zoryn build, and zoryn submit — they can also be invoked standalone.

zoryn check version

Check if a new upstream version is available.

zoryn check version [-p|--package <name>] [-b <repo>]

Options:

  • -p, --package <name> — package name (default: from current directory).
  • -b <repo> — branch to check against (default: sisyphus).

zoryn check upstream

Analyse upstream and determine update method.

zoryn check upstream [-p|--package <name>] [-b <repo>]

Returns information about upstream source, current version, and recommended update workflow (git-merge vs tarball).

zoryn check spec

Validate RPM spec file before submit.

zoryn check spec [--no-network] [SPECFILE] [-B BRANCH]

Checks:

  • Required fields (Name, Version, Release, Summary, License, Group).
  • Deprecated Packager tag.
  • Duplicate versions in changelog.
  • URL and VCS reachability (unless --no-network).
  • Changelog vulnerability identifiers (CVE/BDU/OVE/MFSA) formatting for the girar parser.
  • Changelog bug-closure syntax — detects invalid formats not recognised by girar (e.g. (fix #N) instead of (Closes: #N)), out-of-range bug numbers, non-existent bugs, and already-closed bugs (via Bugzilla REST API, requires network).
  • Non-printable characters in metadata fields — control characters, NBSP, invalid UTF-8, and other invisible bytes. Locale-tagged fields (Summary(ru_RU.UTF-8), %description -l ru_RU.UTF-8) allow valid Unicode text.

Options:

  • --no-network — skip URL/VCS reachability checks and RDB queries.
  • SPECFILE — path to spec file (default: auto-detect in gear repository).
  • -B, --branch BRANCH — target branch for RDB version check (default: sisyphus).

Errors block zoryn submit; warnings are displayed but don't block. Use --skip-check on submit to bypass.

zoryn check packages

Run package quality checks (sisyphus_check, etc.) on RPM packages.

zoryn check packages [PATH...] [-b name] [--skip-check=LIST] [--tool=NAME]

Checks RPM packages for policy violations. By default, runs sisyphus_check --no-check=gpg on the host. If no paths are specified, checks packages in the current builder's hasher repository (local) or the downloaded results directory (remote).

Also runs automatically after every successful zoryn build and zoryn up. Use --skip-check=all to disable.

Options:

  • PATH... — RPM files or directories to check (default: builder's hasher repo).
  • -b, --builder <name> — builder for template variable expansion (default: auto-detected).
  • --skip-check=LIST — skip specified tools (comma-separated, or all).
  • --tool=NAME — run only specified tool(s) (comma-separated).

Configuration in ~/.zoryn:

[check.tools.sisyphus_check]
command = "sisyphus_check --no-check=gpg {packages_dir}"
fatal = true
order = 10

zoryn check version-up

Validate .gear/version-up configuration.

zoryn check version-up [--from VERSION] [--to VERSION] [--no-network]

Validates [version], [changelog], [merge], [batch], [tarball] sections for invalid values, missing required fields, and unused keys. Checks all sections (including [sandbox], [add_changelog]) for unknown keys and unknown parser/format values. Optionally simulates changelog generation for a version range.

Options:

  • --from VERSION — old version for simulation (default: from spec).
  • --to VERSION — new version for simulation.
  • --no-network — skip network checks and simulation.

Exit code 0 if all OK, 1 if errors found.