waku [枠] means framework in Japanese.
waku is a microframework for building modular and loosely coupled applications.
waku helps you build maintainable Python applications by providing:
- Clean architecture patterns
- Dependency injection
- Module system
- Extension system
- Command/Query handling (CQRS)
- Build modular monoliths with clear boundaries
- Enforce loose coupling between components
- Validate dependency graphs automatically
- Control module visibility and access
- Built-in extension mechanism
- Lifecycle hooks for modules and applications
- Custom extension points
- Rich ecosystem of built-in extensions
- Framework-agnostic DI implementation
- Providers with different lifetimes (singleton, scoped, transient)
- Easy testing and mocking
- Built-in CQRS extension
- Command/Query requests handling
- Event handling
- Middleware support
# Using pip
pip install waku
# Using UV (recommended)
uv add waku
# Using poetry
poetry add wakuimport asyncio
from waku import Application, ApplicationConfig, Module
from waku.di import Scoped, Injected, inject
from waku.di.contrib.aioinject import AioinjectDependencyProvider
# Define your providers
class UserService:
async def get_user(self, user_id: str) -> dict[str, str]:
return {"id": user_id, "name": "John Doe"}
# Create a module
user_module = Module(
name="users",
providers=[
Scoped(UserService),
],
exports=[UserService],
)
# Create the application
application = Application(
name="my_app",
config=ApplicationConfig(
dependency_provider=AioinjectDependencyProvider(),
modules=[user_module],
),
)
# Define entrypoints
# In real world this can be FastAPI routes, etc.
@inject
async def handler(user_service: Injected[UserService]) -> dict[str, str]:
return await user_service.get_user(user_id='123')
# Run the application
# In real world this would be run by a 3rd party framework like FastAPI
async def main() -> None:
dp = application.dependency_provider
async with application, dp.context():
result = await handler()
print(result)
if __name__ == '__main__':
asyncio.run(main())For detailed documentation, visit our documentation site.
We welcome contributions! Please see our Contributing Guide for details.
See out contributing guide for development setup.
This project is licensed under the MIT License.