Add path_safe method

[bdraco]

Needed for aio-libs/aiohttp#9267

[Dreamsorcerer]

Added some docs, let me know if that looks good to you.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 95.45%. Comparing base (497752c) to head (d65dea6).
Report is 1 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1150      +/-   ##
==========================================
+ Coverage   95.42%   95.45%   +0.02%     
==========================================
  Files          30       30              
  Lines        4767     4792      +25     
  Branches      423      425       +2     
==========================================
+ Hits         4549     4574      +25     
  Misses        192      192              
  Partials       26       26              

Flag	Coverage Δ
CI-GHA	95.40% <100.00%> (+0.02%)	⬆️
MyPy	41.29% <69.23%> (+0.14%)	⬆️
OS-Linux	99.40% <100.00%> (+<0.01%)	⬆️
OS-Windows	99.49% <100.00%> (+<0.01%)	⬆️
OS-macOS	99.11% <100.00%> (+<0.01%)	⬆️
Py-3.10.11	99.01% <100.00%> (+<0.01%)	⬆️
Py-3.10.15	99.24% <100.00%> (+<0.01%)	⬆️
Py-3.11.10	99.24% <100.00%> (+<0.01%)	⬆️
Py-3.11.9	99.01% <100.00%> (+<0.01%)	⬆️
Py-3.12.6	99.24% <100.00%> (+<0.01%)	⬆️
Py-3.13.0-rc.2	99.24% <100.00%> (+<0.01%)	⬆️
Py-3.8.10	98.95% <100.00%> (+<0.01%)	⬆️
Py-3.8.18	99.19% <100.00%> (+<0.01%)	⬆️
Py-3.9.13	98.95% <100.00%> (+<0.01%)	⬆️
Py-3.9.20	99.19% <100.00%> (+<0.01%)	⬆️
Py-pypy7.3.11	99.24% <100.00%> (+<0.01%)	⬆️
Py-pypy7.3.16	99.24% <100.00%> (+<0.01%)	⬆️
Py-pypy7.3.17	99.27% <100.00%> (+<0.01%)	⬆️
VM-macos-latest	99.11% <100.00%> (+<0.01%)	⬆️
VM-ubuntu-latest	99.40% <100.00%> (+<0.01%)	⬆️
VM-windows-latest	99.49% <100.00%> (+<0.01%)	⬆️
pytest	99.40% <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.