Skip to content
Tech News
← Back to articles

Tangleflow: Converts GitHub Actions workflows to tangled workflows and back

read original more articles
Why This Matters

Tangleflow offers a novel approach to managing GitHub Actions workflows by enabling seamless conversion between traditional workflows and a tangled, modular format. This flexibility can improve workflow organization, readability, and maintainability for developers and teams. Its command-line and library integrations make it a versatile tool for optimizing CI/CD processes in the tech industry.

Key Takeaways

🪢 tangleflow

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.

Usage

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=tangled reads .github/workflows/*.{yml,yaml} and writes to .tangled/workflows/

reads and writes to --target=gh reads .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.

... continue reading