bug(doc): local `mkdocs` build issue

[LouisTsai-Csie]

Summary

I could not build the documentation locally with mkdoc.

Environment: MacOS (M2 chip)

Reproduction

I follow the documentation to build:

1. uv sync --all-extras
2. uv run mkdocs build --strict or uv run mkdocs serve

I will get the following output in terminal

(ethereum-execution-spec-tests) caijiacheng@caijiachengs-MacBook-Air execution-spec-tests % uv run mkdocs build --strict
ERROR   -  "cairosvg" Python module is installed, but it crashed with:
           no library called "cairo-2" was found
           no library called "cairo" was found
           no library called "libcairo-2" was found
           cannot load library 'libcairo.so.2': dlopen(libcairo.so.2, 0x0002): tried: 'libcairo.so.2' (no such file), '/System/Volumes/Preboot/Cryptexes/OSlibcairo.so.2' (no such
           file), '/usr/lib/libcairo.so.2' (no such file, not in dyld cache), 'libcairo.so.2' (no such file).  Additionally, ctypes.util.find_library() did not manage to locate a
           library called 'libcairo.so.2'
           cannot load library 'libcairo.2.dylib': dlopen(libcairo.2.dylib, 0x0002): tried: 'libcairo.2.dylib' (no such file),
           '/System/Volumes/Preboot/Cryptexes/OSlibcairo.2.dylib' (no such file), '/usr/lib/libcairo.2.dylib' (no such file, not in dyld cache), 'libcairo.2.dylib' (no such
           file).  Additionally, ctypes.util.find_library() did not manage to locate a library called 'libcairo.2.dylib'
           cannot load library 'libcairo-2.dll': dlopen(libcairo-2.dll, 0x0002): tried: 'libcairo-2.dll' (no such file), '/System/Volumes/Preboot/Cryptexes/OSlibcairo-2.dll' (no
           such file), '/usr/lib/libcairo-2.dll' (no such file, not in dyld cache), 'libcairo-2.dll' (no such file).  Additionally, ctypes.util.find_library() did not manage to
           locate a library called 'libcairo-2.dll'

           --> Check out the troubleshooting guide: https://t.ly/MfX6u

Aborted with a BuildError!

After consulting online resource and LLM, I've tried the following steps:

1. brew install cairo / brew reinstall cairo
2. unistall and install cairosvg again
3. Export the library path for macOS dynamic linker:

export DYLD_LIBRARY_PATH="/opt/homebrew/lib:$DYLD_LIBRARY_PATH"
export DYLD_LIBRARY_PATH="/usr/local/lib:$DYLD_LIBRARY_PATH"

[fselmo]

I'm seeing this as well - MacOS M3 👍🏼

[LouisTsai-Csie]

I later tried uvx --with=tox-uv tox -e mkdocs command, but encounter another issue.

tests/prague/eip2537_bls_12_381_precompiles/helpers.py:405: in
           find_g2_point_by_x
INFO    -      raise ValueError(
INFO    -  E   ValueError: ('Failed to find G2 point by
           x=(3774909539632720209615359732343820780355072254513441911318,
           4768170580756990927476434470010702123794868313605627473304),',
           'in_subgroup={in_subgroup},', 'on_curve={on_curve}')

It seems like the BLS precompile is not passing rn.

I also check this trick here, but it still not working:

export DYLD_FALLBACK_LIBRARY_PATH=/opt/homebrew/lib