Struct Dar 

pub struct Dar { /* private fields */ }

A parsed DAR: its manifest fields plus the raw bytes of each .dalf.

Implementations

impl Dar

pub fn open(path: impl AsRef<Path>) -> Result<Self, DarError>

Read a DAR from a file on disk.

Errors

Returns DarError if the file cannot be read or is not a valid DAR.

pub fn from_bytes(bytes: &[u8]) -> Result<Self, DarError>

Read a DAR from an in-memory byte buffer.

Errors

Returns DarError if the bytes are not a valid DAR.

pub fn name(&self) -> Option<&str>

The package name (manifest Name), if present.

pub fn sdk_version(&self) -> Option<&str>

The Daml SDK version the DAR was built with (manifest Sdk-Version).

pub fn main_package_bytes(&self) -> Result<&[u8], DarError>

The raw Daml-LF bytes of the main package (the DAR’s own package, as opposed to its daml-prim / daml-stdlib / transitive dependencies).

Errors

Returns DarError if the manifest does not name the main package or the named entry is absent.

pub fn package_paths(&self) -> impl Iterator<Item = &str>

The archive paths of every package (.dalf) in the DAR, main and dependencies, in sorted order.

pub fn package_bytes(&self) -> impl Iterator<Item = &[u8]>

The raw Daml-LF bytes of every package in the DAR — the main package and its full dependency closure (daml-prim, daml-stdlib, and any other packages the DAR bundles). Decoding all of them gives the PackageMap needed to resolve cross-package references.

pub fn package_entries(&self) -> impl Iterator<Item = (&str, &[u8])>

Like Self::package_bytes, each package paired with its archive path — so a decode failure can name the offending .dalf.

pub fn package_count(&self) -> usize

The number of packages (.dalf entries) in the DAR.

Trait Implementations

impl Debug for Dar

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

Formats the value using the given formatter.