feat(openapi): add multipart/form-data & form support

Author: oyiz-michael

aws_lambda_powertools/event_handler/openapi/dependant.py

@@ -348,6 +348,7 @@ def get_body_field(*, dependant: Dependant, name: str) -> ModelField | None:
         alias="body",
         field_info=body_field_info(**body_field_info_kwargs),
     )
+    
     return final_field
 
 
@@ -367,11 +368,11 @@ def get_body_field_info(
         body_field_info_kwargs["default"] = None
 
     if any(isinstance(f.field_info, _File) for f in flat_dependant.body_params):
-        # MAINTENANCE: body_field_info: type[Body] = _File
-        raise NotImplementedError("_File fields are not supported in request bodies")
+        body_field_info = Body
+        body_field_info_kwargs["media_type"] = "multipart/form-data"
     elif any(isinstance(f.field_info, _Form) for f in flat_dependant.body_params):
-        # MAINTENANCE: body_field_info: type[Body] = _Form
-        raise NotImplementedError("_Form fields are not supported in request bodies")
+        body_field_info = Body
+        body_field_info_kwargs["media_type"] = "application/x-www-form-urlencoded"
     else:
         body_field_info = Body
 

aws_lambda_powertools/event_handler/openapi/models.py

@@ -480,14 +480,7 @@ class OpenAPI(OpenAPIExtensions):
 
     model_config = MODEL_CONFIG_ALLOW
 
-# Helper schema for file upload
-class FileSchema(BaseModel):
-    """OpenAPI 3.0 schema for binary file uploads (multipart/form-data)."""
 
-    type: Literal["string"] = Field("string", const=True)
-    format: Literal["binary"] = Field("binary", const=True)
-
-    model_config = MODEL_CONFIG_ALLOW
 
 
 model_rebuild(Schema)

aws_lambda_powertools/event_handler/openapi/params.py

@@ -848,6 +848,13 @@ def __init__(
         json_schema_extra: dict[str, Any] | None = None,
         **extra: Any,
     ):
+        # For file uploads, ensure the OpenAPI schema has the correct format
+        file_schema_extra = {"format": "binary"}
+        if json_schema_extra:
+            json_schema_extra.update(file_schema_extra)
+        else:
+            json_schema_extra = file_schema_extra
+            
         super().__init__(
             default=default,
             default_factory=default_factory,
@@ -1122,3 +1129,8 @@ def _create_model_field(
         required=field_info.default in (Required, Undefined),
         field_info=field_info,
     )
+
+
+# Public type aliases for form and file parameters
+File = _File
+Form = _Form