python-version-file: ".python-version"
      - name: Setup uv
        uses: astral-sh/setup-uv@v7
        with:
          cache-dependency-glob: |
            pyproject.toml
            uv.lock
      - name: Install Dependencies
        run: uv sync --locked --extra all
      - name: Run prek - pre-commit
        id: precommit
        run: uvx prek run --from-ref origin/${GITHUB_BASE_REF} --to-ref HEAD --show-diff-on-failure

你可以使用 **Pydantic 模型** 在 FastAPI 中宣告 **表單欄位**。

/// info | 說明

要使用表單，首先安裝 [`python-multipart`](https://github.com/Kludex/python-multipart)。

請先建立[虛擬環境](../virtual-environments.md)、啟用後再安裝，例如：

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

///

/// note | 注意

此功能自 FastAPI 版本 `0.113.0` 起支援。🤓

///

## 針對表單的 Pydantic 模型 { #pydantic-models-for-forms }

Bir [virtual environment](../virtual-environments.md) oluşturduğunuzdan, onu etkinleştirdiğinizden emin olun ve ardından örneğin şöyle kurun:

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

///

## `Form`'u Import Edin { #import-form }

`Form`'u `fastapi`'den import edin:

{* ../../docs_src/request_forms/tutorial001_an_py310.py hl[3] *}

fi

if [ ! -f ./kes ]; then
	wget --quiet -O kes https://github.com/minio/kes/releases/latest/download/kes-linux-amd64 &&
		chmod +x kes
fi

if ! openssl version &>/dev/null; then
	apt install openssl || sudo apt install opensssl
fi

# Start KES Server
(./kes server --dev 2>&1 >kes-server.log) &
kes_pid=$!
sleep 5s
API_KEY=$(grep "API Key" <kes-server.log | awk -F" " '{print $3}')

git clone https://github.com/codelibs/fess-suggest.git
cd fess-suggest

# Compile the project
mvn compile

# Run tests
mvn test

# Package JAR
mvn package

# Install to local repository
mvn install
```

### Code Quality Commands

```bash
# Format code (Eclipse formatter)
mvn formatter:format

# Check/apply license headers
mvn license:check
mvn license:format

///

<details>
<summary>Dockerfile 預覽 👀</summary>

```Dockerfile
FROM python:3.14

WORKDIR /code

COPY ./requirements.txt /code/requirements.txt

RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt

COPY ./app /code/app

CMD ["fastapi", "run", "app/main.py", "--port", "80"]

# 若在 Nginx 或 Traefik 等代理伺服器後方執行，請加入 --proxy-headers

As it's running **locally**, and not in the open internet, you decide to **not have any authentication** set up, just trusting the access to the local network.

Then one of your users could install it and run it locally.

Then they could open a malicious website, e.g. something like

```
https://evilhackers.example.com
```

 * specific language governing permissions and limitations
 * under the License.
 */
package org.apache.maven.internal.impl;

import java.nio.file.Path;
import java.time.Instant;
import java.util.Collection;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;

## **2. Prerequisites**

- Install Hortonworks Distribution using this [guide.](https://docs.hortonworks.com/HDPDocuments/Ambari-2.7.1.0/bk_ambari-installation/content/ch_Installing_Ambari.html)

そのために `WSGIMiddleware` を使用して、Flask や Django などの WSGI アプリをラップできます。

## `WSGIMiddleware` の使用 { #using-wsgimiddleware }

/// info | 情報

これには `a2wsgi` のインストールが必要です。例: `pip install a2wsgi`。

///

`a2wsgi` から `WSGIMiddleware` をインポートします。

次に、そのミドルウェアで WSGI（例: Flask）アプリをラップします。

そして、それをあるパスの下にマウントします。

{* ../../docs_src/wsgi/tutorial001_py310.py hl[1,3,23] *}

/// note | 備考