Allow replacing path without replacing query or fragment

[paul-nameless]

What do these changes do?

Add keep_query and keep_fragment arguments to with_path function to allow replacing path without replacing query or fragment

Are there changes in behavior for the user?

Yes, users can now replace the path in a URL without unintentionally modifying the query string or fragment by using the new arguments. Existing behavior remains unchanged unless the new arguments are explicitly used.

Related issue number

closes #111

Checklist

• I think the code is well written
• Unit tests for the changes exist
• Documentation reflects the changes

[codspeed-hq]

CodSpeed Performance Report

Merging #1421 will not alter performance

_{Comparing paul-nameless:with-path-keep-query (41ecc98) with master (2b94725)}

Summary

✅ 85 untouched benchmarks

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 96.11%. Comparing base (2b94725) to head (41ecc98).
Report is 1 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1421      +/-   ##
==========================================
+ Coverage   96.04%   96.11%   +0.06%     
==========================================
  Files          31       31              
  Lines        5770     5871     +101     
  Branches      348      348              
==========================================
+ Hits         5542     5643     +101     
  Misses        202      202              
  Partials       26       26              

Flag	Coverage Δ
CI-GHA	96.11% <100.00%> (+0.06%)	⬆️
MyPy	49.35% <88.88%> (+0.71%)	⬆️
OS-Linux	99.55% <100.00%> (+<0.01%)	⬆️
OS-Windows	99.62% <100.00%> (+<0.01%)	⬆️
OS-macOS	99.30% <100.00%> (+<0.01%)	⬆️
Py-3.10.11	99.28% <100.00%> (+<0.01%)	⬆️
Py-3.10.15	99.51% <100.00%> (+<0.01%)	⬆️
Py-3.11.10	99.51% <100.00%> (+<0.01%)	⬆️
Py-3.11.9	99.28% <100.00%> (+<0.01%)	⬆️
Py-3.12.7	99.51% <100.00%> (+<0.01%)	⬆️
Py-3.13.0	99.51% <100.00%> (+<0.01%)	⬆️
Py-3.9.13	99.24% <100.00%> (+<0.01%)	⬆️
Py-3.9.20	99.47% <100.00%> (+<0.01%)	⬆️
Py-pypy7.3.16	99.53% <100.00%> (+<0.01%)	⬆️
Py-pypy7.3.17	99.55% <100.00%> (+<0.01%)	⬆️
VM-macos-latest	99.30% <100.00%> (+<0.01%)	⬆️
VM-ubuntu-latest	99.55% <100.00%> (+<0.01%)	⬆️
VM-windows-latest	99.62% <100.00%> (+<0.01%)	⬆️
pytest	99.55% <100.00%> (+<0.01%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

---

🚨 Try these New Features:

• Flaky Tests Detection - Detect and resolve failed and flaky tests

[bdraco]

reframed this as a new feature since the current behavior doesn't change and its by design. All the functionality here is new.

[bdraco]

We also need to update the docs for with_path

[bdraco]

One last thing, we also need to update the docs for with_path with the new params

https://yarl--1421.org.readthedocs.build/en/1421/api/#yarl.URL.with_path

[asvetlov]

We also have .with_name() and .with_suffix().
Maybe these methods need proposed skip options as well?

[bdraco]

We will also need to bump the version to 1.18.0.dev0 after merging this PR

[asvetlov]

We will also need to bump the version to 1.18.0.dev0 after merging this PR

Technically, we can do it right now.

[asvetlov]

Please update affected method signatures in docs to reflect added parameters.

[asvetlov]

A few neats.

[asvetlov]

LGTM, thanks!