v0.2.0 - Probe-Not-Mutate: the L0 Identity Layer, True to Its Layer

UNCtools v0.2.0

Windows UNC path handling and network drive utilities -- the L0 path-identity layer of the DazzleLib stack: it may probe the filesystem read-only to answer identity questions ("is this UNC / network / subst / local -- and what is its other name?"); it never mutates or transfers content.

The probe-not-mutate release (stack phase P1, #3)

Removed (breaking):

• Content-I/O wrappers (safe_open, safe_copy, batch_copy, process_files, replace_in_file, batch_replace_in_files) -- file I/O has no home in the identity layer; zero external consumers (verified by the stack audit)
• normalize_path(prefer_unc=) -- the explicit convert_to_local / convert_to_unc ARE the API
• Internal case-sensitivity helpers (never exported; merging into dazzle-filekit)

Changed:

• get_path_type -> classify_path_origin (it classifies WHERE a path comes from; dazzle-filekit's get_path_type classifies WHAT an object is). Old name warns through 0.2.x, removed in 0.3.0.
• operations module dissolved: probes -> detector, path algebra -> converter; warning facade through 0.2.x. Top-level imports unchanged for all surviving symbols.

Added:

• dazzle-unctools alias dist -- pip install dazzle-unctools installs this library under the DazzleLib org's uniform naming (import stays unctools); same pattern as dazzle-dz -> dazzlecmd
• docs/api-stability.md + an import-stability canary: the public surface is locked and machine-checked from this release on
• CHANGELOG; release workflow converted to PyPI trusted publishing (dual-publish: unctools + dazzle-unctools from one run)

Installation

pip install unctools          # or equivalently:
pip install dazzle-unctools

Tests: 50 passed, 2 skipped, 2 xfailed. Python 3.6+ (3.9+ tested in CI). Windows full / Unix graceful no-ops.