Struct holochain::prelude::AppBundle

source ·

pub struct AppBundle(/* private fields */);

Expand description

A bundle of an AppManifest and collection of DNAs

Implementations§

source §

impl AppBundle

source

pub async fn new<R>( manifest: AppManifest, resources: R, root_dir: PathBuf ) -> Result<AppBundle, AppBundleError>
where R: IntoIterator<Item = (PathBuf, DnaBundle)>,

Create an AppBundle from a manifest and DNA files

source

pub fn decode(bytes: &[u8]) -> Result<AppBundle, AppBundleError>

Construct from raw bytes

source

pub fn into_inner(self) -> Bundle<AppManifest>

Convert to the inner Bundle

source

pub fn get_all_dnas_from_store( &self, dna_store: &impl DnaStore ) -> HashMap<HoloHash<Dna>, DnaFile>

Look up every installed_hash of every role, getting the DnaFiles from the DnaStore

source

pub async fn resolve_cells( self, dna_store: &impl DnaStore, agent: HoloHash<Agent>, membrane_proofs: HashMap<String, Arc<SerializedBytes>> ) -> Result<AppRoleResolution, AppBundleError>

Given a partial list of already available DnaFiles, fetch the missing others via mr_bundle::Location resolution

Methods from Deref<Target = Bundle<AppManifest>>§

source

pub fn manifest(&self) -> &M

Accessor for the Manifest

source

pub async fn write_to_file(&self, path: &Path) -> Result<(), MrBundleError>

Write a Bundle to a file

source

pub async fn resolve( &self, location: &Location ) -> Result<Cow<'_, ResourceBytes>, MrBundleError>

Retrieve the bytes for a resource at a Location, downloading it if necessary

source

pub async fn resolve_all( &self ) -> Result<HashMap<Location, Cow<'_, ResourceBytes>>, MrBundleError>

Return the full set of resources specified by this bundle’s manifest. References to bundled resources can be returned directly, while all others will be fetched from the filesystem or the network.

source

pub async fn resolve_all_cloned( &self ) -> Result<HashMap<Location, ResourceBytes>, MrBundleError>

Resolve all resources, but with fully owned references

source

pub fn bundled_resources(&self) -> &BTreeMap<PathBuf, ResourceBytes>

Access the map of resources included in this bundle Bundled resources are also accessible via resolve or resolve_all, but using this method prevents a Clone

source

pub fn encode(&self) -> Result<Vec<u8>, MrBundleError>

An arbitrary and opaque encoding of the bundle data into a byte array

source

pub fn find_root_dir(&self, path: &Path) -> Result<PathBuf, MrBundleError>

Given that the Manifest is located at the given absolute path, find the absolute root directory for the “unpacked” Bundle directory. Useful when “imploding” a directory into a bundle to determine the default location of the generated Bundle file.

This will only be different than the Manifest path itself if the Manifest::path impl specifies a nested path.

Will return None if the path does not actually end with the manifest relative path, meaning that either the manifest file is misplaced within the unpacked directory, or an incorrect path was supplied.

source

pub async fn unpack_yaml( &self, base_path: &Path, force: bool ) -> Result<(), MrBundleError>

Create a directory which contains the manifest as a YAML file, and each resource written to its own file (as raw bytes) The paths of the resources are specified by the paths of the bundle, and the path of the manifest file is specified by the Manifest::path trait method implementation of the M type.