mknodes 2.0.0a2__tar.gz → 2.0.0a4__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (279) hide show
  1. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/PKG-INFO +1 -1
  2. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/__init__.py +2 -2
  3. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkdiagram/__init__.py +2 -3
  4. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/info/folderinfo.py +2 -1
  5. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/info/license.py +19 -19
  6. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/navs/mknav.py +4 -2
  7. mknodes-2.0.0a4/mknodes/navs/navigation.py +239 -0
  8. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/navs/navparser.py +9 -11
  9. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/navs/navrouter.py +65 -30
  10. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkbadge/__init__.py +12 -5
  11. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkbadge/metadata.toml +1 -1
  12. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkchangelog/__init__.py +3 -1
  13. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkclassdiagram/__init__.py +2 -3
  14. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkdevtools/__init__.py +4 -8
  15. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mklicense/__init__.py +1 -1
  16. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkllm/__init__.py +9 -9
  17. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkllm/metadata.toml +1 -1
  18. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkpipdeptree/__init__.py +6 -4
  19. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkpydeps/__init__.py +9 -8
  20. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkpydeps/metadata.toml +1 -1
  21. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mktreeview/__init__.py +15 -10
  22. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/theme/materialtheme/__init__.py +8 -8
  23. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/theme/mkblog.py +1 -1
  24. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/pyproject.toml +1 -1
  25. mknodes-2.0.0a2/mknodes/navs/navigation.py +0 -133
  26. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/LICENSE +0 -0
  27. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/README.md +0 -0
  28. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/__init__.py +0 -0
  29. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/_mkdocstrings/__init__.py +0 -0
  30. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/_mkdocstrings/metadata.toml +0 -0
  31. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkadmonition/__init__.py +0 -0
  32. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkadmonition/metadata.toml +0 -0
  33. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkannotations/__init__.py +0 -0
  34. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkannotations/metadata.toml +0 -0
  35. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkbasetable/__init__.py +0 -0
  36. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkbinaryimage/__init__.py +0 -0
  37. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkbinaryimage/metadata.toml +0 -0
  38. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkblock/__init__.py +0 -0
  39. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkblockquote/__init__.py +0 -0
  40. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkblockquote/metadata.toml +0 -0
  41. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkcard/__init__.py +0 -0
  42. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkcard/grid.css +0 -0
  43. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkcard/metadata.toml +0 -0
  44. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkclidoc/__init__.py +0 -0
  45. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkclidoc/metadata.toml +0 -0
  46. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkcode/__init__.py +0 -0
  47. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkcode/metadata.toml +0 -0
  48. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkcompactadmonition/__init__.py +0 -0
  49. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkcompactadmonition/compactadmonition.css +0 -0
  50. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkcompactadmonition/metadata.toml +0 -0
  51. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkcontainer/__init__.py +0 -0
  52. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkcontainer/metadata.toml +0 -0
  53. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkcritic/__init__.py +0 -0
  54. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkcritic/metadata.toml +0 -0
  55. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkdataclassinfo/__init__.py +0 -0
  56. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkdataclassinfo/metadata.toml +0 -0
  57. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkdefinitionlist/__init__.py +0 -0
  58. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkdefinitionlist/metadata.toml +0 -0
  59. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkdetailsblock/__init__.py +0 -0
  60. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkdetailsblock/metadata.toml +0 -0
  61. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkdiagram/metadata.toml +0 -0
  62. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkfootnotes/__init__.py +0 -0
  63. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkfootnotes/metadata.toml +0 -0
  64. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkheader/__init__.py +0 -0
  65. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkheader/metadata.toml +0 -0
  66. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkhtmlblock/__init__.py +0 -0
  67. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkhtmlblock/metadata.toml +0 -0
  68. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkhtmltable/__init__.py +0 -0
  69. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkhtmltable/metadata.toml +0 -0
  70. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkicon/__init__.py +0 -0
  71. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkicon/metadata.toml +0 -0
  72. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkiframe/__init__.py +0 -0
  73. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkiframe/metadata.toml +0 -0
  74. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkimage/__init__.py +0 -0
  75. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkimage/metadata.toml +0 -0
  76. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkimagecompare/__init__.py +0 -0
  77. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkimagecompare/metadata.toml +0 -0
  78. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkimageslideshow/__init__.py +0 -0
  79. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkimageslideshow/metadata.toml +0 -0
  80. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkjupyterlite/__init__.py +0 -0
  81. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkjupyterlite/metadata.toml +0 -0
  82. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkkeys/__init__.py +0 -0
  83. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkkeys/metadata.toml +0 -0
  84. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mklink/__init__.py +0 -0
  85. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mklink/metadata.toml +0 -0
  86. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mklist/__init__.py +0 -0
  87. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mklist/metadata.toml +0 -0
  88. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkmaterialbadge/__init__.py +0 -0
  89. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkmaterialbadge/materialbadge.css +0 -0
  90. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkmaterialbadge/metadata.toml +0 -0
  91. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mknode/__init__.py +0 -0
  92. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkprogressbar/__init__.py +0 -0
  93. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkprogressbar/metadata.toml +0 -0
  94. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkprogressbar/progressbar.css +0 -0
  95. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkpyodide/__init__.py +0 -0
  96. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkpyodide/metadata.toml +0 -0
  97. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkpyscript/__init__.py +0 -0
  98. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkpyscript/metadata.toml +0 -0
  99. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkshowcase/__init__.py +0 -0
  100. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkshowcase/metadata.toml +0 -0
  101. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkspeechbubble/__init__.py +0 -0
  102. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkspeechbubble/metadata.toml +0 -0
  103. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mkspeechbubble/speechbubble.css +0 -0
  104. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mktabbed/__init__.py +0 -0
  105. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mktabbed/metadata.toml +0 -0
  106. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mktabbedblocks/__init__.py +0 -0
  107. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mktabbedblocks/metadata.toml +0 -0
  108. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mktabcontainer.py +0 -0
  109. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mktable/__init__.py +0 -0
  110. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mktable/metadata.toml +0 -0
  111. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mktabs/__init__.py +0 -0
  112. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mktabs/mktab.toml +0 -0
  113. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mktasklist/__init__.py +0 -0
  114. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mktasklist/metadata.toml +0 -0
  115. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mktext/__init__.py +0 -0
  116. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mktext/metadata.toml +0 -0
  117. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mktimeline/__init__.py +0 -0
  118. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mktimeline/metadata.toml +0 -0
  119. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mktimeline/timeline.css +0 -0
  120. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/mktimeline/timeline.js +0 -0
  121. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/basenodes/processors/__init__.py +0 -0
  122. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/data/__init__.py +0 -0
  123. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/data/admonition.py +0 -0
  124. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/data/badges.py +0 -0
  125. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/data/buildsystems.py +0 -0
  126. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/data/commitconventions.py +0 -0
  127. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/data/datatypes.py +0 -0
  128. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/data/eventplugins.py +0 -0
  129. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/data/fences.py +0 -0
  130. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/data/installmethods.py +0 -0
  131. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/data/taskrunners.py +0 -0
  132. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/data/tools.py +0 -0
  133. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/data/treestyles.py +0 -0
  134. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/extranodes/__init__.py +0 -0
  135. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/extranodes/mkcodeimage/__init__.py +0 -0
  136. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/extranodes/mkcodeimage/metadata.toml +0 -0
  137. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/extranodes/mkgrid/__init__.py +0 -0
  138. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/extranodes/mkgrid/metadata.toml +0 -0
  139. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/extranodes/mkprettyprint/__init__.py +0 -0
  140. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/extranodes/mkprettyprint/metadata.toml +0 -0
  141. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/extranodes/mksnippet/__init__.py +0 -0
  142. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/extranodes/mksnippet/metadata.toml +0 -0
  143. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/info/__init__.py +0 -0
  144. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/info/configfile.py +0 -0
  145. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/info/contexts.py +0 -0
  146. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/info/gitrepository.py +0 -0
  147. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/info/grifferegistry.py +0 -0
  148. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/info/linkprovider.py +0 -0
  149. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/info/mkdocsconfigfile.py +0 -0
  150. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/info/nodefile.py +0 -0
  151. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/info/packageinfo.py +0 -0
  152. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/info/packageregistry.py +0 -0
  153. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/info/pyproject.py +0 -0
  154. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/info/reporegistry.py +0 -0
  155. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/jinja/__init__.py +0 -0
  156. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/jinja/filters.py +0 -0
  157. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/jinja/nodeenvironment.py +0 -0
  158. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/manual/__init__.py +0 -0
  159. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/manual/a_quick_tour.py +0 -0
  160. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/manual/dev_section.py +0 -0
  161. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/manual/get_started_section.py +0 -0
  162. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/manual/github_index.py +0 -0
  163. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/manual/navs_section.py +0 -0
  164. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/manual/nodes_section.py +0 -0
  165. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/manual/page_section.py +0 -0
  166. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/manual/root.py +0 -0
  167. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/manual/routing.py +0 -0
  168. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/manual/templating_section.py +0 -0
  169. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/mdlib/__init__.py +0 -0
  170. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/mdlib/mdconverter.py +0 -0
  171. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/navs/__init__.py +0 -0
  172. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/navs/mkdoc.py +0 -0
  173. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/navs/navbuilder.py +0 -0
  174. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/navs/router.py +0 -0
  175. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/nodemods/__init__.py +0 -0
  176. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/nodemods/mod.py +0 -0
  177. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/nodemods/modmanager.py +0 -0
  178. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/nodemods/parallax.py +0 -0
  179. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/nodemods/parallax.toml +0 -0
  180. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/nodemods/scrollreveal.py +0 -0
  181. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/nodemods/scrollreveal.toml +0 -0
  182. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/pages/__init__.py +0 -0
  183. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/pages/metadata.py +0 -0
  184. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/pages/mkclasspage/__init__.py +0 -0
  185. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/pages/mkclasspage/classpage.md +0 -0
  186. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/pages/mkclasspage/classpage_tabbed.md +0 -0
  187. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/pages/mkmodulepage/__init__.py +0 -0
  188. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/pages/mkmodulepage/modulepage.md +0 -0
  189. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/pages/mkpage.py +0 -0
  190. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/pages/mktemplatepage.py +0 -0
  191. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/pages/pagetemplate.py +0 -0
  192. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/pages/templateblocks.py +0 -0
  193. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/pages/templateregistry.py +0 -0
  194. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/pages/toc.py +0 -0
  195. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/paths.py +0 -0
  196. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/py.typed +0 -0
  197. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/resources/css/animated.css +0 -0
  198. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/resources/css/hero.css +0 -0
  199. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/resources/css/material_css_extra.jinja +0 -0
  200. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/resources/css/theme_material.css +0 -0
  201. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/resources/css/theme_mkdocs.css +0 -0
  202. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/resources/filters.toml +0 -0
  203. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/resources/js/tablesort.js +0 -0
  204. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/resources/python_objects.inv +0 -0
  205. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/resources/toolfiles/tool_black.toml +0 -0
  206. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/resources/toolfiles/tool_coverage.toml +0 -0
  207. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/resources/toolfiles/tool_mkdocs.toml +0 -0
  208. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/resources/toolfiles/tool_mypy.toml +0 -0
  209. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/resources/toolfiles/tool_precommit.toml +0 -0
  210. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/resources/toolfiles/tool_pyright.toml +0 -0
  211. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/resources/toolfiles/tool_ruff.toml +0 -0
  212. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/__init__.py +0 -0
  213. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkchangelog/metadata.toml +0 -0
  214. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkclassdiagram/metadata.toml +0 -0
  215. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkclasstable/__init__.py +0 -0
  216. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkclasstable/metadata.toml +0 -0
  217. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkcodeofconduct/__init__.py +0 -0
  218. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkcodeofconduct/metadata.toml +0 -0
  219. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkcommandoutput/__init__.py +0 -0
  220. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkcommandoutput/metadata.toml +0 -0
  221. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkcommandoutput/terminal.css +0 -0
  222. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkcommentedcode/__init__.py +0 -0
  223. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkcommentedcode/metadata.toml +0 -0
  224. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkcommitconventions/__init__.py +0 -0
  225. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkcommitconventions/metadata.toml +0 -0
  226. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkconfigsetting/__init__.py +0 -0
  227. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkconfigsetting/metadata.toml +0 -0
  228. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkdependencytable/__init__.py +0 -0
  229. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkdependencytable/metadata.toml +0 -0
  230. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkdevenvsetup/__init__.py +0 -0
  231. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkdevenvsetup/metadata.toml +0 -0
  232. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkdevtools/metadata.toml +0 -0
  233. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkinclude/__init__.py +0 -0
  234. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkinclude/metadata.toml +0 -0
  235. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkinstallguide/__init__.py +0 -0
  236. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkinstallguide/metadata.toml +0 -0
  237. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mklicense/metadata.toml +0 -0
  238. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkmetadatabadges/__init__.py +0 -0
  239. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkmetadatabadges/metadata.toml +0 -0
  240. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkmoduletable/__init__.py +0 -0
  241. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkmoduletable/metadata.toml +0 -0
  242. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkpipdeptree/metadata.toml +0 -0
  243. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkpluginflow/__init__.py +0 -0
  244. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkpluginflow/metadata.toml +0 -0
  245. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkreprrawrendered/__init__.py +0 -0
  246. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkreprrawrendered/metadata.toml +0 -0
  247. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkshields/__init__.py +0 -0
  248. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mkshields/metadata.toml +0 -0
  249. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mktemplate/__init__.py +0 -0
  250. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mktemplate/metadata.toml +0 -0
  251. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mktemplatetable/__init__.py +0 -0
  252. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mktemplatetable/metadata.toml +0 -0
  253. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/templatenodes/mktreeview/metadata.toml +0 -0
  254. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/theme/__init__.py +0 -0
  255. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/theme/colortheme.py +0 -0
  256. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/theme/materialtheme/palette.py +0 -0
  257. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/theme/mkgitblog.py +0 -0
  258. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/theme/theme.py +0 -0
  259. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/treelib/__init__.py +0 -0
  260. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/treelib/treeprint.py +0 -0
  261. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/__init__.py +0 -0
  262. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/annotationappender.py +0 -0
  263. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/classhelpers.py +0 -0
  264. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/color.py +0 -0
  265. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/connector.py +0 -0
  266. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/coroutines.py +0 -0
  267. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/downloadhelpers.py +0 -0
  268. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/helpers.py +0 -0
  269. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/icons.py +0 -0
  270. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/inspecthelpers.py +0 -0
  271. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/inventorymanager.py +0 -0
  272. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/linkreplacer.py +0 -0
  273. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/log.py +0 -0
  274. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/packagehelpers.py +0 -0
  275. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/pathhelpers.py +0 -0
  276. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/reprhelpers.py +0 -0
  277. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/resources.py +0 -0
  278. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/superdict.py +0 -0
  279. {mknodes-2.0.0a2 → mknodes-2.0.0a4}/mknodes/utils/xmlhelpers.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: mknodes
