Struct FileProviderSource 

pub struct FileProviderSource { /* private fields */ }

File-backed provider source rooted at a provider directory.

Implementations

impl FileProviderSource

pub fn resolve_python_provider_path( &self, provider_path: &Path, ) -> Result<PathBuf, FileProviderLoadError>

Resolves an exact managed .py provider path under this source.

impl FileProviderSource

pub fn new(root: impl Into<PathBuf>) -> Self

Creates a source rooted at root.

pub fn with_python_environment_preparer( self, preparer: Arc<dyn PythonProviderEnvironmentPreparer>, ) -> Self

Configures immutable Python environment preparation for .py candidates. Existing sources remain ambient unless this is called.

pub fn with_python_runner(self, runner: PythonRunnerSelection) -> Self

Selects persistent execution for eligible Python providers.

pub fn root(&self) -> &Path

Returns the root provider directory.

pub fn inspect( &self, ) -> Result<ProviderDirectoryInspection, FileProviderLoadError>

Non-executing inspection of the provider directory: parses manifests (JSON/TS/WASM sidecar/Python/Markdown) but never runs handler code, calls MCP, or fetches OpenAPI — safe to run before the runtime loads providers.

pub fn load(&self) -> Result<Vec<Arc<dyn Provider>>, FileProviderLoadError>

Loads and builds every enabled provider (including resource-file providers) from the directory, ready for registration.

pub fn load_with_python_environments( &self, selections: &PythonProviderEnvironmentSelections, ) -> Result<Vec<Arc<dyn Provider>>, FileProviderLoadError>

Loads providers using the supplied immutable Python environment selections.

pub async fn load_with_python_environments_async( &self, selections: &PythonProviderEnvironmentSelections, ) -> Result<Vec<Arc<dyn Provider>>, FileProviderLoadError>

Loads providers and preflights every persistent Python worker before returning a candidate set to the registry.

pub fn fingerprint(&self) -> Result<String, FileProviderLoadError>

Computes a stable SHA-256 fingerprint over all provider inputs, used to detect changes to the provider directory.

pub fn fingerprint_with_python_environments( &self, selections: &PythonProviderEnvironmentSelections, ) -> Result<String, FileProviderLoadError>

Fingerprints provider inputs plus active Python environment generations.

Trait Implementations

impl Clone for FileProviderSource

fn clone(&self) -> FileProviderSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileProviderSource

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

Formats the value using the given formatter.