Fixed #225. Handling of empty class folders. (#226)

* Fixed #225. Handling of empty class folders.

* Added empty class folder.

CHANGES.rst

@@ -1,3 +1,11 @@
+sphinxcontrib-matlabdomain-0.X.Y (2023-MM-DD)
+==============================================
+
+* Fixed `Issue 225`. Empty ``@classfolder`` would throw an assertion error.
+
+.. _Issue 225: https://github.com/sphinx-contrib/matlabdomain/issues/225
+
+
 sphinxcontrib-matlabdomain-0.20.2 (2023-09-15)
 ==============================================
 

sphinxcontrib/mat_types.py

@@ -251,6 +251,10 @@ def isClassFolderModule(name, entity):
         # Find the class entity class.
         class_entities = [e for e in cf_entity.entities if isinstance(e[1], MatClass)]
         func_entities = [e for e in cf_entity.entities if isinstance(e[1], MatFunction)]
+
+        empty_class_folder = not class_entities and not func_entities
+        if empty_class_folder:
+            continue
         assert len(class_entities) == 1
         cls = class_entities[0][1]
 

tests/helper.py

@@ -17,7 +17,7 @@
     from pathlib import Path
 
     def rootdir(the_file):
-        return Path(os.path.dirname(__file__)).absolute()
+        return Path(os.path.dirname(__file__)).resolve().absolute()
 
 else:
     from sphinx.testing.path import path as sphinx_path

tests/test_data/@EmptyClassFolder/readme.txt

@@ -0,0 +1 @@
+Intentionally empty folder. Tests https://github.com/sphinx-contrib/matlabdomain/issues/225

tests/test_matlabify.py

@@ -52,6 +52,7 @@ def test_module(mod):
     expected_items = {
         "+package",
         "@ClassFolder",
+        "@EmptyClassFolder",
         "Application",
         "ClassAbstract",
         "ClassExample",