opsward.util

Shared helpers for opsward.

opsward.util.iter_files(directory: Path, *, suffix: str = '')

Yield files in directory (non-recursive), optionally filtered by suffix.

opsward.util.iter_subdirs(directory: Path)

Yield immediate subdirectories of directory, sorted by name.

opsward.util.read_json_safe(path: Path) → dict | None

Read a JSON file, returning None on any failure.

opsward.util.read_text_safe(path: Path) → str

Read a text file, returning ‘’ if it doesn’t exist or can’t be decoded.

>>> from pathlib import Path
>>> read_text_safe(Path('/nonexistent/file.txt'))
''