mirror of
https://github.com/home-assistant/core
synced 2024-08-02 23:40:32 +02:00
66 lines
2.0 KiB
Python
66 lines
2.0 KiB
Python
"""Decorator for view methods to help with data validation."""
|
|
from __future__ import annotations
|
|
|
|
from collections.abc import Awaitable, Callable
|
|
from functools import wraps
|
|
from http import HTTPStatus
|
|
import logging
|
|
from typing import Any
|
|
|
|
from aiohttp import web
|
|
import voluptuous as vol
|
|
|
|
from .view import HomeAssistantView
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
|
|
class RequestDataValidator:
|
|
"""Decorator that will validate the incoming data.
|
|
|
|
Takes in a voluptuous schema and adds 'data' as
|
|
keyword argument to the function call.
|
|
|
|
Will return a 400 if no JSON provided or doesn't match schema.
|
|
"""
|
|
|
|
def __init__(self, schema: vol.Schema, allow_empty: bool = False) -> None:
|
|
"""Initialize the decorator."""
|
|
if isinstance(schema, dict):
|
|
schema = vol.Schema(schema)
|
|
|
|
self._schema = schema
|
|
self._allow_empty = allow_empty
|
|
|
|
def __call__(
|
|
self, method: Callable[..., Awaitable[web.StreamResponse]]
|
|
) -> Callable:
|
|
"""Decorate a function."""
|
|
|
|
@wraps(method)
|
|
async def wrapper(
|
|
view: HomeAssistantView, request: web.Request, *args: Any, **kwargs: Any
|
|
) -> web.StreamResponse:
|
|
"""Wrap a request handler with data validation."""
|
|
data = None
|
|
try:
|
|
data = await request.json()
|
|
except ValueError:
|
|
if not self._allow_empty or (await request.content.read()) != b"":
|
|
_LOGGER.error("Invalid JSON received")
|
|
return view.json_message("Invalid JSON.", HTTPStatus.BAD_REQUEST)
|
|
data = {}
|
|
|
|
try:
|
|
kwargs["data"] = self._schema(data)
|
|
except vol.Invalid as err:
|
|
_LOGGER.error("Data does not match schema: %s", err)
|
|
return view.json_message(
|
|
f"Message format incorrect: {err}", HTTPStatus.BAD_REQUEST
|
|
)
|
|
|
|
result = await method(view, request, *args, **kwargs)
|
|
return result
|
|
|
|
return wrapper
|