| | |
| | """ |
| | Path and filesystem related utilities. |
| | """ |
| | from pathlib import Path |
| | from typing import Any, Union |
| |
|
| | def to_path(obj: Any) -> Path: |
| | """Converts a string or Path object to a resolved Path.""" |
| | if isinstance(obj, Path): |
| | return obj.resolve(strict=False) |
| | if isinstance(obj, str): |
| | return Path(obj).resolve(strict=False) |
| | raise TypeError(f"Object of type {type(obj).__name__} cannot be converted to Path") |
| |
|
| | def is_binary_file(path: Union[str, Path], chunk_size: int = 1024) -> bool: |
| | """ |
| | Heuristically determines if a file is binary by checking for null bytes. |
| | Returns True on read errors (assume not plain text). |
| | """ |
| | try: |
| | file_path = to_path(path) |
| | if not file_path.is_file(): |
| | return True |
| | with file_path.open("rb") as f: |
| | chunk = f.read(chunk_size) |
| | return b"\x00" in chunk |
| | except Exception: |
| | return True |
| |
|
| | def safe_glob(base: Union[str, Path], pattern: str) -> list[Path]: |
| | """ |
| | Performs a glob search relative to a base path, handling exceptions. |
| | Returns a list of resolved Path objects. |
| | """ |
| | try: |
| | base_path = to_path(base) |
| | if not base_path.is_dir(): |
| | return [] |
| | results = base_path.rglob(pattern) if "**" in pattern else base_path.glob(pattern) |
| | return [p.resolve(strict=False) for p in results if p.exists()] |
| | except Exception: |
| | return [] |
| |
|
