Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

copy-dir

Declares one copy per direct child of a directory, all of them in one destination directory.

[[actions]]
type = "copy-dir"
id = "seeds"
source-dir = "seed"
dest-dir = "~"
dot-prefix = true
FieldTypeRequiredDescription
source-dirrepository pathyesThe directory whose direct children are copied.
dest-dirtemplate stringyesThe directory the copies are made in. Created if it is missing.
dot-prefixbooleannoPrefix each installed name with .. Defaults to false.
includeglob or listnoEntries under source-dir to copy, at any depth; absent, every entry. See entry filters.
excludeglob or listnoEntries under source-dir not to copy, at any depth.

Each direct child is seeded separately: an occupied child destination is kept, and its siblings are still seeded. A directory child is one whole seed; nothing merges into an existing child directory.

Paths, sorted order, dot-prefix, empty/non-directory sources, and destination containers follow symlink-dir. Permissions and allowed node types follow copy.

Filters match paths relative to source-dir at any depth, before dot-prefix. A child is seeded if it or something beneath it is selected, and contains only selected entries. A wholly unselected child’s destination is not inspected. Other filter rules are copy’s.

See common action fields for id, group, and conditions.