Add docs for scripts

scripts/clean_db.py

@@ -1,16 +1,20 @@
+"""Script for clearing the connected database of all data."""
+
 import os
 from os import getenv
 
 import psycopg2
 
-with psycopg2.connect(
-    user=getenv("SQL_USER"),
-    password=getenv("SQL_PASSWORD"),
-    host=getenv("SQL_HOST"),
-    port=getenv("SQL_PORT"),
-    database="template1",
-) as connection:
-    connection.set_isolation_level(0)
-    with connection.cursor() as cursor:
-        cursor.execute(f"DROP DATABASE {os.getenv('SQL_DATABASE')}")
-        cursor.execute(f"CREATE DATABASE {os.getenv('SQL_DATABASE')}")
+
+if __name__ == '__main__':
+    with psycopg2.connect(
+        user=getenv("SQL_USER"),
+        password=getenv("SQL_PASSWORD"),
+        host=getenv("SQL_HOST"),
+        port=getenv("SQL_PORT"),
+        database="template1",
+    ) as connection:
+        connection.set_isolation_level(0)
+        with connection.cursor() as cursor:
+            cursor.execute(f"DROP DATABASE {os.getenv('SQL_DATABASE')}")
+            cursor.execute(f"CREATE DATABASE {os.getenv('SQL_DATABASE')}")

scripts/fake/config.py

@@ -18,6 +18,7 @@ class PostgreSQL:
 
     @classproperty
     def dsn(cls) -> str:
+        """Return the DSN for connecting to the configured database."""
         return f"postgres://{cls.USER}:{cls.PASSWORD}@{cls.HOST}:{cls.PORT}/template1"