mkdocstrings-matlab 0.6.0__py3-none-any.whl → 0.8.0__py3-none-any.whl

Sign up to get free protection for your applications and to get access to all the features.
Files changed (22) hide show
  1. mkdocstrings_handlers/matlab/collect.py +84 -32
  2. mkdocstrings_handlers/matlab/handler.py +31 -10
  3. mkdocstrings_handlers/matlab/models.py +60 -28
  4. mkdocstrings_handlers/matlab/templates/material/children.html.jinja +172 -0
  5. mkdocstrings_handlers/matlab/templates/material/docstring/namespaces.html.jinja +86 -0
  6. mkdocstrings_handlers/matlab/templates/material/docstring/properties.html.jinja +109 -0
  7. mkdocstrings_handlers/matlab/templates/material/folder.html.jinja +121 -0
  8. mkdocstrings_handlers/matlab/templates/material/namespace.html.jinja +121 -0
  9. mkdocstrings_handlers/matlab/templates/material/property.html.jinja +120 -0
  10. mkdocstrings_handlers/matlab/templates/material/style.css +26 -0
  11. mkdocstrings_handlers/matlab/templates/material/summary/namespaces.html.jinja +21 -0
  12. mkdocstrings_handlers/matlab/templates/material/summary/properties.html.jinja +21 -0
  13. mkdocstrings_handlers/matlab/templates/material/summary.html.jinja +26 -0
  14. {mkdocstrings_matlab-0.6.0.dist-info → mkdocstrings_matlab-0.8.0.dist-info}/METADATA +9 -9
  15. mkdocstrings_matlab-0.8.0.dist-info/RECORD +21 -0
  16. mkdocs_material_matlab/__init__.py +0 -4
  17. mkdocs_material_matlab/css/style.css +0 -7
  18. mkdocs_material_matlab/mkdocs_material_matlab.py +0 -20
  19. mkdocstrings_matlab-0.6.0.dist-info/RECORD +0 -15
  20. mkdocstrings_matlab-0.6.0.dist-info/entry_points.txt +0 -2
  21. {mkdocstrings_matlab-0.6.0.dist-info → mkdocstrings_matlab-0.8.0.dist-info}/WHEEL +0 -0
  22. {mkdocstrings_matlab-0.6.0.dist-info → mkdocstrings_matlab-0.8.0.dist-info}/licenses/LICENSE +0 -0
@@ -1,9 +1,9 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mkdocstrings-matlab
3
- Version: 0.6.0
3
+ Version: 0.8.0
4
4
  Summary: A MATLAB handler for mkdocstrings
5
5
  Author-email: Mark Hu <watermarkhu@gmail.com>
6
- License: ISC
6
+ License: MIT
7
7
  License-File: LICENSE
8
8
  Classifier: Development Status :: 4 - Beta
9
9
  Classifier: Intended Audience :: Developers
@@ -21,11 +21,11 @@ Classifier: Topic :: Software Development :: Documentation
21
21
  Classifier: Topic :: Utilities
22
22
  Classifier: Typing :: Typed
23
23
  Requires-Python: >=3.10
24
- Requires-Dist: charset-normalizer>=3.3.2
24
+ Requires-Dist: charset-normalizer==3.4.1
25
25
  Requires-Dist: mkdocstrings-python==1.13.0
26
26
  Requires-Dist: mkdocstrings==0.27.0
27
- Requires-Dist: tree-sitter-matlab>=1.0.2
28
- Requires-Dist: tree-sitter>=0.23.2
27
+ Requires-Dist: tree-sitter-matlab==1.0.3
28
+ Requires-Dist: tree-sitter==0.23.2
29
29
  Description-Content-Type: text/markdown
30
30
 
31
31
  <!-- --8<-- [start:header] -->
