mknodes 2.0.0a5__tar.gz → 2.0.2__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 (285) hide show
  1. {mknodes-2.0.0a5 → mknodes-2.0.2}/PKG-INFO +5 -1
  2. {mknodes-2.0.0a5 → mknodes-2.0.2}/pyproject.toml +33 -8
  3. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/__init__.py +5 -1
  4. mknodes-2.0.2/src/mknodes/__main__.py +7 -0
  5. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkadmonition/__init__.py +2 -1
  6. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkbasetable/__init__.py +2 -1
  7. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkdefinitionlist/__init__.py +5 -2
  8. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkhtmlblock/__init__.py +5 -2
  9. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mklink/__init__.py +2 -1
  10. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mklist/__init__.py +2 -1
  11. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mknode/__init__.py +6 -74
  12. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkshowcase/__init__.py +2 -1
  13. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkspeechbubble/__init__.py +5 -2
  14. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mktabs/__init__.py +5 -2
  15. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mktasklist/__init__.py +5 -2
  16. mknodes-2.0.2/src/mknodes/build/__init__.py +10 -0
  17. mknodes-2.0.2/src/mknodes/build/builder.py +110 -0
  18. mknodes-2.0.2/src/mknodes/build/exporter.py +168 -0
  19. mknodes-2.0.2/src/mknodes/build/output.py +30 -0
  20. mknodes-2.0.2/src/mknodes/cli/__init__.py +164 -0
  21. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/extranodes/mkgrid/__init__.py +5 -2
  22. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/info/contexts.py +6 -3
  23. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/info/folderinfo.py +2 -1
  24. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/info/mkdocsconfigfile.py +1 -1
  25. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/info/nodefile.py +1 -1
  26. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/info/pyproject.py +3 -1
  27. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/jinja/__init__.py +4 -1
  28. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/jinja/filters.py +1 -1
  29. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/manual/navs_section.py +1 -1
  30. mknodes-2.0.2/src/mknodes/manual/standalone.py +80 -0
  31. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/navs/mkdoc.py +0 -3
  32. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/navs/navigation.py +1 -17
  33. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/navs/navparser.py +1 -1
  34. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/pages/mkpage.py +2 -1
  35. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/pages/mktemplatepage.py +1 -6
  36. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/pages/toc.py +6 -2
  37. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/paths.py +1 -1
  38. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkllm/__init__.py +2 -2
  39. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkmetadatabadges/__init__.py +5 -5
  40. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkpydeps/__init__.py +1 -1
  41. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkshields/__init__.py +2 -1
  42. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mktemplate/__init__.py +2 -7
  43. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mktreeview/metadata.toml +5 -5
  44. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/theme/theme.py +3 -1
  45. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/classhelpers.py +2 -1
  46. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/inventorymanager.py +2 -1
  47. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/packagehelpers.py +1 -1
  48. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/superdict.py +2 -1
  49. {mknodes-2.0.0a5 → mknodes-2.0.2}/LICENSE +0 -0
  50. {mknodes-2.0.0a5 → mknodes-2.0.2}/README.md +0 -0
  51. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/__init__.py +0 -0
  52. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/_mkdocstrings/__init__.py +0 -0
  53. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/_mkdocstrings/metadata.toml +0 -0
  54. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkadmonition/metadata.toml +0 -0
  55. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkannotations/__init__.py +0 -0
  56. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkannotations/metadata.toml +0 -0
  57. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkbinaryimage/__init__.py +0 -0
  58. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkbinaryimage/metadata.toml +0 -0
  59. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkblock/__init__.py +0 -0
  60. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkblockquote/__init__.py +0 -0
  61. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkblockquote/metadata.toml +0 -0
  62. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkcard/__init__.py +0 -0
  63. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkcard/grid.css +0 -0
  64. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkcard/metadata.toml +0 -0
  65. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkclidoc/__init__.py +0 -0
  66. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkclidoc/metadata.toml +0 -0
  67. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkcode/__init__.py +0 -0
  68. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkcode/metadata.toml +0 -0
  69. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkcompactadmonition/__init__.py +0 -0
  70. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkcompactadmonition/compactadmonition.css +0 -0
  71. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkcompactadmonition/metadata.toml +0 -0
  72. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkcontainer/__init__.py +0 -0
  73. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkcontainer/metadata.toml +0 -0
  74. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkcritic/__init__.py +0 -0
  75. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkcritic/metadata.toml +0 -0
  76. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkdataclassinfo/__init__.py +0 -0
  77. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkdataclassinfo/metadata.toml +0 -0
  78. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkdefinitionlist/metadata.toml +0 -0
  79. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkdetailsblock/__init__.py +0 -0
  80. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkdetailsblock/metadata.toml +0 -0
  81. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkdiagram/__init__.py +0 -0
  82. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkdiagram/metadata.toml +0 -0
  83. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkfootnotes/__init__.py +0 -0
  84. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkfootnotes/metadata.toml +0 -0
  85. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkheader/__init__.py +0 -0
  86. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkheader/metadata.toml +0 -0
  87. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkhtmlblock/metadata.toml +0 -0
  88. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkhtmltable/__init__.py +0 -0
  89. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkhtmltable/metadata.toml +0 -0
  90. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkicon/__init__.py +0 -0
  91. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkicon/metadata.toml +0 -0
  92. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkiframe/__init__.py +0 -0
  93. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkiframe/metadata.toml +0 -0
  94. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkimage/__init__.py +0 -0
  95. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkimage/metadata.toml +0 -0
  96. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkimagecompare/__init__.py +0 -0
  97. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkimagecompare/metadata.toml +0 -0
  98. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkimageslideshow/__init__.py +0 -0
  99. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkimageslideshow/metadata.toml +0 -0
  100. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkjupyterlite/__init__.py +0 -0
  101. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkjupyterlite/metadata.toml +0 -0
  102. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkkeys/__init__.py +0 -0
  103. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkkeys/metadata.toml +0 -0
  104. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mklink/metadata.toml +0 -0
  105. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mklist/metadata.toml +0 -0
  106. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkmaterialbadge/__init__.py +0 -0
  107. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkmaterialbadge/materialbadge.css +0 -0
  108. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkmaterialbadge/metadata.toml +0 -0
  109. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkprogressbar/__init__.py +0 -0
  110. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkprogressbar/metadata.toml +0 -0
  111. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkprogressbar/progressbar.css +0 -0
  112. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkpyodide/__init__.py +0 -0
  113. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkpyodide/metadata.toml +0 -0
  114. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkpyscript/__init__.py +0 -0
  115. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkpyscript/metadata.toml +0 -0
  116. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkshowcase/metadata.toml +0 -0
  117. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkspeechbubble/metadata.toml +0 -0
  118. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mkspeechbubble/speechbubble.css +0 -0
  119. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mktabbed/__init__.py +0 -0
  120. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mktabbed/metadata.toml +0 -0
  121. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mktabbedblocks/__init__.py +0 -0
  122. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mktabbedblocks/metadata.toml +0 -0
  123. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mktabcontainer.py +0 -0
  124. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mktable/__init__.py +0 -0
  125. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mktable/metadata.toml +0 -0
  126. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mktabs/mktab.toml +0 -0
  127. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mktasklist/metadata.toml +0 -0
  128. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mktext/__init__.py +0 -0
  129. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mktext/metadata.toml +0 -0
  130. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mktimeline/__init__.py +0 -0
  131. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mktimeline/metadata.toml +0 -0
  132. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mktimeline/timeline.css +0 -0
  133. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/mktimeline/timeline.js +0 -0
  134. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/basenodes/processors/__init__.py +0 -0
  135. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/data/__init__.py +0 -0
  136. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/data/admonition.py +0 -0
  137. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/data/badges.py +0 -0
  138. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/data/buildsystems.py +0 -0
  139. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/data/commitconventions.py +0 -0
  140. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/data/datatypes.py +0 -0
  141. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/data/eventplugins.py +0 -0
  142. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/data/fences.py +0 -0
  143. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/data/installmethods.py +0 -0
  144. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/data/taskrunners.py +0 -0
  145. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/data/tools.py +0 -0
  146. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/data/treestyles.py +0 -0
  147. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/extranodes/__init__.py +0 -0
  148. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/extranodes/mkcodeimage/__init__.py +0 -0
  149. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/extranodes/mkcodeimage/metadata.toml +0 -0
  150. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/extranodes/mkgrid/metadata.toml +0 -0
  151. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/extranodes/mkprettyprint/__init__.py +0 -0
  152. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/extranodes/mkprettyprint/metadata.toml +0 -0
  153. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/extranodes/mksnippet/__init__.py +0 -0
  154. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/extranodes/mksnippet/metadata.toml +0 -0
  155. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/info/__init__.py +0 -0
  156. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/info/configfile.py +0 -0
  157. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/info/gitrepository.py +0 -0
  158. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/info/grifferegistry.py +0 -0
  159. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/info/license.py +0 -0
  160. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/info/linkprovider.py +0 -0
  161. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/info/packageinfo.py +0 -0
  162. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/info/packageregistry.py +0 -0
  163. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/info/reporegistry.py +0 -0
  164. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/jinja/nodeenvironment.py +0 -0
  165. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/manual/__init__.py +0 -0
  166. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/manual/a_quick_tour.py +0 -0
  167. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/manual/dev_section.py +0 -0
  168. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/manual/get_started_section.py +0 -0
  169. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/manual/github_index.py +0 -0
  170. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/manual/nodes_section.py +0 -0
  171. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/manual/page_section.py +0 -0
  172. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/manual/root.py +0 -0
  173. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/manual/routing.py +0 -0
  174. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/manual/templating_section.py +0 -0
  175. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/mdlib/__init__.py +0 -0
  176. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/mdlib/mdconverter.py +0 -0
  177. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/navs/__init__.py +0 -0
  178. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/navs/mknav.py +0 -0
  179. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/navs/navbuilder.py +0 -0
  180. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/navs/navrouter.py +0 -0
  181. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/navs/router.py +0 -0
  182. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/nodemods/__init__.py +0 -0
  183. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/nodemods/mod.py +0 -0
  184. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/nodemods/modmanager.py +0 -0
  185. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/nodemods/parallax.py +0 -0
  186. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/nodemods/parallax.toml +0 -0
  187. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/nodemods/scrollreveal.py +0 -0
  188. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/nodemods/scrollreveal.toml +0 -0
  189. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/pages/__init__.py +0 -0
  190. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/pages/metadata.py +0 -0
  191. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/pages/mkclasspage/__init__.py +0 -0
  192. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/pages/mkclasspage/classpage.md +0 -0
  193. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/pages/mkclasspage/classpage_tabbed.md +0 -0
  194. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/pages/mkmodulepage/__init__.py +0 -0
  195. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/pages/mkmodulepage/modulepage.md +0 -0
  196. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/pages/pagetemplate.py +0 -0
  197. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/pages/templateblocks.py +0 -0
  198. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/pages/templateregistry.py +0 -0
  199. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/py.typed +0 -0
  200. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/resources/css/animated.css +0 -0
  201. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/resources/css/hero.css +0 -0
  202. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/resources/css/material_css_extra.jinja +0 -0
  203. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/resources/css/theme_material.css +0 -0
  204. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/resources/css/theme_mkdocs.css +0 -0
  205. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/resources/filters.toml +0 -0
  206. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/resources/js/tablesort.js +0 -0
  207. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/resources/python_objects.inv +0 -0
  208. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/resources/toolfiles/tool_black.toml +0 -0
  209. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/resources/toolfiles/tool_coverage.toml +0 -0
  210. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/resources/toolfiles/tool_mkdocs.toml +0 -0
  211. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/resources/toolfiles/tool_mypy.toml +0 -0
  212. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/resources/toolfiles/tool_precommit.toml +0 -0
  213. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/resources/toolfiles/tool_pyright.toml +0 -0
  214. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/resources/toolfiles/tool_ruff.toml +0 -0
  215. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/__init__.py +0 -0
  216. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkbadge/__init__.py +0 -0
  217. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkbadge/metadata.toml +0 -0
  218. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkchangelog/__init__.py +0 -0
  219. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkchangelog/metadata.toml +0 -0
  220. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkclassdiagram/__init__.py +0 -0
  221. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkclassdiagram/metadata.toml +0 -0
  222. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkclasstable/__init__.py +0 -0
  223. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkclasstable/metadata.toml +0 -0
  224. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkcodeofconduct/__init__.py +0 -0
  225. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkcodeofconduct/metadata.toml +0 -0
  226. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkcommandoutput/__init__.py +0 -0
  227. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkcommandoutput/metadata.toml +0 -0
  228. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkcommandoutput/terminal.css +0 -0
  229. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkcommentedcode/__init__.py +0 -0
  230. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkcommentedcode/metadata.toml +0 -0
  231. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkcommitconventions/__init__.py +0 -0
  232. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkcommitconventions/metadata.toml +0 -0
  233. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkconfigsetting/__init__.py +0 -0
  234. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkconfigsetting/metadata.toml +0 -0
  235. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkdependencytable/__init__.py +0 -0
  236. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkdependencytable/metadata.toml +0 -0
  237. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkdevenvsetup/__init__.py +0 -0
  238. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkdevenvsetup/metadata.toml +0 -0
  239. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkdevtools/__init__.py +0 -0
  240. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkdevtools/metadata.toml +0 -0
  241. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkinclude/__init__.py +0 -0
  242. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkinclude/metadata.toml +0 -0
  243. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkinstallguide/__init__.py +0 -0
  244. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkinstallguide/metadata.toml +0 -0
  245. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mklicense/__init__.py +0 -0
  246. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mklicense/metadata.toml +0 -0
  247. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkllm/metadata.toml +0 -0
  248. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkmetadatabadges/metadata.toml +0 -0
  249. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkmoduletable/__init__.py +0 -0
  250. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkmoduletable/metadata.toml +0 -0
  251. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkpipdeptree/__init__.py +0 -0
  252. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkpipdeptree/metadata.toml +0 -0
  253. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkpluginflow/__init__.py +0 -0
  254. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkpluginflow/metadata.toml +0 -0
  255. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkpydeps/metadata.toml +0 -0
  256. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkreprrawrendered/__init__.py +0 -0
  257. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkreprrawrendered/metadata.toml +0 -0
  258. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mkshields/metadata.toml +0 -0
  259. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mktemplate/metadata.toml +0 -0
  260. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mktemplatetable/__init__.py +0 -0
  261. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mktemplatetable/metadata.toml +0 -0
  262. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/templatenodes/mktreeview/__init__.py +0 -0
  263. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/theme/__init__.py +0 -0
  264. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/theme/colortheme.py +0 -0
  265. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/theme/materialtheme/__init__.py +0 -0
  266. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/theme/materialtheme/palette.py +0 -0
  267. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/theme/mkblog.py +0 -0
  268. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/theme/mkgitblog.py +0 -0
  269. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/treelib/__init__.py +0 -0
  270. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/treelib/treeprint.py +0 -0
  271. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/__init__.py +0 -0
  272. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/annotationappender.py +0 -0
  273. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/color.py +0 -0
  274. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/connector.py +0 -0
  275. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/coroutines.py +0 -0
  276. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/downloadhelpers.py +0 -0
  277. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/helpers.py +0 -0
  278. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/icons.py +0 -0
  279. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/inspecthelpers.py +0 -0
  280. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/linkreplacer.py +0 -0
  281. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/log.py +0 -0
  282. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/pathhelpers.py +0 -0
  283. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/reprhelpers.py +0 -0
  284. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/resources.py +0 -0
  285. {mknodes-2.0.0a5 → mknodes-2.0.2/src}/mknodes/utils/xmlhelpers.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: mknodes