3
- Version: 2.0.0a2
3
+ Version: 2.0.0a4
4
4
  Summary: Don't write docs. Code them.
5
5
  Keywords: docs,docstrings,documentation,framework,internet,markdown
6
6
  Author: Philipp Temminghoff
@@ -90,7 +90,7 @@ from .theme.theme import Theme
90
90
  from .theme.materialtheme import MaterialTheme
91
91
 
92
92
 
93
- def parse(project=None, **kwargs):
93
+ async def parse(project=None, **kwargs):
94
94
  if project:
95
95
  kwargs["context"] = project.context
96
96
  from mknodes.navs.navparser import parse_new_style_nav
@@ -98,7 +98,7 @@ def parse(project=None, **kwargs):
98
98
  pages = kwargs.pop("pages")
99
99
  root_nav = MkNav(**kwargs)
100
100
  project.root = root_nav
101
- parse_new_style_nav(root_nav, pages)
101
+ await parse_new_style_nav(root_nav, pages)
102
102
  return root_nav
103
103
 
104
104
 
@@ -55,10 +55,9 @@ class MkDiagram(mkcode.MkCode):
55
55
 
56
56
  async def get_text(self) -> str:
57
57
  """MkCode override."""
58
- return f"graph {self.direction}\n{self.mermaid_code}"
58
+ return f"graph {self.direction}\n{await self.get_mermaid_code()}"
59
59
 
