thinking-machines-lab/tinker
1
0
Fork 0
mirror of https://github.com/thinking-machines-lab/tinker.git synced 2026-04-26 17:13:11 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Sync contents

Browse source
This commit is contained in:
Dylan Huang 2026-03-19 00:10:49 +00:00
parent 35a77e79fe
commit f3c0b1f179
17 changed files with 2069 additions and 632 deletions
Download patch file Download diff file Expand all files Collapse all files

39
scripts/generate_docs.py
View file

@ -10,6 +10,7 @@
import ast
import json
import os
import shutil
import subprocess
import sys
from pathlib import Path
@ -95,8 +96,42 @@ class DocumentationGenerator:
def run_pydoc_markdown(self, modules: List[str], output_file: Path) -> bool:
"""Run pydoc-markdown for specific modules."""
try:
# Build the command
cmd = ["pydoc-markdown", "pydoc-markdown.yml", "-I", "src"]
# Invoke pydoc-markdown via uvx/uv tool run so the required
# doc-generation dependencies are resolved consistently.
uvx_path = shutil.which("uvx")
if uvx_path:
cmd = [
uvx_path,
"--from",
"pydoc-markdown>=4.8.0",
"--with",
"pyyaml>=6.0",
"--with",
"setuptools",
"pydoc-markdown",
"pydoc-markdown.yml",
"-I",
"src",
]
else:
uv_path = shutil.which("uv")
if uv_path is None:
raise FileNotFoundError("Could not find `uvx` or `uv` on PATH")
cmd = [
uv_path,
"tool",
"run",
"--from",
"pydoc-markdown>=4.8.0",
"--with",
"pyyaml>=6.0",
"--with",
"setuptools",
"pydoc-markdown",
"pydoc-markdown.yml",
"-I",
"src",
]
# Add modules
for module in modules: