Sub-dependencies in FastAPI - Step-by-Step Execution

Concept Flow - Sub-dependencies

Request comes in

↓

Main dependency called

↓

Sub-dependency called

↓

Sub-dependency returns value

↓

Main dependency receives sub-value

↓

Main dependency returns value

↓

Endpoint receives main value

↓

Response sent

The request triggers the main dependency, which calls the sub-dependency. The sub-dependency returns a value used by the main dependency, which then returns its value to the endpoint.

Execution Sample

FastAPI

from fastapi import FastAPI, Depends

app = FastAPI()

def sub_dep():
    return "sub-value"

def main_dep(sub_value: str = Depends(sub_dep)):
    return f"main uses {sub_value}"

@app.get("/")
async def root(value: str = Depends(main_dep)):
    return {"result": value}

This FastAPI app uses a sub-dependency inside a main dependency, which the endpoint depends on.

Execution Table

Step	Action	Dependency Called	Returned Value	Next Step
1	Request received at '/' endpoint	None	None	Call main_dep()
2	main_dep() starts	sub_dep()	None	Call sub_dep()
3	sub_dep() runs	None	"sub-value"	Return to main_dep()
4	main_dep() receives 'sub-value'	None	"main uses sub-value"	Return to endpoint
5	Endpoint receives 'main uses sub-value'	None	{"result": "main uses sub-value"}	Send response
6	Response sent to client	None	None	End

💡 Response sent, request cycle complete

Variable Tracker

Variable	Start	After Step 3	After Step 4	Final
sub_value	None	"sub-value"	"sub-value"	"sub-value"
value	None	None	"main uses sub-value"	"main uses sub-value"

Key Moments - 2 Insights

Why does main_dep call sub_dep before returning?

Because main_dep depends on sub_dep's output to build its own return value, as shown in execution_table step 2 and 3.

What value does the endpoint receive from main_dep?

The endpoint receives the string 'main uses sub-value' returned by main_dep, as seen in execution_table step 5.

Visual Quiz - 3 Questions

Look at the execution table, what value does sub_dep return at step 3?

A "main uses sub-value"

B "sub-value"

C None

D {"result": "main uses sub-value"}

💡 Hint

Check the 'Returned Value' column at step 3 in the execution_table.

At which step does main_dep receive the sub_dep's returned value?

A Step 4

B Step 3

C Step 2

D Step 5

💡 Hint

Look for when main_dep gets 'sub-value' in the execution_table.

If sub_dep returned 'new-sub-value', what would be the endpoint's final result?

A {"result": "main uses sub-value"}

B {"result": "sub-value"}

C {"result": "main uses new-sub-value"}

D An error occurs

💡 Hint

Follow the flow: sub_dep's return affects main_dep's return, which endpoint uses.

Concept Snapshot

FastAPI Sub-dependencies:
- Define a sub-dependency function.
- Use Depends(sub_dep) inside main dependency.
- Main dependency uses sub-dependency's output.
- Endpoint depends on main dependency.
- Enables clean, reusable dependency chains.

Full Transcript

In FastAPI, sub-dependencies allow one dependency to use another. When a request comes in, the endpoint calls the main dependency. The main dependency calls the sub-dependency to get a value. The sub-dependency returns its value, which the main dependency uses to build its own return value. Finally, the endpoint receives this value and sends it as a response. This chain helps organize code by breaking dependencies into smaller parts.