mknodes 2.0.5__tar.gz → 2.0.7__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 (290) hide show
  1. {mknodes-2.0.5 → mknodes-2.0.7}/PKG-INFO +1 -1
  2. {mknodes-2.0.5 → mknodes-2.0.7}/pyproject.toml +1 -1
  3. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/__init__.py +4 -1
  4. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/_mkdocstrings/__init__.py +3 -3
  5. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkannotations/__init__.py +5 -7
  6. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkbasetable/__init__.py +5 -5
  7. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkcode/__init__.py +1 -1
  8. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkcontainer/__init__.py +3 -3
  9. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkcritic/__init__.py +1 -1
  10. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkdefinitionlist/__init__.py +1 -1
  11. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkdetailsblock/__init__.py +1 -1
  12. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkfootnotes/__init__.py +4 -4
  13. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkhtmlblock/__init__.py +1 -1
  14. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mknode/__init__.py +2 -2
  15. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mktabcontainer.py +1 -1
  16. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mktabs/__init__.py +1 -1
  17. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mktext/__init__.py +1 -1
  18. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/processors/__init__.py +6 -5
  19. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/build/builder.py +1 -1
  20. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/build/exporter.py +3 -2
  21. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/cli/__init__.py +107 -2
  22. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/data/fences.py +1 -1
  23. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/data/installmethods.py +1 -1
  24. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/data/tools.py +4 -3
  25. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/extranodes/mkcodeimage/__init__.py +1 -1
  26. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/info/configfile.py +24 -11
  27. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/info/contexts.py +5 -9
  28. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/info/folderinfo.py +4 -6
  29. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/info/gitrepository.py +2 -2
  30. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/info/grifferegistry.py +8 -3
  31. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/info/license.py +1 -1
  32. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/info/nodefile.py +2 -3
  33. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/info/packageinfo.py +1 -2
  34. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/info/packageregistry.py +7 -2
  35. mknodes-2.0.7/src/mknodes/info/parse_deps.py +115 -0
  36. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/info/pyproject.py +1 -34
  37. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/info/reporegistry.py +2 -2
  38. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/jinja/__init__.py +2 -1
  39. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/jinja/filters.py +4 -2
  40. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/manual/navs_section.py +1 -1
  41. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/manual/root.py +2 -2
  42. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/manual/templating_section.py +3 -1
  43. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/mdlib/mdconverter.py +1 -1
  44. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/navs/mkdoc.py +2 -2
  45. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/navs/mknav.py +3 -3
  46. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/navs/navbuilder.py +4 -2
  47. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/nodemods/modmanager.py +1 -1
  48. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/pages/metadata.py +2 -2
  49. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/pages/mkclasspage/__init__.py +2 -2
  50. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/pages/mkmodulepage/__init__.py +1 -1
  51. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/pages/mkpage.py +1 -1
  52. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/pages/pagetemplate.py +3 -3
  53. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/pages/templateblocks.py +6 -6
  54. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/pages/templateregistry.py +1 -1
  55. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/pages/toc.py +1 -1
  56. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkbadge/__init__.py +1 -1
  57. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkclassdiagram/__init__.py +1 -1
  58. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkcommentedcode/__init__.py +40 -0
  59. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkcommentedcode/metadata.toml +1 -3
  60. mknodes-2.0.7/src/mknodes/templatenodes/mkdependencygroups/__init__.py +60 -0
  61. mknodes-2.0.7/src/mknodes/templatenodes/mkdependencygroups/metadata.toml +11 -0
  62. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkdevenvsetup/__init__.py +1 -1
  63. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkpydeps/__init__.py +1 -1
  64. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mktemplate/__init__.py +1 -1
  65. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/theme/materialtheme/__init__.py +1 -1
  66. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/theme/theme.py +1 -1
  67. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/treelib/treeprint.py +1 -1
  68. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/utils/color.py +4 -4
  69. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/utils/connector.py +3 -3
  70. mknodes-2.0.7/src/mknodes/utils/downloadhelpers.py +33 -0
  71. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/utils/icons.py +2 -7
  72. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/utils/inspecthelpers.py +1 -41
  73. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/utils/inventorymanager.py +25 -32
  74. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/utils/log.py +1 -5
  75. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/utils/packagehelpers.py +3 -12
  76. mknodes-2.0.7/src/mknodes/utils/pathhelpers.py +49 -0
  77. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/utils/resources.py +9 -9
  78. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/utils/superdict.py +8 -21
  79. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/utils/xmlhelpers.py +1 -16
  80. mknodes-2.0.5/src/mknodes/theme/mkblog.py +0 -182
  81. mknodes-2.0.5/src/mknodes/theme/mkgitblog.py +0 -128
  82. mknodes-2.0.5/src/mknodes/utils/downloadhelpers.py +0 -68
  83. mknodes-2.0.5/src/mknodes/utils/pathhelpers.py +0 -133
  84. {mknodes-2.0.5 → mknodes-2.0.7}/LICENSE +0 -0
  85. {mknodes-2.0.5 → mknodes-2.0.7}/README.md +0 -0
  86. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/__main__.py +0 -0
  87. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/__init__.py +0 -0
  88. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/_mkdocstrings/metadata.toml +0 -0
  89. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkadmonition/__init__.py +0 -0
  90. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkadmonition/metadata.toml +0 -0
  91. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkannotations/metadata.toml +0 -0
  92. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkbinaryimage/__init__.py +0 -0
  93. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkbinaryimage/metadata.toml +0 -0
  94. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkblock/__init__.py +0 -0
  95. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkblockquote/__init__.py +0 -0
  96. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkblockquote/metadata.toml +0 -0
  97. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkcard/__init__.py +0 -0
  98. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkcard/grid.css +0 -0
  99. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkcard/metadata.toml +0 -0
  100. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkclidoc/__init__.py +0 -0
  101. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkclidoc/metadata.toml +0 -0
  102. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkcode/metadata.toml +0 -0
  103. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkcompactadmonition/__init__.py +0 -0
  104. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkcompactadmonition/compactadmonition.css +0 -0
  105. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkcompactadmonition/metadata.toml +0 -0
  106. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkcontainer/metadata.toml +0 -0
  107. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkcritic/metadata.toml +0 -0
  108. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkdataclassinfo/__init__.py +0 -0
  109. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkdataclassinfo/metadata.toml +0 -0
  110. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkdefinitionlist/metadata.toml +0 -0
  111. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkdetailsblock/metadata.toml +0 -0
  112. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkdiagram/__init__.py +0 -0
  113. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkdiagram/metadata.toml +0 -0
  114. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkfootnotes/metadata.toml +0 -0
  115. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkheader/__init__.py +0 -0
  116. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkheader/metadata.toml +0 -0
  117. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkhtmlblock/metadata.toml +0 -0
  118. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkhtmltable/__init__.py +0 -0
  119. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkhtmltable/metadata.toml +0 -0
  120. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkicon/__init__.py +0 -0
  121. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkicon/metadata.toml +0 -0
  122. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkiframe/__init__.py +0 -0
  123. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkiframe/metadata.toml +0 -0
  124. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkimage/__init__.py +0 -0
  125. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkimage/metadata.toml +0 -0
  126. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkimagecompare/__init__.py +0 -0
  127. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkimagecompare/metadata.toml +0 -0
  128. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkimageslideshow/__init__.py +0 -0
  129. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkimageslideshow/metadata.toml +0 -0
  130. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkjupyterlite/__init__.py +0 -0
  131. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkjupyterlite/metadata.toml +0 -0
  132. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkkeys/__init__.py +0 -0
  133. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkkeys/metadata.toml +0 -0
  134. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mklink/__init__.py +0 -0
  135. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mklink/metadata.toml +0 -0
  136. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mklist/__init__.py +0 -0
  137. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mklist/metadata.toml +0 -0
  138. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkmaterialbadge/__init__.py +0 -0
  139. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkmaterialbadge/materialbadge.css +0 -0
  140. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkmaterialbadge/metadata.toml +0 -0
  141. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkprogressbar/__init__.py +0 -0
  142. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkprogressbar/metadata.toml +0 -0
  143. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkprogressbar/progressbar.css +0 -0
  144. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkpyodide/__init__.py +0 -0
  145. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkpyodide/metadata.toml +0 -0
  146. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkpyscript/__init__.py +0 -0
  147. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkpyscript/metadata.toml +0 -0
  148. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkshowcase/__init__.py +0 -0
  149. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkshowcase/metadata.toml +0 -0
  150. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkspeechbubble/__init__.py +0 -0
  151. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkspeechbubble/metadata.toml +0 -0
  152. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mkspeechbubble/speechbubble.css +0 -0
  153. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mktabbed/__init__.py +0 -0
  154. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mktabbed/metadata.toml +0 -0
  155. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mktabbedblocks/__init__.py +0 -0
  156. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mktabbedblocks/metadata.toml +0 -0
  157. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mktable/__init__.py +0 -0
  158. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mktable/metadata.toml +0 -0
  159. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mktabs/mktab.toml +0 -0
  160. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mktasklist/__init__.py +0 -0
  161. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mktasklist/metadata.toml +0 -0
  162. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mktext/metadata.toml +0 -0
  163. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mktimeline/__init__.py +0 -0
  164. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mktimeline/metadata.toml +0 -0
  165. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mktimeline/timeline.css +0 -0
  166. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/basenodes/mktimeline/timeline.js +0 -0
  167. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/build/__init__.py +0 -0
  168. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/build/output.py +0 -0
  169. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/data/__init__.py +0 -0
  170. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/data/admonition.py +0 -0
  171. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/data/badges.py +0 -0
  172. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/data/buildsystems.py +0 -0
  173. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/data/commitconventions.py +0 -0
  174. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/data/datatypes.py +0 -0
  175. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/data/eventplugins.py +0 -0
  176. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/data/taskrunners.py +0 -0
  177. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/data/treestyles.py +0 -0
  178. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/extranodes/__init__.py +0 -0
  179. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/extranodes/mkcodeimage/metadata.toml +0 -0
  180. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/extranodes/mkgrid/__init__.py +0 -0
  181. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/extranodes/mkgrid/metadata.toml +0 -0
  182. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/extranodes/mkprettyprint/__init__.py +0 -0
  183. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/extranodes/mkprettyprint/metadata.toml +0 -0
  184. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/extranodes/mksnippet/__init__.py +0 -0
  185. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/extranodes/mksnippet/metadata.toml +0 -0
  186. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/info/__init__.py +0 -0
  187. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/info/linkprovider.py +0 -0
  188. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/info/mkdocsconfigfile.py +0 -0
  189. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/jinja/nodeenvironment.py +0 -0
  190. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/manual/__init__.py +0 -0
  191. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/manual/a_quick_tour.py +0 -0
  192. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/manual/dev_section.py +0 -0
  193. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/manual/get_started_section.py +0 -0
  194. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/manual/github_index.py +0 -0
  195. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/manual/nodes_section.py +0 -0
  196. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/manual/page_section.py +0 -0
  197. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/manual/routing.py +0 -0
  198. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/manual/standalone.py +0 -0
  199. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/mdlib/__init__.py +0 -0
  200. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/navs/__init__.py +0 -0
  201. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/navs/navigation.py +0 -0
  202. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/navs/navparser.py +0 -0
  203. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/navs/navrouter.py +0 -0
  204. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/navs/router.py +0 -0
  205. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/nodemods/__init__.py +0 -0
  206. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/nodemods/mod.py +0 -0
  207. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/nodemods/parallax.py +0 -0
  208. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/nodemods/parallax.toml +0 -0
  209. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/nodemods/scrollreveal.py +0 -0
  210. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/nodemods/scrollreveal.toml +0 -0
  211. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/pages/__init__.py +0 -0
  212. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/pages/mkclasspage/classpage.md +0 -0
  213. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/pages/mkclasspage/classpage_tabbed.md +0 -0
  214. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/pages/mkmodulepage/modulepage.md +0 -0
  215. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/pages/mktemplatepage.py +0 -0
  216. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/paths.py +0 -0
  217. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/py.typed +0 -0
  218. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/resources/css/animated.css +0 -0
  219. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/resources/css/hero.css +0 -0
  220. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/resources/css/material_css_extra.jinja +0 -0
  221. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/resources/css/theme_material.css +0 -0
  222. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/resources/css/theme_mkdocs.css +0 -0
  223. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/resources/filters.toml +0 -0
  224. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/resources/js/tablesort.js +0 -0
  225. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/resources/python_objects.inv +0 -0
  226. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/resources/toolfiles/tool_black.toml +0 -0
  227. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/resources/toolfiles/tool_coverage.toml +0 -0
  228. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/resources/toolfiles/tool_mkdocs.toml +0 -0
  229. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/resources/toolfiles/tool_mypy.toml +0 -0
  230. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/resources/toolfiles/tool_precommit.toml +0 -0
  231. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/resources/toolfiles/tool_pyright.toml +0 -0
  232. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/resources/toolfiles/tool_ruff.toml +0 -0
  233. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/__init__.py +0 -0
  234. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkbadge/metadata.toml +0 -0
  235. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkchangelog/__init__.py +0 -0
  236. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkchangelog/metadata.toml +0 -0
  237. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkclassdiagram/metadata.toml +0 -0
  238. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkclasstable/__init__.py +0 -0
  239. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkclasstable/metadata.toml +0 -0
  240. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkcodeofconduct/__init__.py +0 -0
  241. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkcodeofconduct/metadata.toml +0 -0
  242. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkcommandoutput/__init__.py +0 -0
  243. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkcommandoutput/metadata.toml +0 -0
  244. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkcommandoutput/terminal.css +0 -0
  245. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkcommitconventions/__init__.py +0 -0
  246. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkcommitconventions/metadata.toml +0 -0
  247. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkconfigsetting/__init__.py +0 -0
  248. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkconfigsetting/metadata.toml +0 -0
  249. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkdependencytable/__init__.py +0 -0
  250. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkdependencytable/metadata.toml +0 -0
  251. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkdevenvsetup/metadata.toml +0 -0
  252. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkdevtools/__init__.py +0 -0
  253. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkdevtools/metadata.toml +0 -0
  254. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkinclude/__init__.py +0 -0
  255. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkinclude/metadata.toml +0 -0
  256. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkinstallguide/__init__.py +0 -0
  257. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkinstallguide/metadata.toml +0 -0
  258. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mklicense/__init__.py +0 -0
  259. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mklicense/metadata.toml +0 -0
  260. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkllm/__init__.py +0 -0
  261. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkllm/metadata.toml +0 -0
  262. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkmetadatabadges/__init__.py +0 -0
  263. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkmetadatabadges/metadata.toml +0 -0
  264. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkmoduletable/__init__.py +0 -0
  265. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkmoduletable/metadata.toml +0 -0
  266. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkpipdeptree/__init__.py +0 -0
  267. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkpipdeptree/metadata.toml +0 -0
  268. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkpluginflow/__init__.py +0 -0
  269. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkpluginflow/metadata.toml +0 -0
  270. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkpydeps/metadata.toml +0 -0
  271. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkreprrawrendered/__init__.py +0 -0
  272. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkreprrawrendered/metadata.toml +0 -0
  273. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkshields/__init__.py +0 -0
  274. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mkshields/metadata.toml +0 -0
  275. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mktemplate/metadata.toml +0 -0
  276. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mktemplatetable/__init__.py +0 -0
  277. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mktemplatetable/metadata.toml +0 -0
  278. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mktreeview/__init__.py +0 -0
  279. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/templatenodes/mktreeview/metadata.toml +0 -0
  280. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/theme/__init__.py +0 -0
  281. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/theme/colortheme.py +0 -0
  282. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/theme/materialtheme/palette.py +0 -0
  283. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/treelib/__init__.py +0 -0
  284. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/utils/__init__.py +0 -0
  285. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/utils/annotationappender.py +0 -0
  286. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/utils/classhelpers.py +0 -0
  287. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/utils/coroutines.py +0 -0
  288. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/utils/helpers.py +0 -0
  289. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/utils/linkreplacer.py +0 -0
  290. {mknodes-2.0.5 → mknodes-2.0.7}/src/mknodes/utils/reprhelpers.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: mknodes
