fastapi-lifespan-manager

What it is and what it does

fastapi-lifespan-manager wraps FastAPI's lifespan context manager to allow you to register multiple startup and shutdown handlers without nesting or manually combining them. Instead of writing a single monolithic lifespan context manager, you decorate individual async generator functions with @manager.add, each yielding a dictionary of state to attach to the app. The manager collects these handlers and runs them sequentially during application startup and shutdown.

This is particularly useful for applications that need to initialize multiple external resources—databases, caches, message queues, connection pools—where each resource has its own setup and teardown logic. Rather than manually coordinating all of these in one place, you can define each resource's lifecycle independently and let the manager orchestrate them. The package depends only on fastapi and supports Python 3.8 through 3.12.

Use it for

• Initialize multiple databases and caches on startup, ensuring each is properly closed when the app shuts down.
• Manage background task workers or thread pools that need to be started at app launch and stopped cleanly.
• Coordinate setup of external service clients (Redis, Elasticsearch, etc.) with their respective cleanup routines.
• Separate resource initialization logic into modular, reusable handlers rather than one large lifespan function.
• Build plugin or extension systems where each module registers its own startup and shutdown behavior.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

fastapi-lifespan-manager on PyPI

Before you install

Low friction: pure Python wheel with only fastapi as a runtime dependency. Repository is active with recent commits and no archived status, though the package is relatively young (first release April 2023).

License in practice

MIT license is permissive; you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart

pip install fastapi-lifespan-manager

from fastapi import FastAPI
from fastapi_lifespan_manager import LifespanManager

manager = LifespanManager()

@manager.add
async def setup_resource(app: FastAPI):
    # Initialize resource
    yield {"resource": resource}
    # Cleanup

app = FastAPI(lifespan=manager)

Package facts

Evidence: fastapi_lifespan_manager-0.1.4-py3-none-any.whl

Tags

More Application Frameworks packages

See also asgi-lifespan · fastapi-cache2 · starsessions · fastapi-utilities · fastapi-cli · fastapi-injectable · FastAPI-SQLAlchemy · taskiq-fastapi · nc-py-api · growthbook