60
- @property
61
- def mermaid_code(self) -> str:
60
+ async def get_mermaid_code(self) -> str:
62
61
  """Return code block, excluding fences and (graph type direction) line.
63
62
 
64
63
  Can be overriden by subclasses.
@@ -8,6 +8,7 @@ import pathlib
8
8
  import re
9
9
  from typing import TYPE_CHECKING
10
10
 
11
+ from anyenv import run_sync
11
12
  import epregistry
12
13
  import yamling
13
14
 
@@ -206,7 +207,7 @@ class FolderInfo:
206
207
  if self.license_file_path:
207
208
  return self.license_file_path.read_text(encoding="utf-8")
208
209
  if license_name := self.info.license_name:
209
- obj = lic.License.from_name(license_name)
210
+ obj = run_sync(lic.License.from_name(license_name))
210
211
  return obj.content
211
212
  return None
212
213
 
@@ -1,10 +1,12 @@
1
1
  from __future__ import annotations
2
2
 
3
3
  import dataclasses
4
- import functools
5
4
  import pathlib
6
5
  from typing import Any, Self
7
6
 
7
+ import anyenv
8
+ from anyio import functools as anyio_functools
9
+
8
10
  from mknodes.utils import log
9
11
 
10
12
 
@@ -12,11 +14,9 @@ logger = log.get_logger(__name__)
12
14
  DB_URL = "https://raw.githubusercontent.com/fsfe/reuse-tool/refs/heads/main/src/reuse/resources/licenses.json"
13
15
 
14
16
 
15
- @functools.cache
16
- def get_db() -> list[dict[str, Any]]:
17
- import anyenv
18
-
19
- response = anyenv.get_json_sync(DB_URL, return_type=dict, cache=True)
17
+ @anyio_functools.cache
18
+ async def get_db() -> list[dict[str, Any]]:
19
+ response = await anyenv.get_json(DB_URL, return_type=dict, cache=True)
20
20
  return response["licenses"]
21
21
 
22
22
 
@@ -30,20 +30,18 @@ class License:
30
30
  osi_approved: bool | None = None
31
31
 
32
32
  @classmethod
33
- def from_name(cls, name_or_id: str) -> Self:
33
+ async def from_name(cls, name_or_id: str) -> Self:
34
34
  """Get license based on license name.
