tiangolo.fastapi/docs/em/docs/tutorial/dependencies/dependencies-with-yield.md

🔗 ⏮️ 🌾

FastAPI 🐕‍🦺 🔗 👈 ➕ 🔁 ⏮️ 🏁.

👉, ⚙️ yield ↩️ return, & ✍ ➕ 🔁 ⏮️.

!!! tip ⚒ 💭 ⚙️ yield 1️⃣ 👁 🕰.

!!! note "📡 ℹ" 🙆 🔢 👈 ☑ ⚙️ ⏮️:

* <a href="https://docs.python.org/3/library/contextlib.html#contextlib.contextmanager" class="external-link" target="_blank">`@contextlib.contextmanager`</a> ⚖️
* <a href="https://docs.python.org/3/library/contextlib.html#contextlib.asynccontextmanager" class="external-link" target="_blank">`@contextlib.asynccontextmanager`</a>

🔜 ☑ ⚙️ **FastAPI** 🔗.

👐, FastAPI ⚙️ 📚 2️⃣ 👨‍🎨 🔘.

💽 🔗 ⏮️ yield

🖼, 👆 💪 ⚙️ 👉 ✍ 💽 🎉 & 🔐 ⚫️ ⏮️ 🏁.

🕴 📟 ⏭ & 🔌 yield 📄 🛠️ ⏭ 📨 📨:

{!../../../docs_src/dependencies/tutorial007.py!}

🌾 💲 ⚫️❔ 💉 🔘 ➡ 🛠️ & 🎏 🔗:

{!../../../docs_src/dependencies/tutorial007.py!}

📟 📄 yield 📄 🛠️ ⏮️ 📨 ✔️ 🚚:

{!../../../docs_src/dependencies/tutorial007.py!}

!!! tip 👆 💪 ⚙️ async ⚖️ 😐 🔢.

**FastAPI** 🔜 ▶️️ 👜 ⏮️ 🔠, 🎏 ⏮️ 😐 🔗.

🔗 ⏮️ yield & try

🚥 👆 ⚙️ try 🍫 🔗 ⏮️ yield, 👆 🔜 📨 🙆 ⚠ 👈 🚮 🕐❔ ⚙️ 🔗.

🖼, 🚥 📟 ☝ 🖕, ➕1️⃣ 🔗 ⚖️ ➡ 🛠️, ⚒ 💽 💵 "💾" ⚖️ ✍ 🙆 🎏 ❌, 👆 🔜 📨 ⚠ 👆 🔗.

, 👆 💪 👀 👈 🎯 ⚠ 🔘 🔗 ⏮️ except SomeException.

🎏 🌌, 👆 💪 ⚙️ finally ⚒ 💭 🚪 📶 🛠️, 🙅‍♂ 🤔 🚥 📤 ⚠ ⚖️ 🚫.

{!../../../docs_src/dependencies/tutorial007.py!}

🎧-🔗 ⏮️ yield

👆 💪 ✔️ 🎧-🔗 & "🌲" 🎧-🔗 🙆 📐 & 💠, & 🙆 ⚖️ 🌐 👫 💪 ⚙️ yield.

FastAPI 🔜 ⚒ 💭 👈 "🚪 📟" 🔠 🔗 ⏮️ yield 🏃 ☑ ✔.

🖼, dependency_c 💪 ✔️ 🔗 🔛 dependency_b, & dependency_b 🔛 dependency_a:

{!../../../docs_src/dependencies/tutorial008.py!}

& 🌐 👫 💪 ⚙️ yield.

👉 💼 dependency_c, 🛠️ 🚮 🚪 📟, 💪 💲 ⚪️➡️ dependency_b (📥 📛 dep_b) 💪.

& , 🔄, dependency_b 💪 💲 ⚪️➡️ dependency_a (📥 📛 dep_a) 💪 🚮 🚪 📟.

{!../../../docs_src/dependencies/tutorial008.py!}

🎏 🌌, 👆 💪 ✔️ 🔗 ⏮️ yield & return 🌀.

