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

from dataclasses import dataclass

from litestar.openapi.spec.base import BaseSchemaObject

__all__ = ("ExternalDocumentation",)


@dataclass
class ExternalDocumentation(BaseSchemaObject):
    """Allows referencing an external resource for extended documentation."""

    url: str
    """**REQUIRED**. The URL for the target documentation. Value MUST be in the form of a URL."""

    description: str | None = None
    """A short description of the target documentation.

    `CommonMark syntax <https://spec.commonmark.org/>`_ MAY be used for rich text representation.
    """