Struct Package 

pub struct Package { /* private fields */ }

A package generated by a PackageBuilder, suitable for assembling into a TUF repository.

Implementations

impl Package

pub fn hash(&self) -> &Hash

The merkle root of the package’s meta.far.

pub fn meta_far(&self) -> Result<File>

The package’s meta.far.

pub fn name(&self) -> &PackageName

The name of the package.

pub fn fuchsia_url(&self) -> PinnedAbsolutePackageUrl

The pinned fuchsia-pkg url of the package on fuchsia.com.

pub fn artifacts(&self) -> &Utf8Path

The directory containing the blobs contained in the package, including the meta.far.

pub async fn identity() -> Result<Self, Error>

Builds and returns the package located at “/pkg” in the current namespace.

pub async fn from_dir(root: impl AsRef<Path>) -> Result<Self, Error>

Builds and returns the package located at the given path in the current namespace.

pub fn meta_contents(&self) -> Result<MetaContents, Error>

Returns the parsed contents of the meta/contents file.

pub fn meta_subpackages(&self) -> Result<MetaSubpackages, Error>

Returns the parsed contents of the subpackages manifest.

pub fn list_blobs(&self) -> BTreeSet<Hash>

Returns a set of all unique blobs contained in this package, including meta.far and subpackage blobs.

Panics

If either there are unknown subpackage blobs or there is an error reading meta/contents.

pub fn content_blob_files(&self) -> impl Iterator<Item = BlobFile>

Returns an iterator of merkle/File pairs for each content blob in the package.

Does not include the meta.far, see meta_far() and meta_far_merkle_root(), instead.

pub fn contents(&self) -> (BlobContents, HashMap<Hash, Vec<u8>>)

Returns a tuple of the contents of the meta far and the contents of all content blobs in the package.

pub fn content_and_subpackage_blobs(&self) -> Option<HashMap<Hash, Vec<u8>>>

Returns None if this Package has subpackages but doesn’t have the blobs.

pub async fn write_to_blobfs_ignore_subpackages( &self, blobfs_ramdisk: &BlobfsRamdisk, )

Writes the meta.far and all content blobs to blobfs. Does not write the subpackage blobs, if any.

pub async fn write_to_blobfs(&self, blobfs_ramdisk: &BlobfsRamdisk)

Writes the meta.far and all content and subpackage blobs to blobfs.

pub async fn verify_contents( &self, dir: &DirectoryProxy, ) -> Result<(), VerificationError>

Verifies that the given directory serves the contents of this package.

pub fn subpackage_blobs(&self) -> Option<&HashMap<Hash, Vec<u8>>>

The blobs used by all of the subpackages of this package (recursively). If None, this Package has subpackages but does not have the blobs needed by those subpackages.

Trait Implementations

impl Debug for Package

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

Formats the value using the given formatter.