<div class="termy">

```console
$ Get-Command pip

some/directory/fastapi/env/bin/pip
```

</div>

////

`env/bin/pip`に`pip`バイナリが表示される場合は、正常に機能しています。🎉


/// tip | "豆知識"

この環境で`pip`を使って新しいパッケージをインストールするたびに、仮想環境を再度有効化します。

これにより、そのパッケージによってインストールされたターミナルのプログラム を使用する場合、ローカル環境のものを使用し、グローバルにインストールされたものは使用されなくなります。

///

### pip

上記のように環境を有効化した後:

Com `Form` você pode declarar os mesmos metadados e validação que com `Body` (e `Query`, `Path`, `Cookie`).

/// info | "Informação"

`Form` é uma classe que herda diretamente de `Body`.

///

/// tip | "Dica"

Para declarar corpos de formulário, você precisa usar `Form` explicitamente, porque sem ele os parâmetros seriam interpretados como parâmetros de consulta ou parâmetros de corpo (JSON).

///

处理依赖项时，**FastAPI** 以如下方式调用 `checker`：

```Python
checker(q="somequery")
```

……并用*路径操作函数*的参数 `fixed_content_included` 返回依赖项的值：

```Python hl_lines="20"
{!../../docs_src/dependencies/tutorial011.py!}
```

/// tip | "提示"

本章示例有些刻意，也看不出有什么用处。

这个简例只是为了说明高级依赖项的运作机制。

在有关安全的章节中，工具函数将以这种方式实现。

只要能理解本章内容，就能理解安全工具背后的运行机制。

そうする場合は、すべての *path operation* を追加した後に行う必要があります。

```Python hl_lines="2  12-21  24"
{!../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
```

/// tip | "豆知識"

`app.openapi()` を手動でコールする場合、その前に`operationId`を更新する必要があります。

///

/// warning | "注意"

この方法をとる場合、各 *path operation関数* が一意な名前である必要があります。

それらが異なるモジュール (Pythonファイル) にあるとしてもです。

///

Использование контейнеров на основе Linux имеет ряд преимуществ, включая  **безопасность**, **воспроизводимость**, **простоту** и прочие.

/// tip | "Подсказка"

Торопитесь или уже знакомы с этой технологией? Перепрыгните на раздел [Создать Docker-образ для FastAPI 👇](#docker-fastapi)

///

<details>
<summary>Развернуть Dockerfile 👀</summary>

{!../../docs_src/using_request_directly/tutorial001.py!}
```

Durch die Deklaration eines *Pfadoperation-Funktionsparameters*, dessen Typ der `Request` ist, weiß **FastAPI**, dass es den `Request` diesem Parameter übergeben soll.

/// tip | "Tipp"

Beachten Sie, dass wir in diesem Fall einen Pfad-Parameter zusätzlich zum Request-Parameter deklarieren.

{!../../docs_src/events/tutorial002.py!}
```

此处，`shutdown` 事件处理器函数在 `log.txt` 中写入一行文本 `Application shutdown`。

/// info | "说明"

`open()` 函数中，`mode="a"` 指的是**追加**。因此这行文本会添加在文件已有内容之后，不会覆盖之前的内容。

///

/// tip | "提示"

注意，本例使用 Python `open()` 标准函数与文件交互。

这个函数执行 I/O（输入/输出）操作，需要等待内容写进磁盘。

但 `open()` 函数不支持使用 `async` 与 `await`。

因此，声明事件处理函数要使用 `def`，不能使用 `asnyc def`。

///

/// info | "说明"

你应该在添加了所有 *路径操作* 之后执行此操作。

```Python hl_lines="2 12 13 14 15 16 17 18 19 20 21 24"
{!../../docs_src/path_operation_advanced_configuration/tutorial002.py!}
```

/// tip

如果你手动调用 `app.openapi()`，你应该在此之前更新 `operationId`。

///

/// warning

如果你这样做，务必确保你的每个 *路径操作函数* 的名字唯一。

即使它们在不同的模块中（Python 文件）。

///

## 从 OpenAPI 中排除

Você pode defini-los da seguinte maneira:

```Python hl_lines="3-16  19-32"
{!../../docs_src/metadata/tutorial001.py!}
```

/// tip | Dica

Você pode escrever Markdown no campo `description` e ele será renderizado na saída.

///

Com essa configuração, a documentação automática da API se pareceria com:

```

////

//// tab | Python 3.8+

```Python hl_lines="16"
{!> ../../docs_src/dependencies/tutorial012_an.py!}
```

////

//// tab | Python 3.8 Annotated가 없는 경우

/// tip | "팁"

가능하다면 `Annotated`가 달린 버전을 권장합니다.

///

```Python hl_lines="15"
{!> ../../docs_src/dependencies/tutorial012.py!}
```

////