Module workspace 

Shared utilities for creating isolated project workspaces.

Used by both mutation testing and brutalization to copy a project to a temporary directory for safe source-level modifications.

Constants

MAX_SYMLINK_DEPTH 🔒

Maximum recursion depth for nested lib symlinks to prevent infinite loops.

Functions

copy_dir_recursive

Recursively copy a directory, following symlinked directories only within the allowed root.

copy_dir_recursive_inner 🔒

copy_extra_project_path 🔒

copy_project

Copy essential project files to a temp workspace.

copy_project_dir_recursive 🔒

copy_project_local_optional_path 🔒

copy_project_local_permission_path 🔒

create_project_local_permission_dir 🔒

ensure_safe_relative_path

Validates that rel is a safe relative path. Returns an error mentioning label and orig if the path contains .., is absolute, or otherwise escapes the project root.

ensure_within_root 🔒

Verify that candidate resolves (after following symlinks) to a path that lives inside allowed_root. Protects against src/test/lib/etc. being symlinks that escape the project root.

handled_project_roots 🔒

is_covered_by_handled_root 🔒

is_covered_by_symlinked_project_root 🔒

is_safe_relative_path

Check if a path is safe for use as a relative path within a workspace. Rejects absolute paths, parent directory components (..), and other unsafe patterns.

isolated_mutable_path_rel 🔒

normalize_existing_ancestor 🔒

normalize_path 🔒

process_nested_lib_dir 🔒

push_handled_project_root 🔒

rebase_config_paths

Build a config for a copied temp workspace from an already materialized config.

rebase_mutable_project_path 🔒

rebase_project_path 🔒

rebase_remapping 🔒

relative_to_root

Compute relative path of path under root, or return the path unchanged if not under root.

resolve_against_root 🔒

symlink_dir

Create a symlink to a directory (cross-platform).

symlink_nested_libs 🔒

Recursively symlink nested lib directories within a library.