Skip to content

Add docs warning about ProactorEventLoop and async DB drivers on Windows#2925

Open
baltika10 wants to merge 1 commit intoKludex:mainfrom
baltika10:docs/windows-proactor-async-db-warning
Open

Add docs warning about ProactorEventLoop and async DB drivers on Windows#2925
baltika10 wants to merge 1 commit intoKludex:mainfrom
baltika10:docs/windows-proactor-async-db-warning

Conversation

@baltika10
Copy link
Copy Markdown

Summary

Adds a warning admonition to the Event Loop docs page about ProactorEventLoop being incompatible with async database drivers (psycopg, asyncpg) that rely on add_reader()/add_writer() on Windows.

The warning includes:

  • Which drivers are affected and why
  • The --loop asyncio:SelectorEventLoop workaround using the existing custom event loop syntax
  • The UVICORN_LOOP environment variable as a set-once alternative

Related discussion: #2749

@codspeed-hq
Copy link
Copy Markdown

codspeed-hq Bot commented Apr 29, 2026

Merging this PR will not alter performance

✅ 24 untouched benchmarks


Comparing baltika10:docs/windows-proactor-async-db-warning (a760446) with main (6761b2c)

Open in CodSpeed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant