build-fs-tree 0.8.1

Generate a filesystem tree from a macro or a YAML tree
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

use super::RuntimeError;
use crate::{Build, FileSystemTree, MergeableFileSystemTree, Node};
use pipe_trait::Pipe;
use serde::de::DeserializeOwned;
use serde_yaml::from_reader;
use std::{
    io,
    path::{Path, PathBuf},
};

/// Read a YAML from stdin and build a filesystem tree.
pub fn run<Tree, Path>(target: &Path) -> Result<(), RuntimeError<Path::Owned>>
where
    Path: ToOwned + AsRef<Path> + ?Sized,
    Path::Owned: AsRef<Path>,
    Tree: Build<Path::Owned, io::Error, BorrowedPath = Path, OwnedPath = Path::Owned>
        + Node
        + DeserializeOwned,
    Tree::DirectoryContent: IntoIterator<Item = (Path::Owned, Tree)>,
    Path: Ord,
{
    io::stdin()
        .pipe(from_reader::<_, Tree>)?
        .build(target)?
        .pipe(Ok)
}

/// Read a YAML from stdin and build a filesystem tree.
pub type Run = fn(&Path) -> Result<(), RuntimeError<PathBuf>>;
/// Read a YAML from stdin and create a new filesystem tree.
pub const CREATE: Run = run::<FileSystemTree<PathBuf, String>, Path>;
/// Read a YAML from stdin and populate the target filesystem tree.
pub const POPULATE: Run = run::<MergeableFileSystemTree<PathBuf, String>, Path>;