From: Mike Bayer <mike_mp@zzzcomputing.com>
Date: Sat, 22 Aug 2015 19:30:58 +0000 (-0400)
Subject: - add a cookbook recipe for don't generate if no changes,
X-Git-Tag: rel_0_8_1~1
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=efa75231f94325e8a3bd4ade40933b26f3f1fcd6;p=thirdparty%2Fsqlalchemy%2Falembic.git

- add a cookbook recipe for don't generate if no changes,
references #80
---

diff --git a/docs/build/cookbook.rst b/docs/build/cookbook.rst
index 42762e02..a83e0f08 100644
--- a/docs/build/cookbook.rst
+++ b/docs/build/cookbook.rst
@@ -774,3 +774,38 @@ recreated again within the downgrade for this migration::
     INFO  [sqlalchemy.engine.base.Engine] UPDATE alembic_version SET version_num='28af9800143f' WHERE alembic_version.version_num = '191a2d20b025'
     INFO  [sqlalchemy.engine.base.Engine] {}
     INFO  [sqlalchemy.engine.base.Engine] COMMIT
+
+Don't Generate Empty Migrations with Autogenerate
+=================================================
+
+A common request is to have the ``alembic revision --autogenerate`` command not
+actually generate a revision file if no changes to the schema is detected.  Using
+the :paramref:`.EnvironmentContext.configure.process_revision_directives`
+hook, this is straightforward; place a ``process_revision_directives``
+hook in :meth:`.MigrationContext.configure` which removes the
+single :class:`.MigrationScript` directive if it is empty of
+any operations::
+
+
+    def run_migrations_online():
+
+        # ...
+
+        def process_revision_directives(context, revision, directives):
+            if config.cmd_opts.autogenerate:
+                script = directives[0]
+                if script.upgrade_ops.is_empty():
+                    directives[:] = []
+
+
+        # connectable = ...
+
+        with connectable.connect() as connection:
+            context.configure(
+                connection=connection,
+                target_metadata=target_metadata,
+                process_revision_directives=process_revision_directives
+            )
+
+            with context.begin_transaction():
+                context.run_migrations()
\ No newline at end of file