restructure v1 package

[DirkEilander]

Issue addressed

Fixes #959

Explanation

The package has been restructured as shown below. Some items to mention

• io methods from drivers (read_raster and read_mfraster) have been moved back to io. We keep these here as this functionality is partly shared by models for read/writing model data
• the gis.utils script has been split over gis.gis_utils, gis.vector_utils and gis.raster_utils
• workflows has been moved to model.processes
• data_catalog and model are singular as we define just one. components, drivers. sources, adapters, and uri_resolvers are plural as multiple are defined
• much less methods and classes are exposed at the highest level, this is now limited to DataCatalog, Model, hydromt_step, PLUGINS.
• all internal functions in _utils start with _. This could also be extended to other internal API in _typing, _validators, etc
• The docs API have also been updated accordingly.

hydromt/
├── __init__.py
├── _compat.py
├── config.py
├── plugins.py
├── _typing/
├── _utils/
├── _validators/
├── cli/
├── data_catalog/
│   ├── __init__.py
│   ├── predefined_catalogs.py
│   ├── data_catalog.py
│   ├── adapters/
│   ├── sources/
│   ├── drivers/
│   ├── uri_resolvers/ 
├── gis/
├── io/
├── model/
│   ├── __init__.py  
│   ├── model.py
│   ├── root.py
│   ├── hydromt_step.py
│   ├── components/
│   ├── processes/ 
├── stats/
├── utils/

General Checklist

• [ ] Updated tests or added new tests
• [x] Branch is up to date with main
• [x] Tests & pre-commit hooks pass
• [x] Updated documentation
• [ ] Updated changelog.rst

Data/Catalog checklist

• [ ] data/catalogs/predefined_catalogs.yml has not been modified.
• [ ] None of the old data_catalog.yml files have been chagned
• [ ] data/chagnelog.rst has been updated
• [ ] new file uses LF line endings (done automatically if you used update_versions.py)
• [ ] New file has been tested locally
• [ ] Tests have been added using the new file in the test suite

Additional Notes (optional)

Add any additional notes or information that may be helpful.

[DirkEilander]

Some items are left todo, I suggest picking these up in separate PRs:

• structure tests similar to package #976
• update migration guide #977
• rename MetaDataResolver class to UriResolver #979

[savente93]

I'll try and review later this day