35
35
 
36
36
  Args:
37
37
  name_or_id: Name or id of the license to get.
38
38
  """
39
- import anyenv
40
-
41
- db = get_db()
39
+ db = await get_db()
42
40
  name_or_id = name_or_id.lower()
43
41
  for lic in db:
44
42
  if name_or_id in {lic["name"].lower(), lic["licenseId"].lower()}:
45
43
  url = lic["detailsUrl"]
46
- response = anyenv.get_json_sync(url, return_type=dict[str, Any], cache=True)
44
+ response = await anyenv.get_json(url, return_type=dict[str, Any], cache=True)
47
45
  return cls(
48
46
  name=lic["name"],
49
47
  identifier=lic["licenseId"],
@@ -62,14 +60,16 @@ class License:
62
60
  path: Path to get license from.
63
61
  """
64
62
  p = pathlib.Path(path)
65
- return cls(
66
- path=str(p),
67
- content=p.read_text(encoding="utf-8"),
68
- name=p.name,
69
- identifier=p.name,
70
- )
63
+ content = p.read_text(encoding="utf-8")
64
+ return cls(path=str(p), content=content, name=p.name, identifier=p.name)
71
65
 
72
66
 
73
67
  if __name__ == "__main__":
74
- db = License.from_name("BSD-3-Clause")
75
- print(db)
68
+
69
+ async def main():
70
+ db = await License.from_name("BSD-3-Clause")
71
+ print(db)
72
+
73
+ import asyncio
74
+
75
+ asyncio.run(main())
@@ -101,13 +101,15 @@ class MkNav(mknode.MkNode):
101
101
 
102
102
  def get_children(self) -> list[navigation.NavSubType]: # type: ignore[override] # pyright: ignore[reportIncompatibleMethodOverride]
103
103
  """Return all child items from the navigation."""
104
- return self.nav.all_items
104
+ return self.nav.get_all_items()
105
105
 
106
106
  def set_children(self, items: list[navigation.NavSubType]) -> None: # type: ignore[override] # pyright: ignore[reportIncompatibleMethodOverride]
107
107
  """Set children by replacing the navigation."""
108
108
  from mknodes.navs import navigation as nav_module
109
109
 
110
- self.nav = nav_module.Navigation(items)
110
+ self.nav = nav_module.Navigation()
111
+ for item in items:
112
+ self.nav.register(item)
111
113
 
112
114
  def __add__(self, other: navigation.NavSubType):
113
115
  """Use this to to register MkNodes."""
