Struct Selection 

pub struct Selection { /* private fields */ }

Which of a DAR’s packages a crate emits.

Keys are package names or package ids, as for ExternalPackages, and the name form is the one to prefer for the same reason.

Implementations

impl Selection

pub fn everything() -> Self

Emit every package in the DAR.

pub fn only<K: Into<String>>(keys: impl IntoIterator<Item = K>) -> Self

Emit only the packages named here.

pub fn and_prefixed<K: Into<String>>( self, prefixes: impl IntoIterator<Item = K>, ) -> Self

Also emit every package whose name is prefix, or begins with prefix-.

The standard library arrives as some thirty packages — daml-stdlib, daml-stdlib-DA-Time-Types, daml-prim-GHC-Types, … — and which ones a DAR carries depends on what its Daml source happened to touch. Listing them by hand produces a list that is wrong for the next DAR; the family is what is meant, so the family is what is written.

The - is required so that daml-prim does not also select a package called daml-primary.

This narrows: applied to Selection::everything it stops meaning “the whole DAR” and starts meaning “these families”.

Trait Implementations

impl Clone for Selection

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Selection

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

Formats the value using the given formatter.

impl Default for Selection

fn default() -> Self

Returns the “default value” for a type.