3
- Version: 2.0.5
3
+ Version: 2.0.7
4
4
  Summary: Don't write docs. Code them.
5
5
  Keywords: docs,docstrings,documentation,framework,internet,markdown
6
6
  Author: Philipp Temminghoff
@@ -2,7 +2,7 @@
2
2
 
3
3
  [project]
4
4
  name = "mknodes"
5
- version = "2.0.5"
5
+ version = "2.0.7"
6
6
  description = "Don't write docs. Code them."
7
7
  readme = "README.md"
8
8
  requires-python = ">=3.13"
@@ -1,4 +1,5 @@
1
1
  from __future__ import annotations
2
+ from typing import Any
2
3
 
3
4
  from .jinja.nodeenvironment import NodeEnvironment
4
5
  from importlib.metadata import version
@@ -72,6 +73,7 @@ from .templatenodes.mkreprrawrendered import MkReprRawRendered
72
73
  from .templatenodes.mktreeview import MkTreeView
73
74
  from .templatenodes.mklicense import MkLicense
74
75
  from .templatenodes.mkdependencytable import MkDependencyTable
76
+ from .templatenodes.mkdependencygroups import MkDependencyGroups
75
77
  from .templatenodes.mkcommandoutput import MkCommandOutput
76
78
  from .templatenodes.mkbadge import MkBadge
