summaryrefslogtreecommitdiff
path: root/venv/lib/python3.11/site-packages/litestar/openapi/spec/discriminator.py
blob: 3c292ce0f634e686d429e42daba1c129b02ac8e5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
from __future__ import annotations

from dataclasses import dataclass

from litestar.openapi.spec.base import BaseSchemaObject

__all__ = ("Discriminator",)


@dataclass(unsafe_hash=True)
class Discriminator(BaseSchemaObject):
    """When request bodies or response payloads may be one of a number of different schemas, a ``discriminator``
    object can be used to aid in serialization, deserialization, and validation.

    The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an
    alternative schema based on the value associated with it.

    When using the discriminator, _inline_ schemas will not be considered.
    """

    property_name: str
    """**REQUIRED**. The name of the property in the payload that will hold the discriminator value."""

    mapping: dict[str, str] | None = None
    """An object to hold mappings between payload values and schema names or references."""