* Conversão de dados
* Validação de dados
* Documentação automática

## Tipos especiais e validação { #special-types-and-validation }

Além dos tipos singulares normais como `str`, `int`, `float`, etc. Você também pode usar tipos singulares mais complexos que herdam de `str`.

Para ver todas as opções possíveis, consulte a [Visão geral dos tipos do Pydantic](https://docs.pydantic.dev/latest/concepts/types/). Você verá alguns exemplos no próximo capítulo.

from pydantic_settings import BaseSettings


class Settings(BaseSettings):
    app_name: str = "Awesome API"
    admin_email: str

from pydantic_settings import BaseSettings


class Settings(BaseSettings):
    app_name: str = "Awesome API"
    admin_email: str

from collections.abc import AsyncIterable, Iterable

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()


class Item(BaseModel):
    name: str
    description: str | None


items = [
    Item(name="Plumbus", description="A multi-purpose household device."),
    Item(name="Portal Gun", description="A portal opening device."),
    Item(name="Meeseeks Box", description="A box that summons a Meeseeks."),
]

from typing import Annotated


def say_hello(name: Annotated[str, "this is just metadata"]) -> str:

대괄호 안의 내부 타입은 "type parameters"라고 부릅니다.

이 경우 `str`이 `list`에 전달된 타입 매개변수입니다.

///

이는 "변수 `items`는 `list`이고, 이 `list`의 각 아이템은 `str`이다"라는 뜻입니다.

이렇게 하면, 에디터는 리스트의 아이템을 처리하는 동안에도 지원을 제공할 수 있습니다:

<img src="/img/python-types/image05.png">

타입이 없으면, 이는 거의 불가능합니다.

변수 `item`이 리스트 `items`의 요소 중 하나라는 점에 주목하세요.

그리고 에디터는 여전히 이것이 `str`임을 알고, 그에 대한 지원을 제공합니다.

#### Tuple과 Set { #tuple-and-set }

from pydantic_settings import BaseSettings, SettingsConfigDict


class Settings(BaseSettings):
    app_name: str = "Awesome API"
    admin_email: str
    items_per_user: int = 50

app = FastAPI(generate_unique_id_function=custom_generate_unique_id)


class Item(BaseModel):
    name: str
    price: float


class ResponseMessage(BaseModel):
    message: str


class User(BaseModel):
    username: str
    email: str


@app.post("/items/", response_model=ResponseMessage, tags=["items"])
async def create_item(item: Item):

        final IntentDetectionResult result = IntentDetectionResult.search("test query", "reasoning");

        final String str = result.toString();
        assertNotNull(str);
        assertTrue(str.contains("IntentDetectionResult"));
        assertTrue(str.contains("SEARCH"));
        assertTrue(str.contains("test query"));
    }

    @Test
    public void test_reasoning_preserved() {

Zum Beispiel könnten Sie deklarieren, dass etwas ein `str` oder `None` sein könnte:

```python
from typing import Union


def say_hi(name: Union[str, None]):
        print(f"Hi {name}!")
```

`typing` hat außerdem eine Abkürzung, um zu deklarieren, dass etwas `None` sein könnte, mit `Optional`.