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

mkdocstrings_handlers/matlab/collect.py

@@ -200,7 +200,7 @@ class PathCollection(ModulesCollection):
             return model
         return None
 
-    def update_model(self, model: MatlabMixin, config: Mapping):
+    def update_model(self, model: MatlabMixin, config: Mapping) -> MatlabMixin:
         """
         Update the given model based on the provided configuration.
 
@@ -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/handler.py

@@ -21,7 +21,10 @@ class MatlabHandler(BaseHandler):
     """Whether this handler is interested in enabling the creation of the `objects.inv` Sphinx inventory file."""
     fallback_theme = "material"
     """The fallback theme."""
-    fallback_config: ClassVar[dict] = {"fallback": True}
+    fallback_config: ClassVar[dict] = {
+        "fallback": True,
+        "merge_constructor_into_class": True,
+    }
     """The configuration used to collect item during autorefs fallback."""
     default_config: ClassVar[dict] = {
         # General options
@@ -51,7 +54,7 @@ class MatlabHandler(BaseHandler):
         "docstring_options": {},
         "docstring_section_style": "table",
         "create_from_argument_blocks": False,
-        "merge_constructor_into_class": False,
+        "merge_constructor_into_class": True,
         "show_if_no_docstring": False,
         "show_docstring_attributes": True,
         "show_docstring_functions": True,

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.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocstrings-matlab
-Version: 0.3.0
+Version: 0.3.2
 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.2.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=9DKuE5Q6kXcNm6coQZnmtTNRzMNIeILlljMd1GgVEKk,23035
 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/handler.py,sha256=KmQuCuaoS-K8HR2peS4LfvBUaJT4a8-428-3ZiHRdYY,15427
+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.2.dist-info/METADATA,sha256=c1mVS2_ocxD-sPdaTEWYauALHXUHoF1qVtnxdLl1k0M,4097
+mkdocstrings_matlab-0.3.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mkdocstrings_matlab-0.3.2.dist-info/entry_points.txt,sha256=qUZFuB2TKh7KPlg4dR2npfbNgNExw6O6j1vF276PtPw,92
+mkdocstrings_matlab-0.3.2.dist-info/licenses/LICENSE,sha256=z5Ee0lckFL6K9LhLKftDu0JDl2Uie24Po20IclVk2SI,743
+mkdocstrings_matlab-0.3.2.dist-info/RECORD,,