NAME

zoryn-task-batch - Run batch build from config file.

SYNOPSIS

zoryn task batch [OPTION]… CONFIG

DESCRIPTION

Build a chain of related packages from a batch configuration file. Useful for maintaining package groups like PHP extensions where all packages share common settings.

Reads package list from config file and builds each package in order. Config can be specified by name (loaded from ~/.config/zoryn/batch/) or full path.

When multiple repositories are specified with -B, builds for each repo in order with automatic --deps between them.

ARGUMENTS

CONFIG (required)

Batch config name (from ~/.config/zoryn/batch/) or path to .conf file.

OPTIONS

--abort

Discard interrupted batch state.

--allow-overwrite-tag

Force-recreate existing local tags during batch run, bypassing the gears/ancestor safety checks. Note: on --continue, the flag's current value always wins over the saved-state value -- re-pass it on every resume if you want overwrite to stay enabled.

-B REPO, --branch=REPO

Target repository (default: sisyphus). Multiple repos can be specified as comma-separated list, e.g. 'sisyphus,p11,p10'.

-b NAME, --builder=NAME

Use builder NAME for local builds. See 'zoryn builder list' for available builders.

--basedir=PATH

Base directory for packages (overrides config setting).

--batch-pkgs=PKGS

Process only packages PKGS (comma-separated names). Names must exist in the config. Combines with --skip, which then further excludes from the selection.

-C DIR

Change to directory DIR before running.

--continue

Continue interrupted batch from last checkpoint.

--create-task

Create new task if not found (adds main package automatically).

-d, --debug

Enable debug output.

--dry-run

Show what would be done without making changes.

--no-build

Skip local build, only commit/tag/push/submit.

--no-edit-commit

Do not open editor when committing (for automation).

--no-python-auto-deps

Disable automatic .gear/pyproject_deps.json update and rebuild retry when Python package dependencies change during build.

--refresh

Refresh packages that have local changes. Creates new tag, pushes, and replaces subtask in existing tasks.

--restart

Discard old state and start fresh batch run.

--skip=PKGS

Skip packages PKGS (comma-separated names).

--test

Local test build mode. Builds all packages locally without interacting with gitery/gyle. No commits, tags, pushes, or task operations. Use -b to select builder.

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 batch 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

Build from config in ~/.config/zoryn/batch/:

  zoryn task batch php-8.4

Build from explicit path:

  zoryn task batch ~/configs/mypackages.conf

Build for multiple branches with dependencies:

  zoryn task batch php-8.4 -B sisyphus,p11,p10

Override basedir from config:

  zoryn task batch php-8.4 --basedir ~/packages

Skip local builds (only submit to gyle):

  zoryn task batch php-8.4 --no-build

Preview without changes:

  zoryn task batch php-8.4 --dry-run

Refresh packages with local changes (replace subtasks with new tags):

  zoryn task batch php-8.4 --refresh

Test build locally without submitting:

  zoryn task batch php-8.4 --test

Test build on specific builder, skipping packages:

  zoryn task batch php-8.4 --test -b arm-server --skip php-xdebug,php-json

Build only selected packages from the batch:

  zoryn task batch php-8.4 --batch-pkgs php-redis,php-xdebug

Resume interrupted batch:

  zoryn task batch php-8.4 --continue

Discard interrupted batch state:

  zoryn task batch php-8.4 --abort

Start fresh, discarding old state:

  zoryn task batch php-8.4 --restart

SEE ALSO

zoryn(1)

FILES

~/.config/zoryn/batch/*.conf

Batch configuration files