meta data for this page
  •  

ruamel.yaml.clib

Problem:

IDF routine to check for requirements fails on ruamel.yaml.clib version 0.2.15. With downgraded version 0.2.14 works.

Fix:

Issue is fixed in:

See also Fixed wheels issues with Python 3.14 + improvements #53

Traces 

'ruamel.yaml.clib' - was not found and is required by the application
/home/user/esp-idf-v5.2.1/install.sh esp32s3
Detecting the Python interpreter
...
Installing Python packages
 Constraint file: /home/user/.espressif/espidf.constraints.v5.2.txt
 Requirement files:
  - /home/user/ap-pro-sw/esp-idf-v5.2.1/tools/requirements/requirements.core.txt
...
Collecting ruamel.yaml (from idf-component-manager->-r /home/user/esp-idf-v5.2.1/tools/requirements/requirements.core.txt (line 12))
  Downloading https://pypi.ovh/packages/ruamel-yaml/0.18.16/ruamel.yaml-0.18.16-py3-none-any.whl (119 kB)
 
Collecting ruamel.yaml.clib>=0.2.7 (from ruamel.yaml->idf-component-manager->-r /home/user/esp-idf-v5.2.1/tools/requirements/requirements.core.txt (line 12))
  Downloading https://pypi.ovh/packages/ruamel-yaml-clib/0.2.15/ruamel_yaml_clib-0.2.15-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl (777 kB)
...
Successfully built esptool
Installing collected packages: reedsolo, pyserial, pygdbmi, pyelftools, intelhex, bitarray, urllib3, typing-extensions, truststore, tqdm, six, ruamel.yaml.clib, PyYAML, python-dotenv, pyparsing, pygments, pycparser, pyclang, packaging, mdurl, kconfiglib, jsonref, idna, freertos_gdb, esp-idf-panic-decoder, construct, colorama, click, charset_normalizer, certifi, bitstring, argcomplete, annotated-types, typing-inspection, ruamel.yaml, requests, pydantic-core, markdown-it-py, esp-idf-kconfig, ecdsa, cffi, rich, requests-toolbelt, requests-file, pydantic, cryptography, pydantic-settings, esptool, esp-idf-size, idf-component-manager, esp-coredump, esp-idf-monitor
Successfully installed PyYAML-6.0.3 annotated-types-0.7.0 argcomplete-3.6.3 bitarray-3.8.0 bitstring-4.3.1 certifi-2025.11.12 cffi-2.0.0 charset_normalizer-3.4.4 click-8.1.8 colorama-0.4.6 construct-2.10.70 cryptography-41.0.7 ecdsa-0.19.1 esp-coredump-1.14.0 esp-idf-kconfig-1.5.0 esp-idf-monitor-1.8.0 esp-idf-panic-decoder-1.4.2 esp-idf-size-1.7.1 esptool-4.10.0 freertos_gdb-1.0.4 idf-component-manager-2.4.2 idna-3.11 intelhex-2.3.0 jsonref-1.1.0 kconfiglib-14.1.0 markdown-it-py-4.0.0 mdurl-0.1.2 packaging-25.0 pyclang-0.6.3 pycparser-2.23 pydantic-2.12.5 pydantic-core-2.41.5 pydantic-settings-2.12.0 pyelftools-0.32 pygdbmi-0.11.0.0 pygments-2.19.2 pyparsing-3.2.5 pyserial-3.5 python-dotenv-1.2.1 reedsolo-1.7.0 requests-2.32.5 requests-file-3.0.1 requests-toolbelt-1.0.0 rich-14.2.0 
 
ruamel.yaml-0.18.16 
ruamel.yaml.clib-0.2.15 
 
six-1.17.0 tqdm-4.67.1 truststore-0.10.4 typing-extensions-4.15.0 typing-inspection-0.4.2 urllib3-1.26.20
All done! You can now run:
 
  . /home/user/esp-idf-v5.2.1/export.sh
source /home/user/esp-idf-v5.2.1/export.sh && idf.py -B /home/user/build/firmware -DBUILD_PROTO_DIR="/home/user/build/gen/proto" \
		  update-dependencies
Setting IDF_PATH to '/home/user/esp-idf-v5.2.1'
Detecting the Python interpreter
Checking "python3" ...
Python 3.9.2
"python3" has been detected
Checking Python compatibility
Checking other ESP-IDF version.
Adding ESP-IDF tools to PATH...
Checking if Python packages are up to date...
Constraint file: /home/user/.espressif/espidf.constraints.v5.2.txt
Requirement files:
 - /home/user/esp-idf-v5.2.1/tools/requirements/requirements.core.txt
Python being checked: /home/user/.espressif/python_env/idf5.2_py3.9_env/bin/python
The following Python requirements are not satisfied:
'ruamel.yaml.clib' - was not found and is required by the application
To install the missing packages, please run "install.sh"
Diagnostic information:
    IDF_PYTHON_ENV_PATH: /home/user/.espressif/python_env/idf5.2_py3.9_env
    Python interpreter used: /home/user/.espressif/python_env/idf5.2_py3.9_env/bin/python