Polish sqlalchemy code and docs.

Author: tobiasraabe

docs/source/reference_guides/configuration.md

@@ -45,7 +45,7 @@ are welcome to also support macOS.
 ````{confval} database_url
 
 pytask uses a database to keep track of tasks, products, and dependencies over runs. By
-default, it will create an SQLITE database in the project's root directory called
+default, it will create an SQLite database in the project's root directory called
 `.pytask.sqlite3`. If you want to use a different name or a different dialect
 [supported by sqlalchemy](https://docs.sqlalchemy.org/en/latest/core/engines.html#backend-specific-urls),
 use either {option}`pytask build --database-url` or `database_url` in the config.
@@ -54,7 +54,7 @@ use either {option}`pytask build --database-url` or `database_url` in the config
 database_url = "sqlite:///.pytask.sqlite3"
 ```
 
-Relative paths for SQLITE databases are interpreted as either relative to the
+Relative paths for SQLite databases are interpreted as either relative to the
 configuration file or the root directory.
 
 ````

src/_pytask/database_utils.py

@@ -13,16 +13,21 @@
 from sqlalchemy.orm import sessionmaker
 
 
-__all__ = ["create_database", "update_states_in_database", "DatabaseSession"]
+__all__ = [
+    "create_database",
+    "update_states_in_database",
+    "BaseTable",
+    "DatabaseSession",
+]
 
 
 DatabaseSession = sessionmaker()
 
 
-Base = declarative_base()
+BaseTable = declarative_base()
 
 
-class State(Base):  # type: ignore[valid-type, misc]
+class State(BaseTable):  # type: ignore[valid-type, misc]
     """Represent the state of a node in relation to a task."""
 
     __tablename__ = "state"
@@ -37,7 +42,7 @@ def create_database(url: str) -> None:
     """Create the database."""
     try:
         engine = create_engine(url)
-        Base.metadata.create_all(bind=engine)
+        BaseTable.metadata.create_all(bind=engine)
         DatabaseSession.configure(bind=engine)
     except Exception:
         raise

src/_pytask/profile.py

@@ -19,7 +19,7 @@
 from _pytask.config import hookimpl
 from _pytask.console import console
 from _pytask.console import format_task_id
-from _pytask.database_utils import Base
+from _pytask.database_utils import BaseTable
 from _pytask.database_utils import DatabaseSession
 from _pytask.exceptions import CollectionError
 from _pytask.exceptions import ConfigurationError
@@ -47,7 +47,7 @@ class _ExportFormats(enum.Enum):
     CSV = "csv"
 
 
-class Runtime(Base):  # type: ignore[valid-type, misc]
+class Runtime(BaseTable):  # type: ignore[valid-type, misc]
     """Record of runtimes of tasks."""
 
     __tablename__ = "runtime"

src/pytask/__init__.py

@@ -13,6 +13,7 @@
 from _pytask.compat import import_optional_dependency
 from _pytask.config import hookimpl
 from _pytask.console import console
+from _pytask.database_utils import BaseTable
 from _pytask.database_utils import create_database
 from _pytask.database_utils import DatabaseSession
 from _pytask.database_utils import State
@@ -65,6 +66,7 @@
 
 
 __all__ = [
+    "BaseTable",
     "CollectionError",
     "CollectionMetadata",
     "CollectionOutcome",