Add uv among command example to work with virtual env and quarto

[cderv]

Thanks, the suggestion to wrap quarto render inside uv run works here and seems like the cleanest option.

You can also leverage uv run directly, as the command will be ran in the virtual env

Maybe content about uv could be added to the Quarto docs on virtual environments?

https://quarto.org/docs/projects/virtual-environments.html

Originally posted by @westat-schneider in #12053

We are mentionning venv and how to create it. uv seems widely use and it could be interesting to document it too.

[mcanouil]

FWIW, I agree with the addition of uv example, but I am a bit concerned that it will need updates/maintenance if we add it now or in few months, as the API evolves quite rapidly and with breaking changes.

[cderv]

The only thing we really need from uv in my opinion is

• Explain that it can be used with Quarto
• Link to their doc one how to create virtualenv with it

then mention

• Activating the venv (which is not a uv command), then quarto render - this is what we document already
• Run uv run quarto render

I was not planning to go deeper in uv api and so was not really concerned about API change on their part.

What do you think could be worth waiting for more stability ?

[mcanouil]

If uv run is stable in the sense that the command itself is not going to change or its behaviour, it's fine.

I did not check uv run but I've seen few days ago in the changelog:

uv publish is no longer in preview

I'm just saying to check the status.

[cderv]

ok - good to keep in mind. I was wondering if you spotted anything specific. 👍