Feature request: Add support for Files and Form in OpenAPI schema

[leandrodamascena]

Use case

Original discussion: #3609

OpenAPI supports File and Form fields in the Request Body and we must add support for this.

https://swagger.io/docs/specification/describing-request-body/

Solution/User Experience

Add support for File and Form fields.

Alternative solutions

No response

Acknowledgment

• This feature request meets Powertools for AWS Lambda (Python) Tenets
• Should this be considered in other Powertools for AWS Lambda languages? i.e. Java, TypeScript, and .NET

[leandrodamascena]

Assigned to @rubenfonseca

[Hatter1337]

Hi 👋🏼
From the original discussion, I see this concerns app.enable_swagger().
Could you please let me know if it is possible to add multipart/form-data to the request body when using app.get_openapi_json_schema, or is this option currently unavailable as well?

@router.post(
    "/user/activities/<activity_id>/assets",
    summary="Create asset",
    description="Create an asset for a user activity",
    responses={
        201: {
            "description": "Created",
            "content": {"application/json": {"model": models.ActivityAssetResponse}},
        }
    }
    | default_openapi_responses,  # 400, 409, etc.
    tags=["User"],
)

Thank you.

[dreamorosi]

@leandrodamascena can you please take a look at the question above when you can?

---

Regarding the feature, we're still keeping this non our backlog and will get to it eventually. If anyone has knowledge on the topic and would like to contribute, please leave a comment to claim the issue.