NAME

zoryn-task-refresh - Refresh stale subtasks in task.

SYNOPSIS

zoryn task refresh [OPTION]… TASK_ID

DESCRIPTION

Refresh stale subtasks in a task with newer versions from repo. By default, compares rebuild subtasks against the task's own branch. Use --from to compare against another branch (e.g., sisyphus) and replace stale subtasks with copy.

ARGUMENTS

TASK_ID (required)

Task ID.

OPTIONS

-C DIR

Change to directory DIR before running.

--commit

Pass --commit to task run. Requires --run.

-d, --debug

Enable debug output.

--dry-run

Show what would be refreshed without doing it.

--from=BRANCH

Source branch to compare against. Without this flag, compares against the task's own branch. With this flag, stale subtasks are replaced with copy from the source branch.

-m MESSAGE, --message=MESSAGE

Build reason forwarded to task run as -m. Use -m - to read from stdin. Requires --run.

--run

Queue the task for build after a successful refresh (also runs when no stale subtasks were found; skipped if any subtask failed to refresh).

--test-only

Pass --test-only to task run. Requires --run.

--types=TYPES

Comma-separated subtask types to check: copy, rebuild, build (=gear+srpm), ALL (=all except delete). Default without --from: rebuild. Required with --from.

COMMON OPTIONS

--help[=FMT] (default=auto)

Show this help in format FMT. The value FMT must be one of auto, pager, groff or plain. With auto, the format is pager or plain whenever the TERM env var is dumb or undefined.

--version

Show version information.

EXIT STATUS

zoryn task refresh exits with:

0

on success.

123

on indiscriminate errors reported on standard error.

124

on command line parsing errors.

125

on unexpected internal errors (bugs).

EXAMPLES

Refresh rebuild subtasks on same branch:

  zoryn task refresh 123456

Sync all subtasks with sisyphus:

  zoryn task refresh 123456 --from sisyphus --types ALL

Sync only copy subtasks with sisyphus:

  zoryn task refresh 123456 --from sisyphus --types copy

Dry run:

  zoryn task refresh 123456 --from sisyphus --types ALL --dry-run

Refresh and queue the task for build:

  zoryn task refresh 123456 --run

Refresh and run in test-only mode:

  zoryn task refresh 123456 --run --test-only

SEE ALSO

zoryn(1)