77
79
  from .templatenodes.mkmetadatabadges import MkMetadataBadges
@@ -92,7 +94,7 @@ from .theme.theme import Theme
92
94
  from .theme.materialtheme import MaterialTheme
93
95
 
94
96
 
95
- async def parse(project=None, **kwargs):
97
+ async def parse(project=None, **kwargs: Any) -> MkNav:
96
98
  if project:
97
99
  kwargs["context"] = project.context
98
100
  from mknodes.navs.navparser import parse_new_style_nav
@@ -135,6 +137,7 @@ __all__ = [
135
137
  "MkCritic",
136
138
  "MkDataClassInfo",
137
139
  "MkDefinitionList",
140
+ "MkDependencyGroups",
138
141
  "MkDependencyTable",
139
142
  "MkDetailsBlock",
140
143
  "MkDevEnvSetup",
@@ -165,12 +165,12 @@ class MkDocStrings(mknode.MkNode):
165
165
  opts = self.OPTIONS_DEFAULT.copy() | opts
166
166
  self._options = {k: v for k, v in opts.items() if v is not None}
167
167
 
168
- def __repr__(self):
168
+ def __repr__(self) -> str:
169
169
  option_kwargs = {k: v for k, v in self.options.items() if v is not None}
170
170
  return reprhelpers.get_repr(self, obj=self.obj, **option_kwargs)
171
171
 
172
172
  @property
173
- def obj_path(self):
173
+ def obj_path(self) -> str:
174
174
  match self.obj:
175
175
  case types.ModuleType():
176
176
  return self.obj.__name__
@@ -189,7 +189,7 @@ class MkDocStrings(mknode.MkNode):
189
189
  raise TypeError(self.obj)
190
190
 
191
191
  @property
192
- def options(self):
192
+ def options(self) -> dict[str, Any]:
193
193
  import mknodes as mk
194
194
 
195
195
  # The default section style does not work well inside Annotations,
@@ -32,7 +32,7 @@ class MkAnnotation(mkcontainer.MkContainer):
32
32
  self.num = num
33
33
  super().__init__(content=content, **kwargs)
34
34
 
35
- def __repr__(self):
35
+ def __repr__(self) -> str:
36
36
  return reprhelpers.get_repr(self, num=self.num, content=self.get_items())
37
37
 
38
38
  async def to_md_unprocessed(self) -> str:
@@ -52,7 +52,7 @@ class MkAnnotations(mkcontainer.MkContainer):
52
52
  self,
53
53
  annotations: Mapping[int, str | mk.MkNode] | list[mk.MkNode | str] | None = None,
54
54
  **kwargs: Any,
55
- ):
55
+ ) -> None:
56
56
  """Constructor.
57
57
 
58
58
  Args:
@@ -64,9 +64,7 @@ class MkAnnotations(mkcontainer.MkContainer):
64
64
  items = []
65
65
  case list():
66
66
  items = [
67
- (
68
- ann if isinstance(ann, MkAnnotation) else MkAnnotation(i, ann) # type: ignore
69
- )
67
+ (ann if isinstance(ann, MkAnnotation) else MkAnnotation(i, ann))
70
68
  for i, ann in enumerate(annotations, start=1)
71
69
  ]
72
70
  case Mapping():
@@ -79,7 +77,7 @@ class MkAnnotations(mkcontainer.MkContainer):
79
77
  """Return the list of annotations."""
80
78
  return self._items # type: ignore[return-value]
81
79
 
82
- def __getitem__(self, item: int):
80
+ def __getitem__(self, item: int) -> MkAnnotation:
83
81
  for node in self.get_items():
84
82
  if node.num == item:
85
83
  return node
@@ -94,7 +92,7 @@ class MkAnnotations(mkcontainer.MkContainer):
94
92
  case _:
95
93
  raise TypeError(item)
96
94
 
97
- def __repr__(self):
95
+ def __repr__(self) -> str:
98
96
  notes: list[str | MkAnnotation] = []
99
97
  for item in self.get_items():
100
98
  item_children = item.get_items()
@@ -1,7 +1,7 @@
1
1
  from __future__ import annotations
2
2
 
3
3
  from collections.abc import Mapping
4
- from typing import TYPE_CHECKING, Any
4
+ from typing import TYPE_CHECKING, Any, Self
5
5
 
6
6
  from mknodes.basenodes import mkcontainer
7
7
  from mknodes.utils import log, reprhelpers
@@ -30,7 +30,7 @@ class MkBaseTable(mkcontainer.MkContainer):
30
30
  | None = None,
31
31
  columns: Sequence[str] | None = None,
32
32
  **kwargs: Any,
33
- ):
33
+ ) -> None:
34
34
  """Constructor.
