build: added alembic for migrations

app/alembic.ini

@@ -0,0 +1,42 @@
+[alembic]
+script_location = alembic
+prepend_sys_path = .
+version_path_separator = os
+sqlalchemy.url = postgresql://pepper:pepper@localhost:15432/pepper
+
+[post_write_hooks]
+
+# Logging configuration
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARNING
+handlers = console
+qualname =
+
+[logger_sqlalchemy]
+level = WARNING
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s
+datefmt = %H:%M:%S

app/alembic/README

@@ -0,0 +1 @@
+Generic single-database configuration.

app/alembic/env.py

@@ -0,0 +1,71 @@
+# Copyright (c) 2025 <Godwin peter. O>
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+#
+#  Project: pepper-local
+#  Author: Godwin peter. O (me@godwin.dev)
+#  Created At: Tue 25 Feb 2025 14:51:59
+#  Modified By: Godwin peter. O (me@godwin.dev)
+#  Modified At: Tue 25 Feb 2025 14:51:59
+
+from logging.config import fileConfig
+from sqlalchemy import engine_from_config
+from sqlalchemy import pool
+from alembic import context
+from app.models import Base
+
+config = context.config
+
+if config.config_file_name is not None:
+	fileConfig(config.config_file_name)
+
+target_metadata = Base.metadata
+
+
+def run_migrations_offline() -> None:
+	url = config.get_main_option('sqlalchemy.url')
+	context.configure(
+		url=url,
+		target_metadata=target_metadata,
+		literal_binds=True,
+		dialect_opts={'paramstyle': 'named'},
+	)
+
+	with context.begin_transaction():
+		context.run_migrations()
+
+
+def run_migrations_online() -> None:
+	connectable = engine_from_config(
+		config.get_section(config.config_ini_section, {}),
+		prefix='sqlalchemy.',
+		poolclass=pool.NullPool,
+	)
+
+	with connectable.connect() as connection:
+		context.configure(connection=connection, target_metadata=target_metadata)
+
+		with context.begin_transaction():
+			context.run_migrations()
+
+
+if context.is_offline_mode():
+	run_migrations_offline()
+else:
+	run_migrations_online()

app/alembic/script.py.mako

@@ -0,0 +1,26 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+revision: str = ${repr(up_revision)}
+down_revision: Union[str, None] = ${repr(down_revision)}
+branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
+depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    ${downgrades if downgrades else "pass"}

pyproject.toml

@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools>=64", "pyinstaller", "pytest", "ruff"]
+requires = ["setuptools>=64", "pyinstaller", "pytest", "ruff", "alembic"]
 build-backend = "setuptools.build_meta"
 
 
@@ -31,6 +31,7 @@ dependencies = [
   "marshmallow_sqlalchemy>=1.1.0",
   "psycopg2-binary>=2.9.5",
   "SQLAlchemy>=2.0.29",
+  "alembic >= 1.14.1",
   "aiohttp-swagger3>=0.9.0",
 ]