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

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))

tests/unit/core/python/_core/test_PythonDocumentationGenerator/test_generate_documentation/case02/project/pkg/module/module2.py

@@ -0,0 +1,3 @@
+"""
+Module 2.
+"""