mirror of
https://github.com/lightpanda-io/browser.git
synced 2026-07-31 17:55:59 -04:00
f4ecf92f3b
pip-installable Python API driving the bundled binary over MCP HTTP: Browser/Session with one generated method per browser tool (lightpanda/_methods.py, regenerated from tools/list), run_script() replay, a CLI trampoline entry point, pytest suite against local fixtures, and pdoc docs generation.
33 lines
954 B
Python
33 lines
954 B
Python
"""Generate API documentation with pdoc (zignal's flow, adapted).
|
|
|
|
Usage, from bindings/python (needs a lightpanda binary for regeneration):
|
|
uv run --group docs python scripts/build_docs.py
|
|
"""
|
|
|
|
import shutil
|
|
import subprocess
|
|
import sys
|
|
from pathlib import Path
|
|
|
|
HERE = Path(__file__).parent.parent
|
|
|
|
|
|
def main():
|
|
print("Regenerating tool methods from the binary...")
|
|
if subprocess.call([sys.executable, str(HERE / "scripts" / "generate_methods.py")]) != 0:
|
|
sys.exit("error: failed to regenerate lightpanda/_methods.py")
|
|
|
|
docs_dir = HERE / "docs"
|
|
if docs_dir.exists():
|
|
shutil.rmtree(docs_dir)
|
|
|
|
print("Generating documentation...")
|
|
cmd = [sys.executable, "-m", "pdoc", "lightpanda", "-o", str(docs_dir), "--no-show-source"]
|
|
if subprocess.call(cmd, cwd=HERE) != 0:
|
|
sys.exit("error generating documentation")
|
|
print(f"documentation generated in {docs_dir}")
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|