@@ -40,7 +40,7 @@ Description-Content-Type: text/markdown
40
40
  [![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://watermarkhu.nl/mkdocstrings-matlab)
41
41
  [![pypi version](https://img.shields.io/pypi/v/mkdocstrings-matlab.svg)](https://pypi.org/project/mkdocstrings-matlab/)
42
42
 
43
- The MATLAB handler uses [Tree-sitter](https://tree-sitter.github.io/tree-sitter/) and its [MATLAB parser](https://github.com/acristoffers/tree-sitter-matlab) to collect documentation from MATLAB source code. Via the python bindings the Abstract Syntax Tree (AST) of the source code is traversed to extract useful information. The imported objected are imported as custom [Griffe](https://mkdocstrings.github.io/griffe/) objects and mocked for the [python handler](https://mkdocstrings.github.io/python/).
43
+ The MATLAB handler uses [Tree-sitter](https://tree-sitter.github.io/tree-sitter/) and its [MATLAB parser](https://github.com/acristoffers/tree-sitter-matlab) to collect documentation from MATLAB source code. The AST information are imported as custom [Griffe](https://mkdocstrings.github.io/griffe/) objects and mocked for the [python handler](https://mkdocstrings.github.io/python/).
44
44
 
45
45
 
46
46
  You can install this handler by specifying it as a dependency:
@@ -64,10 +64,10 @@ dependencies = [
64
64
 
65
65
  - **Support for argument validation blocks:** Tree-sitter collects your [function and method argument validation](https://mathworks.com/help/matlab/matlab_prog/function-argument-validation-1.html)
66
66
  blocks to display input and output argument types and default values.
67
- It is even able to automatically add cross-references o other objects from your API.
67
+ It is even able to automatically add cross-references to other objects from your API.
68
68
 
69
- - **Recursive documentation of MATLAB [namespaces](https://mathworks.com/help/matlab/matlab_oop/namespaces.html):**
70
- just add `+` to the identifer, and you get the full namespace docs. You don't need to inject documentation for each class, function, and script. Additionaly, the parent namespace documentation will be either extracted from the `Contents.m` or the `readme.md` file at the root of the namespace.
69
+ - **Recursive documentation of MATLAB [namespaces](https://mathworks.com/help/matlab/matlab_oop/namespaces.html) and folders:**
70
+ just add `+` to the identifer for namespaces or the relative path for folder, and you get documentation for the entire directory. You don't need to inject documentation for each class, function, and script. Additionaly, the directory documentation will be either extracted from the `Contents.m` or the `readme.md` file at the root of the namespace or folder.
71
71
 
72
72
  - **Support for documented properties:** properties definitions followed by a docstring will be recognized in classes.
73
73
 
@@ -0,0 +1,21 @@
1
+ mkdocstrings_handlers/matlab/__init__.py,sha256=w5R9cGtqeJF0GUP_Jc_ad8FnS4FpbutnmHvzVRlohPM,1124
2
+ mkdocstrings_handlers/matlab/collect.py,sha256=WXuRIDYL0T1fKv1MwwOC6uWAB80PxRCs4uYDgOHiQcg,29749
3
+ mkdocstrings_handlers/matlab/enums.py,sha256=lr3wLlhPxyBym3O7Rt0cLUZYqPCz6wQ2PYBibLKLTek,982
4
+ mkdocstrings_handlers/matlab/handler.py,sha256=kHyBrHTvZJBXVgondNcbjyeRna0pMmfCnIDVk7ru3oQ,19708
5
+ mkdocstrings_handlers/matlab/models.py,sha256=L3x17w9sqFBNMEJ-3rlEbPQpHRGHl2WY_xHE26NLHsQ,19232
6
+ mkdocstrings_handlers/matlab/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
7
+ mkdocstrings_handlers/matlab/treesitter.py,sha256=FkWGuH7EmE_aO2qub5-_NnOVacYeXW353SkB7cNMlRo,21820
8
+ mkdocstrings_handlers/matlab/templates/material/children.html.jinja,sha256=BydWtrB7KR27tzjbzSOZZvv1srEDUHox-vTy4RRE9zk,6456
9
+ mkdocstrings_handlers/matlab/templates/material/folder.html.jinja,sha256=cWgaQH4EDFgL3eEIv0NRwRXYvtn9pp4tW7ntv3X2nM8,4076
10
+ mkdocstrings_handlers/matlab/templates/material/namespace.html.jinja,sha256=NNqL14Z01Lhx6WwK2NxusY-cwcY7HHie07L_VEt8dws,4085
11
+ mkdocstrings_handlers/matlab/templates/material/property.html.jinja,sha256=anYCQM6AcyGgEApDC97TqzWlgVNtc1I_Ys1xyvUXye0,4396
12
+ mkdocstrings_handlers/matlab/templates/material/style.css,sha256=0_Bs5_0fHM3X9l-IU1VHbZfhNA7nUw4SKEH_3zRhCDw,557
13
+ mkdocstrings_handlers/matlab/templates/material/summary.html.jinja,sha256=hVbQGxbMWd6fl01afbg0LhfYCJD1IRPmmCdcDBxU650,735
14
+ mkdocstrings_handlers/matlab/templates/material/docstring/namespaces.html.jinja,sha256=jLtPxNNfZFO3-Ozy0eHqxHvKmlPCODML_5xt8SJr8UE,3165
15
+ mkdocstrings_handlers/matlab/templates/material/docstring/properties.html.jinja,sha256=9ckdYymLlB5sflwYEaEPAQLJuVWF8nezMCV5JnanXVA,4165
16
+ mkdocstrings_handlers/matlab/templates/material/summary/namespaces.html.jinja,sha256=0vVlUB6oh-A7cpXbuDLOQLxTubyb_DisdOKm062WNMs,650
17
+ mkdocstrings_handlers/matlab/templates/material/summary/properties.html.jinja,sha256=nyPaELf9qPCxJQFxK1MWYK4fPwsk5VESh9xKHLtd-XE,643
18
+ mkdocstrings_matlab-0.8.0.dist-info/METADATA,sha256=Y3FVSH3Jx3tgfzfh8bmcoTQLgdtmbn70lyLzprHO9Es,4736
19
+ mkdocstrings_matlab-0.8.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
20
+ mkdocstrings_matlab-0.8.0.dist-info/licenses/LICENSE,sha256=TZQpwBuA3KLH56--XDAY2Qwo9gGdxeTITYhMOylmYhg,743
21
+ mkdocstrings_matlab-0.8.0.dist-info/RECORD,,
@@ -1,4 +0,0 @@
1
- from .mkdocs_material_matlab import MkdocsMaterialMatlabPlugin
2
-
3
-
4
- __all__ = ["MkdocsMaterialMatlabPlugin"]
@@ -1,7 +0,0 @@
1
- code.doc-symbol-attribute::after {
2
- content: "prop" !important;
3
- }
4
-
5
- code.doc-symbol-module::after {
6
- content: "name" !important;
7
- }
@@ -1,20 +0,0 @@
1
- from mkdocs.plugins import BasePlugin
2
- import os
3
-
4
-
5
- class MkdocsMaterialMatlabPlugin(BasePlugin):
6
- def on_config(self, config):
7
- # Ensure the custom CSS file is included in the extra_css list
8
- css_path = "css/style.css"
9
- if css_path not in config["extra_css"]:
10
- config["extra_css"].append(css_path)
11
- return config
12
-
13
- def on_post_build(self, *, config):
14
- # Ensure the custom CSS file is copied to the output directory
15
- css_src_path = os.path.join(os.path.dirname(__file__), "css", "style.css")
16
- css_dest_path = os.path.join(config["site_dir"], "css", "style.css")
17
- os.makedirs(os.path.dirname(css_dest_path), exist_ok=True)
18
- with open(css_src_path, "rb") as src_file:
19
- with open(css_dest_path, "wb") as dest_file:
20
- dest_file.write(src_file.read())
@@ -1,15 +0,0 @@
1
- mkdocs_material_matlab/__init__.py,sha256=9pmrwWbkIyr0T7qvADbsz3OR5bB3rWb231e6JSnwA7o,106
2
- mkdocs_material_matlab/mkdocs_material_matlab.py,sha256=s7vI1lv6hD8s7kDHWBfYKgN6EcldyUstGYJ45sA-VWY,850
3
- mkdocs_material_matlab/css/style.css,sha256=iVTPIKljgvK899jEQylD7yu9yjKfrVE_4GLaITjhk4g,132
4
- mkdocstrings_handlers/matlab/__init__.py,sha256=w5R9cGtqeJF0GUP_Jc_ad8FnS4FpbutnmHvzVRlohPM,1124
5
- mkdocstrings_handlers/matlab/collect.py,sha256=i9OudR4oJX-ELPL4GVv_AJSA5N6iZk-zTSY58dfWGNw,27512
6
- mkdocstrings_handlers/matlab/enums.py,sha256=lr3wLlhPxyBym3O7Rt0cLUZYqPCz6wQ2PYBibLKLTek,982
7
- mkdocstrings_handlers/matlab/handler.py,sha256=koMpRSftxQbI8R2l0fGfBOe36yUkne6lATwDauBa5w0,18676
8
- mkdocstrings_handlers/matlab/models.py,sha256=7WWZ-nLaL0dWF-vOYWP-O3kNEGKtMfa5DK_J23mkhhU,18174
9
- mkdocstrings_handlers/matlab/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
10
- mkdocstrings_handlers/matlab/treesitter.py,sha256=FkWGuH7EmE_aO2qub5-_NnOVacYeXW353SkB7cNMlRo,21820
11
- mkdocstrings_matlab-0.6.0.dist-info/METADATA,sha256=3Q5DCapIgie22A0okETTVhAkZKtde7wJ_G5W4SgRkJM,4779
12
- mkdocstrings_matlab-0.6.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
13
- mkdocstrings_matlab-0.6.0.dist-info/entry_points.txt,sha256=qUZFuB2TKh7KPlg4dR2npfbNgNExw6O6j1vF276PtPw,92
14
- mkdocstrings_matlab-0.6.0.dist-info/licenses/LICENSE,sha256=TZQpwBuA3KLH56--XDAY2Qwo9gGdxeTITYhMOylmYhg,743
15
- mkdocstrings_matlab-0.6.0.dist-info/RECORD,,
@@ -1,2 +0,0 @@
1
- [mkdocs.plugins]
2
- mkdocs-material-matlab = mkdocs_material_matlab:MkdocsMaterialMatlabPlugin