Add PythonDocumentationGenerator method to collect all namespaces

tests/unit/core/python/_core/test_PythonDocumentationGenerator.py

@@ -1,4 +1,8 @@
+import sys
+sys.path.append('.')
+
 from src.jcloud_docsgen.core.python import PythonDocumentationGenerator
+from src.jcloud_docsgen.core.python.namespaces import PythonModuleNamespace, PythonPackageNamespace
 import pytest
 from src.jcloud_docsgen.utils import ExistingDirectory
 
@@ -14,4 +18,13 @@ from src.jcloud_docsgen.utils import ExistingDirectory
 ])
 def test_PythonDocumentationGenerator_type_exceptions(project_directory, docs_directory):
     with pytest.raises(TypeError):
-        PythonDocumentationGenerator(project_directory, docs_directory)
+        PythonDocumentationGenerator(project_directory, docs_directory)
+
+@pytest.mark.parametrize('python_documentation_generator,expected', [
+    (PythonDocumentationGenerator(ExistingDirectory('tests/unit/core/python/_core/test_project_dirs/pdir_1'), ExistingDirectory('tests/unit/core/python/_core/test_project_dirs/pdir_1/docs')), PythonPackageNamespace('src', {})),
+    (PythonDocumentationGenerator(ExistingDirectory('tests/unit/core/python/_core/test_project_dirs/pdir_2'), ExistingDirectory('tests/unit/core/python/_core/test_project_dirs/pdir_2/docs')), PythonPackageNamespace('src', {'module': PythonModuleNamespace('module')})),
+    (PythonDocumentationGenerator(ExistingDirectory('tests/unit/core/python/_core/test_project_dirs/pdir_3'), ExistingDirectory('tests/unit/core/python/_core/test_project_dirs/pdir_3/docs')), PythonPackageNamespace('src', {'module': PythonModuleNamespace('module'), 'pkg': PythonPackageNamespace('pkg', {'module2': PythonModuleNamespace('module2')})})),
+])
+def test_PythonDocumentationGenerator_collect_modules(python_documentation_generator: PythonDocumentationGenerator, expected):
+    print('MODS:', python_documentation_generator.namespace())
+    assert python_documentation_generator.namespace() == expected