`mkdocs build` command fails when running `make run`
When I do make run
as instructed in the README, the Make process tries to call mkdocs build
, which fails with the following error:
mkdocs build
make: mkdocs: No such file or directory
make: *** [site/index.html] Error 1
This appears to be because mkdocs build
doesn't refer to the copy of mkdocs
in the local environment, unlike similar commands in the Makefile which are prefix with .venv/bin/
to solve this. Adding this to the command in the Makefile solves this, but then I get:
File "/Users/admin/Desktop/work/opentechstrategies/llm-api/.venv/lib/python3.10/site-packages/mkdocstrings_handlers/python/handler.py", line 15, in <module>
from griffe.collections import LinesCollection, ModulesCollection
ModuleNotFoundError: No module named 'griffe.collections'
This appears to be a mkdocs version mismatch with a dependency (griffe released a new version with a different API), which is solvable by upgrading mkdocstrings-python
to 1.10.8
.
You should expect an MR with both changes shortly.