From 9b4b5fa46b206e2dcf3de8a1ea71cef114a2cf63 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Wed, 29 Apr 2026 10:48:57 -0700
Subject: [PATCH 01/36] initialize faux module

---
 bapsflib/faux/__init__.py | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 bapsflib/faux/__init__.py

diff --git a/bapsflib/faux/__init__.py b/bapsflib/faux/__init__.py
new file mode 100644
index 00000000..74c073a1
--- /dev/null
+++ b/bapsflib/faux/__init__.py
@@ -0,0 +1,10 @@
+"""
+The `bapsflib.faux` module contains functionality to generate fake /
+faux BaPSF style HDF5 files.
+
+.. caution::
+    The faux functionality is developed to test the `bapsflib` package
+    and help in generating example documnetion.  It is **NOT** intended
+    for end user use.
+
+"""

From 98db5597803fd559c0c163c61707b67736a77dd2 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Wed, 29 Apr 2026 10:49:17 -0700
Subject: [PATCH 02/36] exempt bapsflib.faux from test coverage

---
 pyproject.toml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/pyproject.toml b/pyproject.toml
index cabe0965..23bf93c0 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -82,6 +82,7 @@ line-length = 90  # needs to be the same as in tool.isort
     ".idea/*",
     "*/tests/*",
     "bapsflib/plasma/*",
+    "bapsflib/faux/*",
     "docs/*",
     "LICENSES/*",
   ]

From c42eb5cdfd5be767428229bce3718cae763e5991 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Wed, 29 Apr 2026 10:51:11 -0700
Subject: [PATCH 03/36] move fauxhdfbuilder.py from bapsflib._hdf.maps.tests to
 bapsflib.faux

---
 bapsflib/_hdf/maps/tests/__init__.py                 | 2 +-
 bapsflib/{_hdf/maps/tests => faux}/fauxhdfbuilder.py | 0
 2 files changed, 1 insertion(+), 1 deletion(-)
 rename bapsflib/{_hdf/maps/tests => faux}/fauxhdfbuilder.py (100%)

diff --git a/bapsflib/_hdf/maps/tests/__init__.py b/bapsflib/_hdf/maps/tests/__init__.py
index ce2f664d..f96bbae8 100644
--- a/bapsflib/_hdf/maps/tests/__init__.py
+++ b/bapsflib/_hdf/maps/tests/__init__.py
@@ -1,6 +1,6 @@
 __all__ = ["FauxHDFBuilder", "MapTestBase"]
 
-from bapsflib._hdf.maps.tests.fauxhdfbuilder import FauxHDFBuilder
+from bapsflib.faux.fauxhdfbuilder import FauxHDFBuilder
 from bapsflib.utils.tests import BaPSFTestCase
 
 
diff --git a/bapsflib/_hdf/maps/tests/fauxhdfbuilder.py b/bapsflib/faux/fauxhdfbuilder.py
similarity index 100%
rename from bapsflib/_hdf/maps/tests/fauxhdfbuilder.py
rename to bapsflib/faux/fauxhdfbuilder.py

From a3671feffac6f60ec572a56006dcfa9f59caa636 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Wed, 29 Apr 2026 10:52:27 -0700
Subject: [PATCH 04/36] rename fauxhdfbuilder -> builder

---
 bapsflib/_hdf/maps/tests/__init__.py            | 2 +-
 bapsflib/faux/{fauxhdfbuilder.py => builder.py} | 0
 2 files changed, 1 insertion(+), 1 deletion(-)
 rename bapsflib/faux/{fauxhdfbuilder.py => builder.py} (100%)

diff --git a/bapsflib/_hdf/maps/tests/__init__.py b/bapsflib/_hdf/maps/tests/__init__.py
index f96bbae8..7e181dda 100644
--- a/bapsflib/_hdf/maps/tests/__init__.py
+++ b/bapsflib/_hdf/maps/tests/__init__.py
@@ -1,6 +1,6 @@
 __all__ = ["FauxHDFBuilder", "MapTestBase"]
 
-from bapsflib.faux.fauxhdfbuilder import FauxHDFBuilder
+from bapsflib.faux.builder import FauxHDFBuilder
 from bapsflib.utils.tests import BaPSFTestCase
 
 
diff --git a/bapsflib/faux/fauxhdfbuilder.py b/bapsflib/faux/builder.py
similarity index 100%
rename from bapsflib/faux/fauxhdfbuilder.py
rename to bapsflib/faux/builder.py

From 5a81856e3eae3f0138a6ecd238eecee909f1b4bd Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Wed, 29 Apr 2026 10:53:51 -0700
Subject: [PATCH 05/36] expose FauxHDFBuilder to the bapsflib.faux namespace

---
 bapsflib/_hdf/maps/tests/__init__.py | 2 +-
 bapsflib/faux/__init__.py            | 4 ++++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/bapsflib/_hdf/maps/tests/__init__.py b/bapsflib/_hdf/maps/tests/__init__.py
index 7e181dda..00c9da96 100644
--- a/bapsflib/_hdf/maps/tests/__init__.py
+++ b/bapsflib/_hdf/maps/tests/__init__.py
@@ -1,6 +1,6 @@
 __all__ = ["FauxHDFBuilder", "MapTestBase"]
 
-from bapsflib.faux.builder import FauxHDFBuilder
+from bapsflib.faux import FauxHDFBuilder
 from bapsflib.utils.tests import BaPSFTestCase
 
 
diff --git a/bapsflib/faux/__init__.py b/bapsflib/faux/__init__.py
index 74c073a1..c9047262 100644
--- a/bapsflib/faux/__init__.py
+++ b/bapsflib/faux/__init__.py
@@ -8,3 +8,7 @@
     for end user use.
 
 """
+
+__all__ = ["FauxHDFBuilder"]
+
+from bapsflib.faux.builder import FauxHDFBuilder

From f24e72cbe633c979531239e4e8125688198574f3 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Wed, 29 Apr 2026 11:00:36 -0700
Subject: [PATCH 06/36] expand the bapsflib.faux docstring

---
 bapsflib/faux/__init__.py | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/bapsflib/faux/__init__.py b/bapsflib/faux/__init__.py
index c9047262..46617458 100644
--- a/bapsflib/faux/__init__.py
+++ b/bapsflib/faux/__init__.py
@@ -1,12 +1,24 @@
 """
-The `bapsflib.faux` module contains functionality to generate fake /
-faux BaPSF style HDF5 files.
-
 .. caution::
     The faux functionality is developed to test the `bapsflib` package
     and help in generating example documnetion.  It is **NOT** intended
     for end user use.
 
