[lichess] switch to async Views

As Lichess-related Views will mainly be proxies to the Lichess HTTP API, we would likely benefit from being able to not block workers' threads while the I/O between our server and Lichess are taking place.

Author: olivierphi

Dockerfile

@@ -179,7 +179,7 @@ EXPOSE 8080
 
 ENV DJANGO_SETTINGS_MODULE=project.settings.production
 
-ENV GUNICORN_CMD_ARGS="--bind 0.0.0.0:8080 --workers 2 --max-requests 120 --max-requests-jitter 20 --timeout 8"
+ENV GUNICORN_CMD_ARGS="--bind 0.0.0.0:8080 --workers 4 -k uvicorn_worker.UvicornWorker --max-requests 120 --max-requests-jitter 20 --timeout 8"
 
 RUN chmod +x scripts/start_server.sh
 # See <https://hynek.me/articles/docker-signals/>.

Makefile

@@ -38,11 +38,17 @@ backend/install: bin/uv .venv ## Install the Python dependencies (via uv) and in
 	@${SUB_MAKE} .venv/bin/black
 
 .PHONY: backend/watch
+backend/watch: env_vars ?=
 backend/watch: address ?= localhost
 backend/watch: port ?= 8000
 backend/watch: dotenv_file ?= .env.local
-backend/watch: ## Start the Django development server
-	@${SUB_MAKE} django/manage cmd='runserver ${address}:${port}'
+backend/watch: ## Start Django via Uvicorn, in "watch" mode
+	@@DJANGO_SETTINGS_MODULE=${DJANGO_SETTINGS_MODULE} ${env_vars} \
+		${UV} run uvicorn \
+		--reload --reload-dir src/ \
+		--host ${address} --port ${port} \
+		--env-file ${dotenv_file} \
+		project.asgi:application
 
 .PHONY: backend/resetdb
 backend/resetdb: dotenv_file ?= .env.local

pyproject.toml

@@ -14,6 +14,8 @@ dependencies= [
     # Django doesn't follow SemVer, so we need to specify the minor version:
     "Django==5.1.*",
     "gunicorn==22.*",
+    "uvicorn[standard]==0.30.*",
+    "uvicorn-worker==0.2.*",
     "django-alive==1.*",
     "chess==1.*",
     "django-htmx==1.*",

src/apps/lichess_bridge/components/pages/lichess.py

@@ -7,7 +7,7 @@
 from apps.webui.components.forms_common import csrf_hidden_input
 from apps.webui.components.layout import page
 
-from ...lichess_api import get_lichess_api_client
+from ... import lichess_api
 from ..misc_ui import detach_lichess_account_form
 from ..svg_icons import ICON_SVG_LOG_IN
 
@@ -43,12 +43,12 @@ def lichess_no_account_linked_page(
     )
 
 
-def lichess_account_linked_homepage(
+async def lichess_account_linked_homepage(
     *,
     request: "HttpRequest",
     access_token: "LichessAccessToken",
 ) -> str:
-    me = get_lichess_api_client(access_token).account.get()
+    me = await lichess_api.get_lichess_my_account(access_token)
 
     return page(
         div(

src/apps/lichess_bridge/lichess_api.py

@@ -1,6 +1,7 @@
 from typing import TYPE_CHECKING
 
 import berserk
+from asgiref.sync import sync_to_async
 
 from .models import LICHESS_ACCESS_TOKEN_PREFIX
 
@@ -12,7 +13,14 @@ def is_lichess_api_access_token_valid(token: str) -> bool:
     return token.startswith(LICHESS_ACCESS_TOKEN_PREFIX) and len(token) > 10
 
 
-def get_lichess_api_client(access_token: "LichessAccessToken") -> berserk.Client:
+@sync_to_async(thread_sensitive=False)
+def get_lichess_my_account(
+    access_token: "LichessAccessToken",
+) -> berserk.types.AccountInformation:
+    return _get_lichess_api_client(access_token).account.get()
+
+
+def _get_lichess_api_client(access_token: "LichessAccessToken") -> berserk.Client:
     return _create_lichess_api_client(access_token)
 
 

src/apps/lichess_bridge/views.py

@@ -21,7 +21,7 @@
 
 
 @require_GET
-def lichess_home(request: "HttpRequest") -> HttpResponse:
+async def lichess_home(request: "HttpRequest") -> HttpResponse:
     # Do we have a Lichess API token for this user?
     lichess_access_token = cookie_helpers.get_lichess_api_access_token_from_request(
         request
@@ -30,7 +30,7 @@ def lichess_home(request: "HttpRequest") -> HttpResponse:
     if not lichess_access_token:
         page_content = lichess_no_account_linked_page(request=request)
     else:
-        page_content = lichess_account_linked_homepage(
+        page_content = await lichess_account_linked_homepage(
             request=request,
             access_token=lichess_access_token,
         )