make check command

diff --git a/alembic/command.py b/alembic/command.py
index bbff75d1f78d0d2ef452e3cb98cec4bbce295fd2..88259bd7907c35db2ae59845d192b4aaf8d305e1 100644 (file)
--- a/alembic/command.py
+++ b/alembic/command.py
@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import logging
 import os
 from typing import Callable
 from typing import List
@@ -16,6 +17,7 @@ if TYPE_CHECKING:
     from alembic.config import Config
     from alembic.script.base import Script
 
+log = logging.getLogger(__name__)
 
 def list_templates(config):
     """List available templates.
@@ -240,6 +242,58 @@ def revision(
         return scripts
 
 
+def check(
+    config: "Config",
+) -> Union[Optional["Script"], List[Optional["Script"]]]:
+    """Checks if the revision command with autogenerate has pending upgrade ops to run.
+
+    :param config: a :class:`.Config` object.
+
+    """
+
+    script_directory = ScriptDirectory.from_config(config)
+
+    command_args = dict(
+        message=None,
+        autogenerate=True,
+        sql=False,
+        head="head",
+        splice=False,
+        branch_label=None,
+        version_path=None,
+        rev_id=None,
+        depends_on=None,
+    )
+    revision_context = autogen.RevisionContext(
+        config,
+        script_directory,
+        command_args,
+    )
+
+    def retrieve_migrations(rev, context):
+        revision_context.run_autogenerate(rev, context)
+        return []
+
+    with EnvironmentContext(
+        config,
+        script_directory,
+        fn=retrieve_migrations,
+        as_sql=False,
+        template_args=revision_context.template_args,
+        revision_context=revision_context,
+    ):
+        script_directory.run_env()
+
+    # the revision_context now has MigrationScript structure(s) present.
+
+    migration_script = revision_context.generated_revisions[-1]
+    diffs = migration_script.upgrade_ops.as_diffs()
+    if diffs:
+        raise util.RevisionOpsNotEmptyError(f"Revision has upgrade ops to run: {diffs}.")
+    else:
+        log.info("Revision has no upgrade ops to run.")   
+
+
 def merge(
     config: "Config",
     revisions: str,

diff --git a/alembic/util/__init__.py b/alembic/util/__init__.py
index d5fa4d32550ddecd0d978bdbf1f1578dee00ef57..f77184bfb9054e06084afc4e83cdae7288c8f54a 100644 (file)
--- a/alembic/util/__init__.py
+++ b/alembic/util/__init__.py
@@ -1,5 +1,5 @@
 from .editor import open_in_editor
-from .exc import CommandError
+from .exc import CommandError, RevisionOpsNotEmptyError
 from .langhelpers import _with_legacy_names
 from .langhelpers import asbool
 from .langhelpers import dedupe_tuple

diff --git a/alembic/util/exc.py b/alembic/util/exc.py
index f7ad0211527a1506fd4a9747d1fd6cf07ef0f499..15d118b0257a43fec5feea49b5e03c258940c242 100644 (file)
--- a/alembic/util/exc.py
+++ b/alembic/util/exc.py
@@ -1,2 +1,5 @@
 class CommandError(Exception):
     pass
+
+class RevisionOpsNotEmptyError(Exception):
+    pass

diff --git a/tests/test_command.py b/tests/test_command.py
index 0c0ce378f3a12c99a2d4063d27a102cf503371c6..1a7c13c54e60042f0f26cb4ff766aae162757a32 100644 (file)
--- a/tests/test_command.py
+++ b/tests/test_command.py
@@ -8,8 +8,9 @@ import re
 from typing import cast
 
 from sqlalchemy import exc as sqla_exc
-from sqlalchemy import text
+from sqlalchemy import VARCHAR, text
 from sqlalchemy.engine import Engine
+from sqlalchemy.sql.schema import Column
 
 from alembic import __version__
 from alembic import command
@@ -539,6 +540,61 @@ finally:
         command.revision(self.cfg, sql=True)
 
 
+class CheckTest(TestBase):
+    def setUp(self):
+        self.env = staging_env()
+        self.cfg = _sqlite_testing_config()
+
+    def tearDown(self):
+        clear_staging_env()
+
+    def _env_fixture(self, version_table_pk=True):
+        env_file_fixture(
+            """
+
+from sqlalchemy import MetaData, engine_from_config
+target_metadata = MetaData()
+
+engine = engine_from_config(
+    config.get_section(config.config_ini_section),
+    prefix='sqlalchemy.')
+
+connection = engine.connect()
+
+context.configure(
+    connection=connection, target_metadata=target_metadata,
+    version_table_pk=%r
+)
+
+try:
+    with context.begin_transaction():
+        context.run_migrations()
+finally:
+    connection.close()
+    engine.dispose()
+
+"""
+            % (version_table_pk,)
+        )
+
+    def test_check_no_changes(self):
+        self._env_fixture()
+        command.check(self.cfg) # no problem
+
+    def test_check_changes_detected(self):
+        self._env_fixture()
+        with mock.patch(
+            "alembic.operations.ops.UpgradeOps.as_diffs",
+            return_value=[('remove_column', None, 'foo', Column('old_data', VARCHAR()))]
+        ):
+            assert_raises_message(
+                util.RevisionOpsNotEmptyError,
+                "Revision has upgrade ops to run:",
+                command.check,
+                self.cfg,
+            )
+
+
 class _StampTest:
     def _assert_sql(self, emitted_sql, origin, destinations):
         ins_expr = (