# Gelişmiş Python Tipleri { #advanced-python-types }

Python tipleriyle çalışırken işinize yarayabilecek bazı ek fikirler.

## `Union` veya `Optional` Kullanımı { #using-union-or-optional }

Kodunuz herhangi bir nedenle `|` kullanamıyorsa — örneğin bir tip açıklamasında (type annotation) değil de `response_model=` gibi bir yerdeyse — dikey çizgi (`|`) yerine `typing` içindeki `Union`'ı kullanabilirsiniz.

# Tipos Avançados de Python { #advanced-python-types }

Aqui estão algumas ideias adicionais que podem ser úteis ao trabalhar com tipos em Python.

## Usando `Union` ou `Optional` { #using-union-or-optional }

Se, por algum motivo, seu código não puder usar `|`, por exemplo, se não for em uma anotação de tipo, mas em algo como `response_model=`, em vez de usar a barra vertical (`|`) você pode usar `Union` do `typing`.

함수의 첫 번째 매개변수인 `first_name`을 입력하고, 점(`.`)을 찍은 다음, 완성을 트리거하기 위해 `Ctrl+Space`를 누릅니다.

하지만, 슬프게도 쓸만한 게 아무것도 없습니다:

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

### 타입 추가하기 { #add-types }

이전 버전에서 한 줄만 수정해봅시다.

함수의 매개변수인 정확히 이 부분을:

```Python
    first_name, last_name
```

에서:

```Python
    first_name: str, last_name: str
```

로 바꾸겠습니다.

이게 다입니다.

이것들이 "타입 힌트"입니다:

따라서, 다음과 같이 Pydantic 객체 `user_in`을 생성할 수 있습니다:

```Python
user_in = UserIn(username="john", password="secret", email="******@****.***")
```

그 다음, 다음과 같이 호출합니다:

```Python
user_dict = user_in.model_dump()
```

이제 변수 `user_dict`에 데이터가 포함된 `dict`를 가지게 됩니다(이는 Pydantic 모델 객체가 아닌 `dict`입니다).

그리고 다음과 같이 호출하면:

```Python
print(user_dict)
```

Python의 `dict`가 다음과 같이 출력됩니다:

```Python
{

# Продвинутые типы Python { #advanced-python-types }

Ниже несколько дополнительных идей, которые могут быть полезны при работе с типами Python.

## Использование `Union` или `Optional` { #using-union-or-optional }

Если по какой-то причине ваш код не может использовать `|`, например, если это не аннотация типов, а что-то вроде `response_model=`, вместо вертикальной черты (`|`) можно использовать `Union` из `typing`.

# 고급 Python 타입 { #advanced-python-types }

Python 타입을 다룰 때 유용할 수 있는 몇 가지 추가 아이디어를 소개합니다.

## `Union` 또는 `Optional` 사용 { #using-union-or-optional }

어떤 이유로 코드에서 `|`를 사용할 수 없다면, 예를 들어 타입 어노테이션이 아니라 `response_model=` 같은 곳이라면, 파이프 문자(`|`) 대신 `typing`의 `Union`을 사용할 수 있습니다.

예를 들어, 어떤 값이 `str` 또는 `None`이 될 수 있다고 선언할 수 있습니다:

```python
from typing import Union


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

```

그리고 나서 다른 디렉터리들을 탐색합니다.

따라서 터미널에 `python`을 입력하면, 시스템은 다음 위치에서 Python 프로그램을 찾고:

```plaintext
C:\Users\user\code\awesome-project\.venv\Scripts\python
```

그것을 사용하게 됩니다.

////

중요한 세부 사항은 가상 환경 경로가 `PATH` 변수의 **맨 앞**에 들어간다는 점입니다. 시스템은 다른 어떤 Python보다도 **먼저** 이를 찾게 됩니다. 이렇게 하면 `python`을 실행할 때, 다른 어떤 `python`(예: 전역 환경의 `python`)이 아니라 **가상 환경의 Python**을 사용하게 됩니다.

# Fortgeschrittene Python-Typen { #advanced-python-types }

Hier sind einige zusätzliche Ideen, die beim Arbeiten mit Python-Typen nützlich sein könnten.

## `Union` oder `Optional` verwenden { #using-union-or-optional }

Wenn Ihr Code aus irgendeinem Grund nicht `|` verwenden kann, z. B. wenn es nicht in einer Typannotation ist, sondern in etwas wie `response_model=`, können Sie anstelle des senkrechten Strichs (`|`) `Union` aus `typing` verwenden.

# Types Python avancés { #advanced-python-types }

Voici quelques idées supplémentaires qui peuvent être utiles lorsque vous travaillez avec les types Python.

## Utiliser `Union` ou `Optional` { #using-union-or-optional }

# 高级 Python 类型 { #advanced-python-types }

这里有一些在使用 Python 类型时可能有用的额外想法。

## 使用 `Union` 或 `Optional` { #using-union-or-optional }

如果你的代码因为某些原因不能使用 `|`，例如它不是在类型注解里，而是在 `response_model=` 之类的参数中，那么你可以使用 `typing` 中的 `Union` 来代替竖线（`|`）。

例如，你可以声明某个值可以是 `str` 或 `None`：

```python
from typing import Union


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

`typing` 也提供了一个声明“可能为 `None`”的快捷方式：`Optional`。