35
35
 
36
36
  Args:
@@ -54,7 +54,7 @@ class MkBaseTable(mkcontainer.MkContainer):
54
54
  case _:
55
55
  raise TypeError(data)
56
56
 
57
- def __repr__(self):
57
+ def __repr__(self) -> str:
58
58
  kwarg_data = {
59
59
  k: [reprhelpers.to_str_if_textnode(i) for i in v] for k, v in self.data.items()
60
60
  }
@@ -93,7 +93,7 @@ class MkBaseTable(mkcontainer.MkContainer):
93
93
  def add_row(
94
94
  self,
95
95
  row: Sequence[str | mk.MkNode | None] | dict[str, str | None],
96
- ):
96
+ ) -> None:
97
97
  if len(row) != len(self.columns):
98
98
  msg = "Row to add doesnt have same length as header"
99
99
  raise ValueError(msg)
@@ -112,7 +112,7 @@ class MkBaseTable(mkcontainer.MkContainer):
112
112
  yield [data[k][j] for k in data]
113
113
 
114
114
  @classmethod
115
- def for_items(cls, items: list[dict[str, Any]], columns: dict[str, Callable[..., Any]]):
115
+ def for_items(cls, items: list[dict[str, Any]], columns: dict[str, Callable[..., Any]]) -> Self:
116
116
  ls = [{k: v(item) for k, v in columns.items()} for item in items]
