docs(bug): unable to install eest with error Failed to build coincurve==20.0.0

[daniellehrner]

I've used tag [email protected] on MacOS Sequioa and ran uv sync --all-extras. The full error is:

  × Failed to build `coincurve==20.0.0`
  ├─▶ The build backend returned an error
  ╰─▶ Call to `hatchling.build.build_wheel` failed (exit status: 1)

      [stdout]
      WARNING: Use build.verbose instead of cmake.verbose for scikit-build-core >= 0.10
      *** scikit-build-core 0.10.7 using CMake 3.31.1 (wheel)
      *** Configuring CMake...
      loading initial cache file /private/var/folders/v9/f0lwq77d1zx1r3n6r4hx1bd40000gn/T/tmp3nl67exd/build/CMakeInit.txt
      -- The C compiler identification is AppleClang 16.0.0.16000026
      -- Detecting C compiler ABI info
      -- Detecting C compiler ABI info - done
      -- Check for working C compiler: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang - skipped
      -- Detecting C compile features
      -- Detecting C compile features - done
      -- Found Python: /Users/daniel/.cache/uv/builds-v0/.tmpMqCx37/bin/python (found suitable version "3.13.1", minimum required is "3") found
      components: Interpreter Development.Module Development.SABIModule
      -- Configuring incomplete, errors occurred!

      [stderr]
      CMake Error at /opt/homebrew/share/cmake/Modules/FindPackageHandleStandardArgs.cmake:233 (message):
        Could NOT find PkgConfig (missing: PKG_CONFIG_EXECUTABLE)
      Call Stack (most recent call first):
        /opt/homebrew/share/cmake/Modules/FindPackageHandleStandardArgs.cmake:603 (_FPHSA_FAILURE_MESSAGE)
        /opt/homebrew/share/cmake/Modules/FindPkgConfig.cmake:114 (find_package_handle_standard_args)
        CMakeLists.txt:35 (find_package)

      
      Traceback (most recent call last):
        File "<string>", line 11, in <module>
          wheel_filename = backend.build_wheel("/Users/daniel/.cache/uv/builds-v0/.tmp8NEgzn", {}, None)
        File "/Users/daniel/.cache/uv/builds-v0/.tmpMqCx37/lib/python3.13/site-packages/hatchling/build.py", line 58, in build_wheel
          return os.path.basename(next(builder.build(directory=wheel_directory, versions=['standard'])))
                                  ~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        File "/Users/daniel/.cache/uv/builds-v0/.tmpMqCx37/lib/python3.13/site-packages/hatchling/builders/plugin/interface.py", line 147, in build
          build_hook.initialize(version, build_data)
          ~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^
        File "/Users/daniel/.cache/uv/builds-v0/.tmpMqCx37/lib/python3.13/site-packages/scikit_build_core/hatch/plugin.py", line 124, in initialize
          self._initialize(build_data=build_data)
          ~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^
        File "/Users/daniel/.cache/uv/builds-v0/.tmpMqCx37/lib/python3.13/site-packages/scikit_build_core/hatch/plugin.py", line 226, in _initialize
          builder.configure(
          ~~~~~~~~~~~~~~~~~^
              defines=defines,
              ^^^^^^^^^^^^^^^^
          ...<2 lines>...
              version=Version(self.build_config.builder.metadata.version),
              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
          )
          ^
        File "/Users/daniel/.cache/uv/builds-v0/.tmpMqCx37/lib/python3.13/site-packages/scikit_build_core/builder/builder.py", line 255, in configure
          self.config.configure(
          ~~~~~~~~~~~~~~~~~~~~~^
              defines=cmake_defines,
              ^^^^^^^^^^^^^^^^^^^^^^
              cmake_args=[*self.get_cmake_args(), *configure_args],
              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
          )
          ^
        File "/Users/daniel/.cache/uv/builds-v0/.tmpMqCx37/lib/python3.13/site-packages/scikit_build_core/cmake.py", line 242, in configure
          raise FailedLiveProcessError(msg) from None
      scikit_build_core.errors.FailedLiveProcessError: CMake configuration failed

      hint: This usually indicates a problem with the package or the build environment.
  help: `coincurve` (v20.0.0) was included because `ethereum-execution-spec-tests` (v1.0.0) depends on `coincurve`

The problem is the missing PkgConfig dependency on MacOS. I have solved it by installing it with homebrew:

brew install pkg-config

After that the command runs without error.

[marioevz]

@danceratopz I think this should be pointed out somewhere in the docs.