+The `bapsflib.faux` module contains functionality to generate fake /
+faux BaPSF style HDF5 files.
+
+`bapsflib.faux` is not explicitly exposed to the `bapsflib` namespace,
+so it needs to be explicitly imported.  For example:
+
+>>> import bapsflib
+>>> bapsflib.faux
+AttributeError: module 'bapsflib' has no attribute 'faux'
+>>>
+>>> import bapsflib.faux
+>>> bapsflib.faux
+<module 'bapsflib.faux'>
+
+
 """
 
 __all__ = ["FauxHDFBuilder"]

From 18a014aa92f36e74e62dad033c340f7824f212d1 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Wed, 29 Apr 2026 11:02:09 -0700
Subject: [PATCH 07/36] add the bapsflib.faux stub file

---
 docs/api_static/bapsflib.faux.rst | 8 ++++++++
 1 file changed, 8 insertions(+)
 create mode 100644 docs/api_static/bapsflib.faux.rst

diff --git a/docs/api_static/bapsflib.faux.rst b/docs/api_static/bapsflib.faux.rst
new file mode 100644
index 00000000..9b986cb4
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux
+==============
+
+.. py:currentmodule:: bapsflib.faux
+
+.. automodapi:: bapsflib.faux

From 22b8e7722dc17a03ebd997f5fd7ddfe01e985179 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 09:07:18 -0700
Subject: [PATCH 08/36] move fauxbmotion.py from
 bapsflib._hdf.maps.controls.tests -> bapsflib.faux.controls

---
 bapsflib/_hdf/maps/controls/tests/__init__.py                   | 1 -
 bapsflib/_hdf/maps/controls/tests/test_bmotion.py               | 2 +-
 bapsflib/faux/controls/__init__.py                              | 0
 .../{_hdf/maps/controls/tests => faux/controls}/fauxbmotion.py  | 0
 4 files changed, 1 insertion(+), 2 deletions(-)
 create mode 100644 bapsflib/faux/controls/__init__.py
 rename bapsflib/{_hdf/maps/controls/tests => faux/controls}/fauxbmotion.py (100%)

diff --git a/bapsflib/_hdf/maps/controls/tests/__init__.py b/bapsflib/_hdf/maps/controls/tests/__init__.py
index f92e5109..1af0791e 100644
--- a/bapsflib/_hdf/maps/controls/tests/__init__.py
+++ b/bapsflib/_hdf/maps/controls/tests/__init__.py
@@ -8,7 +8,6 @@
 # License: Standard 3-clause BSD; see "LICENSES/LICENSE.txt" for full
 #   license terms and contributor agreement.
 #
-from bapsflib._hdf.maps.controls.tests.fauxbmotion import FauxBMotion
 from bapsflib._hdf.maps.controls.tests.fauxn5700ps import FauxN5700PS
 from bapsflib._hdf.maps.controls.tests.fauxnixyz import FauxNIXYZ
 from bapsflib._hdf.maps.controls.tests.fauxnixz import FauxNIXZ
diff --git a/bapsflib/_hdf/maps/controls/tests/test_bmotion.py b/bapsflib/_hdf/maps/controls/tests/test_bmotion.py
index f80d0df2..ee4456e7 100644
--- a/bapsflib/_hdf/maps/controls/tests/test_bmotion.py
+++ b/bapsflib/_hdf/maps/controls/tests/test_bmotion.py
@@ -8,7 +8,7 @@
 
 from bapsflib._hdf.maps.controls.bmotion import HDFMapControlBMotion
 from bapsflib._hdf.maps.controls.tests.common import ControlTestCase
-from bapsflib._hdf.maps.controls.tests.fauxbmotion import FauxBMotion
+from bapsflib.faux.controls.fauxbmotion import FauxBMotion
 from bapsflib._hdf.maps.controls.types import ConType
 from bapsflib.utils import _bytes_to_str
 from bapsflib.utils.exceptions import HDFMappingError
diff --git a/bapsflib/faux/controls/__init__.py b/bapsflib/faux/controls/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/bapsflib/_hdf/maps/controls/tests/fauxbmotion.py b/bapsflib/faux/controls/fauxbmotion.py
similarity index 100%
rename from bapsflib/_hdf/maps/controls/tests/fauxbmotion.py
rename to bapsflib/faux/controls/fauxbmotion.py

From eefe818787b99d9ac6ee31656c716f27757e426c Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 09:08:00 -0700
Subject: [PATCH 09/36] move fauxn5700ps.py from
 bapsflib._hdf.maps.controls.tests -> bapsflib.faux.controls

---
 bapsflib/_hdf/maps/controls/tests/__init__.py                    | 1 -
 .../{_hdf/maps/controls/tests => faux/controls}/fauxn5700ps.py   | 0
 2 files changed, 1 deletion(-)
 rename bapsflib/{_hdf/maps/controls/tests => faux/controls}/fauxn5700ps.py (100%)

diff --git a/bapsflib/_hdf/maps/controls/tests/__init__.py b/bapsflib/_hdf/maps/controls/tests/__init__.py
index 1af0791e..431cafd6 100644
--- a/bapsflib/_hdf/maps/controls/tests/__init__.py
+++ b/bapsflib/_hdf/maps/controls/tests/__init__.py
@@ -8,7 +8,6 @@
 # License: Standard 3-clause BSD; see "LICENSES/LICENSE.txt" for full
 #   license terms and contributor agreement.
 #
-from bapsflib._hdf.maps.controls.tests.fauxn5700ps import FauxN5700PS
 from bapsflib._hdf.maps.controls.tests.fauxnixyz import FauxNIXYZ
 from bapsflib._hdf.maps.controls.tests.fauxnixz import FauxNIXZ
 from bapsflib._hdf.maps.controls.tests.fauxpositions180e import FauxPositions180E
diff --git a/bapsflib/_hdf/maps/controls/tests/fauxn5700ps.py b/bapsflib/faux/controls/fauxn5700ps.py
similarity index 100%
rename from bapsflib/_hdf/maps/controls/tests/fauxn5700ps.py
rename to bapsflib/faux/controls/fauxn5700ps.py

From 504c47d6e7b581da76524c11e19a6fbd8c233b7c Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 09:08:37 -0700
Subject: [PATCH 10/36] move fauxnixyz.py from
 bapsflib._hdf.maps.controls.tests -> bapsflib.faux.controls

---
 bapsflib/_hdf/maps/controls/tests/__init__.py                    | 1 -
 .../{_hdf/maps/controls/tests => faux/controls}/fauxnixyz.py     | 0
 2 files changed, 1 deletion(-)
 rename bapsflib/{_hdf/maps/controls/tests => faux/controls}/fauxnixyz.py (100%)

diff --git a/bapsflib/_hdf/maps/controls/tests/__init__.py b/bapsflib/_hdf/maps/controls/tests/__init__.py
index 431cafd6..e122ddf8 100644
--- a/bapsflib/_hdf/maps/controls/tests/__init__.py
+++ b/bapsflib/_hdf/maps/controls/tests/__init__.py
@@ -8,7 +8,6 @@
 # License: Standard 3-clause BSD; see "LICENSES/LICENSE.txt" for full
 #   license terms and contributor agreement.
 #
-from bapsflib._hdf.maps.controls.tests.fauxnixyz import FauxNIXYZ
 from bapsflib._hdf.maps.controls.tests.fauxnixz import FauxNIXZ
 from bapsflib._hdf.maps.controls.tests.fauxpositions180e import FauxPositions180E
 from bapsflib._hdf.maps.controls.tests.fauxsixk import FauxSixK
diff --git a/bapsflib/_hdf/maps/controls/tests/fauxnixyz.py b/bapsflib/faux/controls/fauxnixyz.py
similarity index 100%
rename from bapsflib/_hdf/maps/controls/tests/fauxnixyz.py
rename to bapsflib/faux/controls/fauxnixyz.py

From 2ffd230cb70d024644d5fd8c01ddb74b01ff89a1 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 09:09:07 -0700
Subject: [PATCH 11/36] move fauxnixz.py from bapsflib._hdf.maps.controls.tests
 -> bapsflib.faux.controls

---
 bapsflib/_hdf/maps/controls/tests/__init__.py                    | 1 -
 bapsflib/{_hdf/maps/controls/tests => faux/controls}/fauxnixz.py | 0
 2 files changed, 1 deletion(-)
 rename bapsflib/{_hdf/maps/controls/tests => faux/controls}/fauxnixz.py (100%)

diff --git a/bapsflib/_hdf/maps/controls/tests/__init__.py b/bapsflib/_hdf/maps/controls/tests/__init__.py
index e122ddf8..f227dddc 100644
--- a/bapsflib/_hdf/maps/controls/tests/__init__.py
+++ b/bapsflib/_hdf/maps/controls/tests/__init__.py
@@ -8,7 +8,6 @@
 # License: Standard 3-clause BSD; see "LICENSES/LICENSE.txt" for full
 #   license terms and contributor agreement.
 #
-from bapsflib._hdf.maps.controls.tests.fauxnixz import FauxNIXZ
 from bapsflib._hdf.maps.controls.tests.fauxpositions180e import FauxPositions180E
 from bapsflib._hdf.maps.controls.tests.fauxsixk import FauxSixK
 from bapsflib._hdf.maps.controls.tests.fauxwaveform import FauxWaveform
diff --git a/bapsflib/_hdf/maps/controls/tests/fauxnixz.py b/bapsflib/faux/controls/fauxnixz.py
similarity index 100%
rename from bapsflib/_hdf/maps/controls/tests/fauxnixz.py
rename to bapsflib/faux/controls/fauxnixz.py

From dc2a078e7dcdf9155934b06abcb4a2167463eeac Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 09:09:50 -0700
Subject: [PATCH 12/36] move fauxpositions180e.py from
 bapsflib._hdf.maps.controls.tests -> bapsflib.faux.controls

---
 bapsflib/_hdf/maps/controls/tests/__init__.py                  | 1 -
 bapsflib/_hdf/maps/controls/tests/test_positions180e.py        | 3 +--
 .../maps/controls/tests => faux/controls}/fauxpositions180e.py | 0
 3 files changed, 1 insertion(+), 3 deletions(-)
 rename bapsflib/{_hdf/maps/controls/tests => faux/controls}/fauxpositions180e.py (100%)

diff --git a/bapsflib/_hdf/maps/controls/tests/__init__.py b/bapsflib/_hdf/maps/controls/tests/__init__.py
index f227dddc..59a9e154 100644
--- a/bapsflib/_hdf/maps/controls/tests/__init__.py
+++ b/bapsflib/_hdf/maps/controls/tests/__init__.py
@@ -8,6 +8,5 @@
 # License: Standard 3-clause BSD; see "LICENSES/LICENSE.txt" for full
 #   license terms and contributor agreement.
 #
-from bapsflib._hdf.maps.controls.tests.fauxpositions180e import FauxPositions180E
 from bapsflib._hdf.maps.controls.tests.fauxsixk import FauxSixK
 from bapsflib._hdf.maps.controls.tests.fauxwaveform import FauxWaveform
diff --git a/bapsflib/_hdf/maps/controls/tests/test_positions180e.py b/bapsflib/_hdf/maps/controls/tests/test_positions180e.py
index db4a2dcf..3055f619 100644
--- a/bapsflib/_hdf/maps/controls/tests/test_positions180e.py
+++ b/bapsflib/_hdf/maps/controls/tests/test_positions180e.py
@@ -3,10 +3,9 @@
 
 from bapsflib._hdf.maps.controls.positions180e import HDFMapControlPositions180E
 from bapsflib._hdf.maps.controls.tests.common import ControlTestCase
-from bapsflib._hdf.maps.controls.tests.fauxpositions180e import FauxPositions180E
+from bapsflib.faux.controls.fauxpositions180e import FauxPositions180E
 from bapsflib._hdf.maps.controls.types import ConType
 from bapsflib.utils.exceptions import HDFMappingError
-from bapsflib.utils.warnings import HDFMappingWarning
 
 
 class TestPositions180E(ControlTestCase):
diff --git a/bapsflib/_hdf/maps/controls/tests/fauxpositions180e.py b/bapsflib/faux/controls/fauxpositions180e.py
similarity index 100%
rename from bapsflib/_hdf/maps/controls/tests/fauxpositions180e.py
rename to bapsflib/faux/controls/fauxpositions180e.py

From 720f2bd1126a82c93bb2629a1f904b60be0c7b61 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 09:10:21 -0700
Subject: [PATCH 13/36] move fauxsixk.py from bapsflib._hdf.maps.controls.tests
 -> bapsflib.faux.controls

---
 bapsflib/_hdf/maps/controls/tests/__init__.py                    | 1 -
 bapsflib/{_hdf/maps/controls/tests => faux/controls}/fauxsixk.py | 0
 2 files changed, 1 deletion(-)
 rename bapsflib/{_hdf/maps/controls/tests => faux/controls}/fauxsixk.py (100%)

diff --git a/bapsflib/_hdf/maps/controls/tests/__init__.py b/bapsflib/_hdf/maps/controls/tests/__init__.py
index 59a9e154..7e22a4a1 100644
--- a/bapsflib/_hdf/maps/controls/tests/__init__.py
+++ b/bapsflib/_hdf/maps/controls/tests/__init__.py
@@ -8,5 +8,4 @@
 # License: Standard 3-clause BSD; see "LICENSES/LICENSE.txt" for full
 #   license terms and contributor agreement.
 #
-from bapsflib._hdf.maps.controls.tests.fauxsixk import FauxSixK
 from bapsflib._hdf.maps.controls.tests.fauxwaveform import FauxWaveform
diff --git a/bapsflib/_hdf/maps/controls/tests/fauxsixk.py b/bapsflib/faux/controls/fauxsixk.py
similarity index 100%
rename from bapsflib/_hdf/maps/controls/tests/fauxsixk.py
rename to bapsflib/faux/controls/fauxsixk.py

From bccfc8b44e6a9049245cb6a9fc9a380a739c7ab5 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 09:10:51 -0700
Subject: [PATCH 14/36] move fauxwaveform.py from
 bapsflib._hdf.maps.controls.tests -> bapsflib.faux.controls

---
 bapsflib/_hdf/maps/controls/tests/__init__.py                    | 1 -
 .../{_hdf/maps/controls/tests => faux/controls}/fauxwaveform.py  | 0
 2 files changed, 1 deletion(-)
 rename bapsflib/{_hdf/maps/controls/tests => faux/controls}/fauxwaveform.py (100%)

diff --git a/bapsflib/_hdf/maps/controls/tests/__init__.py b/bapsflib/_hdf/maps/controls/tests/__init__.py
index 7e22a4a1..9ce148ee 100644
--- a/bapsflib/_hdf/maps/controls/tests/__init__.py
+++ b/bapsflib/_hdf/maps/controls/tests/__init__.py
@@ -8,4 +8,3 @@
 # License: Standard 3-clause BSD; see "LICENSES/LICENSE.txt" for full
 #   license terms and contributor agreement.
 #
-from bapsflib._hdf.maps.controls.tests.fauxwaveform import FauxWaveform
diff --git a/bapsflib/_hdf/maps/controls/tests/fauxwaveform.py b/bapsflib/faux/controls/fauxwaveform.py
similarity index 100%
rename from bapsflib/_hdf/maps/controls/tests/fauxwaveform.py
rename to bapsflib/faux/controls/fauxwaveform.py

From f78189a2f2561d42268d6ab826ff143b5254f04b Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:19:56 -0700
Subject: [PATCH 15/36] rename all the control faux py file by removing the
 "faux" from their name

---
 bapsflib/faux/controls/{fauxbmotion.py => bmotion.py}             | 0
 bapsflib/faux/controls/{fauxn5700ps.py => n5700ps.py}             | 0
 bapsflib/faux/controls/{fauxnixyz.py => nixyz.py}                 | 0
 bapsflib/faux/controls/{fauxnixz.py => nixz.py}                   | 0
 bapsflib/faux/controls/{fauxpositions180e.py => positions180e.py} | 0
 bapsflib/faux/controls/{fauxsixk.py => sixk.py}                   | 0
 bapsflib/faux/controls/{fauxwaveform.py => waveform.py}           | 0
 7 files changed, 0 insertions(+), 0 deletions(-)
 rename bapsflib/faux/controls/{fauxbmotion.py => bmotion.py} (100%)
 rename bapsflib/faux/controls/{fauxn5700ps.py => n5700ps.py} (100%)
 rename bapsflib/faux/controls/{fauxnixyz.py => nixyz.py} (100%)
 rename bapsflib/faux/controls/{fauxnixz.py => nixz.py} (100%)
 rename bapsflib/faux/controls/{fauxpositions180e.py => positions180e.py} (100%)
 rename bapsflib/faux/controls/{fauxsixk.py => sixk.py} (100%)
 rename bapsflib/faux/controls/{fauxwaveform.py => waveform.py} (100%)

diff --git a/bapsflib/faux/controls/fauxbmotion.py b/bapsflib/faux/controls/bmotion.py
similarity index 100%
rename from bapsflib/faux/controls/fauxbmotion.py
rename to bapsflib/faux/controls/bmotion.py
diff --git a/bapsflib/faux/controls/fauxn5700ps.py b/bapsflib/faux/controls/n5700ps.py
similarity index 100%
rename from bapsflib/faux/controls/fauxn5700ps.py
rename to bapsflib/faux/controls/n5700ps.py
diff --git a/bapsflib/faux/controls/fauxnixyz.py b/bapsflib/faux/controls/nixyz.py
similarity index 100%
rename from bapsflib/faux/controls/fauxnixyz.py
rename to bapsflib/faux/controls/nixyz.py
diff --git a/bapsflib/faux/controls/fauxnixz.py b/bapsflib/faux/controls/nixz.py
similarity index 100%
rename from bapsflib/faux/controls/fauxnixz.py
rename to bapsflib/faux/controls/nixz.py
diff --git a/bapsflib/faux/controls/fauxpositions180e.py b/bapsflib/faux/controls/positions180e.py
similarity index 100%
rename from bapsflib/faux/controls/fauxpositions180e.py
rename to bapsflib/faux/controls/positions180e.py
diff --git a/bapsflib/faux/controls/fauxsixk.py b/bapsflib/faux/controls/sixk.py
similarity index 100%
rename from bapsflib/faux/controls/fauxsixk.py
rename to bapsflib/faux/controls/sixk.py
diff --git a/bapsflib/faux/controls/fauxwaveform.py b/bapsflib/faux/controls/waveform.py
similarity index 100%
rename from bapsflib/faux/controls/fauxwaveform.py
rename to bapsflib/faux/controls/waveform.py

From b965a1cf01b2365a63d62c1960e905fdb1816b78 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:20:35 -0700
Subject: [PATCH 16/36] expose all the faux control device modules to the
 bapsflib.faux.controls namespace

---
 bapsflib/faux/builder.py           |  2 +-
 bapsflib/faux/controls/__init__.py | 21 +++++++++++++++++++++
 2 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/bapsflib/faux/builder.py b/bapsflib/faux/builder.py
index 9a3aeed2..6ade8d05 100644
--- a/bapsflib/faux/builder.py
+++ b/bapsflib/faux/builder.py
@@ -6,7 +6,7 @@
 
 from typing import Any, Dict
 
-from bapsflib._hdf.maps.controls.tests import (
+from bapsflib.faux.controls import (
     FauxBMotion,
     FauxN5700PS,
     FauxNIXYZ,
diff --git a/bapsflib/faux/controls/__init__.py b/bapsflib/faux/controls/__init__.py
index e69de29b..dab3b2b6 100644
--- a/bapsflib/faux/controls/__init__.py
+++ b/bapsflib/faux/controls/__init__.py
@@ -0,0 +1,21 @@
+"""
+The `bapsflib.faux.controls` module contains all the control device
+group generators used by `~bapsflib.faux.builder.FauxHDFBuilder`.
+"""
+__all__ = [
+    "FauxBMotion",
+    "FauxN5700PS",
+    "FauxNIXYZ",
+    "FauxNIXZ",
+    "FauxPositions180E",
+    "FauxSixK",
+    "FauxWaveform",
+]
+
+from bapsflib.faux.controls.bmotion import FauxBMotion
+from bapsflib.faux.controls.n5700ps import FauxN5700PS
+from bapsflib.faux.controls.nixyz import FauxNIXYZ
+from bapsflib.faux.controls.nixz import FauxNIXZ
+from bapsflib.faux.controls.positions180e import FauxPositions180E
+from bapsflib.faux.controls.sixk import FauxSixK
+from bapsflib.faux.controls.waveform import FauxWaveform

From 34d1157dc3072556e7095ad7cb75a9d9996ad630 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:21:25 -0700
Subject: [PATCH 17/36] update imports of FauxHDFBmotion and FauxPositions180E

---
 bapsflib/_hdf/maps/controls/tests/test_bmotion.py       | 2 +-
 bapsflib/_hdf/maps/controls/tests/test_positions180e.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/bapsflib/_hdf/maps/controls/tests/test_bmotion.py b/bapsflib/_hdf/maps/controls/tests/test_bmotion.py
index ee4456e7..802a0018 100644
--- a/bapsflib/_hdf/maps/controls/tests/test_bmotion.py
+++ b/bapsflib/_hdf/maps/controls/tests/test_bmotion.py
@@ -8,7 +8,7 @@
 
 from bapsflib._hdf.maps.controls.bmotion import HDFMapControlBMotion
 from bapsflib._hdf.maps.controls.tests.common import ControlTestCase
-from bapsflib.faux.controls.fauxbmotion import FauxBMotion
+from bapsflib.faux.controls import FauxBMotion
 from bapsflib._hdf.maps.controls.types import ConType
 from bapsflib.utils import _bytes_to_str
 from bapsflib.utils.exceptions import HDFMappingError
diff --git a/bapsflib/_hdf/maps/controls/tests/test_positions180e.py b/bapsflib/_hdf/maps/controls/tests/test_positions180e.py
index 3055f619..6ad31b5f 100644
--- a/bapsflib/_hdf/maps/controls/tests/test_positions180e.py
+++ b/bapsflib/_hdf/maps/controls/tests/test_positions180e.py
@@ -3,7 +3,7 @@
 
 from bapsflib._hdf.maps.controls.positions180e import HDFMapControlPositions180E
 from bapsflib._hdf.maps.controls.tests.common import ControlTestCase
-from bapsflib.faux.controls.fauxpositions180e import FauxPositions180E
+from bapsflib.faux.controls import FauxPositions180E
 from bapsflib._hdf.maps.controls.types import ConType
 from bapsflib.utils.exceptions import HDFMappingError
 

From a4982dee054ea8f320ee6b66456248bc5d615088 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:25:05 -0700
Subject: [PATCH 18/36] create the bapsflib.faux.digitizers submodule

---
 bapsflib/faux/digitizers/__init__.py | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 bapsflib/faux/digitizers/__init__.py

diff --git a/bapsflib/faux/digitizers/__init__.py b/bapsflib/faux/digitizers/__init__.py
new file mode 100644
index 00000000..e69de29b

From 18259b2c51ed96980b6f87fa14f0bc94960393d8 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:27:30 -0700
Subject: [PATCH 19/36] move the digitizer faux py files from
 bapsflib._hdf.maps.digitizers.tests -> bapsflib.faux.digitizers

---
 bapsflib/_hdf/maps/digitizers/tests/__init__.py              | 4 +---
 bapsflib/_hdf/maps/digitizers/tests/test_lecroy.py           | 3 +--
 bapsflib/_hdf/utils/tests/test_hdfreaddata.py                | 5 ++---
 bapsflib/_hdf/utils/tests/test_helpers.py                    | 2 +-
 .../digitizers/tests => faux/digitizers}/fauxlecroy180e.py   | 0
 .../maps/digitizers/tests => faux/digitizers}/fauxsis3301.py | 0
 .../digitizers/tests => faux/digitizers}/fauxsiscrate.py     | 0
 7 files changed, 5 insertions(+), 9 deletions(-)
 rename bapsflib/{_hdf/maps/digitizers/tests => faux/digitizers}/fauxlecroy180e.py (100%)
 rename bapsflib/{_hdf/maps/digitizers/tests => faux/digitizers}/fauxsis3301.py (100%)
 rename bapsflib/{_hdf/maps/digitizers/tests => faux/digitizers}/fauxsiscrate.py (100%)

diff --git a/bapsflib/_hdf/maps/digitizers/tests/__init__.py b/bapsflib/_hdf/maps/digitizers/tests/__init__.py
index 8542e498..8b137891 100644
--- a/bapsflib/_hdf/maps/digitizers/tests/__init__.py
+++ b/bapsflib/_hdf/maps/digitizers/tests/__init__.py
@@ -1,3 +1 @@
-from bapsflib._hdf.maps.digitizers.tests.fauxlecroy180e import FauxLeCroy180E
-from bapsflib._hdf.maps.digitizers.tests.fauxsis3301 import FauxSIS3301
-from bapsflib._hdf.maps.digitizers.tests.fauxsiscrate import FauxSISCrate
+
diff --git a/bapsflib/_hdf/maps/digitizers/tests/test_lecroy.py b/bapsflib/_hdf/maps/digitizers/tests/test_lecroy.py
index 30cd063b..571552f1 100644
--- a/bapsflib/_hdf/maps/digitizers/tests/test_lecroy.py
+++ b/bapsflib/_hdf/maps/digitizers/tests/test_lecroy.py
@@ -1,11 +1,10 @@
 import numpy as np
-import unittest as ut
 
 from unittest import mock
 
 from bapsflib._hdf.maps.digitizers.lecroy import HDFMapDigiLeCroy180E
 from bapsflib._hdf.maps.digitizers.tests.common import DigitizerTestCase
-from bapsflib._hdf.maps.digitizers.tests.fauxlecroy180e import FauxLeCroy180E
+from bapsflib.faux.digitizers.fauxlecroy180e import FauxLeCroy180E
 from bapsflib.utils.exceptions import HDFMappingError
 from bapsflib.utils.warnings import HDFMappingWarning
 
diff --git a/bapsflib/_hdf/utils/tests/test_hdfreaddata.py b/bapsflib/_hdf/utils/tests/test_hdfreaddata.py
index 6fa6ee5e..8a5eb324 100644
--- a/bapsflib/_hdf/utils/tests/test_hdfreaddata.py
+++ b/bapsflib/_hdf/utils/tests/test_hdfreaddata.py
@@ -17,7 +17,6 @@
 import h5py
 import numpy as np
 import os
-import unittest as ut
 
 from typing import TYPE_CHECKING
 from unittest import mock
@@ -38,8 +37,8 @@
 
 if TYPE_CHECKING:
     # This is done for typing purposes only.  A full import is not needed.
-    from bapsflib._hdf.maps.digitizers.tests.fauxlecroy180e import FauxLeCroy180E
-    from bapsflib._hdf.maps.digitizers.tests.fauxsis3301 import FauxSIS3301
+    from bapsflib.faux.digitizers.fauxlecroy180e import FauxLeCroy180E
+    from bapsflib.faux.digitizers.fauxsis3301 import FauxSIS3301
 
 
 class TestHDFReadData(TestBase):
diff --git a/bapsflib/_hdf/utils/tests/test_helpers.py b/bapsflib/_hdf/utils/tests/test_helpers.py
index a5565817..29f4a5c5 100644
--- a/bapsflib/_hdf/utils/tests/test_helpers.py
+++ b/bapsflib/_hdf/utils/tests/test_helpers.py
@@ -18,7 +18,7 @@
 from numpy.lib import recfunctions as rfn
 
 from bapsflib._hdf.maps.controls.waveform import HDFMapControlWaveform
-from bapsflib._hdf.maps.digitizers.tests.fauxlecroy180e import FauxLeCroy180E
+from bapsflib.faux.digitizers.fauxlecroy180e import FauxLeCroy180E
 from bapsflib._hdf.utils.file import File
 from bapsflib._hdf.utils.helpers import (
     build_shotnum_dset_relation,
diff --git a/bapsflib/_hdf/maps/digitizers/tests/fauxlecroy180e.py b/bapsflib/faux/digitizers/fauxlecroy180e.py
similarity index 100%
rename from bapsflib/_hdf/maps/digitizers/tests/fauxlecroy180e.py
rename to bapsflib/faux/digitizers/fauxlecroy180e.py
diff --git a/bapsflib/_hdf/maps/digitizers/tests/fauxsis3301.py b/bapsflib/faux/digitizers/fauxsis3301.py
similarity index 100%
rename from bapsflib/_hdf/maps/digitizers/tests/fauxsis3301.py
rename to bapsflib/faux/digitizers/fauxsis3301.py
diff --git a/bapsflib/_hdf/maps/digitizers/tests/fauxsiscrate.py b/bapsflib/faux/digitizers/fauxsiscrate.py
similarity index 100%
rename from bapsflib/_hdf/maps/digitizers/tests/fauxsiscrate.py
rename to bapsflib/faux/digitizers/fauxsiscrate.py

From 78b96b470467f7719b0a43d1c049197c64700019 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:30:06 -0700
Subject: [PATCH 20/36] rename the digitizer faux py files by removing the
 leading "faux"

---
 bapsflib/_hdf/maps/digitizers/tests/test_lecroy.py            | 2 +-
 bapsflib/_hdf/utils/tests/test_hdfreaddata.py                 | 4 ++--
 bapsflib/_hdf/utils/tests/test_helpers.py                     | 2 +-
 bapsflib/faux/digitizers/{fauxlecroy180e.py => lecroy180e.py} | 0
 bapsflib/faux/digitizers/{fauxsis3301.py => sis3301.py}       | 0
 bapsflib/faux/digitizers/{fauxsiscrate.py => siscrate.py}     | 0
 6 files changed, 4 insertions(+), 4 deletions(-)
 rename bapsflib/faux/digitizers/{fauxlecroy180e.py => lecroy180e.py} (100%)
 rename bapsflib/faux/digitizers/{fauxsis3301.py => sis3301.py} (100%)
 rename bapsflib/faux/digitizers/{fauxsiscrate.py => siscrate.py} (100%)

diff --git a/bapsflib/_hdf/maps/digitizers/tests/test_lecroy.py b/bapsflib/_hdf/maps/digitizers/tests/test_lecroy.py
index 571552f1..e981e72b 100644
--- a/bapsflib/_hdf/maps/digitizers/tests/test_lecroy.py
+++ b/bapsflib/_hdf/maps/digitizers/tests/test_lecroy.py
@@ -4,7 +4,7 @@
 
 from bapsflib._hdf.maps.digitizers.lecroy import HDFMapDigiLeCroy180E
 from bapsflib._hdf.maps.digitizers.tests.common import DigitizerTestCase
-from bapsflib.faux.digitizers.fauxlecroy180e import FauxLeCroy180E
+from bapsflib.faux.digitizers.lecroy180e import FauxLeCroy180E
 from bapsflib.utils.exceptions import HDFMappingError
 from bapsflib.utils.warnings import HDFMappingWarning
 
diff --git a/bapsflib/_hdf/utils/tests/test_hdfreaddata.py b/bapsflib/_hdf/utils/tests/test_hdfreaddata.py
index 8a5eb324..55ba2791 100644
--- a/bapsflib/_hdf/utils/tests/test_hdfreaddata.py
+++ b/bapsflib/_hdf/utils/tests/test_hdfreaddata.py
@@ -37,8 +37,8 @@
 
 if TYPE_CHECKING:
     # This is done for typing purposes only.  A full import is not needed.
-    from bapsflib.faux.digitizers.fauxlecroy180e import FauxLeCroy180E
-    from bapsflib.faux.digitizers.fauxsis3301 import FauxSIS3301
+    from bapsflib.faux.digitizers.lecroy180e import FauxLeCroy180E
+    from bapsflib.faux.digitizers.sis3301 import FauxSIS3301
 
 
 class TestHDFReadData(TestBase):
diff --git a/bapsflib/_hdf/utils/tests/test_helpers.py b/bapsflib/_hdf/utils/tests/test_helpers.py
index 29f4a5c5..2ed0f410 100644
--- a/bapsflib/_hdf/utils/tests/test_helpers.py
+++ b/bapsflib/_hdf/utils/tests/test_helpers.py
@@ -18,7 +18,7 @@
 from numpy.lib import recfunctions as rfn
 
 from bapsflib._hdf.maps.controls.waveform import HDFMapControlWaveform
-from bapsflib.faux.digitizers.fauxlecroy180e import FauxLeCroy180E
+from bapsflib.faux.digitizers.lecroy180e import FauxLeCroy180E
 from bapsflib._hdf.utils.file import File
 from bapsflib._hdf.utils.helpers import (
     build_shotnum_dset_relation,
diff --git a/bapsflib/faux/digitizers/fauxlecroy180e.py b/bapsflib/faux/digitizers/lecroy180e.py
similarity index 100%
rename from bapsflib/faux/digitizers/fauxlecroy180e.py
rename to bapsflib/faux/digitizers/lecroy180e.py
diff --git a/bapsflib/faux/digitizers/fauxsis3301.py b/bapsflib/faux/digitizers/sis3301.py
similarity index 100%
rename from bapsflib/faux/digitizers/fauxsis3301.py
rename to bapsflib/faux/digitizers/sis3301.py
diff --git a/bapsflib/faux/digitizers/fauxsiscrate.py b/bapsflib/faux/digitizers/siscrate.py
similarity index 100%
rename from bapsflib/faux/digitizers/fauxsiscrate.py
rename to bapsflib/faux/digitizers/siscrate.py

From 2305399fa2c490c6d7c8eec3e9cc3c7ce664a665 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:31:58 -0700
Subject: [PATCH 21/36] expose all the digitizer Faux classes to the
 bapsflib.faux.digitizers namespace

---
 bapsflib/faux/digitizers/__init__.py | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/bapsflib/faux/digitizers/__init__.py b/bapsflib/faux/digitizers/__init__.py
index e69de29b..bf36a2d2 100644
--- a/bapsflib/faux/digitizers/__init__.py
+++ b/bapsflib/faux/digitizers/__init__.py
@@ -0,0 +1,13 @@
+"""
+The `bapsflib.faux.digitizers` module contains all the digitzer device
+group generators used by `~bapsflib.faux.builder.FauxHDFBuilder`.
+"""
+__all__ = [
+    "FauxSIS3301",
+    "FauxSISCrate",
+    "FauxLeCroy180E",
+]
+
+from bapsflib.faux.digitizers.lecroy180e import FauxLeCroy180E
+from bapsflib.faux.digitizers.sis3301 import FauxSIS3301
+from bapsflib.faux.digitizers.siscrate import FauxSISCrate

From ecff8de05ff725fd2db8b4e47c89e661a019ed28 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:33:31 -0700
Subject: [PATCH 22/36] update imports from bapsflib.faux.digitizers

---
 bapsflib/_hdf/maps/digitizers/tests/test_lecroy.py | 2 +-
 bapsflib/_hdf/utils/tests/test_hdfreaddata.py      | 3 +--
 bapsflib/_hdf/utils/tests/test_helpers.py          | 2 +-
 3 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/bapsflib/_hdf/maps/digitizers/tests/test_lecroy.py b/bapsflib/_hdf/maps/digitizers/tests/test_lecroy.py
index e981e72b..f519028c 100644
--- a/bapsflib/_hdf/maps/digitizers/tests/test_lecroy.py
+++ b/bapsflib/_hdf/maps/digitizers/tests/test_lecroy.py
@@ -4,7 +4,7 @@
 
 from bapsflib._hdf.maps.digitizers.lecroy import HDFMapDigiLeCroy180E
 from bapsflib._hdf.maps.digitizers.tests.common import DigitizerTestCase
-from bapsflib.faux.digitizers.lecroy180e import FauxLeCroy180E
+from bapsflib.faux.digitizers import FauxLeCroy180E
 from bapsflib.utils.exceptions import HDFMappingError
 from bapsflib.utils.warnings import HDFMappingWarning
 
diff --git a/bapsflib/_hdf/utils/tests/test_hdfreaddata.py b/bapsflib/_hdf/utils/tests/test_hdfreaddata.py
index 55ba2791..0e23351c 100644
--- a/bapsflib/_hdf/utils/tests/test_hdfreaddata.py
+++ b/bapsflib/_hdf/utils/tests/test_hdfreaddata.py
@@ -37,8 +37,7 @@
 
 if TYPE_CHECKING:
     # This is done for typing purposes only.  A full import is not needed.
-    from bapsflib.faux.digitizers.lecroy180e import FauxLeCroy180E
-    from bapsflib.faux.digitizers.sis3301 import FauxSIS3301
+    from bapsflib.faux.digitizers import FauxLeCroy180E, FauxSIS3301
 
 
 class TestHDFReadData(TestBase):
diff --git a/bapsflib/_hdf/utils/tests/test_helpers.py b/bapsflib/_hdf/utils/tests/test_helpers.py
index 2ed0f410..bf3603e6 100644
--- a/bapsflib/_hdf/utils/tests/test_helpers.py
+++ b/bapsflib/_hdf/utils/tests/test_helpers.py
@@ -18,7 +18,6 @@
 from numpy.lib import recfunctions as rfn
 
 from bapsflib._hdf.maps.controls.waveform import HDFMapControlWaveform
-from bapsflib.faux.digitizers.lecroy180e import FauxLeCroy180E
 from bapsflib._hdf.utils.file import File
 from bapsflib._hdf.utils.helpers import (
     build_shotnum_dset_relation,
@@ -27,6 +26,7 @@
     do_shotnum_intersection,
 )
 from bapsflib._hdf.utils.tests import TestBase
+from bapsflib.faux.digitizers import FauxLeCroy180E
 from bapsflib.utils import _bytes_to_str
 from bapsflib.utils.decorators import with_bf
 

From 3800143f300d076c93371653df515b892c242eeb Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:35:07 -0700
Subject: [PATCH 23/36] appease grumpy black

---
 bapsflib/faux/controls/__init__.py   | 1 +
 bapsflib/faux/digitizers/__init__.py | 1 +
 2 files changed, 2 insertions(+)

diff --git a/bapsflib/faux/controls/__init__.py b/bapsflib/faux/controls/__init__.py
index dab3b2b6..4cd7fafa 100644
--- a/bapsflib/faux/controls/__init__.py
+++ b/bapsflib/faux/controls/__init__.py
@@ -2,6 +2,7 @@
 The `bapsflib.faux.controls` module contains all the control device
 group generators used by `~bapsflib.faux.builder.FauxHDFBuilder`.
 """
+
 __all__ = [
     "FauxBMotion",
     "FauxN5700PS",
diff --git a/bapsflib/faux/digitizers/__init__.py b/bapsflib/faux/digitizers/__init__.py
index bf36a2d2..c2929943 100644
--- a/bapsflib/faux/digitizers/__init__.py
+++ b/bapsflib/faux/digitizers/__init__.py
@@ -2,6 +2,7 @@
 The `bapsflib.faux.digitizers` module contains all the digitzer device
 group generators used by `~bapsflib.faux.builder.FauxHDFBuilder`.
 """
+
 __all__ = [
     "FauxSIS3301",
     "FauxSISCrate",

From cd86ea0562b8bff92b95b57d5b074eeb73538a31 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:36:49 -0700
Subject: [PATCH 24/36] appease grumpy isort

---
 .../_hdf/maps/controls/tests/test_bmotion.py     |  2 +-
 .../maps/controls/tests/test_positions180e.py    |  2 +-
 bapsflib/faux/builder.py                         | 16 ++++++++--------
 3 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/bapsflib/_hdf/maps/controls/tests/test_bmotion.py b/bapsflib/_hdf/maps/controls/tests/test_bmotion.py
index 802a0018..41d80f91 100644
--- a/bapsflib/_hdf/maps/controls/tests/test_bmotion.py
+++ b/bapsflib/_hdf/maps/controls/tests/test_bmotion.py
@@ -8,8 +8,8 @@
 
 from bapsflib._hdf.maps.controls.bmotion import HDFMapControlBMotion
 from bapsflib._hdf.maps.controls.tests.common import ControlTestCase
-from bapsflib.faux.controls import FauxBMotion
 from bapsflib._hdf.maps.controls.types import ConType
+from bapsflib.faux.controls import FauxBMotion
 from bapsflib.utils import _bytes_to_str
 from bapsflib.utils.exceptions import HDFMappingError
 from bapsflib.utils.warnings import HDFMappingWarning
diff --git a/bapsflib/_hdf/maps/controls/tests/test_positions180e.py b/bapsflib/_hdf/maps/controls/tests/test_positions180e.py
index 6ad31b5f..d6b11ced 100644
--- a/bapsflib/_hdf/maps/controls/tests/test_positions180e.py
+++ b/bapsflib/_hdf/maps/controls/tests/test_positions180e.py
@@ -3,8 +3,8 @@
 
 from bapsflib._hdf.maps.controls.positions180e import HDFMapControlPositions180E
 from bapsflib._hdf.maps.controls.tests.common import ControlTestCase
-from bapsflib.faux.controls import FauxPositions180E
 from bapsflib._hdf.maps.controls.types import ConType
+from bapsflib.faux.controls import FauxPositions180E
 from bapsflib.utils.exceptions import HDFMappingError
 
 
diff --git a/bapsflib/faux/builder.py b/bapsflib/faux/builder.py
index 6ade8d05..b85d2454 100644
--- a/bapsflib/faux/builder.py
+++ b/bapsflib/faux/builder.py
@@ -6,6 +6,13 @@
 
 from typing import Any, Dict
 
+from bapsflib._hdf.maps.msi.tests import (
+    FauxDischarge,
+    FauxGasPressure,
+    FauxHeater,
+    FauxInterferometerArray,
+    FauxMagneticField,
+)
 from bapsflib.faux.controls import (
     FauxBMotion,
     FauxN5700PS,
@@ -15,14 +22,7 @@
     FauxSixK,
     FauxWaveform,
 )
-from bapsflib._hdf.maps.digitizers.tests import FauxLeCroy180E, FauxSIS3301, FauxSISCrate
-from bapsflib._hdf.maps.msi.tests import (
-    FauxDischarge,
-    FauxGasPressure,
-    FauxHeater,
-    FauxInterferometerArray,
-    FauxMagneticField,
-)
+from bapsflib.faux.digitizers import FauxLeCroy180E, FauxSIS3301, FauxSISCrate
 
 
 class FauxHDFBuilder(h5py.File):

From 59676b937b3bd469cdfaae119e0a5fdde835d9ff Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:38:12 -0700
Subject: [PATCH 25/36] create bapsflib.faux.msi subpackage

---
 bapsflib/faux/msi/__init__.py | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 bapsflib/faux/msi/__init__.py

diff --git a/bapsflib/faux/msi/__init__.py b/bapsflib/faux/msi/__init__.py
new file mode 100644
index 00000000..e69de29b

From e702ef556f326487c564651d09bb8e6263c664cf Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:40:48 -0700
Subject: [PATCH 26/36] move the faux msi py files from
 bapsflib._hdf.maps.msi.tests -> bapsflib.faux.msi

---
 bapsflib/_hdf/maps/msi/tests/__init__.py                     | 5 -----
 bapsflib/{_hdf/maps/msi/tests => faux/msi}/fauxdischarge.py  | 0
 .../{_hdf/maps/msi/tests => faux/msi}/fauxgaspressure.py     | 0
 bapsflib/{_hdf/maps/msi/tests => faux/msi}/fauxheater.py     | 0
 bapsflib/{_hdf/maps/msi/tests => faux/msi}/fauxinterarr.py   | 0
 .../{_hdf/maps/msi/tests => faux/msi}/fauxmagneticfield.py   | 0
 6 files changed, 5 deletions(-)
 rename bapsflib/{_hdf/maps/msi/tests => faux/msi}/fauxdischarge.py (100%)
 rename bapsflib/{_hdf/maps/msi/tests => faux/msi}/fauxgaspressure.py (100%)
 rename bapsflib/{_hdf/maps/msi/tests => faux/msi}/fauxheater.py (100%)
 rename bapsflib/{_hdf/maps/msi/tests => faux/msi}/fauxinterarr.py (100%)
 rename bapsflib/{_hdf/maps/msi/tests => faux/msi}/fauxmagneticfield.py (100%)

diff --git a/bapsflib/_hdf/maps/msi/tests/__init__.py b/bapsflib/_hdf/maps/msi/tests/__init__.py
index c0bec10c..c33ac261 100644
--- a/bapsflib/_hdf/maps/msi/tests/__init__.py
+++ b/bapsflib/_hdf/maps/msi/tests/__init__.py
@@ -8,8 +8,3 @@
 # License: Standard 3-clause BSD; see "LICENSES/LICENSE.txt" for full
 #   license terms and contributor agreement.
 #
-from bapsflib._hdf.maps.msi.tests.fauxdischarge import FauxDischarge
-from bapsflib._hdf.maps.msi.tests.fauxgaspressure import FauxGasPressure
-from bapsflib._hdf.maps.msi.tests.fauxheater import FauxHeater
-from bapsflib._hdf.maps.msi.tests.fauxinterarr import FauxInterferometerArray
-from bapsflib._hdf.maps.msi.tests.fauxmagneticfield import FauxMagneticField
diff --git a/bapsflib/_hdf/maps/msi/tests/fauxdischarge.py b/bapsflib/faux/msi/fauxdischarge.py
similarity index 100%
rename from bapsflib/_hdf/maps/msi/tests/fauxdischarge.py
rename to bapsflib/faux/msi/fauxdischarge.py
diff --git a/bapsflib/_hdf/maps/msi/tests/fauxgaspressure.py b/bapsflib/faux/msi/fauxgaspressure.py
similarity index 100%
rename from bapsflib/_hdf/maps/msi/tests/fauxgaspressure.py
rename to bapsflib/faux/msi/fauxgaspressure.py
diff --git a/bapsflib/_hdf/maps/msi/tests/fauxheater.py b/bapsflib/faux/msi/fauxheater.py
similarity index 100%
rename from bapsflib/_hdf/maps/msi/tests/fauxheater.py
rename to bapsflib/faux/msi/fauxheater.py
diff --git a/bapsflib/_hdf/maps/msi/tests/fauxinterarr.py b/bapsflib/faux/msi/fauxinterarr.py
similarity index 100%
rename from bapsflib/_hdf/maps/msi/tests/fauxinterarr.py
rename to bapsflib/faux/msi/fauxinterarr.py
diff --git a/bapsflib/_hdf/maps/msi/tests/fauxmagneticfield.py b/bapsflib/faux/msi/fauxmagneticfield.py
similarity index 100%
rename from bapsflib/_hdf/maps/msi/tests/fauxmagneticfield.py
rename to bapsflib/faux/msi/fauxmagneticfield.py

From 4b6f1d3d133e7d1152e10c67c877005dfaed2cb7 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:41:21 -0700
Subject: [PATCH 27/36] remove unnecessary comment header

---
 bapsflib/_hdf/maps/msi/tests/__init__.py | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/bapsflib/_hdf/maps/msi/tests/__init__.py b/bapsflib/_hdf/maps/msi/tests/__init__.py
index c33ac261..e69de29b 100644
--- a/bapsflib/_hdf/maps/msi/tests/__init__.py
+++ b/bapsflib/_hdf/maps/msi/tests/__init__.py
@@ -1,10 +0,0 @@
-# This file is part of the bapsflib package, a Python toolkit for the
-# BaPSF group at UCLA.
-#
-# http://plasma.physics.ucla.edu/
-#
-# Copyright 2017-2018 Erik T. Everson and contributors
-#
-# License: Standard 3-clause BSD; see "LICENSES/LICENSE.txt" for full
-#   license terms and contributor agreement.
-#

From d13b67cba3400e04315ffdd24ce17aaf071cee8c Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:42:46 -0700
Subject: [PATCH 28/36] rename faux msi py files by removing the "faux"

---
 bapsflib/faux/msi/{fauxdischarge.py => discharge.py}         | 0
 bapsflib/faux/msi/{fauxgaspressure.py => gaspressure.py}     | 0
 bapsflib/faux/msi/{fauxheater.py => heater.py}               | 0
 bapsflib/faux/msi/{fauxinterarr.py => interarr.py}           | 0
 bapsflib/faux/msi/{fauxmagneticfield.py => magneticfield.py} | 0
 5 files changed, 0 insertions(+), 0 deletions(-)
 rename bapsflib/faux/msi/{fauxdischarge.py => discharge.py} (100%)
 rename bapsflib/faux/msi/{fauxgaspressure.py => gaspressure.py} (100%)
 rename bapsflib/faux/msi/{fauxheater.py => heater.py} (100%)
 rename bapsflib/faux/msi/{fauxinterarr.py => interarr.py} (100%)
 rename bapsflib/faux/msi/{fauxmagneticfield.py => magneticfield.py} (100%)

diff --git a/bapsflib/faux/msi/fauxdischarge.py b/bapsflib/faux/msi/discharge.py
similarity index 100%
rename from bapsflib/faux/msi/fauxdischarge.py
rename to bapsflib/faux/msi/discharge.py
diff --git a/bapsflib/faux/msi/fauxgaspressure.py b/bapsflib/faux/msi/gaspressure.py
similarity index 100%
rename from bapsflib/faux/msi/fauxgaspressure.py
rename to bapsflib/faux/msi/gaspressure.py
diff --git a/bapsflib/faux/msi/fauxheater.py b/bapsflib/faux/msi/heater.py
similarity index 100%
rename from bapsflib/faux/msi/fauxheater.py
rename to bapsflib/faux/msi/heater.py
diff --git a/bapsflib/faux/msi/fauxinterarr.py b/bapsflib/faux/msi/interarr.py
similarity index 100%
rename from bapsflib/faux/msi/fauxinterarr.py
rename to bapsflib/faux/msi/interarr.py
diff --git a/bapsflib/faux/msi/fauxmagneticfield.py b/bapsflib/faux/msi/magneticfield.py
similarity index 100%
rename from bapsflib/faux/msi/fauxmagneticfield.py
rename to bapsflib/faux/msi/magneticfield.py

From 07840e923c64cc607e4a1773019573e0e8dcdfd4 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:45:00 -0700
Subject: [PATCH 29/36] expose all the Faux MSI classes to the
 bapsflib.faux.msi namespace

---
 bapsflib/faux/msi/__init__.py | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/bapsflib/faux/msi/__init__.py b/bapsflib/faux/msi/__init__.py
index e69de29b..486c4443 100644
--- a/bapsflib/faux/msi/__init__.py
+++ b/bapsflib/faux/msi/__init__.py
@@ -0,0 +1,18 @@
+"""
+The `bapsflib.faux.msi` module contains all the MSI device
+group generators used by `~bapsflib.faux.builder.FauxHDFBuilder`.
+"""
+
+__all__ = [
+    "FauxDischarge",
+    "FauxGasPressure",
+    "FauxHeater",
+    "FauxInterferometerArray",
+    "FauxMagneticField"
+]
+
+from bapsflib.faux.msi.discharge import FauxDischarge
+from bapsflib.faux.msi.gaspressure import FauxGasPressure
+from bapsflib.faux.msi.heater import FauxHeater
+from bapsflib.faux.msi.interarr import FauxInterferometerArray
+from bapsflib.faux.msi.magneticfield import FauxMagneticField

From cbee1be98a4e25e0d4259aaca6eb0e30065b4263 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:46:42 -0700
Subject: [PATCH 30/36] fix imports of msi faux classes

---
 bapsflib/faux/builder.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bapsflib/faux/builder.py b/bapsflib/faux/builder.py
index b85d2454..8cf4970c 100644
--- a/bapsflib/faux/builder.py
+++ b/bapsflib/faux/builder.py
@@ -6,7 +6,7 @@
 
 from typing import Any, Dict
 
-from bapsflib._hdf.maps.msi.tests import (
+from bapsflib.faux.msi import (
     FauxDischarge,
     FauxGasPressure,
     FauxHeater,

From 90c47c5364d3e92e78e798c8a1bf9910c513240a Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:48:15 -0700
Subject: [PATCH 31/36] appease grumpy isort

---
 bapsflib/faux/builder.py | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/bapsflib/faux/builder.py b/bapsflib/faux/builder.py
index 8cf4970c..96d9ee4c 100644
--- a/bapsflib/faux/builder.py
+++ b/bapsflib/faux/builder.py
@@ -6,13 +6,6 @@
 
 from typing import Any, Dict
 
-from bapsflib.faux.msi import (
-    FauxDischarge,
-    FauxGasPressure,
-    FauxHeater,
-    FauxInterferometerArray,
-    FauxMagneticField,
-)
 from bapsflib.faux.controls import (
     FauxBMotion,
     FauxN5700PS,
@@ -23,6 +16,13 @@
     FauxWaveform,
 )
 from bapsflib.faux.digitizers import FauxLeCroy180E, FauxSIS3301, FauxSISCrate
+from bapsflib.faux.msi import (
+    FauxDischarge,
+    FauxGasPressure,
+    FauxHeater,
+    FauxInterferometerArray,
+    FauxMagneticField,
+)
 
 
 class FauxHDFBuilder(h5py.File):

From c99d442728bce38ec34da9357adaa7efdce202be Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:48:29 -0700
Subject: [PATCH 32/36] appease grumpy black

---
 bapsflib/faux/msi/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bapsflib/faux/msi/__init__.py b/bapsflib/faux/msi/__init__.py
index 486c4443..f2d7c28a 100644
--- a/bapsflib/faux/msi/__init__.py
+++ b/bapsflib/faux/msi/__init__.py
@@ -8,7 +8,7 @@
     "FauxGasPressure",
     "FauxHeater",
     "FauxInterferometerArray",
-    "FauxMagneticField"
+    "FauxMagneticField",
 ]
 
 from bapsflib.faux.msi.discharge import FauxDischarge

From 02fcc2615c47ae4f90734ecc57bdbe756da260d5 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 12:52:12 -0700
Subject: [PATCH 33/36] expose the controls, digitizers, and msi subpackages to
 the bapsflib.faux namespace

---
 bapsflib/faux/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bapsflib/faux/__init__.py b/bapsflib/faux/__init__.py
index 46617458..6574b4af 100644
--- a/bapsflib/faux/__init__.py
+++ b/bapsflib/faux/__init__.py
@@ -18,9 +18,9 @@
 >>> bapsflib.faux
 <module 'bapsflib.faux'>
 
-
 """
 
 __all__ = ["FauxHDFBuilder"]
 
 from bapsflib.faux.builder import FauxHDFBuilder
+from bapsflib.faux import controls, digitizers, msi

From 0af7db55a6928d7062fa38baa0edc0d8d4c6f190 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 13:10:48 -0700
Subject: [PATCH 34/36] create all doc stub files for the bapsflib.faux
 subpackage

---
 docs/api_static/bapsflib.faux.builder.rst                | 8 ++++++++
 docs/api_static/bapsflib.faux.controls.bmotion.rst       | 8 ++++++++
 docs/api_static/bapsflib.faux.controls.n5700ps.rst       | 8 ++++++++
 docs/api_static/bapsflib.faux.controls.nixyz.rst         | 8 ++++++++
 docs/api_static/bapsflib.faux.controls.nixz.rst          | 8 ++++++++
 docs/api_static/bapsflib.faux.controls.positions180e.rst | 8 ++++++++
 docs/api_static/bapsflib.faux.controls.rst               | 8 ++++++++
 docs/api_static/bapsflib.faux.controls.sixk.rst          | 8 ++++++++
 docs/api_static/bapsflib.faux.controls.waveform.rst      | 8 ++++++++
 docs/api_static/bapsflib.faux.digitizers.lecroy180e.rst  | 8 ++++++++
 docs/api_static/bapsflib.faux.digitizers.rst             | 8 ++++++++
 docs/api_static/bapsflib.faux.digitizers.sis3301.rst     | 8 ++++++++
 docs/api_static/bapsflib.faux.digitizers.siscrate.rst    | 8 ++++++++
 docs/api_static/bapsflib.faux.msi.discharge.rst          | 8 ++++++++
 docs/api_static/bapsflib.faux.msi.gaspressure.rst        | 8 ++++++++
 docs/api_static/bapsflib.faux.msi.heater.rst             | 8 ++++++++
 docs/api_static/bapsflib.faux.msi.interarr.rst           | 8 ++++++++
 docs/api_static/bapsflib.faux.msi.magneticfield.rst      | 8 ++++++++
 docs/api_static/bapsflib.faux.msi.rst                    | 8 ++++++++
 19 files changed, 152 insertions(+)
 create mode 100644 docs/api_static/bapsflib.faux.builder.rst
 create mode 100644 docs/api_static/bapsflib.faux.controls.bmotion.rst
 create mode 100644 docs/api_static/bapsflib.faux.controls.n5700ps.rst
 create mode 100644 docs/api_static/bapsflib.faux.controls.nixyz.rst
 create mode 100644 docs/api_static/bapsflib.faux.controls.nixz.rst
 create mode 100644 docs/api_static/bapsflib.faux.controls.positions180e.rst
 create mode 100644 docs/api_static/bapsflib.faux.controls.rst
 create mode 100644 docs/api_static/bapsflib.faux.controls.sixk.rst
 create mode 100644 docs/api_static/bapsflib.faux.controls.waveform.rst
 create mode 100644 docs/api_static/bapsflib.faux.digitizers.lecroy180e.rst
 create mode 100644 docs/api_static/bapsflib.faux.digitizers.rst
 create mode 100644 docs/api_static/bapsflib.faux.digitizers.sis3301.rst
 create mode 100644 docs/api_static/bapsflib.faux.digitizers.siscrate.rst
 create mode 100644 docs/api_static/bapsflib.faux.msi.discharge.rst
 create mode 100644 docs/api_static/bapsflib.faux.msi.gaspressure.rst
 create mode 100644 docs/api_static/bapsflib.faux.msi.heater.rst
 create mode 100644 docs/api_static/bapsflib.faux.msi.interarr.rst
 create mode 100644 docs/api_static/bapsflib.faux.msi.magneticfield.rst
 create mode 100644 docs/api_static/bapsflib.faux.msi.rst

diff --git a/docs/api_static/bapsflib.faux.builder.rst b/docs/api_static/bapsflib.faux.builder.rst
new file mode 100644
index 00000000..a89d4d3f
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.builder.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.builder
+=======================
+
+.. py:currentmodule:: bapsflib.faux.builder
+
+.. automodapi:: bapsflib.faux.builder
diff --git a/docs/api_static/bapsflib.faux.controls.bmotion.rst b/docs/api_static/bapsflib.faux.controls.bmotion.rst
new file mode 100644
index 00000000..9ac145fa
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.controls.bmotion.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.controls\.bmotion
+=================================
+
+.. py:currentmodule:: bapsflib.faux.controls.bmotion
+
+.. automodapi:: bapsflib.faux.controls.bmotion
diff --git a/docs/api_static/bapsflib.faux.controls.n5700ps.rst b/docs/api_static/bapsflib.faux.controls.n5700ps.rst
new file mode 100644
index 00000000..eba20b16
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.controls.n5700ps.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.controls\.n5700ps
+=================================
+
+.. py:currentmodule:: bapsflib.faux.controls.n5700ps
+
+.. automodapi:: bapsflib.faux.controls.n5700ps
diff --git a/docs/api_static/bapsflib.faux.controls.nixyz.rst b/docs/api_static/bapsflib.faux.controls.nixyz.rst
new file mode 100644
index 00000000..648c9a5f
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.controls.nixyz.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.controls\.nixyz
+===============================
+
+.. py:currentmodule:: bapsflib.faux.controls.nixyz
+
+.. automodapi:: bapsflib.faux.controls.nixyz
diff --git a/docs/api_static/bapsflib.faux.controls.nixz.rst b/docs/api_static/bapsflib.faux.controls.nixz.rst
new file mode 100644
index 00000000..75e468b8
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.controls.nixz.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.controls\.nixz
+==============================
+
+.. py:currentmodule:: bapsflib.faux.controls.nixz
+
+.. automodapi:: bapsflib.faux.controls.nixz
diff --git a/docs/api_static/bapsflib.faux.controls.positions180e.rst b/docs/api_static/bapsflib.faux.controls.positions180e.rst
new file mode 100644
index 00000000..7913b0fc
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.controls.positions180e.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.controls\.positions180e
+=======================================
+
+.. py:currentmodule:: bapsflib.faux.controls.positions180e
+
+.. automodapi:: bapsflib.faux.controls.positions180e
diff --git a/docs/api_static/bapsflib.faux.controls.rst b/docs/api_static/bapsflib.faux.controls.rst
new file mode 100644
index 00000000..9d88fa74
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.controls.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.controls
+========================
+
+.. py:currentmodule:: bapsflib.faux.controls
+
+.. automodapi:: bapsflib.faux.controls
diff --git a/docs/api_static/bapsflib.faux.controls.sixk.rst b/docs/api_static/bapsflib.faux.controls.sixk.rst
new file mode 100644
index 00000000..49ada4ae
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.controls.sixk.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.controls\.sixk
+==============================
+
+.. py:currentmodule:: bapsflib.faux.controls.sixk
+
+.. automodapi:: bapsflib.faux.controls.sixk
diff --git a/docs/api_static/bapsflib.faux.controls.waveform.rst b/docs/api_static/bapsflib.faux.controls.waveform.rst
new file mode 100644
index 00000000..5587ccf1
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.controls.waveform.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.controls\.waveform
+==================================
+
+.. py:currentmodule:: bapsflib.faux.controls.waveform
+
+.. automodapi:: bapsflib.faux.controls.waveform
diff --git a/docs/api_static/bapsflib.faux.digitizers.lecroy180e.rst b/docs/api_static/bapsflib.faux.digitizers.lecroy180e.rst
new file mode 100644
index 00000000..b563d629
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.digitizers.lecroy180e.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.digitizers\.lecroy180e
+======================================
+
+.. py:currentmodule:: bapsflib.faux.digitizers.lecroy180e
+
+.. automodapi:: bapsflib.faux.digitizers.lecroy180e
diff --git a/docs/api_static/bapsflib.faux.digitizers.rst b/docs/api_static/bapsflib.faux.digitizers.rst
new file mode 100644
index 00000000..a0057816
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.digitizers.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.digitizers
+==========================
+
+.. py:currentmodule:: bapsflib.faux.digitizers
+
+.. automodapi:: bapsflib.faux.digitizers
diff --git a/docs/api_static/bapsflib.faux.digitizers.sis3301.rst b/docs/api_static/bapsflib.faux.digitizers.sis3301.rst
new file mode 100644
index 00000000..b62143a7
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.digitizers.sis3301.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.digitizers\.sis3301
+===================================
+
+.. py:currentmodule:: bapsflib.faux.digitizers.sis3301
+
+.. automodapi:: bapsflib.faux.digitizers.sis3301
diff --git a/docs/api_static/bapsflib.faux.digitizers.siscrate.rst b/docs/api_static/bapsflib.faux.digitizers.siscrate.rst
new file mode 100644
index 00000000..1dc35ad0
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.digitizers.siscrate.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.digitizers\.siscrate
+====================================
+
+.. py:currentmodule:: bapsflib.faux.digitizers.siscrate
+
+.. automodapi:: bapsflib.faux.digitizers.siscrate
diff --git a/docs/api_static/bapsflib.faux.msi.discharge.rst b/docs/api_static/bapsflib.faux.msi.discharge.rst
new file mode 100644
index 00000000..199a14d8
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.msi.discharge.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.msi\.discharge
+==============================
+
+.. py:currentmodule:: bapsflib.faux.msi.discharge
+
+.. automodapi:: bapsflib.faux.msi.discharge
diff --git a/docs/api_static/bapsflib.faux.msi.gaspressure.rst b/docs/api_static/bapsflib.faux.msi.gaspressure.rst
new file mode 100644
index 00000000..5f008ffe
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.msi.gaspressure.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.msi\.gaspressure
+================================
+
+.. py:currentmodule:: bapsflib.faux.msi.gaspressure
+
+.. automodapi:: bapsflib.faux.msi.gaspressure
diff --git a/docs/api_static/bapsflib.faux.msi.heater.rst b/docs/api_static/bapsflib.faux.msi.heater.rst
new file mode 100644
index 00000000..b70e5d71
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.msi.heater.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.msi\.heater
+===========================
+
+.. py:currentmodule:: bapsflib.faux.msi.heater
+
+.. automodapi:: bapsflib.faux.msi.heater
diff --git a/docs/api_static/bapsflib.faux.msi.interarr.rst b/docs/api_static/bapsflib.faux.msi.interarr.rst
new file mode 100644
index 00000000..94e5bec4
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.msi.interarr.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.msi\.interarr
+=============================
+
+.. py:currentmodule:: bapsflib.faux.msi.interarr
+
+.. automodapi:: bapsflib.faux.msi.interarr
diff --git a/docs/api_static/bapsflib.faux.msi.magneticfield.rst b/docs/api_static/bapsflib.faux.msi.magneticfield.rst
new file mode 100644
index 00000000..f5460b5b
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.msi.magneticfield.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.msi\.magneticfield
+==================================
+
+.. py:currentmodule:: bapsflib.faux.msi.magneticfield
+
+.. automodapi:: bapsflib.faux.msi.magneticfield
diff --git a/docs/api_static/bapsflib.faux.msi.rst b/docs/api_static/bapsflib.faux.msi.rst
new file mode 100644
index 00000000..61557648
--- /dev/null
+++ b/docs/api_static/bapsflib.faux.msi.rst
@@ -0,0 +1,8 @@
+:orphan:
+
+bapsflib\.faux\.msi
+===================
+
+.. py:currentmodule:: bapsflib.faux.msi
+
+.. automodapi:: bapsflib.faux.msi

From eebf8a375fea731b727fe5b2705c56052a2e64f7 Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 19:24:27 -0700
Subject: [PATCH 35/36] appease grumpy isort

---
 bapsflib/faux/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bapsflib/faux/__init__.py b/bapsflib/faux/__init__.py
index 6574b4af..67c76eff 100644
--- a/bapsflib/faux/__init__.py
+++ b/bapsflib/faux/__init__.py
@@ -22,5 +22,5 @@
 
 __all__ = ["FauxHDFBuilder"]
 
-from bapsflib.faux.builder import FauxHDFBuilder
 from bapsflib.faux import controls, digitizers, msi
+from bapsflib.faux.builder import FauxHDFBuilder

From 473db2afc3d65d809ebd729dacfe40aacbb8c1af Mon Sep 17 00:00:00 2001
From: Erik <eteverson@gmail.com>
Date: Thu, 30 Apr 2026 19:26:40 -0700
Subject: [PATCH 36/36] add module docstring and __all__ to builder.py

---
 bapsflib/faux/builder.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/bapsflib/faux/builder.py b/bapsflib/faux/builder.py
index 96d9ee4c..ae2b2de1 100644
--- a/bapsflib/faux/builder.py
+++ b/bapsflib/faux/builder.py
@@ -1,3 +1,9 @@
+"""
+Module that defines the `~bapsflib.faux.builder.FauxHDFBuilder` class.
+"""
+
+__all__ = ["FauxHDFBuilder"]
+
 import h5py
 import inspect
 import os