Adding upstream version 0.5.1.

Signed-off-by: Daniel Baumann <daniel@debian.org>

openapi_pydantic/v3/v3_1/info.py

@@ -0,0 +1,87 @@
+from typing import Optional
+
+from pydantic import BaseModel
+
+from openapi_pydantic.compat import PYDANTIC_V2, ConfigDict, Extra
+
+from .contact import Contact
+from .license import License
+
+_examples = [
+    {
+        "title": "Sample Pet Store App",
+        "summary": "A pet store manager.",
+        "description": "This is a sample server for a pet store.",
+        "termsOfService": "http://example.com/terms/",
+        "contact": {
+            "name": "API Support",
+            "url": "http://www.example.com/support",
+            "email": "support@example.com",
+        },
+        "license": {
+            "name": "Apache 2.0",
+            "url": "https://www.apache.org/licenses/LICENSE-2.0.html",
+        },
+        "version": "1.0.1",
+    }
+]
+
+
+class Info(BaseModel):
+    """
+    The object provides metadata about the API.
+    The metadata MAY be used by the clients if needed,
+    and MAY be presented in editing or documentation generation tools for convenience.
+    """
+
+    title: str
+    """
+    **REQUIRED**. The title of the API.
+    """
+
+    summary: Optional[str] = None
+    """
+    A short summary of the API.
+    """
+
+    description: Optional[str] = None
+    """
+    A description of the API.
+    [CommonMark syntax](https://spec.commonmark.org/) MAY be used for rich text 
+    representation.
+    """
+
+    termsOfService: Optional[str] = None
+    """
+    A URL to the Terms of Service for the API.
+    MUST be in the form of a URL.
+    """
+
+    contact: Optional[Contact] = None
+    """
+    The contact information for the exposed API.
+    """
+
+    license: Optional[License] = None
+    """
+    The license information for the exposed API.
+    """
+
+    version: str
+    """
+    **REQUIRED**. The version of the OpenAPI document
+    (which is distinct from the [OpenAPI Specification version](#oasVersion) or the API 
+    implementation version).
+    """
+
+    if PYDANTIC_V2:
+        model_config = ConfigDict(
+            extra="allow",
+            json_schema_extra={"examples": _examples},
+        )
+
+    else:
+
+        class Config:
+            extra = Extra.allow
+            schema_extra = {"examples": _examples}