Struct PythonEnvironmentBinding 

pub struct PythonEnvironmentBinding {
    pub version: u32,
    pub executable: String,
    pub handler: String,
    pub runtime_sha256: String,
    pub import_roots_sha256: Vec<String>,
}

Versioned file-tree binding for a supervised Python deployment. Absolute installation paths are excluded so an identical package can move without changing checkpoint identity.

Fields

version: u32

Tree fingerprint format. Currently only 1 is admitted.

executable: String

Selected interpreter’s UTF-8 path relative to the runtime root, using / separators.

handler: String

Exact top-level handler module and callable, written as module:function.

runtime_sha256: String

Lowercase hex SHA-256 of the complete runtime tree, including bytecode and native files.

import_roots_sha256: Vec<String>

Ordered tree digests: handler directory first, then the configured import roots.

Implementations

impl PythonEnvironmentBinding

pub fn capture( runtime_root: &Path, python: &Path, handler: &str, import_roots: &[PathBuf], ) -> Result<Self, DbError>

Fingerprint a quiescent runtime installation and ordered import trees, including all source, bytecode, native libraries and data. The first import root is the handler directory. handler selects the exact module:function entry point in that directory. This performs blocking filesystem work; call it during packaging or on a blocking task. On Windows, read-share handles exclude writers until capture returns. Directory additions still require a quiescent deployment, and capture does not retain lifetime protection.

Errors

Rejects an interpreter outside the runtime tree, links/reparse points (including path ancestors), more than 128 ancestors per configured path, non-UTF-8 paths, more than 16 import roots, 32,768 total entries, 4 GiB total bytes or a 512 MiB file. Windows also rejects files with an existing incompatible write/delete handle.

Trait Implementations

impl Clone for PythonEnvironmentBinding

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PythonEnvironmentBinding

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PythonEnvironmentBinding

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for PythonEnvironmentBinding

impl PartialEq for PythonEnvironmentBinding

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for PythonEnvironmentBinding

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PythonEnvironmentBinding