docs: include documentation for BaseModel.model_validate_strings

[airwoodix]

Change Summary

This patch includes documentation for BaseModel.model_validate_strings() introduced in #7552 to the docs build.

Background on the validate_strings() feature is discussed in #7549 and #8736 in particular. Is a more detailed explanation necessary, especially to show the differences between the three validation helpers on BaseModel?

The pydantic-core stubs have _StringInput = dict[str, _StringInput] as type annotation for the object to validate. Since the pydantic implementation fully delegates to pydantic-core, only dicts are actually allowed. Should the annotation in pydantic be updated?

Checklist

• The pull request title is a good summary of the changes - it will be used in the changelog
• Unit tests for the changes exist
• Tests pass on CI
• Documentation reflects the changes where applicable
• My PR is ready to review, please add a comment including the phrase "please review" to assign reviewers

Selected Reviewer: @samuelcolvin

[codspeed-hq]

CodSpeed Performance Report

Merging #9506 will not alter performance

_{Comparing airwoodix:docs-basemodel-validate-strings (7c259b6) with main (afa1738)}

Summary

✅ 13 untouched benchmarks

[airwoodix]

please review

[sydney-runkle]

This patch includes documentation for BaseModel.model_validate_strings() introduced in #7552 to the docs build.

Amazing, thanks! Great work here.

Background on the validate_strings() feature is discussed in #7549 and #8736 in particular. Is a more detailed explanation necessary, especially to show the differences between the three validation helpers on BaseModel?

I don't think we need something much more in depth, though perhaps we could pull a bit of info from:

https://github.com/pydantic/pydantic-core/blob/fd262933683fad0a9706e63298065f0d6ab9905d/python/pydantic_core/_pydantic_core.pyi#L170-L184

The pydantic-core stubs have _StringInput = dict[str, _StringInput] as type annotation for the object to validate. Since the pydantic implementation fully delegates to pydantic-core, only dicts are actually allowed. Should the annotation in pydantic be updated?

What are you suggesting we update the annotation to? Feel free to make the change, and I can review in context!

Ping me when you'd like another review :).

[sydney-runkle]

Hi @airwoodix,

Let me know if you have any other questions about the above notes!

[sydney-runkle]

I've made a few minor wording changes - looks good otherwise!