Struct PyEnvs 

pub struct PyEnvs { /* private fields */ }

Every plugin environment of one engine.

Implementations

impl PyEnvs

pub fn new(root: impl Into<PathBuf>, base: Vec<OsString>) -> Self

Environments go under root (e.g. <data>/plugin-python); base is the interpreter they are made from (and the one plugins without requirements use).

pub fn with_uv(self, uv: Option<PathBuf>) -> Self

Use this uv (None: pip only) instead of looking for one.

pub fn offline(self) -> Self

Install without a package index (local wheels and folders only; tests).

pub fn base(&self) -> &[OsString]

pub fn helper_dir(&self) -> Result<PathBuf, String>

The folder holding byob_plugin.py, written there the first time it is asked for.

pub fn for_plugin(&self, requirements: &[String], dir: &Path) -> Arc<PyEnv>

The environment for a plugin in dir that needs requirements (relative paths, like ./wheels/x.whl, are taken from the plugin folder).

pub fn forget_failed(&self)

Forget failed builds so they are tried again (a reload).

pub fn python( &self, env: Option<&PyEnv>, cancelled: &dyn Fn() -> bool, ) -> Result<Python, String>

How to start Python for a plugin with this environment (None: no requirements). Builds the environment if needed, until cancelled(): call it off the engine thread.