fix: parse enum names through nested annotations

[Sanjays2402]

With env_parse_enums=True, enum names inside nested wrappers such as Optional[Annotated[MyEnum, ...]] were left as strings and failed validation. Resolve enum members recursively through annotation arguments, while preserving existing direct and union handling; the regression test fails before the source change and passes with it.

[hramezani]

Thanks @Sanjays2402 for the fix! I pushed one follow-up commit (761bfb9) to the branch.

_annotation_enum_val_to_name — the twin of the function you fixed — had the exact same one-level lookup limitation. It only inspected the annotation, its origin, and its direct args, so an enum wrapped as Optional[Annotated[MyEnum, ...]] was not resolved. This shows up in CLI help rendering of enum defaults, which fell back to the raw value (e.g. (default: 1)) instead of the member name ((default: kiwi)).

The commit applies the same recursive-descent pattern you used for _annotation_enum_name_to_val, plus a regression test (test_cli_enum_default_through_nested_annotation) that fails before the change and passes with it. This keeps the two helpers symmetric so both the env-parsing and CLI-help paths handle nested annotations consistently.
@

[Copilot]

Pull request overview

Fixes enum parsing when env_parse_enums=True (and CLI default rendering) for enums wrapped inside nested typing constructs (e.g. Optional[Annotated[MyEnum, ...]]), by recursively inspecting annotation arguments to resolve enum names/values correctly.

Changes:

• Update enum (name ↔ value) resolution helpers to traverse nested annotation arguments recursively.
• Add a regression test ensuring CLI --help shows enum defaults correctly through nested Annotated + optional wrappers.
• Add a regression test ensuring env enum parsing works through nested Annotated + optional wrappers.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
tests/test_source_cli.py	Adds CLI help-output regression test for enum defaults in nested annotations.
tests/test_settings.py	Adds env parsing regression test for enums in nested Annotated + optional annotations.
pydantic_settings/sources/utils.py	Makes enum name/value resolution recursive across annotation arguments to support nested wrappers.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[hramezani]

Thanks @Sanjays2402