Add API calls that return pathlib.Path instead of str objects

[papr]

Implements #3 by wrapping the existing API in pathlib.Path calls and handles multipath-affected API as suggested in #24.

[codecov-commenter]

Codecov Report

Merging #27 (f90a11a) into main (6fe8168) will increase coverage by 1.07%.
The diff coverage is 97.18%.

@@            Coverage Diff             @@
##             main      #27      +/-   ##
==========================================
+ Coverage   89.64%   90.72%   +1.07%     
==========================================
  Files          12       12              
  Lines         425      496      +71     
  Branches       43       44       +1     
==========================================
+ Hits          381      450      +69     
- Misses         31       32       +1     
- Partials       13       14       +1     

Flag	Coverage Δ
tests	90.32% <97.18%> (+1.14%)	⬆️

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

Impacted Files	Coverage Δ
src/platformdirs/unix.py	74.60% <81.81%> (+1.52%)	⬆️
src/platformdirs/__init__.py	100.00% <100.00%> (ø)
src/platformdirs/api.py	100.00% <100.00%> (ø)
tests/conftest.py	100.00% <100.00%> (ø)
tests/test_api.py	100.00% <100.00%> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 6fe8168...f90a11a. Read the comment docs.

[gaborbernat]

[WhyNotHugo]

Neat, thanks!