Add support for enabling/disabling input and url fields in validation errors

fastapi/_compat.py

@@ -89,6 +89,8 @@ if PYDANTIC_V2:
         field_info: FieldInfo
         name: str
         mode: Literal["validation", "serialization"] = "validation"
+        include_error_input: bool = True
+        include_error_url: bool = False
 
         @property
         def alias(self) -> str:
@@ -131,7 +133,11 @@ if PYDANTIC_V2:
                 )
             except ValidationError as exc:
                 return None, _regenerate_error_with_loc(
-                    errors=exc.errors(include_url=False), loc_prefix=loc
+                    errors=exc.errors(
+                        include_input=self.include_error_input,
+                        include_url=self.include_error_url,
+                    ),
+                    loc_prefix=loc,
                 )
 
         def serialize(
@@ -267,10 +273,15 @@ if PYDANTIC_V2:
         assert issubclass(origin_type, sequence_types)  # type: ignore[arg-type]
         return sequence_annotation_to_type[origin_type](value)  # type: ignore[no-any-return]
 
-    def get_missing_field_error(loc: Tuple[str, ...]) -> Dict[str, Any]:
+    def get_missing_field_error(
+        loc: Tuple[str, ...],
+        include_error_input: bool = True,
+        include_error_url: bool = False,
+    ) -> Dict[str, Any]:
         error = ValidationError.from_exception_data(
             "Field required", [{"type": "missing", "loc": loc, "input": {}}]
-        ).errors(include_url=False)[0]
+        ).errors(include_url=include_error_url)[0]
+        if include_error_input:
             error["input"] = None
         return error  # type: ignore[return-value]
 
@@ -509,10 +520,18 @@ else:
     def serialize_sequence_value(*, field: ModelField, value: Any) -> Sequence[Any]:
         return sequence_shape_to_type[field.shape](value)  # type: ignore[no-any-return,attr-defined]
 
-    def get_missing_field_error(loc: Tuple[str, ...]) -> Dict[str, Any]:
+    def get_missing_field_error(
+        loc: Tuple[str, ...],
+        include_error_input: bool = True,
+        include_error_url: bool = False,
+    ) -> Dict[str, Any]:
         missing_field_error = ErrorWrapper(MissingError(), loc=loc)  # type: ignore[call-arg]
