dennisdoomen / pathy / 31413386981

96%

Build Type

push

github

Committed by dennisdoomen

Commit Message

Add IFormattable support and document/validate edge-case path behaviour

- ChainablePath now implements IFormattable via ToString(format), with
  'U' and 'W' specifiers (and matching ToUnixPath()/ToWindowsPath() helpers)
  to render a path with forward or backward slashes regardless of platform.
- Add ChainablePath.IsValid: a best-effort check for characters that are
  invalid on the current platform, using Path.GetInvalidPathChars() and
  Path.GetInvalidFileNameChars(), ignoring the root so drive letters and
  UNC shares aren't flagged.
- Fix Parent throwing ArgumentException at a root path (drive root or UNC
  share root); it now returns Empty, consistent with Directory, so walking
  up a UNC path correctly stops at the share instead of throwing.
- Add specs pinning down behaviour for invalid characters, long paths
  (including the \\?\ extended-length prefix) and UNC paths (IsRooted,
  Root, Parent, AsRelativeTo).
- Document all of the above in the README, and update the approved API
  surface accordingly.

Closes #149

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Coverage Stats

140 of 152 branches covered (92.11%)

Branch coverage included in aggregate %.

22 of 22 new or added lines in 1 file covered. (100.0%)

8 existing lines in 1 file now uncovered.

337 of 347 relevant lines covered (97.12%)

146.22 hits per line