feat: add FastApiDepsStack for long-lived dependency resolution outside request context

[ADR-007]

Adds FastApiDepsStack (async) and fastapi_depends_anywhere.sync.FastApiDepsStack (sync) — a stateful context manager that starts the FastAPI lifespan once, resolves multiple dependencies keeping them alive across calls, and tears everything down on close.

Usage

# async
async with FastApiDepsStack(app=app) as stack:
    db = await stack.resolve(DbDep)
    cache = await stack.resolve(CacheDep)

# sync
with sync.FastApiDepsStack(app=app) as stack:
    db = stack.resolve(DbDep)
    cache = stack.resolve(CacheDep)

Changes

• fastapi_depends_anywhere/stack.py — async FastApiDepsStack
• fastapi_depends_anywhere/sync/stack.py — sync wrapper delegating to async via _run_sync
• Both exported from their respective __init__.py
• 18 tests (9 async + 9 sync), 100% coverage

[github-actions]

Code Coverage Summary

Details

Filename                                      Stmts    Miss  Cover    Missing
------------------------------------------  -------  ------  -------  ---------
fastapi_depends_anywhere/__init__.py             12       0  100.00%
fastapi_depends_anywhere/_internal.py             7       0  100.00%
fastapi_depends_anywhere/config.py               20       0  100.00%
fastapi_depends_anywhere/core.py                 61       0  100.00%
fastapi_depends_anywhere/lifecycle.py            26       0  100.00%
fastapi_depends_anywhere/runners.py              18       0  100.00%
fastapi_depends_anywhere/stack.py                42       0  100.00%
fastapi_depends_anywhere/sync/__init__.py         5       0  100.00%
fastapi_depends_anywhere/sync/_loop.py           18       0  100.00%
fastapi_depends_anywhere/sync/core.py            85       0  100.00%
fastapi_depends_anywhere/sync/lifecycle.py       36       0  100.00%
fastapi_depends_anywhere/sync/runners.py         37       0  100.00%
fastapi_depends_anywhere/sync/stack.py           22       0  100.00%
TOTAL                                           389       0  100.00%

Diff against main

Filename                                     Stmts    Miss  Cover
-----------------------------------------  -------  ------  --------
fastapi_depends_anywhere/__init__.py            +1       0  +100.00%
fastapi_depends_anywhere/stack.py              +42       0  +100.00%
fastapi_depends_anywhere/sync/__init__.py       +1       0  +100.00%
fastapi_depends_anywhere/sync/stack.py         +22       0  +100.00%
TOTAL                                          +66       0  +100.00%

Results for commit: f6f3426

Minimum allowed coverage is 90%

♻️ This comment has been updated with latest results