### 프로그램이란 { #what-is-a-program }

**프로그램**이라는 단어는 보통 여러 가지를 가리키는 데 사용됩니다:

* 여러분이 작성하는 **코드**, 즉 **Python 파일**들
* 운영체제에서 **실행**할 수 있는 **파일**, 예: `python`, `python.exe`, `uvicorn`
* 운영체제에서 **실행 중**인 특정 프로그램으로, CPU를 사용하고 메모리에 내용을 저장합니다. 이것을 **프로세스**라고도 합니다.

### 프로세스란 { #what-is-a-process }

Ayrıca birçok araç, ortam, veritabanı ve uygulama için önceden hazırlanmış **resmi container image**'ların bulunduğu herkese açık bir [Docker Hub](https://hub.docker.com/) vardır.

Örneğin, resmi bir [Python Image](https://hub.docker.com/_/python) bulunur.

Ve veritabanları gibi farklı şeyler için de birçok image vardır; örneğin:

* [PostgreSQL](https://hub.docker.com/_/postgres)
* [MySQL](https://hub.docker.com/_/mysql)

{* ../../docs_src/body/tutorial001_py310.py hl[2] *}

## Crie seu modelo de dados { #create-your-data-model }

Então você declara seu modelo de dados como uma classe que herda `BaseModel`.

Utilize os tipos Python padrão para todos os atributos:

{* ../../docs_src/body/tutorial001_py310.py hl[5:9] *}

```

</div>

/// note

指令 `uvicorn main:app` 指的是：

* `main`：檔案 `main.py`（Python「模組」）。
* `app`：在 `main.py` 中以 `app = FastAPI()` 建立的物件。

等同於：

```Python
from main import app
```

///

其他 ASGI 伺服器也有類似的指令，詳見各自的文件。

/// warning

Uvicorn 與其他伺服器支援 `--reload` 選項，對開發期間很有幫助。

- ⚡ [**FastAPI**](https://fastapi.tiangolo.com/es) para la API del backend en Python.
    - 🧰 [SQLModel](https://sqlmodel.tiangolo.com) para las interacciones con bases de datos SQL en Python (ORM).
    - 🔍 [Pydantic](https://docs.pydantic.dev), utilizado por FastAPI, para la validación de datos y gestión de configuraciones.

## Full Stack FastAPI Template - Technology Stack and Features { #full-stack-fastapi-template-technology-stack-and-features }

- ⚡ [**FastAPI**](https://fastapi.tiangolo.com) for the Python backend API.
  - 🧰 [SQLModel](https://sqlmodel.tiangolo.com) for the Python SQL database interactions (ORM).
  - 🔍 [Pydantic](https://docs.pydantic.dev), used by FastAPI, for the data validation and settings management.

      - name: Checkout repository
        if: ${{ github.event_name == 'push' }}
        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
      - name: Build binary and run python tests on nightly for all python versions
        shell: bash
        run: |
          is_nightly=0 && tf_project_name='tf_ci_ext' && ${{ github.event_name == 'schedule' }} && is_nightly=1 && tf_project_name='tf_nightly_ci_ext'

它會把函式轉換成所謂的「**非同步內容管理器（async context manager）**」。

{* ../../docs_src/events/tutorial003_py310.py hl[1,13] *}

Python 中的**內容管理器（context manager）**可以用在 `with` 陳述式中，例如 `open()` 可以作為內容管理器使用：

```Python
with open("file.txt") as file:
    file.read()
```

在較新的 Python 版本中，也有**非同步內容管理器**。你可以用 `async with` 來使用它：

```Python
async with lifespan(app):
    await do_stuff()
```

## 執行 { #run-it }

/// info

當你使用 `pip install "fastapi[standard]"` 指令安裝時，[`python-multipart`](https://github.com/Kludex/python-multipart) 套件會隨 FastAPI 自動安裝。

不過若只執行 `pip install fastapi`，預設不會包含 `python-multipart`。

若要手動安裝，請先建立並啟用一個[虛擬環境](../../virtual-environments.md)，接著執行：

```console
$ pip install python-multipart
```

因為 OAuth2 會以「form data」傳送 `username` 與 `password`。

///

用以下指令執行範例：

## 运行 { #run-it }

/// info | 信息

当你使用命令 `pip install "fastapi[standard]"` 安装 **FastAPI** 时，[`python-multipart`](https://github.com/Kludex/python-multipart) 包会自动安装。

但是，如果你使用 `pip install fastapi`，默认不会包含 `python-multipart` 包。

如需手动安装，请先创建并激活[虚拟环境](../../virtual-environments.md)，然后执行：

```console
$ pip install python-multipart
```

这是因为 **OAuth2** 使用“表单数据”来发送 `username` 和 `password`。

///

用下面的命令运行示例：