fix(models): enable 'populate_by_name' to alias fields correctly

[omikader]

Summary

This PR adds "populate_by_name": True to the model_config for the SecurityScheme model

Context

When creating the application, we can define supported security schemes using plain dicts or the SecurityScheme object. The SecurityScheme object is more typesafe but must eventually be dumped to JSON in order for the API docs to be generated.

app = OpenAPI(
    "app",
    security_schemes={
        "jwt": {"type": "http", "scheme": "bearer"},
        "key": {"type": "apiKey", "in": "header", "name": "X-APP-API-KEY"},
    },
)

OR

app = OpenAPI(
    "app",
    security_schemes={
        "jwt": SecurityScheme(type="http", scheme="bearer"},
        "key": SecurityScheme(type="apiKey", security_scheme_in="header", name="X-APP-API-KEY"),
    },
)

The in keyword is reserved in Python which is why it is currently aliased to security_scheme_in however the model_dump invocation doesn't actually alias it correctly unless populate_by_name is enabled.

self.spec_json = self.spec.model_dump(mode="json", by_alias=True, exclude_unset=True, warnings=False)

Checklist:

• Run pytest tests and no failed.
• Run ruff check flask_openapi3 tests examples and no failed.
• Run mypy flask_openapi3 and no failed.
• Run mkdocs serve and no failed.

[luolingchun]

Thanks for your contribution, but you need to fix all similar issues:

• https://github.com/luolingchun/flask-openapi3/blob/master/flask_openapi3/models/media_type.py#L14
• https://github.com/luolingchun/flask-openapi3/blob/master/flask_openapi3/models/parameter.py#L15
• https://github.com/luolingchun/flask-openapi3/blob/master/flask_openapi3/models/path_item.py#L17
• https://github.com/luolingchun/flask-openapi3/blob/master/flask_openapi3/models/reference.py#L7
• https://github.com/luolingchun/flask-openapi3/blob/master/flask_openapi3/models/schema.py#L15
• https://github.com/luolingchun/flask-openapi3/blob/master/flask_openapi3/models/security_scheme.py#L12