-        new_error = ValidationError([missing_field_error], RequestErrorModel)
+        new_error = ValidationError([missing_field_error], RequestErrorModel).errors(
-        return new_error.errors()[0]  # type: ignore[return-value]
+            include_url=include_error_url
+        )[0]
+        if include_error_input:
+            new_error["input"] = None
+        return new_error  # type: ignore[return-value]
 
     def create_body_model(
         *, fields: Sequence[ModelField], model_name: str

fastapi/applications.py

@@ -752,6 +752,22 @@ class FastAPI(Starlette):
                 """
             ),
         ] = True,
+        include_error_input: Annotated[
+            bool,
+            Doc(
+                """
+                TODO
+                """
+            ),
+        ] = True,
+        include_error_url: Annotated[
+            bool,
+            Doc(
+                """
+                TODO
+                """
+            ),
+        ] = False,
         swagger_ui_parameters: Annotated[
             Optional[Dict[str, Any]],
             Doc(
@@ -941,6 +957,8 @@ class FastAPI(Starlette):
             callbacks=callbacks,
             deprecated=deprecated,
             include_in_schema=include_in_schema,
+            include_error_input=include_error_input,
+            include_error_url=include_error_url,
             responses=responses,
             generate_unique_id_function=generate_unique_id_function,
         )
@@ -1076,6 +1094,8 @@ class FastAPI(Starlette):
         response_model_exclude_defaults: bool = False,
         response_model_exclude_none: bool = False,
         include_in_schema: bool = True,
+        include_error_input: bool = True,
+        include_error_url: bool = False,
         response_class: Union[Type[Response], DefaultPlaceholder] = Default(
             JSONResponse
         ),
@@ -1106,6 +1126,8 @@ class FastAPI(Starlette):
             response_model_exclude_defaults=response_model_exclude_defaults,
             response_model_exclude_none=response_model_exclude_none,
             include_in_schema=include_in_schema,
+            include_error_input=include_error_input,
+            include_error_url=include_error_url,
             response_class=response_class,
             name=name,
             openapi_extra=openapi_extra,
@@ -1134,6 +1156,8 @@ class FastAPI(Starlette):
         response_model_exclude_defaults: bool = False,
         response_model_exclude_none: bool = False,
         include_in_schema: bool = True,
+        include_error_input: bool = True,
+        include_error_url: bool = False,
         response_class: Type[Response] = Default(JSONResponse),
         name: Optional[str] = None,
         openapi_extra: Optional[Dict[str, Any]] = None,
@@ -1163,6 +1187,8 @@ class FastAPI(Starlette):
                 response_model_exclude_defaults=response_model_exclude_defaults,
                 response_model_exclude_none=response_model_exclude_none,
                 include_in_schema=include_in_schema,
+                include_error_input=include_error_input,
+                include_error_url=include_error_url,
                 response_class=response_class,
                 name=name,
                 openapi_extra=openapi_extra,

fastapi/dependencies/utils.py

@@ -269,6 +269,8 @@ def get_dependant(
     name: Optional[str] = None,
     security_scopes: Optional[List[str]] = None,
     use_cache: bool = True,
+    include_error_input: bool = True,
+    include_error_url: bool = False,
 ) -> Dependant:
     path_param_names = get_path_param_names(path)
     endpoint_signature = get_typed_signature(call)
@@ -287,6 +289,8 @@ def get_dependant(
             annotation=param.annotation,
             value=param.default,
             is_path_param=is_path_param,
+            include_error_input=include_error_input,
+            include_error_url=include_error_url,
         )
         if param_details.depends is not None:
             sub_dependant = get_param_sub_dependant(
@@ -351,6 +355,8 @@ def analyze_param(
     annotation: Any,
     value: Any,
     is_path_param: bool,
+    include_error_input: bool,
+    include_error_url: bool,
 ) -> ParamDetails:
     field_info = None
     depends = None
@@ -492,6 +498,8 @@ def analyze_param(
             alias=alias,
             required=field_info.default in (RequiredParam, Undefined),
             field_info=field_info,
+            include_error_input=include_error_input,
+            include_error_url=include_error_url,
         )
         if is_path_param:
             assert is_scalar_field(field=field), (
@@ -700,7 +708,11 @@ def _validate_value_with_model_field(
 ) -> Tuple[Any, List[Any]]:
     if value is None:
         if field.required:
-            return None, [get_missing_field_error(loc=loc)]
+            return None, [
+                get_missing_field_error(
+                    loc, field.include_error_input, field.include_error_url
+                )
+            ]
         else:
             return deepcopy(field.default), []
     v_, errors_ = field.validate(value, values, loc=loc)
@@ -915,7 +927,11 @@ async def request_body_to_args(
                 value = body_to_process.get(field.alias)
             # If the received body is a list, not a dict
             except AttributeError:
-                errors.append(get_missing_field_error(loc))
+                errors.append(
+                    get_missing_field_error(
+                        loc, field.include_error_input, field.include_error_url
+                    )
+                )
                 continue
         v_, errors_ = _validate_value_with_model_field(
             field=field, value=value, values=values, loc=loc

fastapi/routing.py

@@ -450,6 +450,8 @@ class APIRoute(routing.Route):
         response_model_exclude_defaults: bool = False,
         response_model_exclude_none: bool = False,
         include_in_schema: bool = True,
+        include_error_input: bool = True,
+        include_error_url: bool = False,
         response_class: Union[Type[Response], DefaultPlaceholder] = Default(
             JSONResponse
         ),
@@ -480,6 +482,8 @@ class APIRoute(routing.Route):
         self.response_model_exclude_defaults = response_model_exclude_defaults
         self.response_model_exclude_none = response_model_exclude_none
         self.include_in_schema = include_in_schema
+        self.include_error_input = include_error_input
+        self.include_error_url = include_error_url
         self.response_class = response_class
         self.dependency_overrides_provider = dependency_overrides_provider
         self.callbacks = callbacks
@@ -512,6 +516,8 @@ class APIRoute(routing.Route):
                 name=response_name,
                 type_=self.response_model,
                 mode="serialization",
+                include_error_input=self.include_error_input,
+                include_error_url=self.include_error_url,
             )
             # Create a clone of the field, so that a Pydantic submodel is not returned
             # as is just because it's an instance of a subclass of a more limited class
@@ -542,7 +548,11 @@ class APIRoute(routing.Route):
                 )
                 response_name = f"Response_{additional_status_code}_{self.unique_id}"
                 response_field = create_model_field(
-                    name=response_name, type_=model, mode="serialization"
+                    name=response_name,
+                    type_=model,
+                    mode="serialization",
+                    include_error_input=self.include_error_input,
+                    include_error_url=self.include_error_url,
                 )
                 response_fields[additional_status_code] = response_field
         if response_fields:
@@ -551,7 +561,12 @@ class APIRoute(routing.Route):
             self.response_fields = {}
 
         assert callable(endpoint), "An endpoint must be a callable"
-        self.dependant = get_dependant(path=self.path_format, call=self.endpoint)
+        self.dependant = get_dependant(
+            path=self.path_format,
+            call=self.endpoint,
+            include_error_input=self.include_error_input,
+            include_error_url=self.include_error_url,
+        )
         for depends in self.dependencies[::-1]:
             self.dependant.dependencies.insert(
                 0,
@@ -818,6 +833,22 @@ class APIRouter(routing.Router):
                 """
             ),
         ] = True,
