From 908e299fa07c204e30ecc12063f738edbad3a7a0 Mon Sep 17 00:00:00 2001 From: Jakob Scheid Date: Tue, 29 Sep 2026 17:43:19 +0200 Subject: [PATCH 1/3] fix(python-generator): check for module namespace Added a check whether a module namespace with the name off a directory already exists before adding a package namespace for the directory. --- src/jcloud_docsgen/core/python/_core.py | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/jcloud_docsgen/core/python/_core.py b/src/jcloud_docsgen/core/python/_core.py index c84cb11..78b3f14 100644 --- a/src/jcloud_docsgen/core/python/_core.py +++ b/src/jcloud_docsgen/core/python/_core.py @@ -1107,7 +1107,9 @@ class PythonDocumentationGenerator: ) for entry in directory.iterdir(): - if entry.is_dir(): + if entry.is_dir() and ( + entry.parent / (f'{entry.stem}.py') + ).resolve() not in [e.resolve() for e in entry.parent.iterdir()]: namespace.add(self._namespace(entry)) elif entry.suffix == '.py': namespace.add(PythonModuleNamespace(entry.stem)) From fe40b672da90549dc9810d713998fec87c706a9f Mon Sep 17 00:00:00 2001 From: Jakob Scheid Date: Tue, 29 Sep 2026 18:13:28 +0200 Subject: [PATCH 2/3] test(python-generator): add test data for namespace conflict preventing Added a package with the same name as a module to a test Python project. --- .../case02/project/pkg/module/module2.py | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 tests/unit/core/python/_core/test_PythonDocumentationGenerator/test_generate_documentation/case02/project/pkg/module/module2.py diff --git a/tests/unit/core/python/_core/test_PythonDocumentationGenerator/test_generate_documentation/case02/project/pkg/module/module2.py b/tests/unit/core/python/_core/test_PythonDocumentationGenerator/test_generate_documentation/case02/project/pkg/module/module2.py new file mode 100644 index 0000000..3d76135 --- /dev/null +++ b/tests/unit/core/python/_core/test_PythonDocumentationGenerator/test_generate_documentation/case02/project/pkg/module/module2.py @@ -0,0 +1,3 @@ +""" +Module 2. +""" From 7d20d21f3dd12a16f6521225ed3b749206278136 Mon Sep 17 00:00:00 2001 From: Jakob Scheid Date: Tue, 29 Sep 2026 18:17:15 +0200 Subject: [PATCH 3/3] docs(changelog): add Python namespace conflict fix entry Added a changelog entry for the Python namespace name conflict fix. --- docs/CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 650549c..01926dc 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -4,6 +4,7 @@ ### Fixed +- Python namespace name conflict when package and module have the same name - Internal namespace name error which occured when generating Python documentation with `.` as the project directory ## [0.2.0] - 2026-09-28