3
- Version: 2.0.0a5
3
+ Version: 2.0.2
4
4
  Summary: Don't write docs. Code them.
5
5
  Keywords: docs,docstrings,documentation,framework,internet,markdown
6
6
  Author: Philipp Temminghoff
@@ -64,11 +64,15 @@ Requires-Dist: pytest-asyncio>=1.3.0
64
64
  Requires-Dist: python-dotenv
65
65
  Requires-Dist: setuptools>=80.9.0
66
66
  Requires-Dist: tomli-w
67
+ Requires-Dist: typer>=0.12.0
67
68
  Requires-Dist: universal-pathlib
68
69
  Requires-Dist: upathtools[httpx]
69
70
  Requires-Dist: yamling
70
71
  Requires-Python: >=3.13
72
+ Project-URL: Code coverage, https://app.codecov.io/gh/phil65/mknodes
73
+ Project-URL: Discussions, https://github.com/phil65/mknodes/discussions
71
74
  Project-URL: Documentation, https://phil65.github.io/mknodes/
75
+ Project-URL: Issues, https://github.com/phil65/mknodes/issues
72
76
  Project-URL: Source, https://github.com/phil65/mknodes
73
77
  Description-Content-Type: text/markdown
74
78
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  [project]
4
4
  name = "mknodes"