@@ -0,0 +1,239 @@
1
+ from __future__ import annotations
2
+
3
+ import concurrent.futures
4
+ import inspect
5
+ import pathlib
6
+ from typing import TYPE_CHECKING, Any
7
+
8
+ from anyenv import run_sync
9
+
10
+ from mknodes.basenodes import mklink
11
+ from mknodes.navs import navbuilder
12
+ from mknodes.pages import mkpage
13
+
14
+
15
+ if TYPE_CHECKING:
16
+ from collections.abc import Awaitable, Callable, Iterator
17
+
18
+ from mknodes.navs import mknav
19
+
20
+ type NavSubType = mknav.MkNav | mkpage.MkPage | mklink.MkLink
21
+ type PendingFn = Callable[[], None] | Callable[[], Awaitable[None]]
22
+
23
+
24
+ class Navigation:
25
+ """An object representing a website structure.
26
+
27
+ Contains a mapping of path-tuple -> NavSubType (navs, pages, links).
28
+ Supports lazy execution of decorated route functions (sync and async).
29
+ """
30
+
31
+ def __init__(self, *, parallel: bool = False, max_workers: int | None = None) -> None:
32
+ self._data: dict[tuple[Any, ...], mknav.MkNav | mkpage.MkPage | mklink.MkLink] = {}
33
+ self._index_page: mkpage.MkPage | None = None
34
+ self._pending: list[PendingFn] = []
35
+ self._materialized: bool = True
36
+ self._parallel: bool = parallel
37
+ self._max_workers: int | None = max_workers
38
+
39
+ async def materialize(self) -> None:
40
+ """Execute all pending route registrations (async)."""
41
+ if self._materialized:
42
+ return
43
+ pending = self._pending
44
+ self._pending = []
45
+ self._materialized = True
46
+ for fn in pending:
47
+ result = fn()
48
+ if inspect.iscoroutine(result):
49
+ await result
50
+
51
+ def _ensure_materialized(self) -> None:
52
+ """Execute all pending route registrations."""
53
+ if self._materialized:
54
+ return
55
+ if self._parallel:
56
+ self._materialize_parallel()
57
+ else:
58
+ self._materialize_sequential()
59
+
60
+ def _materialize_sequential(self) -> None:
61
+ pending = self._pending
62
+ self._pending = []
63
+ self._materialized = True
64
+ for fn in pending:
65
+ result = fn()
66
+ if inspect.iscoroutine(result):
67
+ run_sync(result)
68
+
69
+ def _materialize_parallel(self) -> None:
70
+ pending = self._pending
71
+ self._pending = []
72
+ self._materialized = True
73
+
74
+ def run_fn(fn: PendingFn) -> None:
75
+ result = fn()
76
+ if inspect.iscoroutine(result):
77
+ run_sync(result)
78
+
79
+ with concurrent.futures.ThreadPoolExecutor(max_workers=self._max_workers) as executor:
80
+ futures = [executor.submit(run_fn, fn) for fn in pending]
81
+ concurrent.futures.wait(futures)
82
+ for future in futures:
83
+ future.result()
84
+
85
+ def add_pending(self, register_fn: PendingFn) -> None:
86
+ """Add a pending registration to be executed lazily."""
87
+ self._pending.append(register_fn)
88
+ self._materialized = False
89
+
90
+ @property
91
+ def index_page(self) -> mkpage.MkPage | None:
92
+ self._ensure_materialized()
93
+ return self._index_page
94
+
95
+ @index_page.setter
96
+ def index_page(self, value: mkpage.MkPage | None) -> None:
97
+ self._index_page = value
98
+
99
+ def __setitem__(
100
+ self,
101
+ index: tuple[Any, ...] | str,
102
+ node: mknav.MkNav | mkpage.MkPage | mklink.MkLink,
103
+ ) -> None:
104
+ """Put a Navigation-type instance into the registry."""
105
+ if isinstance(index, str):
106
+ index = (index,)
107
+ self._data[index] = node
108
+
109
+ def __getitem__(
110
+ self, index: tuple[Any, ...] | str
111
+ ) -> mknav.MkNav | mkpage.MkPage | mklink.MkLink:
112
+ self._ensure_materialized()
113
+ if isinstance(index, str):
114
+ index = (index,)
115
+ return self._data[index]
116
+
117
+ def __delitem__(self, index: tuple[Any, ...] | str) -> None:
118
+ self._ensure_materialized()
119
+ if isinstance(index, str):
120
+ index = (index,)
121
+ del self._data[index]
122
+
123
+ def __contains__(self, index: tuple[Any, ...] | str) -> bool:
124
+ self._ensure_materialized()
125
+ if isinstance(index, str):
126
+ index = (index,)
127
+ return index in self._data
128
+
129
+ def __len__(self) -> int:
130
+ self._ensure_materialized()
131
+ return len(self._data)
132
+
133
+ def __iter__(self) -> Iterator[tuple[Any, ...]]:
134
+ self._ensure_materialized()
135
+ return iter(self._data)
136
+
137
+ def __bool__(self) -> bool:
138
+ self._ensure_materialized()
139
+ return bool(self._data) or self._index_page is not None
140
+
141
+ def keys(self):
142
+ self._ensure_materialized()
143
+ return self._data.keys()
144
+
145
+ def values(self):
146
+ self._ensure_materialized()
147
+ return self._data.values()
148
+
149
+ def items(self):
150
+ self._ensure_materialized()
151
+ return self._data.items()
152
+
153
+ def register(self, node: mknav.MkNav | mkpage.MkPage | mklink.MkLink) -> None:
154
+ from mknodes.navs import mknav as mknav_module
155
+
156
+ match node:
157
+ case mknav_module.MkNav() | mkpage.MkPage():
158
+ self[node.title,] = node
159
+ case _:
160
+ raise TypeError(node)
161
+
162
+ def get_all_items(self) -> list[mknav.MkNav | mkpage.MkPage | mklink.MkLink]:
163
+ self._ensure_materialized()
164
+ nodes: list[mknav.MkNav | mkpage.MkPage | mklink.MkLink] = (
165
+ [self._index_page] if self._index_page else []
166
+ )
167
+ nodes += list(self._data.values())
168
+ return nodes
169
+
170
+ def get_navs(self) -> list[mknav.MkNav]:
171
+ """Return all registered navs."""
172
+ from mknodes.navs import mknav as mknav_module
173
+
174
+ self._ensure_materialized()
175
+ return [node for node in self._data.values() if isinstance(node, mknav_module.MkNav)]
176
+
177
+ def get_pages(self) -> list[mkpage.MkPage]:
178
+ """Return all registered pages."""
179
+ self._ensure_materialized()
180
+ return [node for node in self._data.values() if isinstance(node, mkpage.MkPage)]
181
+
182
+ @property
183
+ def links(self) -> list[mklink.MkLink]:
184
+ """Return all registered links."""
185
+ self._ensure_materialized()
186
+ return [node for node in self._data.values() if isinstance(node, mklink.MkLink)]
187
+
188
+ def to_nav_dict(self) -> dict[str, str | dict[str, Any]]:
189
+ """Return a nested dictionary for the MkDocs nav section."""
190
+ import mknodes as mk
191
+
192
+ self._ensure_materialized()
193
+ dct: dict[str, str | dict[str, Any]] = {}
194
+ if idx := self._index_page:
195
+ dct[idx.title] = pathlib.Path(idx.resolved_file_path).as_posix()
196
+ for path, item in self._data.items():
197
+ data = dct
198
+ for part in path[:-1]:
199
+ data = data.setdefault(part, {}) # type: ignore[assignment] # pyright: ignore[reportUnknownMemberType, reportAttributeAccessIssue]
200
+ assert isinstance(data, dict)
201
+ match item:
202
+ case mk.MkNav():
203
+ data[path[-1]] = item.nav.to_nav_dict()
204
+ case mk.MkPage():
205
+ data[path[-1]] = item.resolved_file_path
206
+ case mklink.MkLink():
207
+ data[path[-1]] = str(item.target)
208
+ return dct
209
+
210
+ def to_literate_nav(self) -> str:
211
+ """Return a literate-nav-style str representation of the nav."""
212
+ self._ensure_materialized()
213
+ nav = navbuilder.NavBuilder()
214
+ if idx := self._index_page:
215
+ nav[idx.title] = pathlib.Path(idx.path).as_posix()
216
+ for path, item in self._data.items():
217
+ match item:
218
+ case mkpage.MkPage():
219
+ nav[path] = pathlib.Path(item.path).as_posix()
220
+ case _:
221
+ from mknodes.navs import mknav as mknav_module
222
+
223
+ if isinstance(item, mknav_module.MkNav):
224
+ nav[path] = f"{item.title}/"
225
+ elif isinstance(item, mklink.MkLink):
226
+ nav[path] = str(item.target)
227
+ else:
228
+ raise TypeError(item)
229
+ return "".join(nav.build_literate_nav())
230
+
231
+
232
+ if __name__ == "__main__":
233
+ import mknodes as mk
234
+
235
+ nav_tree_path = pathlib.Path(__file__).parent.parent.parent / "tests/data/nav_tree/"
236
+ nav_file = nav_tree_path / "SUMMARY.md"
237
+ nav = mk.MkNav()
238
+ nav.parse.file(nav_file)
239
+ print(nav.nav.to_nav_dict())
@@ -370,7 +370,9 @@ class NavParser:
370
370
  return self._nav
