Let autoapi discover all _os.py modules (#89)

The API reference was never generated for `_os.py` modules due to disabling autoapi `private-members`. This patch fixes this behaviour specifically for the _os modules.

Author: Miauwkeru

docs/source/conf.py

@@ -15,6 +15,8 @@
 import sys
 from pathlib import Path
 
+from sphinx.application import Sphinx
+
 sys.path.insert(0, os.path.abspath("./contributing"))
 
 for path in map(str, Path("../../submodules/").resolve().iterdir()):
@@ -71,7 +73,7 @@
     api_dir = Path(__file__).parent / "api"
 
     for dir_name in ["acquire/nop", "dissect/nop", "flow/nop"]:
-        api_dir.joinpath(dir_name).mkdir(parents=True)
+        api_dir.joinpath(dir_name).mkdir(parents=True, exist_ok=True)
         api_dir.joinpath(dir_name, "index.rst").write_text(":orphan:\n\nTITLE\n#####\n")
 
 else:
@@ -144,7 +146,7 @@
 acquire_path = Path("../../submodules/acquire")
 
 autoapi_type = "python"
-autoapi_dirs = [acquire_path] + dissect_paths + flow_paths
+autoapi_dirs = [acquire_path, *dissect_paths, *flow_paths]
 autoapi_ignore = ["*tests*", "*.tox*", "*venv*", "*examples*", "*setup.py"]
 autoapi_python_use_implicit_namespaces = True
 autoapi_add_toctree_entry = False
@@ -178,3 +180,15 @@
     # https://github.com/sphinx-doc/sphinx/issues/4961
     "ref.python",
 ]
+
+
+def autoapi_skip_hook(app: Sphinx, what: str, name: str, obj, skip: bool, options: list[str]) -> bool:
+    # Do not skip OS modules in dissect.target (caught by `private-members`)
+    if name.endswith("._os") and what == "module":
+        skip = False
+    return skip
+
+
+def setup(sphinx: Sphinx) -> None:
+    if "autoapi.extension" in extensions:
+        sphinx.connect("autoapi-skip-member", autoapi_skip_hook)