quarto-dev / quarto-python Goto Github PK

@jjallaire Here are some thoughts on how we might enable Python users to more easily install quarto.

How to invoke command

This would work if you think of it as the Python package just bootstrapping the installation process for you.

pip install quarto
python -m quarto install-cli [--version=<latest|prerelease|1.3.450>]

Or if we're literally bundling the quarto binaries into packages hosted on pip, it might be more like:

# Doesn't install quarto cli
pip install quarto

# Installs for Windows
pip install quarto[cli-windows]

# etc.
pip install quarto[cli-mac]
pip install quarto[cli-linux-x64]
pip install quarto[cli-linux-arm64]

# Or maybe automatically??
pip install quarto[cli]

Installation methods

Both methods below will need to discover the latest current (or prerelease, optionally?) quarto version so it knows what to download. Also should be able to let the user specify the desired version.

Untar (for virtualenvs)

Download a platform-specific tarball from https://quarto.org/docs/download/ and unpack it somewhere within sysconfig.get_path("data"). Set up a quarto alias or passthrough script and put it in sysconfig.get_path("scripts").

Package installer (for system python)

For system Python, I think there's not a reason to do a tarball and it's better just to install from the normal installer. Otherwise we're trying to untar stuff into /usr/local/bin or whatever, which both feels aggressive and also would require the user to retry the command with sudo.

In this case, we'd just download the installer to a temp directory and invoke it, I guess?

Resources

Detecting whether in a venv/virtualenv/pyvenv/pipenv or conda env

---
title: "Quarto Basics"
format:
  html:
    code-fold: true
jupyter: python3
---
` ` `{python}
#| label: holoviews
#| fig-cap: "Holoviews plot"

import numpy as np
import holoviews as hv;
hv.extension('bokeh', logo=False);
 
r            = np.arange(0, 2, 0.01)
theta        = 4 * np.pi * r

hv.Curve((theta,r))
` ` `

does not render correctly, e.g, with html and with pdf output