117
117
  return cls(ls)
118
118
 
@@ -114,7 +114,7 @@ class MkCode(mkcontainer.MkContainer):
114
114
  title: str | None = None,
115
115
  language: str | None = None,
116
116
  **kwargs: Any,
117
- ):
117
+ ) -> Self:
118
118
  """Create a MkCode node based on a code file.
119
119
 
120
120
  Line numbers will be shown by default. If `highlight_caller` is `True`,
@@ -1,7 +1,7 @@
1
1
  from __future__ import annotations
2
2
 
3
3
  from abc import abstractmethod
4
- from typing import Any
4
+ from typing import Any, Self
5
5
 
6
6
  from mknodes.basenodes import mknode
7
7
  from mknodes.utils import log
@@ -28,10 +28,10 @@ class MkContainerBase(mknode.MkNode):
28
28
  super().__init__(**kwargs)
29
29
  self.block_separator = block_separator
30
30
 
31
- def __bool__(self):
31
+ def __bool__(self) -> bool:
32
32
  return bool(self.get_items())
33
33
 
34
- def __add__(self, other: str | mknode.MkNode):
34
+ def __add__(self, other: str | mknode.MkNode) -> Self:
35
35
  self.append(other)
36
36
  return self
37
37
 
@@ -38,7 +38,7 @@ class MkCritic(mkcontainer.MkContainer):
38
38
  self.typ = typ
39
39
 
40
40
  @property
41
- def marks(self):
41
+ def marks(self) -> tuple[str, str]:
42
42
  match self.typ:
43
43
  case "addition":
44
44
  return ("++", "++")
@@ -57,7 +57,7 @@ class MkDefinitionList(mkcontainer.MkContainer):
57
57
  self.data: dict[str, str | mknode.MkNode] = {}
58
58
  self.set_items(data)
59
59
 
60
- def __repr__(self):
60
+ def __repr__(self) -> str:
61
61
  kws = {k: reprhelpers.to_str_if_textnode(v) for k, v in self.data.items()}
62
62
  return reprhelpers.get_repr(self, data=kws)
63
63
 
@@ -47,7 +47,7 @@ class MkDetailsBlock(mkblock.MkBlock):
47
47
  **kwargs,
48
48
  )
49
49
 
50
- def __repr__(self):
50
+ def __repr__(self) -> str:
51
51
  items = self.get_items()
52
52
  content = (
53
53
  reprhelpers.to_str_if_textnode(items[0])
@@ -36,7 +36,7 @@ class MkFootNote(mkcontainer.MkContainer):
36
36
  super().__init__(content=content, **kwargs)
37
37
  self.num = num
38
38
 
39
- def __repr__(self):
39
+ def __repr__(self) -> str:
40
40
  return reprhelpers.get_repr(self, num=self.num, content=self.get_items())
41
41
 
42
42
  async def to_md_unprocessed(self) -> str:
@@ -56,7 +56,7 @@ class MkFootNotes(mkcontainer.MkContainer):
56
56
  self,
57
57
  footnotes: (Mapping[int, str | mk.MkNode] | list[MkFootNote] | list[str] | None) = None,
58
58
  **kwargs: Any,
59
- ):
59
+ ) -> None:
60
60
  """Constructor.
61
61
 
62
62
  Args:
@@ -83,7 +83,7 @@ class MkFootNotes(mkcontainer.MkContainer):
83
83
  """Return the list of footnotes."""