5
- version = "2.0.0a5"
5
+ version = "2.0.2"
6
6
  description = "Don't write docs. Code them."
7
7
  readme = "README.md"
8
8
  requires-python = ">=3.13"
@@ -63,6 +63,7 @@ dependencies = [
63
63
  # Serialization
64
64
  "setuptools>=80.9.0",
65
65
  "tomli-w",
66
+ "typer>=0.12.0",
66
67
  "universal_pathlib",
67
68
  "upathtools[httpx]",
68
69
  "yamling",
@@ -70,9 +71,15 @@ dependencies = [
70
71
  ]
71
72
 
72
73
  [project.urls]
74
+ "Code coverage" = "https://app.codecov.io/gh/phil65/mknodes"
75
+ Discussions = "https://github.com/phil65/mknodes/discussions"
73
76
  Documentation = "https://phil65.github.io/mknodes/"
77
+ Issues = "https://github.com/phil65/mknodes/issues"
74
78
  Source = "https://github.com/phil65/mknodes"
75
79
 
80
+ [project.scripts]
81
+ mknodes = "mknodes.cli:main"
82
+
76
83
  [project.entry-points."jinjarope.environment"]
77
84
  mknodes = "mknodes.jinja:setup_env"
78
85
 
@@ -137,19 +144,22 @@ docstring-style = "google"
137
144
 
138
145
  [tool.mypy]
139
146
  python_version = "3.13"
147
+ pretty = true
140
148
  check_untyped_defs = true
149
+ exclude = ["venv/", ".venv/", "tests/"]
150
+ plugins = []
141
151
 
142
152
  [tool.pyright]
143
153
  venvPath = "."
144
154
  venv = ".venv"
145
155
  pythonVersion = "3.13"
146
156
  pythonPlatform = "All"
157
+ typeCheckingMode = "basic"
147
158
  deprecateTypingAliases = true
148
159
  reportMissingTypeStubs = false
149
160
  reportUnusedCallResult = false
150
161
  reportUnknownVariableType = false
151
162
  reportAny = false
152
- reportExplicitAny = false
153
163
  reportImplicitOverride = false
154
164
  reportUnusedFunction = false
155
165
  reportImplicitStringConcatenation = false
@@ -157,13 +167,15 @@ reportIgnoreCommentWithoutRule = false
157
167
  reportUnannotatedClassAttribute = false
158
168
  reportSelfClsParameterName = false
159
169
  reportPrivateImportUsage = false
160
- reportUnreachable = false
161
170
 
162
171
  [tool.pytest]
163
172
  addopts = ["--cov-report=term-missing", "--cov=mknodes/"]
164
173
  log_cli = true
165
174
  log_date_format = "%Y-%m-%d %H:%M:%S"
166
175
  log_format = "%(asctime)s %(levelname)s %(message)s"
176
+ markers = [
177
+ "integration: marks tests as integration tests (deselected by default)",
178
+ ]
167
179
  minversion = "9.0"
168
180
  testpaths = ["tests"]
169
181
  asyncio_default_fixture_loop_scope = "function"
@@ -175,7 +187,7 @@ extend-exclude = ["docs"]
175
187
  target-version = "py313"
176
188
 
177
189
  [tool.ruff.lint]
178
- preview = true
190
+ future-annotations = true
179
191
  select = [
180
192
  "A", # Flake8-builtins
181
193
  # "ANN", # Flake8-Annotations
@@ -289,6 +301,21 @@ ignore = [
289
301
  [tool.ruff.lint.flake8-quotes]
290
302
  docstring-quotes = "double"
291
303
 
304
+ [tool.ruff.lint.flake8-type-checking]
305
+ runtime-evaluated-base-classes = [
306
+ "pydantic.BaseModel",
307
+ "sqlalchemy.orm.DeclarativeBase",
308
+ "schemez.Schema",
309
+ "sqlmodel.SQLModel",
310
+ ]
311
+ runtime-evaluated-decorators = [
312
+ "pydantic.validate_call",
313
+ "fastapi.FastAPI.get",
314
+ "fastapi.FastAPI.post",
315
+ "fastmcp.FastMCP.tool",
316
+ "typer.Typer.command",
317
+ ]
318
+
292
319
  [tool.ruff.lint.isort]
293
320
  lines-after-imports = 2
294
321
  # lines-between-types = 1
@@ -298,11 +325,9 @@ combine-as-imports = true
298
325
 
299
326
  [tool.ruff.lint.per-file-ignores]
300
327
  "__init__.py" = ["E402", "I001"]
328
+ "scripts/*" = ["INP001"]
329
+ "*tests/*" = ["D100"]
301
330
 
302
331
  [tool.ruff.format]
303
- # Enable preview style formatting.
304
332
  preview = true
305
333
  docstring-code-format = true
306
-
307
- [tool.uv.build-backend]
308
- module-root = ""
@@ -56,6 +56,8 @@ from .pages.mkmodulepage import MkModulePage
56
56
  from .navs.mknav import MkNav
57
57
  from .navs.mkdoc import MkDoc
58
58
 
59
+ from .build import BuildOutput, DocBuilder, MarkdownExporter
60
+
59
61
  from .templatenodes.mkinclude import MkInclude
60
62
  from .templatenodes.mkshields import MkShields
61
63
  from .templatenodes.mkinstallguide import MkInstallGuide
@@ -105,6 +107,9 @@ async def parse(project=None, **kwargs):
105
107
  __version__ = version("mknodes")
106
108
 
107
109
  __all__ = [
110
+ "BuildOutput",
111
+ "DocBuilder",
112
+ "MarkdownExporter",
108
113
  "MaterialTheme",
109
114
  "Metadata",
110
115
  "MkAdmonition",
@@ -119,7 +124,6 @@ __all__ = [
119
124
  "MkClassPage",
120
125
  "MkClassTable",
121
126
  "MkCliDoc",
122
- # "MkGrid",
123
127
  "MkCode",
124
128
  "MkCodeOfConduct",
125
129
  "MkCommandOutput",
@@ -0,0 +1,7 @@
1
+ """Entry point for `python -m mknodes`."""
2
+
3
+ from mknodes.cli import main
4
+
5
+
6
+ if __name__ == "__main__":
7
+ main()
@@ -4,10 +4,11 @@ import textwrap
4
4
 
5
5
  from typing import Any, Literal, TYPE_CHECKING
6
6
 
7
- from mknodes.basenodes import mkcontainer, mknode
7
+ from mknodes.basenodes import mkcontainer
8
8
  from mknodes.utils import log, resources
9
9
 
10
10
  if TYPE_CHECKING:
11
+ from mknodes.basenodes import mknode
11
12
  from mknodes.data import datatypes
12
13
 
13
14
 
@@ -1,6 +1,6 @@
1
1
  from __future__ import annotations
2
2
 
3
- from collections.abc import Callable, Iterator, Mapping, Sequence
3
+ from collections.abc import Mapping
4
4
  from typing import TYPE_CHECKING, Any
5
5
 
6
6
  from mknodes.basenodes import mkcontainer
@@ -8,6 +8,7 @@ from mknodes.utils import log, reprhelpers
8
8
 
9
9
 
10
10
  if TYPE_CHECKING:
11
+ from collections.abc import Callable, Iterator, Sequence
11
12
  import mknodes as mk
12
13
 
13
14
  logger = log.get_logger(__name__)
@@ -1,11 +1,14 @@
1
1
  from __future__ import annotations
2
2
 
3
3
  from collections.abc import Mapping
4
- from typing import Any
4
+ from typing import Any, TYPE_CHECKING
5
5
  from jinja2 import filters
6
- from mknodes.basenodes import mkcontainer, mknode
6
+ from mknodes.basenodes import mkcontainer
7
7
  from mknodes.utils import log, reprhelpers, resources
8
8
 
9
+ if TYPE_CHECKING:
10
+ from mknodes.basenodes import mknode
11
+
9
12
 
10
13
  logger = log.get_logger(__name__)
11
14
 
@@ -1,10 +1,13 @@
1
1
  from __future__ import annotations
2
2
 
3
- from typing import Any, Literal
3
+ from typing import Any, Literal, TYPE_CHECKING
4
4
 
5
- from mknodes.basenodes import mkblock, mknode
5
+ from mknodes.basenodes import mkblock
6
6
  from mknodes.utils import log, reprhelpers, resources
7
7
 
8
+ if TYPE_CHECKING:
9
+ from mknodes.basenodes import mknode
10
+
8
11
 
9
12
  logger = log.get_logger(__name__)
10
13
 
@@ -4,13 +4,14 @@ import inspect
4
4
  import os
5
5
  import types
6
6
  from typing import TYPE_CHECKING, Any
7
- from collections.abc import Mapping, Sequence
7
+ from collections.abc import Mapping
8
8
  import json
9
9
  from mknodes.basenodes import mknode
10
10
  from mknodes.utils import icons, log
11
11
  from upathtools import to_upath
12
12
 
13
13
  if TYPE_CHECKING:
14
+ from collections.abc import Sequence
14
15
  from mknodes.info import linkprovider
15
16
 
16
17
  logger = log.get_logger(__name__)
@@ -2,11 +2,12 @@ from __future__ import annotations
2
2
 
3
3
  from typing import Any, TYPE_CHECKING
4
4
 
5
- from mknodes.basenodes import mkcontainer, mknode
5
+ from mknodes.basenodes import mkcontainer
6
6
  from mknodes.info import linkprovider
7
7
  from mknodes.utils import log, resources
8
8
 
9
9
  if TYPE_CHECKING:
10
+ from mknodes.basenodes import mknode
10
11
  from collections.abc import Sequence
11
12
 
12
13
 
@@ -14,27 +14,24 @@ from mknodes.utils import icons, log, mdconverter, reprhelpers, resources, corou
14
14
 
15
15
 
16
16
  if TYPE_CHECKING:
17
- from collections.abc import Callable, Iterable, Iterator, Sequence
17
+ from collections.abc import Callable, Iterable, Iterator
18
18
  import types
19
19
 
20
20
  from mknodes.data import datatypes
21
21
  import mknodes as mk
22
22
 
23
23
 
24
+ logger = log.get_logger(__name__)
25
+ HEADER_REGEX = re.compile(r"^(#{1,6}) (.*)")
26
+ fallback_ctx = contexts.ProjectContext()
27
+
28
+
24
29
  class IllegalArgumentError(ValueError):
25
30
  def __init__(self, node: mk.MkNode, kwargs: Any) -> None:
26
31
  msg = f"Invalid keyword arguments for {type(node)!r}: {kwargs}"
27
32
  super().__init__(msg)
28
33
 
29
34
 
30
- logger = log.get_logger(__name__)
31
-
32
-
33
- HEADER_REGEX = re.compile(r"^(#{1,6}) (.*)")
34
-
35
- fallback_ctx = contexts.ProjectContext()
36
-
37
-
38
35
  class MkNode:
39
36
  """Base class for everything which can be expressed as Markup.
40
37
 
@@ -146,27 +143,6 @@ class MkNode:
146
143
  setattr(result, k, copy.deepcopy(v, memo))
147
144
  return result
148
145
 
149
- def append_child(self, item: MkNode) -> None:
150
- """Append a node as a child.
151
-
152
- Args:
153
- item: Node to add as a child
154
- """
155
- item.parent = self
156
- self.get_children().append(item)
157
-
158
- def insert_children(self, idx: int, items: Sequence[MkNode]) -> None:
159
- """Insert a list of child nodes at given index.
160
-
161
- Args:
162
- idx: The index of insertion
163
- items: A sequence of nodes to add as children
164
- """
165
- children = self.get_children()
166
- children[idx:idx] = items
167
- for item in items:
168
- item.parent = self
169
-
170
146
  @property
171
147
  def ancestors(self) -> Iterable[MkNode]:
172
148
  """Get iterator to yield all ancestors of self, does not include self."""
@@ -188,11 +164,6 @@ class MkNode:
188
164
  """
189
165
  return any(isinstance(i, kls) for i in self.ancestors)
190
166
 
191
- @property
192
- def leaves(self) -> Iterable[MkNode]:
193
- """Get iterator to yield all leaf nodes from self."""
194
- yield from self._preorder_iter(filter_condition=lambda _node: _node.is_leaf)
195
-
196
167
  @property
197
168
  def siblings(self) -> Iterable[MkNode]:
198
169
  """Get siblings of self."""
@@ -239,16 +210,6 @@ class MkNode:
239
210
  """Get indicator if self is leaf node."""
240
211
  return not list(self.get_children())
241
212
 
242
- @property
243
- def is_first_child(self) -> bool:
244
- """Get indicator if self is first child of parent."""
245
- return not bool(self.left_sibling)
246
-
247
- @property
248
- def is_last_child(self) -> bool:
249
- """Get indicator if self is last child of parent."""
250
- return not bool(self.right_sibling)
251
-
252
213
  @property
253
214
  def root(self) -> MkNode:
254
215
  """Get root node of tree."""
@@ -419,28 +380,6 @@ class MkNode:
419
380
  dct_2.pop(attr)
420
381
  return dct_1 == dct_2
421
382
 
422
- def __rshift__(self, other: mk.MkNode | str):
423
- import mknodes as mk
424
-
425
- if self.parent or (isinstance(other, mk.MkNode) and other.parent):
426
- msg = "Can only perform shift when nodes have no parent"
427
- raise RuntimeError(msg)
428
- container = mk.MkContainer(parent=self.parent, block_separator=" ")
429
- container.append(self)
430
- container.append(other)
431
- return container
432
-
433
- def __rrshift__(self, other: mk.MkNode | str):
434
- import mknodes as mk
435
-
436
- if self.parent or (isinstance(other, mk.MkNode) and other.parent):
437
- msg = "Can only perform shift when nodes have no parent"
438
- raise RuntimeError(msg)
439
- container = mk.MkContainer(parent=self.parent, block_separator=" ")
440
- container.append(other)
441
- container.append(self)
442
- return container
443
-
444
383
  @property
445
384
  def ctx(self) -> contexts.ProjectContext:
446
385
  """The tree context.
@@ -671,10 +610,3 @@ class MkNode:
671
610
  exts = list(configs.keys())
672
611
  converter = mdconverter.MdConverter(extensions=exts, extension_configs=configs)
673
612
  return converter.convert(md)
674
-
675
-
676
- if __name__ == "__main__":
677
- import mknodes as mk
678
-
679
- section = "pre" >> mk.MkText("hello\n# Header\nfdsfds") >> "test" >> "xx"
680
- print(section)
@@ -8,12 +8,13 @@ from typing import TYPE_CHECKING, Any
8
8
 
9
9
  from jinja2 import filters
10
10
 
11
- from mknodes.basenodes import mkcard, mkcontainer, mknode
11
+ from mknodes.basenodes import mkcard, mkcontainer
12
12
  from mknodes.pages import mkpage
13
13
  from mknodes.utils import log, pathhelpers
14
14
 
15
15
 
16
16
  if TYPE_CHECKING:
17
+ from mknodes.basenodes import mknode
17
18
  import mknodes as mk
18
19
 
19
20
 
@@ -1,10 +1,13 @@
1
1
  from __future__ import annotations
2
2
 
3
- from typing import Any, Literal
3
+ from typing import Any, Literal, TYPE_CHECKING
4
4
 
5
- from mknodes.basenodes import mkcontainer, mknode
5
+ from mknodes.basenodes import mkcontainer
6
6
  from mknodes.utils import log, resources, xmlhelpers as xml
7
7
 
8
+ if TYPE_CHECKING:
9
+ from mknodes.basenodes import mknode
10
+
8
11
 
9
12
  logger = log.get_logger(__name__)
10
13
 
@@ -2,11 +2,14 @@ from __future__ import annotations
2
2
 
3
3
  import textwrap
4
4
 
5
- from typing import Any
5
+ from typing import Any, TYPE_CHECKING
6
6
 
7
- from mknodes.basenodes import mkblock, mkcontainer, mknode
7
+ from mknodes.basenodes import mkblock, mkcontainer
8
8
  from mknodes.utils import log, reprhelpers, resources
9
9
 
10
+ if TYPE_CHECKING:
11
+ from mknodes.basenodes import mknode
12
+
10
13
 
11
14
  logger = log.get_logger(__name__)
12
15
 
@@ -1,12 +1,15 @@
1
1
  from __future__ import annotations
2
2
 
3
- from typing import Any
3
+ from typing import Any, TYPE_CHECKING
4
4
 
5
5
  from jinja2 import filters
6
6
 
7
- from mknodes.basenodes import mkcontainer, mknode
7
+ from mknodes.basenodes import mkcontainer
8
8
  from mknodes.utils import log, resources
9
9
 
10
+ if TYPE_CHECKING:
11
+ from mknodes.basenodes import mknode
12
+
10
13
 
11
14
  logger = log.get_logger(__name__)
12
15
 
@@ -0,0 +1,10 @@
1
+ """Build module for generating documentation output."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from mknodes.build.builder import DocBuilder
6
+ from mknodes.build.exporter import Exporter, MarkdownExporter
7
+ from mknodes.build.output import BuildOutput
8
+
9
+
10
+ __all__ = ["BuildOutput", "DocBuilder", "Exporter", "MarkdownExporter"]
@@ -0,0 +1,110 @@
1
+ """Core documentation builder."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from typing import TYPE_CHECKING
6
+
7
+ from mknodes.utils import log, resources
8
+
9
+
10
+ if TYPE_CHECKING:
11
+ import mknodes as mk
12
+
13
+ from .output import BuildOutput
14
+
15
+
16
+ logger = log.get_logger(__name__)
17
+
18
+
19
+ class DocBuilder:
20
+ """Traverses node tree, renders markdown, collects resources."""
21
+
22
+ def __init__(self, render_jinja: bool = True):
23
+ """Constructor.
24
+
25
+ Args:
26
+ render_jinja: Whether to render Jinja templates in pages.
27
+ """
28
+ self.render_jinja = render_jinja
29
+ self._files: dict[str, str | bytes] = {}
30
+ self._resources = resources.Resources()
31
+
32
+ async def build(self, root: mk.MkNav) -> BuildOutput:
33
+ """Build documentation from a navigation tree.
34
+
35
+ Args:
36
+ root: Root navigation node to build from.
37
+
38
+ Returns:
39
+ BuildOutput containing all files and collected resources.
40
+ """
41
+ import mknodes as mk
42
+ from mknodes.build.output import BuildOutput
43
+
44
+ logger.info("Starting documentation build...")
45
+
46
+ page_count = 0
47
+
48
+ # First pass: collect all pages and navs
49
+ for _level, node in root.iter_nodes():
50
+ self._files |= node.files
51
+
52
+ match node:
53
+ case mk.MkPage() as page:
54
+ await self._process_page(page)
55
+ page_count += 1
56
+ case mk.MkNav() as nav:
57
+ await self._process_nav(nav)
58
+
59
+ # Build nav structure
60
+ nav_structure = root.nav.to_nav_dict()
61
+
62
+ return BuildOutput(
63
+ files=self._files,
64
+ resources=self._resources,
65
+ nav_structure=nav_structure,
66
+ page_count=page_count,
67
+ )
68
+
69
+ async def _process_page(self, page: mk.MkPage) -> None:
70
+ """Process a single page: render and collect resources.
71
+
72
+ Args:
73
+ page: Page to process.
74
+ """
75
+ if page.resolved_metadata.inclusion_level is False:
76
+ return
77
+
78
+ path = page.resolved_file_path
79
+ logger.debug("Processing page: %s", path)
80
+
81
+ # Collect resources
82
+ req = await page.get_resources()
83
+ self._resources.merge(req)
84
+
85
+ # Render markdown
86
+ md = await page.to_markdown()
87
+
88
+ if self.render_jinja:
89
+ render = page.metadata.get("render_macros", True)
90
+ if render:
91
+ md = await page.env.render_string_async(md)
92
+
93
+ self._files[path] = md
94
+
95
+ async def _process_nav(self, nav: mk.MkNav) -> None:
96
+ """Process a navigation section.
97
+
98
+ Args:
99
+ nav: Navigation to process.
100
+ """
101
+ path = nav.resolved_file_path
102
+ logger.debug("Processing nav: %s", nav.title or "[ROOT]")
103
+
104
+ # Collect resources
105
+ req = await nav.get_node_resources()
106
+ self._resources.merge(req)
107
+
108
+ # Render nav markdown (SUMMARY.md style)
109
+ md = await nav.to_markdown()
110
+ self._files[path] = md