Function materialize_view

atomic-core/src/output/repo/repository/mod.rs:208–299

Materialize the repository view (or prefix) to the working copy. This is the main entry point for synchronizing the working copy with the repository graph state. It traverses the tree, outputs each file, and collects all conflicts.

(
    txn: &T,
    changes: &C,
    working_copy: &W,
    options: MaterializeOptions,
)

/// the repository graph state. It traverses the tree, outputs each file,
/// and collects all conflicts.
pub fn materialize_view<T, C, W>(
    txn: &T,
    changes: &C,
    working_copy: &W,
    options: MaterializeOptions,
) -> Result<MaterializeResult, MaterializeError<W::Error>>
where
    T: TreeTxnT + GraphTxnT,
    C: ChangeStore,
    W: WorkingCopy,
    W::Writer: std::io::Write,
{
    let mut result = MaterializeResult::new();

    // Collect items to output starting from root
    let items = collect_children(txn, Inode::ROOT, "", &options)?;

    // Process each item
    let file_options = options.to_file_options();

    // ── View-aware pre-filter ──────────────────────────────────────
    let (passing_file_paths, passing_ancestors) =
        filter::compute_filters(&items, &options.change_filter);

    for item in items {
        if item.is_directory {
            // Only create directories that will contain files on this view
            if !filter::dir_has_passing_children(&item.path, &passing_ancestors) {
                result.record_skipped();
                continue;
            }
            // Selective materialize: skip directories with no target files.
            if let Some(ref paths) = options.only_paths {
                let has_target = paths.iter().any(|p| p.starts_with(&item.path));
                if !has_target {
                    result.record_skipped();
                    continue;
                }
            }
            // Create directory
            working_copy
                .create_dir_all(&item.path)
                .map_err(MaterializeError::WorkingCopy)?;
            result.record_directory();
        } else {
            // Check prefix filter
            if !options.matches_prefix(&item.path) {
                result.record_skipped();
                continue;
            }

            // Selective materialize: skip files not in the explicit path set.
            if let Some(ref paths) = options.only_paths {
                if !paths.contains(&item.path) {
                    result.record_skipped();
                    continue;
                }
            }