84
84
  return self._items # type: ignore[return-value]
85
85
 
86
- def __repr__(self):
86
+ def __repr__(self) -> str:
87
87
  notes: list[mk.MkNode | str] = []
88
88
  for item in self.get_items():
89
89
  item_children = item.get_items()
@@ -95,7 +95,7 @@ class MkFootNotes(mkcontainer.MkContainer):
95
95
  notes.append(item)
96
96
  return reprhelpers.get_repr(self, footnotes=notes)
97
97
 
98
- def __getitem__(self, index: int):
98
+ def __getitem__(self, index: int) -> MkFootNote:
99
99
  for node in self.get_items():
100
100
  if node.num == index:
101
101
  return node
@@ -52,7 +52,7 @@ class MkHtmlBlock(mkblock.MkBlock):
52
52
  )
53
53
  self.markdown_mode = markdown_mode
54
54
 
55
- def __repr__(self):
55
+ def __repr__(self) -> str:
56
56
  items = self.get_items()
57
57
  content = (
58
58
  reprhelpers.to_str_if_textnode(items[0])
@@ -68,7 +68,7 @@ class MkNode:
68
68
  context: contexts.ProjectContext | None = None,
69
69
  parent: MkNode | None = None,
70
70
  **_kwargs: Any,
71
- ):
71
+ ) -> None:
72
72
  """Constructor.
73
73
 
74
74
  Args:
@@ -109,7 +109,7 @@ class MkNode:
109
109
  """Return the list of children nodes."""
110
110
  return self._children
111
111
 
112
- def __repr__(self):
112
+ def __repr__(self) -> str:
113
113
  return reprhelpers.get_nondefault_repr(self)
114
114
 
115
115
  def __iter__(self) -> Iterator[MkNode]:
@@ -111,7 +111,7 @@ class MkTabContainer(mkcontainer.MkContainer):
111
111
  else:
112
112
  items.append(tab)
113
113
 
114
- def __repr__(self):
114
+ def __repr__(self) -> str:
115
115
  return reprhelpers.get_repr(
116
116
  self,
117
117
  tabs=self.get_items(),
@@ -102,7 +102,7 @@ class MkTab(mkcontainer.MkContainer):
102
102
  self.attrs = attrs
103
103
  super().__init__(content=content, **kwargs)
104
104
 
105
- def __repr__(self):
105
+ def __repr__(self) -> str:
106
106
  content: str | list[str]
107
107
  items = self.get_items()
108
108
  if len(items) == 1:
@@ -55,7 +55,7 @@ class MkText(mknode.MkNode):
55
55
  async def to_md_unprocessed(self) -> str:
56
56
  return await self.get_text()
57
57
 
58
- def get_children(self) -> list[mknode.MkNode]: # type: ignore[override]
58
+ def get_children(self) -> list[mknode.MkNode]:
59
59
  """Return children nodes.
60
60
 
61
61
  For MkText with render_jinja=True, this triggers Jinja rendering
@@ -1,6 +1,6 @@
1
1
  from __future__ import annotations
2
2
 
3
- from typing import TYPE_CHECKING
3
+ from typing import TYPE_CHECKING, Any
4
4
  import textwrap
5
5
 
6
6
  from jinjarope import mdfilters
@@ -9,6 +9,7 @@ from mknodes.pages.metadata import Metadata
9
9
  from mknodes.utils import log
10
10
 
11
11
  if TYPE_CHECKING:
12
+ import jinjarope
12
13
  import mknodes as mk
13
14
 
14
15
  logger = log.get_logger(__name__)
@@ -24,7 +25,7 @@ class TextProcessor:
24
25
  class AnnotationProcessor(TextProcessor):
25
26
  ID = "annotations"
26
27
 
27
- def __init__(self, item) -> None:
28
+ def __init__(self, item: mk.MkNode) -> None:
28
29
  self.item = item
29
30
 
30
31
  def run(self, text: str) -> str:
@@ -66,18 +67,18 @@ class ShiftHeaderLevelProcessor(TextProcessor):
66
67
  class RenderJinjaProcessor(TextProcessor):
67
68
  ID = "render_jinja_templates"
68
69
 
69
- def __init__(self, env, variables=None) -> None:
70
+ def __init__(self, env: jinjarope.Environment, variables: dict[str, Any] | None = None) -> None:
70
71
  self.env = env
71
72
  self.variables = variables or {}
72
73
 
73
74
  def run(self, text: str) -> str:
74
- return self.env.render(text, self.variables)
75
+ return self.env.render_string(text, self.variables)
75
76
 
76
77
 
77
78
  class AppendCssClassesProcessor(TextProcessor):
78
79
  ID = "append_css_classes"
79
80
 
80
- def __init__(self, item) -> None:
81
+ def __init__(self, item: mk.MkNode) -> None:
81
82
  self.item = item
82
83
 
83
84
  def run(self, text: str) -> str:
@@ -32,7 +32,7 @@ logger = log.get_logger(__name__)
32
32
  class DocBuilder:
33
33
  """Traverses node tree, renders markdown, collects resources."""
34
34
 