& 👆 💪 ✔️ 👁 🔗 👈 🚚 📚 🎏 🔗 ⏮️ yield, ♒️.

👆 💪 ✔️ 🙆 🌀 🔗 👈 👆 💚.

FastAPI 🔜 ⚒ 💭 🌐 🏃 ☑ ✔.

!!! note "📡 ℹ" 👉 👷 👏 🐍 🔑 👨‍💼.

**FastAPI** ⚙️ 👫 🔘 🏆 👉.

🔗 ⏮️ yield & HTTPException

👆 👀 👈 👆 💪 ⚙️ 🔗 ⏮️ yield & ✔️ try 🍫 👈 ✊ ⚠.

⚫️ 5️⃣📆 😋 🤚 HTTPException ⚖️ 🎏 🚪 📟, ⏮️ yield. ✋️ ⚫️ 🏆 🚫 👷.

🚪 📟 🔗 ⏮️ yield 🛠️ ⏮️ 📨 📨, ⚠ 🐕‍🦺{.internal-link target=_blank} 🔜 ✔️ ⏪ 🏃. 📤 🕳 😽 ⚠ 🚮 👆 🔗 🚪 📟 (⏮️ yield).

, 🚥 👆 🤚 HTTPException ⏮️ yield, 🔢 (⚖️ 🙆 🛃) ⚠ 🐕‍🦺 👈 ✊ HTTPExceptionⓂ & 📨 🇺🇸🔍 4️⃣0️⃣0️⃣ 📨 🏆 🚫 📤 ✊ 👈 ⚠ 🚫🔜.

👉 ⚫️❔ ✔ 🕳 ⚒ 🔗 (✅ 💽 🎉), 🖼, ⚙️ 🖥 📋.

🖥 📋 🏃 ⏮️ 📨 ✔️ 📨. 📤 🙅‍♂ 🌌 🤚 HTTPException ↩️ 📤 🚫 🌌 🔀 📨 👈 ⏪ 📨.

✋️ 🚥 🖥 📋 ✍ 💽 ❌, 🌘 👆 💪 💾 ⚖️ 😬 🔐 🎉 🔗 ⏮️ yield, & 🎲 🕹 ❌ ⚖️ 📄 ⚫️ 🛰 🕵 ⚙️.

🚥 👆 ✔️ 📟 👈 👆 💭 💪 🤚 ⚠, 🏆 😐/"🙃" 👜 & 🚮 try 🍫 👈 📄 📟.

🚥 👆 ✔️ 🛃 ⚠ 👈 👆 🔜 💖 🍵 ⏭ 🛬 📨 & 🎲 ❎ 📨, 🎲 🙋‍♀ HTTPException, ✍ 🛃 ⚠ 🐕‍🦺{.internal-link target=_blank}.

!!! tip 👆 💪 🤚 ⚠ 🔌 HTTPException ⏭ yield. ✋️ 🚫 ⏮️.

🔁 🛠️ 🌅 ⚖️ 🌘 💖 👉 📊. 🕰 💧 ⚪️➡️ 🔝 🔝. & 🔠 🏓 1️⃣ 🍕 🔗 ⚖️ 🛠️ 📟.

sequenceDiagram

participant client as Client
participant handler as Exception handler
participant dep as Dep with yield
participant operation as Path Operation
participant tasks as Background tasks

    Note over client,tasks: Can raise exception for dependency, handled after response is sent
    Note over client,operation: Can raise HTTPException and can change the response
    client ->> dep: Start request
    Note over dep: Run code up to yield
    opt raise
        dep -->> handler: Raise HTTPException
        handler -->> client: HTTP error response
        dep -->> dep: Raise other exception
    end
    dep ->> operation: Run dependency, e.g. DB session
    opt raise
        operation -->> dep: Raise HTTPException
        dep -->> handler: Auto forward exception
        handler -->> client: HTTP error response
        operation -->> dep: Raise other exception
        dep -->> handler: Auto forward exception
    end
    operation ->> client: Return response to client
    Note over client,operation: Response is already sent, can't change it anymore
    opt Tasks
        operation -->> tasks: Send background tasks
    end
    opt Raise other exception
        tasks -->> dep: Raise other exception
    end
    Note over dep: After yield
    opt Handle other exception
        dep -->> dep: Handle exception, can't change response. E.g. close DB session.
    end

