Irfanuddin Shafi Ahmed
1 year ago
committed by
GitHub
GitHub
69 changed files with 191 additions and 132 deletions
@ -221,7 +221,7 @@ $ ADMIN_EMAIL="[email protected]" APP_NAME="ChimichangApp" uvicorn main:app |
|||||
``` |
``` |
||||
|
|
||||
!!! tip |
!!! tip |
||||
👥 🔜 🔬 `@lru_cache()` 🍖. |
👥 🔜 🔬 `@lru_cache` 🍖. |
||||
|
|
||||
🔜 👆 💪 🤔 `get_settings()` 😐 🔢. |
🔜 👆 💪 🤔 `get_settings()` 😐 🔢. |
||||
|
|
||||
@ -254,7 +254,7 @@ $ ADMIN_EMAIL="[email protected]" APP_NAME="ChimichangApp" uvicorn main:app |
|||||
|
|
||||
✋️ 🇨🇻 📁 🚫 🤙 ✔️ ✔️ 👈 ☑ 📁. |
✋️ 🇨🇻 📁 🚫 🤙 ✔️ ✔️ 👈 ☑ 📁. |
||||
|
|
||||
Pydantic ✔️ 🐕🦺 👂 ⚪️➡️ 👉 🆎 📁 ⚙️ 🔢 🗃. 👆 💪 ✍ 🌖 <a href="https://pydantic-docs.helpmanual.io/usage/settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic ⚒: 🇨🇻 (.🇨🇻) 🐕🦺</a>. |
Pydantic ✔️ 🐕🦺 👂 ⚪️➡️ 👉 🆎 📁 ⚙️ 🔢 🗃. 👆 💪 ✍ 🌖 <a href="https://docs.pydantic.dev/latest/concepts/pydantic_settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic ⚒: 🇨🇻 (.🇨🇻) 🐕🦺</a>. |
||||
|
|
||||
!!! tip |
!!! tip |
||||
👉 👷, 👆 💪 `pip install python-dotenv`. |
👉 👷, 👆 💪 `pip install python-dotenv`. |
||||
@ -302,7 +302,7 @@ def get_settings(): |
|||||
|
|
||||
👥 🔜 ✍ 👈 🎚 🔠 📨, & 👥 🔜 👂 `.env` 📁 🔠 📨. 👶 👶 |
👥 🔜 ✍ 👈 🎚 🔠 📨, & 👥 🔜 👂 `.env` 📁 🔠 📨. 👶 👶 |
||||
|
|
||||
✋️ 👥 ⚙️ `@lru_cache()` 👨🎨 🔛 🔝, `Settings` 🎚 🔜 ✍ 🕴 🕐, 🥇 🕰 ⚫️ 🤙. 👶 👶 |
✋️ 👥 ⚙️ `@lru_cache` 👨🎨 🔛 🔝, `Settings` 🎚 🔜 ✍ 🕴 🕐, 🥇 🕰 ⚫️ 🤙. 👶 👶 |
||||
|
|
||||
```Python hl_lines="1 10" |
```Python hl_lines="1 10" |
||||
{!../../../docs_src/settings/app03/main.py!} |
{!../../../docs_src/settings/app03/main.py!} |
||||
@ -312,14 +312,14 @@ def get_settings(): |
|||||
|
|
||||
#### `lru_cache` 📡 ℹ |
#### `lru_cache` 📡 ℹ |
||||
|
|
||||
`@lru_cache()` 🔀 🔢 ⚫️ 🎀 📨 🎏 💲 👈 📨 🥇 🕰, ↩️ 💻 ⚫️ 🔄, 🛠️ 📟 🔢 🔠 🕰. |
`@lru_cache` 🔀 🔢 ⚫️ 🎀 📨 🎏 💲 👈 📨 🥇 🕰, ↩️ 💻 ⚫️ 🔄, 🛠️ 📟 🔢 🔠 🕰. |
||||
|
|
||||
, 🔢 🔛 ⚫️ 🔜 🛠️ 🕐 🔠 🌀 ❌. & ⤴️ 💲 📨 🔠 👈 🌀 ❌ 🔜 ⚙️ 🔄 & 🔄 🕐❔ 🔢 🤙 ⏮️ ⚫️❔ 🎏 🌀 ❌. |
, 🔢 🔛 ⚫️ 🔜 🛠️ 🕐 🔠 🌀 ❌. & ⤴️ 💲 📨 🔠 👈 🌀 ❌ 🔜 ⚙️ 🔄 & 🔄 🕐❔ 🔢 🤙 ⏮️ ⚫️❔ 🎏 🌀 ❌. |
||||
|
|
||||
🖼, 🚥 👆 ✔️ 🔢: |
🖼, 🚥 👆 ✔️ 🔢: |
||||
|
|
||||
```Python |
```Python |
||||
@lru_cache() |
@lru_cache |
||||
def say_hi(name: str, salutation: str = "Ms."): |
def say_hi(name: str, salutation: str = "Ms."): |
||||
return f"Hello {salutation} {name}" |
return f"Hello {salutation} {name}" |
||||
``` |
``` |
||||
@ -371,7 +371,7 @@ participant execute as Execute function |
|||||
|
|
||||
👈 🌌, ⚫️ 🎭 🌖 🚥 ⚫️ 🌐 🔢. ✋️ ⚫️ ⚙️ 🔗 🔢, ⤴️ 👥 💪 🔐 ⚫️ 💪 🔬. |
👈 🌌, ⚫️ 🎭 🌖 🚥 ⚫️ 🌐 🔢. ✋️ ⚫️ ⚙️ 🔗 🔢, ⤴️ 👥 💪 🔐 ⚫️ 💪 🔬. |
||||
|
|
||||
`@lru_cache()` 🍕 `functools` ❔ 🍕 🐍 🐩 🗃, 👆 💪 ✍ 🌅 🔃 ⚫️ <a href="https://docs.python.org/3/library/functools.html#functools.lru_cache" class="external-link" target="_blank">🐍 🩺 `@lru_cache()`</a>. |
`@lru_cache` 🍕 `functools` ❔ 🍕 🐍 🐩 🗃, 👆 💪 ✍ 🌅 🔃 ⚫️ <a href="https://docs.python.org/3/library/functools.html#functools.lru_cache" class="external-link" target="_blank">🐍 🩺 `@lru_cache`</a>. |
||||
|
|
||||
## 🌃 |
## 🌃 |
||||
|
|
||||
@ -379,4 +379,4 @@ participant execute as Execute function |
|||||
|
|
||||
* ⚙️ 🔗 👆 💪 📉 🔬. |
* ⚙️ 🔗 👆 💪 📉 🔬. |
||||
* 👆 💪 ⚙️ `.env` 📁 ⏮️ ⚫️. |
* 👆 💪 ⚙️ `.env` 📁 ⏮️ ⚫️. |
||||
* ⚙️ `@lru_cache()` ➡️ 👆 ❎ 👂 🇨🇻 📁 🔄 & 🔄 🔠 📨, ⏪ 🤝 👆 🔐 ⚫️ ⏮️ 🔬. |
* ⚙️ `@lru_cache` ➡️ 👆 ❎ 👂 🇨🇻 📁 🔄 & 🔄 🔠 📨, ⏪ 🤝 👆 🔐 ⚫️ ⏮️ 🔬. |
||||
|
|||||
|
After Width: | Height: | Size: 30 KiB |
|
After Width: | Height: | Size: 8.0 KiB |
|
After Width: | Height: | Size: 11 KiB |
|
After Width: | Height: | Size: 6.4 KiB |
|
After Width: | Height: | Size: 36 KiB |
@ -239,7 +239,7 @@ $ ADMIN_EMAIL="[email protected]" APP_NAME="ChimichangApp"uvicorn main:app |
|||||
``` |
``` |
||||
|
|
||||
!!! tip |
!!! tip |
||||
我们稍后会讨论 `@lru_cache()`。 |
我们稍后会讨论 `@lru_cache`。 |
||||
|
|
||||
目前，您可以将 `get_settings()` 视为普通函数。 |
目前，您可以将 `get_settings()` 视为普通函数。 |
||||
|
|
||||
@ -289,7 +289,7 @@ $ ADMIN_EMAIL="[email protected]" APP_NAME="ChimichangApp"uvicorn main:app |
|||||
|
|
||||
但是，dotenv 文件实际上不一定要具有确切的文件名。 |
但是，dotenv 文件实际上不一定要具有确切的文件名。 |
||||
|
|
||||
Pydantic 支持使用外部库从这些类型的文件中读取。您可以在<a href="https://pydantic-docs.helpmanual.io/usage/settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic 设置: Dotenv (.env) 支持</a>中阅读更多相关信息。 |
Pydantic 支持使用外部库从这些类型的文件中读取。您可以在<a href="https://docs.pydantic.dev/latest/concepts/pydantic_settings/#dotenv-env-support" class="external-link" target="_blank">Pydantic 设置: Dotenv (.env) 支持</a>中阅读更多相关信息。 |
||||
|
|
||||
!!! tip |
!!! tip |
||||
要使其工作，您需要执行 `pip install python-dotenv`。 |
要使其工作，您需要执行 `pip install python-dotenv`。 |
||||
@ -337,7 +337,7 @@ def get_settings(): |
|||||
|
|
||||
我们将为每个请求创建该对象，并且将在每个请求中读取 `.env` 文件。 ⚠️ |
我们将为每个请求创建该对象，并且将在每个请求中读取 `.env` 文件。 ⚠️ |
||||
|
|
||||
但是，由于我们在顶部使用了 `@lru_cache()` 装饰器，因此只有在第一次调用它时，才会创建 `Settings` 对象一次。 ✔️ |
但是，由于我们在顶部使用了 `@lru_cache` 装饰器，因此只有在第一次调用它时，才会创建 `Settings` 对象一次。 ✔️ |
||||
|
|
||||
=== "Python 3.9+" |
=== "Python 3.9+" |
||||
|
|
||||
@ -364,13 +364,13 @@ def get_settings(): |
|||||
|
|
||||
#### `lru_cache` 技术细节 |
#### `lru_cache` 技术细节 |
||||
|
|
||||
`@lru_cache()` 修改了它所装饰的函数，以返回第一次返回的相同值，而不是再次计算它，每次都执行函数的代码。 |
`@lru_cache` 修改了它所装饰的函数，以返回第一次返回的相同值，而不是再次计算它，每次都执行函数的代码。 |
||||
|
|
||||
因此，下面的函数将对每个参数组合执行一次。然后，每个参数组合返回的值将在使用完全相同的参数组合调用函数时再次使用。 |
因此，下面的函数将对每个参数组合执行一次。然后，每个参数组合返回的值将在使用完全相同的参数组合调用函数时再次使用。 |
||||
|
|
||||
例如，如果您有一个函数： |
例如，如果您有一个函数： |
||||
```Python |
```Python |
||||
@lru_cache() |
@lru_cache |
||||
def say_hi(name: str, salutation: str = "Ms."): |
def say_hi(name: str, salutation: str = "Ms."): |
||||
return f"Hello {salutation} {name}" |
return f"Hello {salutation} {name}" |
||||
``` |
``` |
||||
@ -422,7 +422,7 @@ participant execute as Execute function |
|||||
|
|
||||
这样，它的行为几乎就像是一个全局变量。但是由于它使用了依赖项函数，因此我们可以轻松地进行测试时的覆盖。 |
这样，它的行为几乎就像是一个全局变量。但是由于它使用了依赖项函数，因此我们可以轻松地进行测试时的覆盖。 |
||||
|
|
||||
`@lru_cache()` 是 `functools` 的一部分，它是 Python 标准库的一部分，您可以在<a href="https://docs.python.org/3/library/functools.html#functools.lru_cache" class="external-link" target="_blank">Python 文档中了解有关 `@lru_cache()` 的更多信息</a>。 |
`@lru_cache` 是 `functools` 的一部分，它是 Python 标准库的一部分，您可以在<a href="https://docs.python.org/3/library/functools.html#functools.lru_cache" class="external-link" target="_blank">Python 文档中了解有关 `@lru_cache` 的更多信息</a>。 |
||||
|
|
||||
## 小结 |
## 小结 |
||||
|
|
||||
@ -430,4 +430,4 @@ participant execute as Execute function |
|||||
|
|
||||
* 通过使用依赖项，您可以简化测试。 |
* 通过使用依赖项，您可以简化测试。 |
||||
* 您可以使用 `.env` 文件。 |
* 您可以使用 `.env` 文件。 |
||||
* 使用 `@lru_cache()` 可以避免为每个请求重复读取 dotenv 文件，同时允许您在测试时进行覆盖。 |
* 使用 `@lru_cache` 可以避免为每个请求重复读取 dotenv 文件，同时允许您在测试时进行覆盖。 |
||||
|
|||||
@ -20,8 +20,10 @@ def client(): |
|||||
def test_swagger_ui_html(client: TestClient): |
def test_swagger_ui_html(client: TestClient): |
||||
response = client.get("/docs") |
response = client.get("/docs") |
||||
assert response.status_code == 200, response.text |
assert response.status_code == 200, response.text |
||||
assert "https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js" in response.text |
assert ( |
||||
assert "https://unpkg.com/swagger-ui-dist@5/swagger-ui.css" in response.text |
"https://unpkg.com/[email protected]/swagger-ui-bundle.js" in response.text |
||||
|
) |
||||
|
assert "https://unpkg.com/[email protected]/swagger-ui.css" in response.text |
||||
|
|
||||
|
|
||||
def test_swagger_ui_oauth2_redirect_html(client: TestClient): |
def test_swagger_ui_oauth2_redirect_html(client: TestClient): |
||||
|
|||||
Loading…
Reference in new issue