35
- def __init__(self, render_jinja: bool = True, max_workers: int | None = None):
35
+ def __init__(self, render_jinja: bool = True, max_workers: int | None = None) -> None:
36
36
  """Constructor.
37
37
 
38
38
  Args:
@@ -12,6 +12,7 @@ if TYPE_CHECKING:
12
12
  from pathlib import Path
13
13
 
14
14
  from mknodes.build.output import BuildOutput
15
+ from mknodes.utils.resources import Resources
15
16
 
16
17
 
17
18
  class Exporter(Protocol):
@@ -25,7 +26,7 @@ class Exporter(Protocol):
25
26
  class MarkdownExporter:
26
27
  """Writes markdown files with per-file metadata sidecars."""
27
28
 
28
- def __init__(self, metadata_suffix: str = ".meta.yaml"):
29
+ def __init__(self, metadata_suffix: str = ".meta.yaml") -> None:
29
30
  """Constructor.
30
31
 
31
32
  Args:
@@ -76,7 +77,7 @@ class MarkdownExporter:
76
77
  meta_path = target_path / ".mknodes.meta.yaml"
77
78
  meta_path.write_text(yamling.dump_yaml(meta, indent=2), encoding="utf-8")
78
79
 
79
- def _serialize_resources(self, res) -> dict[str, Any]:
80
+ def _serialize_resources(self, res: Resources) -> dict[str, Any]:
80
81
  """Serialize a Resources object to a dict."""
