Add support for programmatic title generation

[NeevCohen]

Change Summary

Implement programmatic title generation via ConfigDict and Field

Related issue number

fix #4632

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: @dmontagu

[codspeed-hq]

CodSpeed Performance Report

Merging #9183 will not alter performance

_{Comparing NeevCohen:feature/title-generators (e12c5a2) with main (c488508)}

Summary

✅ 13 untouched benchmarks

[NeevCohen]

Please review

[sydney-runkle]

Hey @NeevCohen,

Great work, as usual!

I want to look again at _generate_schema.py and do a more in-depth look at your tests (great work btw, looks very thorough). This looks very promising though - I've included some initial feedback / some minor change requests.

One other change I'd like to see is the addition of some documentation in the concepts section of our docs!

[NeevCohen]

@sydney-runkle Thanks! I implemented the changes you requested.
Just one question, in what part of the concepts section do you think I should document this feature in?

[PrettyWood]

Question : why not having title be a string or a callable that returns a string instead of two params?
This could be extended to alias generation for example with a context passed as arg in case of callable

[NeevCohen]

@PrettyWood I implemented it the way the original issue suggested, I'm fine with changing it if we decide that is the way we want to go.
Also, since this is similar to the alias and alias_generator parameters, I figured it would be better to be consistent with the API. IMO if we change title to be a string or a callable, we should also change alias to be the same way.

[PrettyWood]

@NeevCohen totally agree. Probably a change for v3 then

[NeevCohen]

@PrettyWood Awesome.
@sydney-runkle did you get a chance to do a more in-depth look?

[sydney-runkle]

@NeevCohen,

Sorry for the delay, was out of the office last week. Looking now 🚀 !

Re your concepts docs question - your changes look great. We might want to add some more cross links with the config / fields sections, but it looks awesome thus far.

[sydney-runkle]

@NeevCohen,

Great work here. Really impressed with the thorough testing, and great work on the docs as well.

[sydney-runkle]

Let's have @samuelcolvin do a final review of this given that he made the original feature request. Stay tuned!