Module pathutil 

Functions

normalize_tool_path

Normalize paths from any client format to a consistent OS-native form. Handles MSYS2/Git Bash (/c/Users/... -> C:/Users/...), mixed separators, double slashes, and trailing slashes. Uses forward slashes for consistency.

safe_canonicalize

Canonicalize a path and strip the Windows verbatim/extended-length prefix (\\?\) that std::fs::canonicalize adds on Windows. This prefix breaks many tools and string-based path comparisons.

safe_canonicalize_bounded

Canonicalize with a timeout guard. On Windows, std::fs::canonicalize can hang indefinitely on cloud-synced paths, reparse points, or network drives. Falls back to the original path if canonicalize doesn’t complete within the timeout.

safe_canonicalize_or_self

Like safe_canonicalize but returns the original path on failure.

strip_verbatim

Remove the \\?\ / //?/ verbatim prefix from a PathBuf. Handles both regular verbatim (\\?\C:\...) and UNC verbatim (\\?\UNC\...).

strip_verbatim_str

Remove the \\?\ / //?/ verbatim prefix from a path string. Returns Some(cleaned) if a prefix was found, None otherwise.