Initial commit

This is a FastAPI backend microservice template used with `copier` utility.

Features of applied template are:
- Configuration file processing logic
- Metrics and tracing (both optional) configuration available
- Debug endpoints
- Database migration commands, prepared Alembic environment
- Database usage example in ping_db endpoint
- gitea sanity check pipeline

{{project_slug}}/dependencies/__init__.py

@@ -0,0 +1 @@
+"""Dependencies-related functions are located here."""

{{project_slug}}/dependencies/connection_manager_dep.py.jinja

@@ -0,0 +1,25 @@
+"""PostgresConnectionManager dependency functions are defined here."""
+
+from fastapi import FastAPI, Request
+
+from {{project_slug}}.db.connection.manager import PostgresConnectionManager
+
+
+def init_dispencer(app: FastAPI, connection_manager: PostgresConnectionManager) -> None:
+    """Initialize PostgresConnectionManager dispencer at app's state."""
+    if hasattr(app.state, "postgres_connection_manager"):
+        if not isinstance(app.state.postgres_connection_manager, PostgresConnectionManager):
+            raise ValueError(
+                "postgres_connection_manager attribute of app's state is already set"
+                f"with other value ({app.state.postgres_connection_manager})"
+            )
+        return
+
+    app.state.postgres_connection_manager = connection_manager
+
+
+def obtain(request: Request) -> PostgresConnectionManager:
+    """Get a PostgresConnectionManager from request's app state."""
+    if not hasattr(request.app.state, "postgres_connection_manager"):
+        raise ValueError("PostgresConnectionManager dispencer was not initialized at app preparation")
+    return request.app.state.postgres_connection_manager

{{project_slug}}/dependencies/logger_dep.py

@@ -0,0 +1,33 @@
+"""PostgresConnectionManager dependency functions are defined here."""
+
+from fastapi import FastAPI, Request
+from structlog.stdlib import BoundLogger
+
+
+def init_dispencer(app: FastAPI, logger: BoundLogger) -> None:
+    """Initialize BoundLogger dispencer at app's state."""
+    if hasattr(app.state, "logger"):
+        if not isinstance(app.state.logger, BoundLogger):
+            raise ValueError("logger attribute of app's state is already set" f"with other value ({app.state.logger})")
+        return
+
+    app.state.logger = logger
+
+
+def attach_to_request(request: Request, logger: BoundLogger) -> None:
+    """Set logger for a concrete request. If request had already had a logger, replace it."""
+    if hasattr(request.state, "logger"):
+        if not isinstance(request.state.logger, BoundLogger):
+            logger.warning("request.state.logger is already set with other value", value=request.state.logger)
+    request.state.logger = logger
+
+
+def obtain(request: Request) -> BoundLogger:
+    """Get a logger from request or app state."""
+    if hasattr(request.state, "logger"):
+        logger = request.state.logger
+        if isinstance(logger, BoundLogger):
+            return logger
+    if not hasattr(request.app.state, "logger"):
+        raise ValueError("BoundLogger dispencer was not initialized at app preparation")
+    return request.app.state.logger