update: make app/utils.py compliant to linter

Author: Rom1-J

.gitignore

@@ -105,3 +105,4 @@ venv.bak/
 
 # mypy
 .mypy_cache/
+.idea

app/config.py

@@ -6,6 +6,8 @@
 
 from docker import DockerClient
 
+from app.types import ConfigChallengeType, ConfigDockerHostType
+
 
 try:
     DEBUG = strtobool(getenv("DEBUG", "0"))
@@ -31,8 +33,8 @@
     MIN_PORTS = config["random_ports"]["min"]
     MAX_PORTS = config["random_ports"]["max"]
 
-    CHALLENGES = config["challenges"]
-    DOCKER_HOSTS = config["hosts"]
+    CHALLENGES: list[ConfigChallengeType] = config["challenges"]
+    DOCKER_HOSTS: list[ConfigDockerHostType] = config["hosts"]
 
     for host in DOCKER_HOSTS:
         host["client"] = DockerClient(base_url=host["api"])

app/types.py

@@ -1,5 +1,7 @@
 import typing
 
+from docker import DockerClient
+
 
 class UserType(typing.TypedDict):
     user_id: int | None
@@ -9,3 +11,36 @@ class UserType(typing.TypedDict):
     team_name: str | None
 
     is_admin: bool
+
+
+class ConfigDockerHostType(typing.TypedDict):
+    domain: str
+    api: str
+    client: DockerClient
+
+
+class ContainerPortType(typing.TypedDict):
+    port: str
+    protocol: typing.Literal["http", "ssh"]
+
+
+class ChallengeContainerType(typing.TypedDict):
+    docker_image: str
+
+    hostname: str | None
+    ports: list[ContainerPortType]
+
+    command: str | None
+    environment: dict[str, typing.Any] | None
+    privileged: bool | None
+
+    mem_limit: str
+    read_only: bool
+
+    cpu_period: int | None
+    cpu_quota: int | None
+
+
+class ConfigChallengeType(typing.TypedDict):
+    name: str
+    containers: list[ChallengeContainerType]