Type public Epochs, Evoked, and io members fully (#14056)

Author: larsoner

doc/changes/dev/14056.newfeature.rst

@@ -0,0 +1 @@
+Added type annotations to public members of ``mne/io``, :class:`mne.Evoked`, and :class:`mne.Epochs`, by `Eric Larson`_.

doc/conf.py

@@ -738,6 +738,9 @@ def fix_sklearn_inherited_docstrings(app, what, name, obj, options, lines):
 # autodoc / autosummary
 autosummary_generate = True
 autodoc_default_options = {"inherited-members": None}
+# Types are documented (in human-readable numpydoc form) in the docstrings
+# themselves, so don't also render the annotations into the signatures.
+autodoc_typehints = "none"
 
 # sphinxcontrib-bibtex
 bibtex_bibfiles = ["./references.bib"]

mne/defaults.py

@@ -3,7 +3,7 @@
 # Copyright the MNE-Python contributors.
 
 from copy import deepcopy
-from typing import Any
+from typing import Any, Final
 
 DEFAULTS: dict[str, Any] = dict(
     color=dict(
@@ -405,6 +405,6 @@ def _handle_default(k, v=None):
 
 
 HEAD_SIZE_DEFAULT = 0.095  # in [m]
-_BORDER_DEFAULT = "mean"
-_INTERPOLATION_DEFAULT = "cubic"
-_EXTRAPOLATE_DEFAULT = "auto"
+_BORDER_DEFAULT: Final = "mean"
+_INTERPOLATION_DEFAULT: Final = "cubic"
+_EXTRAPOLATE_DEFAULT: Final = "auto"