NAME

repomatic lint-workflows - Lint downstream workflow caller files

SYNOPSIS

repomatic lint-workflows [OPTIONS]

DESCRIPTION

Lint workflow files for common issues.

Check thin caller workflows that delegate to the canonical reusable workflows in kdeldycke/repomatic. Use repomatic init workflows to generate or sync workflow files.

- Standalone workflows missing the workflow_dispatch trigger.
- Thin callers using @main instead of a version tag.
- Thin callers with triggers that diverge from the canonical workflow


  (missing or extra entries).
- Thin callers missing required secrets.

OPTIONS

--workflow-dir DIRECTORY: Directory containing workflow YAML files.
--upstream-repo TEXT: Upstream repository to match thin callers against.
--fatal / --warning: Exit with code 1 if issues are found (default: warning only).
--help / -h: Show this message and exit.

ENVIRONMENT

LINT_WORKFLOWS_WORKFLOW_DIR: Directory containing workflow YAML files.
LINT_WORKFLOWS_REPO: Upstream repository to match thin callers against.
LINT_WORKFLOWS_FATAL: Exit with code 1 if issues are found (default: warning only).
LINT_WORKFLOWS__CLICK_DEFAULT_HELP: Show this message and exit.

EXIT STATUS

0: Success.
1: A runtime error, or an aborted prompt (Ctrl-C, a declined confirmation).
2: A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.

EXAMPLES

Lint workflows in default location

repomatic lint\-workflows

Lint with fatal mode (exit 1 on issues)

repomatic lint\-workflows \-\-fatal

Lint a custom directory

repomatic lint\-workflows \-\-workflow\-dir ./my\-workflows

AUTHORS

Kevin Deldycke