refactor(api)!: expose service submodules, not a flattened top-level namespace

`dataretrieval/__init__.py` star-imported every service module, flattening all
their public functions into the top-level package namespace. That:
  - leaked one large, ambiguous namespace (`dataretrieval.get_dv`,
    `dataretrieval.get_results`, ...), and
  - silently collided on names defined by more than one service: `get_ratings`
    (nwis vs waterdata) and `what_sites` (nwis vs wqp) resolved to whichever
    module was star-imported last; the other was shadowed.

Replace the star-imports with submodule imports, so callers reach each service
through its own module -- the pattern the README, the docs (per-module
autodoc), and the tests already use:

    from dataretrieval import waterdata
    df, meta = waterdata.get_ratings(...)

    from dataretrieval import nwis
    df, meta = nwis.get_ratings(...)

`dataretrieval.<name>` and `from dataretrieval import <name>` still work for
every service module, and `__version__` is unchanged. `nldi` remains
import-on-demand (it pulls in the optional geopandas dependency). The collision
is now impossible -- each `get_ratings` / `what_sites` lives only under its
module.

BREAKING CHANGE: top-level function access (e.g. `dataretrieval.get_dv`) is
removed; use the service module (`dataretrieval.nwis.get_dv`). Exception and
helper classes likewise move under their modules (e.g.
`dataretrieval.utils.NoSitesError`).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: thodson-usgs

dataretrieval/__init__.py

@@ -1,14 +1,57 @@
+"""Discover and retrieve water data from U.S. federal hydrologic web services.
+
+Access each service through its submodule rather than the top-level package::
+
+    from dataretrieval import waterdata  # modern USGS Water Data API
+
+    df, meta = waterdata.get_daily(monitoring_location_id="USGS-05427718")
+
+    from dataretrieval import nwis  # legacy NWIS services
+
+    df, meta = nwis.get_dv(sites="05427718")
+
+Available service modules: ``waterdata``, ``wqp`` (Water Quality Portal),
+``nldi``, ``samples``, ``streamstats``, ``nadp``, and the deprecated ``nwis``.
+
+``nldi`` requires geopandas (``pip install dataretrieval[nldi]``) and is not
+imported automatically; import it explicitly with ``from dataretrieval import
+nldi``.
+"""
+
 from importlib.metadata import PackageNotFoundError, version
 
 try:
     __version__ = version("dataretrieval")
 except PackageNotFoundError:
     __version__ = "version-unknown"
 
-from dataretrieval.nadp import *
-from dataretrieval.nwis import *
-from dataretrieval.samples import *
-from dataretrieval.streamstats import *
-from dataretrieval.utils import *
-from dataretrieval.waterdata import *
-from dataretrieval.wqp import *
+# Bind the service submodules as ``dataretrieval.<name>`` -- so
+# ``from dataretrieval import waterdata`` works and the modules load on
+# ``import dataretrieval`` -- WITHOUT flattening their functions into the
+# top-level namespace. Callers go through the owning module, e.g.
+# ``waterdata.get_ratings`` / ``nwis.get_ratings``, which also removes the
+# ambiguity of names defined in more than one service.
+#
+# ``nldi`` is omitted on purpose: it imports geopandas at module load, an
+# optional dependency, so importing it here would break ``import dataretrieval``
+# for installs without the ``[nldi]`` extra.
+from . import (
+    nadp,
+    nwis,
+    samples,
+    streamstats,
+    utils,
+    waterdata,
+    wqp,
+)
+
+__all__ = [
+    "nadp",
+    "nwis",
+    "samples",
+    "streamstats",
+    "utils",
+    "waterdata",
+    "wqp",
+    "__version__",
+]