Replace FilePointer with universal pathlib

[delucchi-cmu]

See astronomy-commons/hipscat#336

Solution Description

Use fsspec's project, universal-pathlib as a path provider. In this way, everywhere we currently pass in a FilePointer we can use a Path instead, and when we need to create remote connections, use UPath.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 99.73%. Comparing base (c61c1a7) to head (2d453ac).
Report is 2 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #387   +/-   ##
=======================================
  Coverage   99.73%   99.73%           
=======================================
  Files          26       26           
  Lines        1507     1520   +13     
=======================================
+ Hits         1503     1516   +13     
  Misses          4        4           

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

[github-actions]

Before [827aac0]	After [2cbb914]	Ratio	Benchmark (Parameter)
failed	failed	n/a	benchmarks.BinningSuite.time_read_histogram

Click here to view all benchmarks.

[hombit]

I love how it makes everything much simpler!

There is an inconsistency in *Arguments' parameters type-hints: some of them are UPath, some are str (the same for List[*]). Only for these "end-user" interfaces, may I ask to use something more broad, like str | Path | UPath?

Do we have a policy that requires any imported package to be an explicit dependency? (it is a good one!) Should we add universal_pathlib to pyproject.toml?

[delucchi-cmu]

I love how it makes everything much simpler!

There is an inconsistency in *Arguments' parameters type-hints: some of them are UPath, some are str (the same for List[*]). Only for these "end-user" interfaces, may I ask to use something more broad, like str | Path | UPath?

Do we have a policy that requires any imported package to be an explicit dependency? (it is a good one!) Should we add universal_pathlib to pyproject.toml?

Added a lot more type hints, and direct dependency on universal_pathlib.

[hombit]

Thank you!