pub struct CopyRequest {
pub items: CopyItems,
pub scope: CopyScope,
pub destination: SourceName,
pub match_by: Option<MatchBy>,
pub recreate: bool,
pub create: bool,
pub dry_run: bool,
}Expand description
A request to copy work into one configured destination.
Fields§
§items: CopyItemsThe qualified items to copy, in the order they were named.
scope: CopyScopeWhat those ids name, and what comes with them.
destination: SourceNameThe configured source to copy into — a source name, never a qualified id.
match_by: Option<MatchBy>How to re-establish a correspondence the two origin rules cannot find.
recreate: boolWhether an origin naming nothing at the destination falls through to the search rule instead of refusing.
create: boolWhether the caller asserts the destination holds no counterpart of any item named, so each is created there without the correspondence lookup — no origin search of the destination at all.
Sound for a caller that has just asked the destination itself: the origin query is
an index that lags a write, so repeating it here would be behind by exactly as much as
the caller’s own was and could find nothing the caller’s did not. Refused beside
match_by and recreate, which are ways of
looking, and for an item that itself records a counterpart at the destination — a
link or an origin naming it — which is a carrier the caller’s assertion overlooked.
dry_run: boolWhether to perform every read and no write.