Ewoks install bootstrap

[woutdenolf]

Closes #341.

Install the environment of a workflow with only a package manager, no ewoks needed:

curl -LsSf https://ewoks.readthedocs.io/en/stable/ewoks-install.sh | sh -s -- demo.json --package-manager-name uv

What changes

• New bootstrap scripts ewoks-install.sh (Linux/macOS) and ewoks-install.ps1 (Windows, or PowerShell anywhere):
  • Create a cached environment with the ewoks version (and engine) of the workflow.
  • Run ewoks install in it with the remaining arguments.
  • --install-package-manager installs uv, pixi, poetry or conda when missing.
  • --print-command only prints the command.
• Workflow requirements now also record the engine that saved the workflow.
• ewoks install prints an execute command that works without ewoks outside the environment.

Review guide

1. Python side: requirements metadata and CLI output.
2. The bootstrap scripts, their tests and the CI job tests-package-manager-install (Linux, macOS, Windows).
3. Docs.

AI Disclosure

• No AI used
• AI tool Claude used to create the shell scripts, docs and tests.

[woutdenolf]

Print the command to execute ewoks from another terminal.

Edit: done.

[codecov]

Codecov Report

❌ Patch coverage is 71.42857% with 10 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/ewoks/__main__.py	30.76%	9 Missing ⚠️
src/ewoks/_engines.py	87.50%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!

[woutdenolf]

@loichuder Maybe we should not stick to the oneliner approach?

curl -LsSf https://ewoks.readthedocs.io/en/stable/ewoks-install.sh | sh -s -- demo.json --package-manager-name uv

This does four this:

• download the bootstrap script
• create the bootstrap environment
• run ewoks install in the bootstrap environment (opt-out with the --print-command argument) which create the final enviroment (unless --in-place), ewoks install also prints how the cleanup the environment
• print the pixi run ewoks execute command (or whatever it is)

Especially in terms of arguments this might be confusing. On the other hand for people who do not care and just want it to be done, the oneliner for installation is more convenient.

[loichuder]

Since the oneliner is a convenience thing, I would not go for parametrization.

Either you use the oneliner and you don't have to touch jack. Or you wish to have more control and in this case, you do use the "classical" approach: install ewoks, run ewoks install, etc.