feat!: explicitly require Cow for absolutize_with base parameter

[hyf0]

Closes #36

[codspeed-hq]

Merging this PR will not alter performance

✅ 29 untouched benchmarks
⏩ 1 skipped benchmark¹

---

_{Comparing hyf_3248092384 (f518f9f) with main (a172f38)}

Footnotes

1. 1 benchmark was skipped, so the baseline result was used instead. If it was deleted from the codebase, click here and archive it to remove it from the performance reports. ↩

[Copilot]

Pull request overview

This PR implements a semver-breaking API change to make SugarPath::absolutize_with explicitly accept Cow<'a, Path> for its base parameter, removing the custom IntoCowPath trait and updating call sites accordingly (per issue #36).

Changes:

• Change absolutize_with signature to fn absolutize_with<'a>(&self, base: Cow<'a, Path>) -> Cow<'_, Path>.
• Remove IntoCowPath and its implementations from src/utils.rs.
• Update docs, tests, and benchmarks to pass Cow::Borrowed(...) / Cow::Owned(...).

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/sugar_path.rs	Updates the public trait method signature and doc examples to use Cow<'a, Path>.
src/impl_sugar_path.rs	Updates implementations to accept Cow directly and removes into_cow_path() usage.
src/utils.rs	Deletes the IntoCowPath trait and keeps only get_current_dir().
src/lib.rs	Updates crate-level rustdoc examples to the new Cow-based API.
tests/absolutize_with.rs	Updates test callsites to pass Cow (adds a helper macro for concision).
tests/deep_paths.rs	Updates deep-path tests to pass Cow::Borrowed bases.
benches/absolutize.rs	Updates benchmarks to pass Cow::Borrowed(cwd.as_path()).
AGENTS.md	Updates repository documentation to reflect removal of IntoCowPath.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.