improve code & comments

Author: Fabien Coelho

tests/secret.py

@@ -8,12 +8,14 @@
 random.seed(os.environ.get("TEST_SEED", None))
 
 # parameters
-LENGTH: int = 16
-CHARS: str = string.printable.replace(",", "")  # all but ","
+PASS_LENGTH: int = 16
+PASS_CHARS: str = string.printable.replace(",", "")  # all but ","
+
+# user logins to generate
 USERS: list[str] = ["calvin", "hobbes", "susie", "moe"]
 
 # login -> clear-password
 PASSES: dict[str, str] = {
-    login: "".join(random.choice(CHARS) for _ in range(LENGTH))
+    login: "".join(random.choice(PASS_CHARS) for _ in range(PASS_LENGTH))
         for login in USERS
 }