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: the Name: field of the .gear spec in the current directory).
  • -B, --branch <repo> — branch to check against (default: sisyphus).

zoryn check upstream

Analyse upstream and determine update method.

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

--package defaults to the Name: field of the .gear spec in the current directory.

Where data is looked up. When run inside the package's gear repository (spec Name: matches the package), the local worktree is scanned first — so even uncommitted changes are seen. If the local tree has no watch file, the missing pieces are pulled from the remote gitweb (git.altlinux.org, the HEAD of the gears or srpms repo); local fields still take precedence. Outside the package's repository, only the remote gitweb is queried.

Where the watch file is looked for (in this order):

  1. the file named by a copy: directive in .gear/rules or .gear-rules. A file named just watch also qualifies (e.g. altlinux/watch); a * glob is substituted with the package name;
  2. .gear/watch;
  3. <package>.watch;
  4. .gear/<package>.watch;
  5. debian/watch.

Prints whether a watch file was found, its source, the VCS URL, and the upstream git repository.

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.