81
82
  return {
82
83
  "markdown_extensions": res.markdown_extensions,
@@ -32,7 +32,11 @@ RENDER_JINJA_HELP = "Render Jinja templates in pages."
32
32
  VERBOSE_HELP = "Enable verbose output (DEBUG level)."
33
33
  QUIET_HELP = "Suppress output during build."
34
34
  INPUT_HELP = "Input markdown file to render (use - for stdin)."
35
+ INPUT_DIR_HELP = "Input directory containing files to render."
35
36
  OUTPUT_FILE_HELP = "Output file (use - for stdout, default)."
37
+ OUTPUT_DIR_HELP = "Output directory for rendered files."
38
+ GLOB_HELP = "Glob pattern for files to render as Jinja templates."
39
+ COPY_OTHER_HELP = "Copy files not matching the glob pattern as-is."
36
40
  WORKERS_HELP = "Number of parallel workers for page processing. Set PYTHON_GIL=0 for best performance with Python 3.14t."
37
41
 
38
42
  SCRIPT_CMDS = "-s", "--script"
@@ -42,15 +46,16 @@ VERBOSE_CMDS = "-v", "--verbose"
42
46
  QUIET_CMDS = "-q", "--quiet"
43
47
  INPUT_CMDS = "-i", "--input"
44
48
  OUTPUT_FILE_CMDS = "-o", "--output"
49
+ GLOB_CMDS = "-g", "--glob"
45
50
  WORKERS_CMDS = "-w", "--workers"
46
51
 
47
52
 
48
- def verbose_callback(ctx: t.Context, _param: t.CallbackParam, value: bool):
53
+ def verbose_callback(ctx: t.Context, _param: t.CallbackParam, value: bool) -> None:
49
54
  if value:
50
55
  logging.getLogger("mknodes").setLevel(logging.DEBUG)
51
56
 
52
57
 
53
- def quiet_callback(ctx: t.Context, _param: t.CallbackParam, value: bool):
58
+ def quiet_callback(ctx: t.Context, _param: t.CallbackParam, value: bool) -> None:
54
59
  if value:
55
60
  logging.getLogger("mknodes").setLevel(logging.ERROR)
56
61
 
@@ -184,6 +189,106 @@ async def _render_async(input_file: str, output_file: str, repo_url: str | None)
184
189
  logger.info("Rendered output written to: %s", output_file)
185
190
 
186
191
 
192
+ @cli.command()
193
+ def render_folder(
194
+ input_dir: Path = t.Option(..., *INPUT_CMDS, help=INPUT_DIR_HELP), # noqa: B008
195
+ output_dir: Path = t.Option(..., *OUTPUT_CMDS, help=OUTPUT_DIR_HELP), # noqa: B008
196
+ repo_url: str | None = t.Option(None, *REPO_CMDS, help=REPO_HELP, show_default=False),
197
+ glob: str = t.Option("**/*.md", *GLOB_CMDS, help=GLOB_HELP),
198
+ copy_other: bool = t.Option(True, "--copy-other/--no-copy-other", help=COPY_OTHER_HELP),
199
+ workers: int | None = t.Option(None, *WORKERS_CMDS, help=WORKERS_HELP),
200
+ _verbose: bool = t.Option(False, *VERBOSE_CMDS, help=VERBOSE_HELP, callback=verbose_callback),
201
+ _quiet: bool = t.Option(False, *QUIET_CMDS, help=QUIET_HELP, callback=quiet_callback),
202
+ ) -> None:
203
+ """Render a folder of markdown files with Jinja macros.
204
+
205
+ Processes all files matching the glob pattern through Jinja templating,
206
+ preserving directory structure. Non-matching files can optionally be copied as-is.
207
+
208
+ Example:
209
+ mknodes render-folder -i ./src/docs -o ./docs
210
+ mknodes render-folder -i ./templates -o ./output --glob "**/*.md" --no-copy-other
211
+ """
212
+ asyncio.run(_render_folder_async(input_dir, output_dir, repo_url, glob, copy_other, workers))
213
+
214
+
215
+ async def _render_folder_async(
216
+ input_dir: Path,
217
+ output_dir: Path,
218
+ repo_url: str | None,
219
+ glob: str,
220
+ copy_other: bool,
221
+ max_workers: int | None,
222
+ ) -> None:
223
+ """Async implementation of render_folder command."""
224
+ import shutil
225
+ from concurrent.futures import ThreadPoolExecutor
226
+
227
+ from mknodes.jinja import nodeenvironment
228
+
229
+ if not input_dir.exists():
230
+ logger.error("Input directory not found: %s", input_dir)
231
+ raise SystemExit(1)
232
+
233
+ if not input_dir.is_dir():
234
+ logger.error("Input path is not a directory: %s", input_dir)
235
+ raise SystemExit(1)
236
+
237
+ # Create context for rendering
238
+ nav = mk.MkNav.with_context(repo_url=repo_url) if repo_url else mk.MkNav()
239
+ page = nav.add_page("render", is_index=True)
240
+ env = nodeenvironment.NodeEnvironment(node=page)
241
+
242
+ # Collect files to process
243
+ matching_files = list(input_dir.glob(glob))
244
+ all_files = list(input_dir.rglob("*"))
245
+ non_matching_files = [f for f in all_files if f.is_file() and f not in matching_files]
246
+ msg = "Found %d files to render, %d other files"
247
+ logger.info(msg, len(matching_files), len(non_matching_files))
248
+
249
+ # Ensure output directory exists
250
+ output_dir.mkdir(parents=True, exist_ok=True)
251
+
252
+ async def render_file(src: Path) -> None:
253
+ """Render a single file."""
254
+ rel_path = src.relative_to(input_dir)
255
+ dest = output_dir / rel_path
256
+ dest.parent.mkdir(parents=True, exist_ok=True)
257
+
258
+ content = src.read_text(encoding="utf-8")
259
+ rendered = await env.render_string_async(content)
260
+ dest.write_text(rendered, encoding="utf-8")
261
+ logger.debug("Rendered: %s -> %s", src, dest)
262
+
263
+ def copy_file(src: Path) -> None:
264
+ """Copy a single file."""
265
+ rel_path = src.relative_to(input_dir)
266
+ dest = output_dir / rel_path
267
+ dest.parent.mkdir(parents=True, exist_ok=True)
268
+ shutil.copy2(src, dest)
269
+ logger.debug("Copied: %s -> %s", src, dest)
270
+
271
+ # Render matching files
272
+ for src in matching_files:
273
+ await render_file(src)
274
+
275
+ # Copy non-matching files if requested
276
+ if copy_other and non_matching_files:
277
+ loop = asyncio.get_event_loop()
278
+ workers = max_workers or min(32, len(non_matching_files))
279
+ with ThreadPoolExecutor(max_workers=workers) as executor:
280
+ await asyncio.gather(*[
281
+ loop.run_in_executor(executor, copy_file, f) for f in non_matching_files
282
+ ])
283
+
284
+ logger.info(
285
+ "Render complete: %d rendered, %d copied to %s",
286
+ len(matching_files),
287
+ len(non_matching_files) if copy_other else 0,
288
+ output_dir,
289
+ )
290
+
291
+
187
292
  def main() -> None:
188
293
  """Entry point for CLI."""
189
294
  log.basic()
@@ -24,7 +24,7 @@ class Fences:
24
24
  class_name: str
25
25
  format_fn: str | Callable[..., Any]
26
26
 
27
- def as_dict(self):
27
+ def as_dict(self) -> dict[str, Any]:
28
28
  """Return fence data as a dictionary."""
29
29
  return {"name": self.name, "class": self.class_name, "format": self.format_fn}
30
30
 
@@ -27,7 +27,7 @@ class InstallMethod:
27
27
  return {i.ID: i for i in cls.__subclasses__()}
28
28
 
29
29
  @classmethod
30
- def by_id(cls, identifier: str):
30
+ def by_id(cls, identifier: str) -> type[InstallMethod]:
31
31
  return cls.get_installmethods()[identifier]
32
32
 
33
33
 
@@ -2,7 +2,7 @@ from __future__ import annotations
2
2
 
3
3
  import dataclasses
4
4
  import tomllib
5
- from typing import TYPE_CHECKING, Any
5
+ from typing import TYPE_CHECKING, Any, Self
6
6
 
7
7
  from mknodes import paths
8
8
  from mknodes.utils import pathhelpers
@@ -14,6 +14,7 @@ if TYPE_CHECKING:
14
14
  import upath
15
15
 
16
16
  from mknodes.info import folderinfo
17
+ from mknodes.info.folderinfo import FolderInfo
17
18
 
18
19
 
19
20
  @dataclasses.dataclass
@@ -66,13 +67,13 @@ class Tool:
66
67
  return None
67
68
 
68
69
  @classmethod
69
- def from_file(cls, path: upath.UPath | pathlib.Path):
70
+ def from_file(cls, path: upath.UPath | pathlib.Path) -> Self:
70
71
  txt = path.read_text(encoding="utf-8")
71
72
  dct = tomllib.loads(txt)
72
73
  return cls(**dct)
73
74
 
74
75
 
75
- def get_tools_for_folder(folder) -> list[Tool]:
76
+ def get_tools_for_folder(folder: FolderInfo) -> list[Tool]:
76
77
  tools = []
77
78
  for file in (paths.RESOURCES / "toolfiles").iterdir():
78
79
  tool = Tool.from_file(file)
@@ -89,7 +89,7 @@ class MkCodeImage(mknode.MkNode):
89
89
  storage_options: dict[str, Any] | None = None,
90
90
  title: str | None = None,
91
91
  **kwargs: Any,
92
- ):
92
+ ) -> Self:
93
93
  """Create a MkCode node based on a code file.
94
94
 
95
95
  Args: