Improve housekeep.py

housekeep.py

@@ -93,11 +93,13 @@ def deldir(targ: Path, verbose: bool = True):
 
 
 def dump_env():
+    env = dict(os.environ)
+    env["PYTHON_EXE"] = str(sys.executable)
     dumpdir = Path(DUMP_DIR)
     dumpdir.mkdir(exist_ok=True)
     with (dumpdir / f"ENV.{TOX_ENV_NAME}.py").open("wt") as fout:
         print("ENV = \\", file=fout)
-        pprint.pprint(dict(os.environ), stream=fout)
+        pprint.pprint(env, stream=fout)
 
 
 def move_prof(verbose: bool = False):
@@ -141,6 +143,18 @@ def pycache_clean(verbose=False):
         print(flush=True)
 
 
+def docs_clean(verbose=False):
+    """Cleanup build/ to force sphinx-build to rebuild"""
+    buildpath = Path("build")
+    if not buildpath.exists():
+        print("Docs already cleaned.")
+        return
+    print("Removing build/ ...", end="")
+    deldir(buildpath, verbose)
+    if verbose:
+        print(flush=True)
+
+
 def rm_work():
     """Remove work dirs & files. They are .gitignore'd anyways."""
     print(f"{Style.BRIGHT}Removing work dirs ... ", end="", flush=True)
@@ -185,6 +199,13 @@ def dispatch_remcache():
     pycache_clean()
 
 
+def dispatch_remdocs():
+    """
+    Remove all docs artefacts
+    """
+    docs_clean()
+
+
 def dispatch_superclean():
     """
     Total cleaning of all test artifacts