Tangleflow: GitHub Actionsワークフローをタンブルワークフローに変換し、その逆も可能に
Tangleflow: Converts GitHub Actions workflows to tangled workflows and back (github.com)
要約
Tangleflowは、GitHub Actionsのワークフローを「タンブルワークフロー」形式に変換し、その逆も行うことができるコマンドラインツールおよびライブラリです。依存関係のあるジョブを単一のワークフローに統合することで、複雑なワークフローを簡素化します。
全文翻訳
🪢 tangleflow
GitHub Actionsのワークフローをtangledワークフローに、またはその逆に変換します。
リポジトリ内のワークフローファイルを変換するためのコマンドラインツールとして、または独自のコードで解析済みのワークフローオブジェクトを変換するためのライブラリとして使用できます。
使用方法
npx tangleflow --target=<tangled|gh> [file...]
| オプション |
|---|
--target=tangled |
--target=gh, --target=github |
ファイルが指定されない場合、ソースディレクトリ内のすべてのワークフローが変換されます。
--target=tangledは.github/workflows/*.{yml,yaml}を読み込み、.tangled/workflows/に書き込みます。--target=ghは.tangled/workflows/*.{yml,yaml}を読み込み、.github/workflows/に書き込みます。
tangledへの変換時、独立した各ジョブは個別の .tangled/workflows/<job>.yml ファイルになります。needs でリンクされたジョブは、依存関係の順序で実行される単一のワークフローにまとめられます。
Tangleflowが現在サポートしている機能と計画中の機能については、COMPATIBILITY.mdで確認できます。
インストール(ライブラリとして)
npm install tangleflow
API
convertWorkflowToTangled(workflow)
解析済みのGitHub Actionsワークフローオブジェクトをtangledワークフローに変換します。ワークフロー名は、実行される最初のジョブの名前でキー付けされたオブジェクトとして返されます。needs でリンクされたジョブは1つのワークフローに結合されます。
convertWorkflowToGitHub(workflow, path)
解析済みのtangledワークフローオブジェクトをGitHub Actionsワークフローオブジェクトに変換します。