feat: roll openapi json into fastapi

[pawel-kmiecik]

This PR:

• bumps pydantic to 2.5.x and removes it from explicit dependencies list (will be managed by fastapi)
• introduced Form params description in the code, which will form openapi and swagger documentation
• rolled back some openapi customizations
• keeps backward compatibility for passing parameters in form of list[str] (will not be shown in the documentation)

[pawel-kmiecik]

@awalker4 should I remove openapi.json file from the repository then?

[awalker4]

I take it this is for the backwards compatibility? Can we have a comment here to clarify how new params should be added (assuming they do not need to go into as_form)?

[pawel-kmiecik]

for backward compatibility I added:

BeforeValidator(SmartValueParser[List[str]]().value_or_first_element),

In old fields that expected values both as a single value or as an element of a list.
The SmartValueParser will extract the first element from the list if the expected type is not a container.
SmartValueParser is a generic class and is parametrized with the expected type - in the above example its List[str]
You can check its tests to see how it's working:
SmartValueParser tests
Deprecated API tests (with params passed as lists)

[awalker4]

I'm getting this error locally - any idea what happened?

[awalker4]

@awalker4 should I remove openapi.json file from the repository then?

Yes please!

[pawel-kmiecik]

I'm getting this error locally - any idea what happened?

Should be fixed now, I removed openapi.json static file as well.