Converts GitHub Actions workflows into tangled workflows and vice versa.
Use it as a command-line tool to convert the workflow files in a repository, or as a library to convert parsed workflow objects in your own code.
npx tangleflow --target=<tangled|gh> [file...]| Option | Description |
|---|---|
--target=tangled |
Convert GitHub Actions workflows to tangled |
--target=gh, --target=github |
Convert tangled workflows to GitHub Actions |
If no files are given, every workflow in the source directory is converted:
--target=tangledreads.github/workflows/*.{yml,yaml}and writes to.tangled/workflows/--target=ghreads.tangled/workflows/*.{yml,yaml}and writes to.github/workflows/
When converting to tangled, each independent job becomes its own
.tangled/workflows/<job>.yml file. Jobs linked by needs collapse into a
single workflow whose steps run in dependency order.
Converts a parsed GitHub Actions workflow object into a tangled Pipeline (an
array of workflows, one per GitHub job).
Converts a parsed tangled workflow object into a GitHub Actions workflow object.