371
371
 
372
372
 
373
- def parse_new_style_nav(root_nav: mk.MkNav, items: list[dict[str, Any]] | dict[str, Any]) -> None:
373
+ async def parse_new_style_nav(
374
+ root_nav: mk.MkNav, items: list[dict[str, Any]] | dict[str, Any]
375
+ ) -> None:
374
376
  """Parse and add navigation items to the root navigation in a new style format.
375
377
 
376
378
  This function processes a list or dictionary of navigation items and adds them to the
@@ -414,9 +416,9 @@ def parse_new_style_nav(root_nav: mk.MkNav, items: list[dict[str, Any]] | dict[s
414
416
  items = [items]
415
417
  for item in items:
416
418
  if "type" in item and "title" in item:
417
- if (condition := item.pop("condition", False)) and not root_nav.env.render_condition(
418
- condition
419
- ):
419
+ if (
420
+ condition := item.pop("condition", False)
421
+ ) and not await root_nav.env.render_condition_async(condition):
420
422
  continue
421
423
  kls = getattr(mk, item.pop("type"))
422
424
  title = item.pop("title")
@@ -433,7 +435,7 @@ def parse_new_style_nav(root_nav: mk.MkNav, items: list[dict[str, Any]] | dict[s
433
435
  for node_dct in nodes:
434
436
  if (
435
437
  condition := node_dct.pop("condition", False)
436
- ) and not instance.env.render_condition(condition):
438
+ ) and not await instance.env.render_condition_async(condition):
437
439
  continue
438
440
  kls = getattr(mk, node_dct.pop("type"))
439
441
  if header := node_dct.pop("title", None):
@@ -443,11 +445,7 @@ def parse_new_style_nav(root_nav: mk.MkNav, items: list[dict[str, Any]] | dict[s
443
445
  instance.title = title
444
446
  root_nav += instance
445
447
  case _:
446
- page = root_nav.add_page(
447
- title,
448
- is_index=is_index,
449
- is_homepage=is_homepage,
450
- )
448
+ page = root_nav.add_page(title, is_index=is_index, is_homepage=is_homepage)
451
449
  page += instance
452
450
  else:
453
451
  name, items = next(iter(item.items()))
@@ -455,7 +453,7 @@ def parse_new_style_nav(root_nav: mk.MkNav, items: list[dict[str, Any]] | dict[s
455
453
  root_nav += mk.MkPage.from_file(items, title=name)
456
454
  else:
457
455
  nav = root_nav.add_nav(name)
458
- parse_new_style_nav(nav, items)
456
+ await parse_new_style_nav(nav, items)
459
457
 
460
458
 
461
459
  if __name__ == "__main__":
@@ -1,5 +1,6 @@
1
1
  from __future__ import annotations
2
2
 
3
+ import inspect
3
4
  from typing import TYPE_CHECKING, Any
4
5
 
5
6
  from mknodes.basenodes import mklink
@@ -9,13 +10,18 @@ from mknodes.utils import log
9
10
 
10
11
 
11
12
  if TYPE_CHECKING:
12
- from collections.abc import Callable
13
+ from collections.abc import Awaitable, Callable
13
14
 
14
15
  NavSubType = mknav.MkNav | mkpage.MkPage | mklink.MkLink
15
16
  PageCallable = Callable[[mkpage.MkPage], mkpage.MkPage | None]
17
+ AsyncPageCallable = Callable[[mkpage.MkPage], Awaitable[mkpage.MkPage | None]]
16
18
  NavCallable = Callable[[mknav.MkNav], mknav.MkNav | None]
19
+ AsyncNavCallable = Callable[[mknav.MkNav], Awaitable[mknav.MkNav | None]]
17
20
  NavSubTypeCallable = Callable[..., NavSubType]
18
- PageDecorator = Callable[[PageCallable], Any]
21
+ AsyncNavSubTypeCallable = Callable[..., Awaitable[NavSubType]]
22
+ AnyPageCallable = PageCallable | AsyncPageCallable
23
+ AnyNavCallable = NavCallable | AsyncNavCallable
24
+ AnyNavSubTypeCallable = NavSubTypeCallable | AsyncNavSubTypeCallable
19
25
 
20
26
  logger = log.get_logger(__name__)
21
27
 
@@ -31,7 +37,7 @@ class NavRouter:
31
37
  """
