Foundry
Home cli-tool

Planemo

Galaxy tool/workflow runtime testing CLI; used by run-workflow-test and friends.

draft cli-toolcli/planemo
Revised
2026-07-20
Rev
5

planemo

Galaxy’s runtime testing and authoring CLI. Foundry Molds invoke planemo test, planemo lint, and friends for end-to-end workflow validation; the cast skill consumes structured JSON output from --test_output_json and validates it against planemo-test-report.

Pin

package_version pins to the released planemo==0.75.45 from PyPI — base upstream planemo, no fork.

galaxyproject/planemo#1636 merged 2026-05-14 and first shipped in released 0.75.42, so planemo cli_metadata and planemo output_schema are available in every release at or above this pin. Every Foundry consumer runs off this base pin: the workflow-test phases (run-workflow-test, implement-galaxy-workflow-test) which need only planemo test --test_output_json, the convergence loop in convert-nfcore-module-to-galaxy-tool, and the vendored-artifact regeneration story (packages/planemo-cli-meta/, packages/planemo-test-report-schema/). No fork pin is required.

Install

uvx --from planemo==0.75.45 planemo --version

For a persistent install:

uv tool install planemo==0.75.45

Contributor laptops only need planemo when regenerating vendored artifacts (the schema JSON in packages/planemo-test-report-schema/, the planemo CLI manual pages under content/cli/planemo/). Normal Foundry development — npm run validate, npm run test, npm run packages-test — builds against the vendored JSON and does not invoke planemo.