Compatibility issue with pydantic 2.12.0 (PACMAN-1179)

[tpwrules]

The Component Manager version

v2.4.0

ESP-IDF Version

v5.3.1

python Version

3.10.12

Operating System

Ubuntu 22 (github CI)

Browser (for https://components.espressif.com Issues)

No response

Description

     Traceback (most recent call last):
  
      File "/usr/lib/python3.10/runpy.py", line 196, in _run_module_as_main
        return _run_code(code, main_globals, None,
      File "/usr/lib/python3.10/runpy.py", line 86, in _run_code
        exec(code, run_globals)
      File "/home/runner/.espressif/python_env/idf5.3_py3.10_env/lib/python3.10/site-packages/idf_component_manager/prepare_components/__main__.py", line 6, in <module>
        main()
      File "/home/runner/.espressif/python_env/idf5.3_py3.10_env/lib/python3.10/site-packages/idf_component_manager/prepare_components/prepare.py", line 88, in main
        setup_logging()
      File "/home/runner/.espressif/python_env/idf5.3_py3.10_env/lib/python3.10/site-packages/idf_component_tools/logging.py", line 106, in setup_logging
        if ComponentManagerSettings().DEBUG_MODE:
      File "/home/runner/.espressif/python_env/idf5.3_py3.10_env/lib/python3.10/site-packages/pydantic_settings/main.py", line 193, in __init__
        super().__init__(
      File "/home/runner/.espressif/python_env/idf5.3_py3.10_env/lib/python3.10/site-packages/pydantic/main.py", line 250, in __init__
        validated_self = self.__pydantic_validator__.validate_python(data, self_instance=self)
      File "/home/runner/.espressif/python_env/idf5.3_py3.10_env/lib/python3.10/site-packages/idf_component_tools/environment.py", line 296, in fallback_to_default
        if field.validation_alias:
  
    AttributeError: 'NoneType' object has no attribute 'validation_alias'

To Reproduce

Difficult to share, sorry.

Expected behaviour

No crash

Additional info

No response

I have checked existing issues and online Documentation

• I confirm I have checked existing issues and online Documentation.

[luenge]

Can confirm, fresh install of ESP-IDF 5.5.1 (~/.espressif deleted) with python 3.13 will not even build esp-idf/examples/get-started/helloworld.

Downgrading from pydantic 2.12.0 to 2.11.10 will resolve the issue

$IDF_PYTHON_ENV_PATH/bin/pip remove pydantic
$IDF_PYTHON_ENV_PATH/bin/pip install 'pydantic<2.12'

[kenh-sq]

Hi,

I'm getting this same issue, but on Windows 11. I chose today to move from IDF v5.4 to v5.5 and now I can't seem to go back to a functional build system.

[AmirHmZz]

Confirm this issue on IDF v5.5.1 and v5.4.2 and many other versions. @kumekay @hfudev seems this is a CRITICAL bug preventing people to build IDF projects...
Pydantic version should be locked on 2.11.X ASAP!

[peterm94]

I am also having this issue with a fresh project generated with esp-rs/esp-idf-template.

[kumekay]

Workaround

For now, as a temporary workaround, the constraint to pydantic version is set on the ESP-IDF side for all existing releases, (https://dl.espressif.com/dl/esp-idf/espidf.constraints.v5.5.txt)

A proper fix on the component manager side is coming.

[Viicos]

Pydantic maintainer here, I believe this is due to this regression, which will be fixed in the next 2.12 patch release. You might also be interested in the PydanticUseDefault helper, that can achieve the same goal as the wrap validator defined here:

idf-component-manager/idf_component_tools/environment.py

Lines 287 to 307 in 485fca0

	@field_validator('*', mode='wrap')
	@classmethod
	def fallback_to_default(
	cls, v: t.Any, handler: ValidatorFunctionWrapHandler, info: ValidationInfo
	) -> t.Any:
	field = cls.model_fields.get(info.field_name)
	# deprecation warning if old env var is set in env
	# the first one is the recommended one
	if field.validation_alias:
	for alias in field.validation_alias.choices[1:]:
	if alias in os.environ:
	warnings.warn(
	f'{alias} environment variable is deprecated. '
	f'Please use {field.validation_alias.choices[0]} instead.',
	UserDeprecationWarning,
	)
	try:
	if v is None:
	return field.default