32
38
  self._nav = nav
33
39
 
34
- def __call__(self, *path: str) -> Callable[[NavSubTypeCallable], Any]:
40
+ def __call__(self, *path: str) -> Callable[[AnyNavSubTypeCallable], Any]:
35
41
  """Decorator method to use for routing.
36
42
 
37
43
  The decorated functions need to return either a MkPage or an MkNav.
@@ -45,21 +51,28 @@ class NavRouter:
45
51
  """
46
52
 
47
53
  def decorator(
48
- fn: NavSubTypeCallable,
54
+ fn: AnyNavSubTypeCallable,
49
55
  path: tuple[str, ...] = path,
50
- ) -> NavSubTypeCallable:
51
- node = fn()
52
- node.parent = self._nav
53
- if isinstance(node, mkpage.MkPage):
54
- node.created_by = fn
55
- elif isinstance(node, mknav.MkNav) and node.index_page:
56
- node.index_page.created_by = fn
57
- self._nav.nav[path] = node
56
+ ) -> AnyNavSubTypeCallable:
57
+ async def register() -> None:
58
+ result = fn()
59
+ if inspect.iscoroutine(result):
60
+ node = await result
61
+ else:
62
+ node = result
63
+ node.parent = self._nav
64
+ if isinstance(node, mkpage.MkPage):
65
+ node.created_by = fn
66
+ elif isinstance(node, mknav.MkNav) and node.index_page:
67
+ node.index_page.created_by = fn
68
+ self._nav.nav[path] = node
69
+
70
+ self._nav.nav.add_pending(register)
58
71
  return fn
59
72
 
60
73
  return decorator
61
74
 
62
- def nav(self, *path: str, **kwargs: Any) -> Callable[[NavCallable], Any]:
75
+ def nav(self, *path: str, **kwargs: Any) -> Callable[[AnyNavCallable], Any]:
63
76
  """Decorator method to use for routing Navs.
64
77
 
65
78
  The decorated functions will get passed an MkNav as an argument which can be
@@ -82,21 +95,29 @@ class NavRouter:
82
95
  """
83
96
 
