Lazy import for docs (#936)

Introduce lazy loading of submodules and so that mkdocs does not fail.

---------

Co-authored-by: Jesper Friis <jesper.friis@sintef.no>
Co-authored-by: Jesper Friis <jesper-friis@users.noreply.github.com>

Author: francescalb

.github/workflows/ci_cd_updated_master.yml

@@ -2,7 +2,9 @@ name: CI/CD - New updates to 'master'
 
 on:
   push:
-    branches: [master]
+    branches:
+      - master
+      - lazy_import_for_docs
 
 jobs:
   updates-to-master:
@@ -23,7 +25,7 @@ jobs:
         emmopy
         ontopy
       python_version: "3.13"
-      doc_extras: "[docs,excel,ontodoc]"
+      doc_extras: "[docs,excel,ontodoc,ontokit]"
       special_file_api_ref_options: "emmopy/emmocheck.py,show_bases: false"
       landing_page_replacements: |
         (LICENSE.txt),(LICENSE.md)

ontopy/ontokit/__init__.py

@@ -1 +1,18 @@
-"""Ontopy subpackage for creating workflows and documenting ontologies"""
+"""Ontopy subpackage for creating workflows and documenting ontologies."""
+
+from importlib import import_module
+
+__all__ = ["docs", "setup"]
+
+
+def __getattr__(name):
+    """Lazily expose submodules for tooling such as mkdocstrings.
+
+    It will import the `docs` module when a user does
+    `import ontokit.docs`. Similar for the other modules.
+    """
+    if name in __all__:
+        module = import_module(f"{__name__}.{name}")
+        globals()[name] = module
+        return module
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")