Struct Registry 

pub struct Registry { /* private fields */ }

The main Pacha registry.

Implementations

impl Registry

pub fn open_default() -> Result<Self>

Create or open a registry at the default location (~/.pacha).

Errors

Returns an error if initialization fails.

pub fn open(config: RegistryConfig) -> Result<Self>

Create or open a registry with the given configuration.

Errors

Returns an error if initialization fails.

pub fn config(&self) -> &RegistryConfig

Get the registry configuration.

pub fn snapshot<P: AsRef<Path>>(&self, to: P) -> Result<()>

HELIX-IDEA-007 — atomic point-in-time snapshot of the registry SQLite metadata file. Wraps SQLite’s VACUUM INTO 'path' so the target file is a self-consistent copy of the source as of the moment the statement begins. Concurrent writers continue against the source; their post-snapshot changes are absent from the copy.

The companion content-addressed object store under objects/ is immutable by construction (BLAKE3-keyed) — a consistent snapshot of the full registry is (snapshot.db, cp -r objects/). We document but do not automate the object copy in v1.

Contract: contracts/apr-registry-snapshot-v1.yaml (FALSIFY-SNAPSHOT-001..003).

Errors

Returns an error if the underlying SQL fails — most commonly when to already exists (SQLite refuses to overwrite via VACUUM INTO).

pub fn register_model( &self, name: &str, version: &ModelVersion, artifact: &[u8], card: ModelCard, ) -> Result<ModelId>

Register a new model.

Errors

Returns an error if registration fails.

pub fn get_model(&self, name: &str, version: &ModelVersion) -> Result<Model>

Get a model by name and version.

Errors

Returns an error if the model is not found.

pub fn get_model_by_id(&self, id: &ModelId) -> Result<Model>

Get a model by ID.

Errors

Returns an error if the model is not found.

pub fn list_model_versions(&self, name: &str) -> Result<Vec<ModelVersion>>

List all versions of a model.

Errors

Returns an error if the query fails.

pub fn list_models(&self) -> Result<Vec<String>>

List all model names.

Errors

Returns an error if the query fails.

pub fn transition_model_stage( &self, name: &str, version: &ModelVersion, target_stage: ModelStage, ) -> Result<()>

Transition a model to a new stage.

Errors

Returns an error if the transition is invalid.

pub fn get_model_artifact( &self, name: &str, version: &ModelVersion, ) -> Result<Vec<u8>>

Get the artifact data for a model.

Errors

Returns an error if the artifact cannot be retrieved.

pub fn get_model_lineage(&self, _model_id: &ModelId) -> Result<LineageGraph>

Get model lineage graph.

Errors

Returns an error if the query fails.

pub fn register_dataset( &self, name: &str, version: &DatasetVersion, data: &[u8], datasheet: Datasheet, ) -> Result<DatasetId>

Register a new dataset.

Errors

Returns an error if registration fails.

pub fn get_dataset( &self, name: &str, version: &DatasetVersion, ) -> Result<Dataset>

Get a dataset by name and version.

Errors

Returns an error if the dataset is not found.

pub fn list_datasets(&self) -> Result<Vec<String>>

List all dataset names.

Errors

Returns an error if the query fails.

pub fn list_dataset_versions(&self, name: &str) -> Result<Vec<DatasetVersion>>

List all versions of a dataset.

Errors

Returns an error if the query fails.

pub fn get_dataset_data( &self, name: &str, version: &DatasetVersion, ) -> Result<Vec<u8>>

Get the data for a dataset.

Errors

Returns an error if the data cannot be retrieved.

pub fn register_recipe(&self, recipe: &TrainingRecipe) -> Result<RecipeId>

Register a new recipe.

Errors

Returns an error if registration fails.

pub fn get_recipe( &self, name: &str, version: &RecipeVersion, ) -> Result<TrainingRecipe>

Get a recipe by name and version.

Errors

Returns an error if the recipe is not found.

pub fn list_recipes(&self) -> Result<Vec<String>>

List all recipe names.

Errors

Returns an error if the query fails.

pub fn list_recipe_versions(&self, name: &str) -> Result<Vec<RecipeVersion>>

List all versions of a recipe.

Errors

Returns an error if the query fails.

pub fn start_run(&self, run: ExperimentRun) -> Result<RunId>

Start a new experiment run.

Errors

Returns an error if starting fails.

pub fn update_run(&self, run: &ExperimentRun) -> Result<()>

Update an experiment run.

Errors

Returns an error if the update fails.

pub fn get_run(&self, run_id: &RunId) -> Result<ExperimentRun>

Get an experiment run by ID.

Errors

Returns an error if the run is not found.

pub fn list_runs( &self, recipe_ref: &RecipeReference, ) -> Result<Vec<ExperimentRun>>

List runs for a recipe.

Errors

Returns an error if the query fails.

pub fn storage_stats(&self) -> Result<StorageStats>

Get storage statistics.

Errors

Returns an error if querying fails.