Struct daml_util::package::DamlPackages

pub struct DamlPackages { /* private fields */ }

Convenience methods for working with a collection of DamlPackage.

In the following example a DamlPackages is created from all known DamlPackage on a Daml ledger and then converted into DarFile using the ArchiveAutoNamingStyle::Uuid naming style:

futures::executor::block_on(async {
let ledger_client = DamlGrpcClientBuilder::uri("http://127.0.0.1").connect().await.unwrap();
let packages = DamlPackages::from_ledger(&ledger_client).await.unwrap();
let dar = packages.into_dar(ArchiveAutoNamingStyle::Uuid).unwrap();

Implementations

impl DamlPackages

pub fn new(packages: Vec<DamlPackage>) -> Self

pub async fn from_ledger(ledger_client: &DamlGrpcClient) -> DamlResult<Self>

Create a DamlPackages from all known DamlPackage on a Daml ledger.

pub async fn find_module(self, module_name: &str) -> DamlResult<String>

Return the hash of the DamlPackage which contains a given module or en error if no such package exists.

The supplied module_name name is assumed to be in DottedName format, i.e. TopModule.SubModule.Module.

pub fn into_dar(
    self,
    auto_naming_style: ArchiveAutoNamingStyle
) -> DamlResult<DarFile>

Package all contained DamlPackage into a single DarFile.

Note that an arbitrary package is selected as the main and the remainder are the dependencies. No attempt is made to ensure that the dependencies do in fact depend on the main. TODO allow specifying the package id to use as the main package TODO allow filtering packages such that only actual dependencies of main are included

pub fn into_archives(
    self,
    auto_naming_style: ArchiveAutoNamingStyle
) -> DamlResult<Vec<DamlLfArchive>>

Convert all contained DamlPackage into DamlLfArchive.

Note that the created archive is not named.

pub fn into_payloads(self) -> DamlResult<Vec<(String, DamlLfArchivePayload)>>

Convert all contained DamlPackage into DamlLfArchivePayload.

Trait Implementations

impl Debug for DamlPackages

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

Formats the value using the given formatter.