|
|
|
|
|
""" |
|
|
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 [] |
|
|
|
