mkdocstrings-matlab 0.3.0__py3-none-any.whl → 0.3.1__py3-none-any.whl

mkdocstrings_handlers/matlab/collect.py

@@ -276,43 +276,55 @@ class PathCollection(ModulesCollection):
             document_parameters = not docstring_parameters and arguments_parameters
             document_returns = not docstring_returns and arguments_returns
 
-            if document_parameters:
-                parameters = DocstringSectionParameters(
-                    [
-                        DocstringParameter(
-                            name=param.name,
-                            value=str(param.default)
-                            if param.default is not None
-                            else None,
-                            annotation=param.annotation,
-                            description=param.docstring.value
-                            if param.docstring is not None
-                            else "",
-                        )
-                        for param in model.parameters
-                        if param.kind is not ParameterKind.keyword_only
-                    ]
+            standard_parameters = [
+                param for param in model.parameters
+                if param.kind is not ParameterKind.keyword_only
+            ]
+
+            keyword_parameters = [
+                param for param in model.parameters
+                if param.kind is ParameterKind.keyword_only
+            ]
+
+            if document_parameters and standard_parameters:
+                model.docstring._extra_sections.append(
+                    DocstringSectionParameters(
+                        [
+                            DocstringParameter(
+                                name=param.name,
+                                value=str(param.default)
+                                if param.default is not None
+                                else None,
+                                annotation=param.annotation,
+                                description=param.docstring.value
+                                if param.docstring is not None
+                                else "",
+                            )
+                            for param in standard_parameters
+                        ]
+                    )
                 )
 
-                keywords = DocstringSectionParameters(
-                    [
-                        DocstringParameter(
-                            name=param.name,
-                            value=str(param.default)
-                            if param.default is not None
-                            else None,
-                            annotation=param.annotation,
-                            description=param.docstring.value
-                            if param.docstring is not None
-                            else "",
-                        )
-                        for param in model.parameters
-                        if param.kind is ParameterKind.keyword_only
-                    ],
-                    title="Keyword Arguments:",
+            if document_parameters and keyword_parameters:
+
+                model.docstring._extra_sections.append(
+                    DocstringSectionParameters(
+                        [
+                            DocstringParameter(
+                                name=param.name,
+                                value=str(param.default)
+                                if param.default is not None
+                                else None,
+                                annotation=param.annotation,
+                                description=param.docstring.value
+                                if param.docstring is not None
+                                else "",
+                            )
+                            for param in keyword_parameters
+                        ],
+                        title="Keyword Arguments:",
+                    )
                 )
-                model.docstring._extra_sections.append(parameters)
-                model.docstring._extra_sections.append(keywords)
 
             if document_returns:
                 returns = DocstringSectionReturns(
@@ -568,12 +580,17 @@ class LazyModel:
             if (
                 member.is_file()
                 and member.suffix == ".m"
-                and member.name != "Contents.m"
                 and member != classfile
             ):
-                method = self._collect_path(member)
-                method.parent = model
-                model.members[method.name] = method
+                if member.name == "Contents.m" and model.docstring is None:
+                    contentsfile = self._collect_path(member)
+                    model.docstring = contentsfile.docstring
+                else:
+                    method = self._collect_path(member)
+                    method.parent = model
+                    model.members[method.name] = method
+        if model.docstring is None:
+            model.docstring = self._collect_readme_md(path, model)
         return model
 
     def _collect_namespace(self, path: Path) -> Namespace | None:
@@ -589,9 +606,26 @@ class LazyModel:
             elif member.is_file() and member.suffix == ".m":
                 if member.name == "Contents.m":
                     contentsfile = self._collect_path(member)
-                    contentsfile.docstring = model.docstring
+                    model.docstring = contentsfile.docstring
                 else:
                     submodel = self._path_collection._models[member].model()
                     if submodel is not None:
                         model.members[submodel.name] = submodel
+
+        if model.docstring is None:
+            model.docstring = self._collect_readme_md(path, model)
+
         return model
+
+    def _collect_readme_md(self, path, parent: MatlabMixin) -> Docstring | None:
+
+        if (path / "README.md").exists():
+            readme = path / "README.md"
+        elif (path / "readme.md").exists():
+            readme = path / "readme.md"
+        else:
+            return None
+        
+        with open(readme, "r") as file:
+            content = file.read()
+        return Docstring(content, parent=parent)

mkdocstrings_handlers/matlab/models.py

@@ -558,3 +558,7 @@ class Namespace(MatlabMixin, PathMixin, Module, MatlabObject):
 
     def __repr__(self) -> str:
         return f"Namespace({self.path!r})"
+
+    @property
+    def is_internal(self) -> bool:
+        return any(part == "+internal" for part in self.filepath.parts) if self.filepath else False

{mkdocstrings_matlab-0.3.0.dist-info → mkdocstrings_matlab-0.3.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocstrings-matlab
-Version: 0.3.0
+Version: 0.3.1
 Summary: A MATLAB handler for mkdocstrings
 Author-email: Mark Hu <watermarkhu@gmail.com>
 License: ISC

{mkdocstrings_matlab-0.3.0.dist-info → mkdocstrings_matlab-0.3.1.dist-info}/RECORD

@@ -2,14 +2,14 @@ mkdocs_material_matlab/__init__.py,sha256=9pmrwWbkIyr0T7qvADbsz3OR5bB3rWb231e6JS
 mkdocs_material_matlab/mkdocs_material_matlab.py,sha256=s7vI1lv6hD8s7kDHWBfYKgN6EcldyUstGYJ45sA-VWY,850
 mkdocs_material_matlab/css/style.css,sha256=iVTPIKljgvK899jEQylD7yu9yjKfrVE_4GLaITjhk4g,132
 mkdocstrings_handlers/matlab/__init__.py,sha256=laA2bEP5rxdIWBLmfLiKKu7ChZ_HzCe-VeRvxmUTqww,128
-mkdocstrings_handlers/matlab/collect.py,sha256=bPQ8e7ENzGA6b_0PGOeZSRoQozwvT7dQLZI_CoglTuk,21815
+mkdocstrings_handlers/matlab/collect.py,sha256=2dqYIQP7S8kHShH8o0cVFkIgTHL8EAoTV7OmtA4NnEs,23020
 mkdocstrings_handlers/matlab/enums.py,sha256=lr3wLlhPxyBym3O7Rt0cLUZYqPCz6wQ2PYBibLKLTek,982
 mkdocstrings_handlers/matlab/handler.py,sha256=w_k3jBaBwv3CYxGOg6cELHE1Z8p-nmxPEk-201tjLtE,15367
-mkdocstrings_handlers/matlab/models.py,sha256=fMDdzrANnsnkYl-Q8QYFgM3OxtnbJwKcKtVFFBKio_c,17363
+mkdocstrings_handlers/matlab/models.py,sha256=y4ozShL4edxKKgb6jqBAfSI8Z9MEygSbEDnTDfBnRtk,17513
 mkdocstrings_handlers/matlab/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mkdocstrings_handlers/matlab/treesitter.py,sha256=dW4RcSep4A0L505WbAE9PGL2sTqizX7nhXLwQqbJh8Y,21726
-mkdocstrings_matlab-0.3.0.dist-info/METADATA,sha256=qctHYlZnFKUY3j4C4_JTBO-G-qcG2foYWHpwLFtxUYA,4097
-mkdocstrings_matlab-0.3.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mkdocstrings_matlab-0.3.0.dist-info/entry_points.txt,sha256=qUZFuB2TKh7KPlg4dR2npfbNgNExw6O6j1vF276PtPw,92
-mkdocstrings_matlab-0.3.0.dist-info/licenses/LICENSE,sha256=z5Ee0lckFL6K9LhLKftDu0JDl2Uie24Po20IclVk2SI,743
-mkdocstrings_matlab-0.3.0.dist-info/RECORD,,
+mkdocstrings_matlab-0.3.1.dist-info/METADATA,sha256=R43NGKuEohkr8gSC5bXCW_CEt7ULYTx-yij9DPEQBUo,4097
+mkdocstrings_matlab-0.3.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mkdocstrings_matlab-0.3.1.dist-info/entry_points.txt,sha256=qUZFuB2TKh7KPlg4dR2npfbNgNExw6O6j1vF276PtPw,92
+mkdocstrings_matlab-0.3.1.dist-info/licenses/LICENSE,sha256=z5Ee0lckFL6K9LhLKftDu0JDl2Uie24Po20IclVk2SI,743
+mkdocstrings_matlab-0.3.1.dist-info/RECORD,,