84
97
  def decorator(
85
- fn: NavCallable,
98
+ fn: AnyNavCallable,
86
99
  path: tuple[str, ...] = path,
87
100
  kwargs: dict[str, Any] = kwargs,
88
- ) -> NavCallable:
89
- node = mknav.MkNav(path[-1], parent=self._nav, **kwargs)
90
- node = fn(node) or node
91
- node.parent = self._nav # in case a new MkPage was generated
92
- if node.index_page:
93
- node.index_page.created_by = fn
94
- self._nav.nav[path] = node
101
+ ) -> AnyNavCallable:
102
+ async def register() -> None:
103
+ node = mknav.MkNav(path[-1], parent=self._nav, **kwargs)
104
+ result = fn(node)
105
+ if inspect.iscoroutine(result):
106
+ awaited = await result
107
+ final = awaited or node
108
+ else:
109
+ final = result or node
110
+ final.parent = self._nav
111
+ if final.index_page:
112
+ final.index_page.created_by = fn
113
+ self._nav.nav[path] = final
114
+
115
+ self._nav.nav.add_pending(register)
95
116
  return fn
96
117
 
97
118
  return decorator
98
119
 
99
- def page(self, *path: str, **kwargs: Any) -> PageDecorator:
120
+ def page(self, *path: str, **kwargs: Any) -> Callable[[AnyPageCallable], Any]:
100
121
  """Decorator method to use for routing Pages.
101
122
 
102
123
  The decorated functions will get passed an MkPage as an argument which can be
@@ -121,16 +142,24 @@ class NavRouter:
121
142
  """
122
143
 
123
144
  def decorator(
124
- fn: PageCallable,
145
+ fn: AnyPageCallable,
125
146
  path: tuple[str, ...] = path,
126
147
  kwargs: dict[str, Any] = kwargs,
127
- ) -> PageCallable:
128
- p = path[-1] if path else (self._nav.title or "Home")
129
- node = mkpage.MkPage(title=p, parent=self._nav, **kwargs)
130
- node = fn(node) or node
131
- node.parent = self._nav # in case a new MkPage was generated
132
- node.created_by = fn
133
- self._nav.nav[path or self._nav.title or "Home"] = node
148
+ ) -> AnyPageCallable:
149
+ async def register() -> None:
150
+ p = path[-1] if path else (self._nav.title or "Home")
151
+ node = mkpage.MkPage(title=p, parent=self._nav, **kwargs)
152
+ result = fn(node)
153
+ if inspect.iscoroutine(result):
154
+ awaited = await result
155
+ final = awaited or node
156
+ else:
157
+ final = result or node
158
+ final.parent = self._nav
159
+ final.created_by = fn
160
+ self._nav.nav[path or self._nav.title or "Home"] = final
161
+
162
+ self._nav.nav.add_pending(register)
134
163
  return fn
135
164
 
136
165
  return decorator
@@ -143,3 +172,9 @@ class NavRouter:
143
172
  if __name__ == "__main__":
144
173
  nav = mknav.MkNav()
145
174
  router = NavRouter(nav)
175
+
176
+ @router.page("Test")
177
+ async def _(_page: mkpage.MkPage) -> None:
178
+ pass
179
+
180
+ print(nav.nav.get_pages())
@@ -1,5 +1,6 @@
1
1
  from __future__ import annotations
2
2
 
3
+ import asyncio
3
4
  import functools
4
5
  import html
5
6
 
@@ -101,7 +102,8 @@ class MkBadge(mkimage.MkImage):
101
102
  return self.ctx.theme.primary_color
102
103
 
103
104
  async def to_md_unprocessed(self) -> str:
104
- inner = htmlfilters.html_link(self.data.replace("\n", ""), await self.get_url())
105
+ data = await self.get_data()
106
+ inner = htmlfilters.html_link(data.replace("\n", ""), await self.get_url())
105
107
  return f"<body>{inner}</body>"
106
108
 
107
109
  @property
@@ -111,9 +113,9 @@ class MkBadge(mkimage.MkImage):
111
113
  color = self.ctx.theme.text_color
112
114
  return f"{color},#fff" if self.use_gitlab_style else f"#fff,{color}"
113
115
 
114
- @property
115
- def data(self) -> str:
116
- return get_badge(
116
+ async def get_data(self) -> str:
117
+ return await asyncio.to_thread(
118
+ get_badge,
117
119
  label=self.label,
118
120
  value=self.value,
119
121
  font_size=self.font_size,
@@ -133,4 +135,9 @@ class MkBadge(mkimage.MkImage):
133
135
 
134
136
  if __name__ == "__main__":
135
137
  img = MkBadge("Left", "right")
136
- print(img.data)
138
+
139
+ async def main():
140
+ data = await img.get_data()
141
+ print(data)
142
+
143
+ asyncio.run(main())
@@ -37,5 +37,5 @@ jinja = """
37
37
 
38
38
  [output.html]
39
39
  template = """
40
- <body>{{ node.data | replace("\n", "") | html_link(node.get_url()) }}</body>
40
+ <body>{{ node.get_data() | replace("\n", "") | html_link(node.get_url()) }}</body>
41
41
  """
@@ -1,5 +1,6 @@
1
1
  from __future__ import annotations
2
2
 
3
+ import asyncio
3
4
  import contextlib
4
5
  import functools
5
6
  import io
@@ -108,7 +109,8 @@ class MkChangelog(mktext.MkText):
108
109
  cfg := self.ctx.metadata.pyproject_file.tool.get("git-changelog")
109
110
  ):
110
111
  filter_commits = cfg.get("filter-commits")
111
- return get_changelog(
112
+ return await asyncio.to_thread(
113
+ get_changelog,
112
114
  repository=str(self.repository),
113
115
  template=self.template,
114
116
  convention=self.convention,