+        include_error_input: Annotated[
+            bool,
+            Doc(
+                """
+                TODO
+                """
+            ),
+        ] = True,
+        include_error_url: Annotated[
+            bool,
+            Doc(
+                """
+                TODO
+                """
+            ),
+        ] = False,
         generate_unique_id_function: Annotated[
             Callable[[APIRoute], str],
             Doc(
@@ -852,6 +883,8 @@ class APIRouter(routing.Router):
         self.dependencies = list(dependencies or [])
         self.deprecated = deprecated
         self.include_in_schema = include_in_schema
+        self.include_error_input = include_error_input
+        self.include_error_url = include_error_url
         self.responses = responses or {}
         self.callbacks = callbacks or []
         self.dependency_overrides_provider = dependency_overrides_provider
@@ -901,6 +934,8 @@ class APIRouter(routing.Router):
         response_model_exclude_defaults: bool = False,
         response_model_exclude_none: bool = False,
         include_in_schema: bool = True,
+        include_error_input: bool = True,
+        include_error_url: bool = False,
         response_class: Union[Type[Response], DefaultPlaceholder] = Default(
             JSONResponse
         ),
@@ -951,6 +986,8 @@ class APIRouter(routing.Router):
             response_model_exclude_defaults=response_model_exclude_defaults,
             response_model_exclude_none=response_model_exclude_none,
             include_in_schema=include_in_schema and self.include_in_schema,
+            include_error_input=include_error_input,
+            include_error_url=include_error_url,
             response_class=current_response_class,
             name=name,
             dependency_overrides_provider=self.dependency_overrides_provider,
@@ -982,6 +1019,8 @@ class APIRouter(routing.Router):
         response_model_exclude_defaults: bool = False,
         response_model_exclude_none: bool = False,
         include_in_schema: bool = True,
+        include_error_input: bool = True,
+        include_error_url: bool = False,
         response_class: Type[Response] = Default(JSONResponse),
         name: Optional[str] = None,
         callbacks: Optional[List[BaseRoute]] = None,
@@ -1012,6 +1051,8 @@ class APIRouter(routing.Router):
                 response_model_exclude_defaults=response_model_exclude_defaults,
                 response_model_exclude_none=response_model_exclude_none,
                 include_in_schema=include_in_schema,
+                include_error_input=include_error_input,
+                include_error_url=include_error_url,
                 response_class=response_class,
                 name=name,
                 callbacks=callbacks,
@@ -1322,6 +1363,8 @@ class APIRouter(routing.Router):
                     include_in_schema=route.include_in_schema
                     and self.include_in_schema
                     and include_in_schema,
+                    include_error_input=route.include_error_input,
+                    include_error_url=route.include_error_url,
                     response_class=use_response_class,
                     name=route.name,
                     route_class_override=type(route),
@@ -1733,6 +1776,8 @@ class APIRouter(routing.Router):
             response_model_exclude_defaults=response_model_exclude_defaults,
             response_model_exclude_none=response_model_exclude_none,
             include_in_schema=include_in_schema,
+            include_error_input=self.include_error_input,
+            include_error_url=self.include_error_url,
             response_class=response_class,
             name=name,
             callbacks=callbacks,
@@ -2115,6 +2160,8 @@ class APIRouter(routing.Router):
             response_model_exclude_defaults=response_model_exclude_defaults,
             response_model_exclude_none=response_model_exclude_none,
             include_in_schema=include_in_schema,
+            include_error_input=self.include_error_input,
+            include_error_url=self.include_error_url,
             response_class=response_class,
             name=name,
             callbacks=callbacks,
@@ -2497,6 +2544,8 @@ class APIRouter(routing.Router):
             response_model_exclude_defaults=response_model_exclude_defaults,
             response_model_exclude_none=response_model_exclude_none,
             include_in_schema=include_in_schema,
+            include_error_input=self.include_error_input,
+            include_error_url=self.include_error_url,
             response_class=response_class,
             name=name,
             callbacks=callbacks,
@@ -2874,6 +2923,8 @@ class APIRouter(routing.Router):
             response_model_exclude_defaults=response_model_exclude_defaults,
             response_model_exclude_none=response_model_exclude_none,
             include_in_schema=include_in_schema,
+            include_error_input=self.include_error_input,
+            include_error_url=self.include_error_url,
             response_class=response_class,
             name=name,
             callbacks=callbacks,
@@ -3251,6 +3302,8 @@ class APIRouter(routing.Router):
             response_model_exclude_defaults=response_model_exclude_defaults,
             response_model_exclude_none=response_model_exclude_none,
             include_in_schema=include_in_schema,
+            include_error_input=self.include_error_input,
+            include_error_url=self.include_error_url,
             response_class=response_class,
             name=name,
             callbacks=callbacks,
@@ -3633,6 +3686,8 @@ class APIRouter(routing.Router):
             response_model_exclude_defaults=response_model_exclude_defaults,
             response_model_exclude_none=response_model_exclude_none,
             include_in_schema=include_in_schema,
+            include_error_input=self.include_error_input,
+            include_error_url=self.include_error_url,
             response_class=response_class,
             name=name,
             callbacks=callbacks,
@@ -4015,6 +4070,8 @@ class APIRouter(routing.Router):
             response_model_exclude_defaults=response_model_exclude_defaults,
             response_model_exclude_none=response_model_exclude_none,
             include_in_schema=include_in_schema,
+            include_error_input=self.include_error_input,
+            include_error_url=self.include_error_url,
             response_class=response_class,
             name=name,
             callbacks=callbacks,
@@ -4397,6 +4454,8 @@ class APIRouter(routing.Router):
             response_model_exclude_defaults=response_model_exclude_defaults,
             response_model_exclude_none=response_model_exclude_none,
             include_in_schema=include_in_schema,
+            include_error_input=self.include_error_input,
+            include_error_url=self.include_error_url,
             response_class=response_class,
             name=name,
             callbacks=callbacks,

fastapi/utils.py

@@ -70,6 +70,8 @@ def create_model_field(
     field_info: Optional[FieldInfo] = None,
     alias: Optional[str] = None,
     mode: Literal["validation", "serialization"] = "validation",
+    include_error_input: bool = True,
+    include_error_url: bool = False,
 ) -> ModelField:
     class_validators = class_validators or {}
     if PYDANTIC_V2:
@@ -78,7 +80,12 @@ def create_model_field(
         )
     else:
         field_info = field_info or FieldInfo()
-    kwargs = {"name": name, "field_info": field_info}
+    kwargs = {
+        "name": name,
+        "field_info": field_info,
+        "include_error_input": include_error_input,
+        "include_error_url": include_error_url,
+    }
     if PYDANTIC_V2:
         kwargs.update({"mode": mode})
     else:
@@ -140,6 +147,8 @@ def create_cloned_field(
     new_field.required = field.required  # type: ignore[misc]
     new_field.model_config = field.model_config  # type: ignore[attr-defined]
     new_field.field_info = field.field_info
+    new_field.include_error_input = field.include_error_input
+    new_field.include_error_url = field.include_error_url
     new_field.allow_none = field.allow_none  # type: ignore[attr-defined]
     new_field.validate_always = field.validate_always  # type: ignore[attr-defined]
     if field.sub_fields:  # type: ignore[attr-defined]