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.
"""
|