MAINT: splitting utils.py to submodules (#5862)

* moving utils.py to a folder

* split into separate files as much as possible

* move utils tests

* cleanup

* FIX: Multiple fixes

* FIX: Almost there

* FIX: Reorganize tests

* FIX: Reorganize tests, too

* FIX: Move

* FIX: Older Pandas

* FIX: Missing files

Author: agramfort

mne/tests/test_docstring_parameters.py

@@ -290,7 +290,8 @@ def test_documented():
                 from_mod = inspect.getmodule(cf).__name__
                 if (from_mod.startswith('mne') and
                         not from_mod.startswith('mne.externals') and
-                        from_mod not in documented_ignored_mods and
+                        not any(from_mod.startswith(x)
+                                for x in documented_ignored_mods) and
                         name not in documented_ignored_names):
                     missing.append('%s (%s.%s)' % (name, from_mod, name))
     if len(missing) > 0:

mne/tests/test_epochs.py

@@ -27,8 +27,7 @@
     bootstrap, equalize_epoch_counts, combine_event_ids, add_channels_epochs,
     EpochsArray, concatenate_epochs, BaseEpochs, average_movements)
 from mne.utils import (requires_pandas, run_tests_if_main,
-                       requires_version, _check_pandas_installed,
-                       catch_logging)
+                       requires_version, catch_logging, _FakeNoPandas)
 from mne.chpi import read_head_pos, head_pos_to_trans_rot_t
 
 from mne.io import RawArray, read_raw_fif
@@ -2244,22 +2243,6 @@ def test_default_values():
     assert_equal(hash(epoch_1), hash(epoch_2))
 
 
-class FakeNoPandas(object):  # noqa: D101
-    def __enter__(self):  # noqa: D105
-
-        def _check(strict=True):
-            if strict:
-                raise RuntimeError('Pandas not installed')
-            else:
-                return False
-        mne.epochs._check_pandas_installed = _check
-        mne.utils._check_pandas_installed = _check
-
-    def __exit__(self, *args):  # noqa: D105
-        mne.epochs._check_pandas_installed = _check_pandas_installed
-        mne.utils._check_pandas_installed = _check_pandas_installed
-
-
 @requires_pandas
 def test_metadata(tmpdir):
     """Test metadata support with pandas."""
@@ -2352,7 +2335,7 @@ def test_metadata(tmpdir):
     epochs_one_read = read_epochs(temp_one_fname)
     assert_metadata_equal(epochs_one.metadata, epochs_one_read.metadata)
 
-    with FakeNoPandas():
+    with _FakeNoPandas():
         epochs_read = read_epochs(temp_fname)
         assert isinstance(epochs_read.metadata, list)
         assert isinstance(epochs_read.metadata[0], dict)