!!! info 🕴 1️⃣ 📨 🔜 📨 👩‍💻. ⚫️ 💪 1️⃣ ❌ 📨 ⚖️ ⚫️ 🔜 📨 ⚪️➡️ ➡ 🛠️.

⏮️ 1️⃣ 📚 📨 📨, 🙅‍♂ 🎏 📨 💪 📨.

!!! tip 👉 📊 🎦 HTTPException, ✋️ 👆 💪 🤚 🙆 🎏 ⚠ ❔ 👆 ✍ 🛃 ⚠ 🐕‍🦺{.internal-link target=_blank}.

🚥 👆 🤚 🙆 ⚠, ⚫️ 🔜 🚶‍♀️ 🔗 ⏮️ 🌾, 🔌 `HTTPException`, & ⤴️ **🔄** ⚠ 🐕‍🦺. 🚥 📤 🙅‍♂ ⚠ 🐕‍🦺 👈 ⚠, ⚫️ 🔜 ⤴️ 🍵 🔢 🔗 `ServerErrorMiddleware`, 🛬 5️⃣0️⃣0️⃣ 🇺🇸🔍 👔 📟, ➡️ 👩‍💻 💭 👈 📤 ❌ 💽.

🔑 👨‍💼

⚫️❔ "🔑 👨‍💼"

"🔑 👨‍💼" 🙆 👈 🐍 🎚 👈 👆 💪 ⚙️ with 📄.

🖼, 👆 💪 ⚙️ with ✍ 📁:

with open("./somefile.txt") as f:
    contents = f.read()
    print(contents)

🔘, open("./somefile.txt") ✍ 🎚 👈 🤙 "🔑 👨‍💼".

🕐❔ with 🍫 🏁, ⚫️ ⚒ 💭 🔐 📁, 🚥 📤 ⚠.

🕐❔ 👆 ✍ 🔗 ⏮️ yield, FastAPI 🔜 🔘 🗜 ⚫️ 🔑 👨‍💼, & 🌀 ⚫️ ⏮️ 🎏 🔗 🧰.

⚙️ 🔑 👨‍💼 🔗 ⏮️ yield

!!! warning 👉, 🌅 ⚖️ 🌘, "🏧" 💭.

🚥 👆 ▶️ ⏮️ **FastAPI** 👆 💪 💚 🚶 ⚫️ 🔜.

🐍, 👆 💪 ✍ 🔑 👨‍💼 🏗 🎓 ⏮️ 2️⃣ 👩‍🔬: __enter__() & __exit__().

👆 💪 ⚙️ 👫 🔘 FastAPI 🔗 ⏮️ yield ⚙️ with ⚖️ async with 📄 🔘 🔗 🔢:

{!../../../docs_src/dependencies/tutorial010.py!}

!!! tip ➕1️⃣ 🌌 ✍ 🔑 👨‍💼 ⏮️:

* <a href="https://docs.python.org/3/library/contextlib.html#contextlib.contextmanager" class="external-link" target="_blank">`@contextlib.contextmanager`</a> ⚖️
* <a href="https://docs.python.org/3/library/contextlib.html#contextlib.asynccontextmanager" class="external-link" target="_blank">`@contextlib.asynccontextmanager`</a>

⚙️ 👫 🎀 🔢 ⏮️ 👁 `yield`.

👈 ⚫️❔ **FastAPI** ⚙️ 🔘 🔗 ⏮️ `yield`.

✋️ 👆 🚫 ✔️ ⚙️ 👨‍🎨 FastAPI 🔗 (&amp; 👆 🚫🔜 🚫).

FastAPI 🔜 ⚫️ 👆 🔘.