From: CaselIT <cfederico87@gmail.com>
Date: Sun, 18 Oct 2020 17:42:33 +0000 (+0200)
Subject: Add ``__main__.py`` file to alembic package
X-Git-Tag: rel_1_5_0~20
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9a11c3595aa82e82e3ca2a819a8dda8caf7a0440;p=thirdparty%2Fsqlalchemy%2Falembic.git

Add ``__main__.py`` file to alembic package

Also reformat the changelog a bit

Fixes: #728
Change-Id: I9198bd9f9fc5d8723a8ddca9faad8835b514fcc0
---

diff --git a/alembic/__main__.py b/alembic/__main__.py
new file mode 100644
index 00000000..af1b8e87
--- /dev/null
+++ b/alembic/__main__.py
@@ -0,0 +1,4 @@
+from .config import main
+
+if __name__ == "__main__":
+    main(prog="alembic")
diff --git a/docs/build/unreleased/728.rst b/docs/build/unreleased/728.rst
new file mode 100644
index 00000000..b7917436
--- /dev/null
+++ b/docs/build/unreleased/728.rst
@@ -0,0 +1,5 @@
+.. change::
+    :tags: usecase, commands
+
+    Add ``__main__.py`` file to alembic package to support invocation
+    with ``python -m alembic``.
diff --git a/docs/build/unreleased/clean_up.rst b/docs/build/unreleased/clean_up.rst
index b91fb8de..ae35f95c 100644
--- a/docs/build/unreleased/clean_up.rst
+++ b/docs/build/unreleased/clean_up.rst
@@ -1,7 +1,53 @@
 .. change::
-    :tags: changed, commands
+    :tags: removed, commands
+
+    Removed deprecated ``--head_only`` option to the ``alembic current``
+    command
+
+.. change::
+    :tags: removed, operations
+
+    Removed legacy parameter names from operations, these have been emitting
+    warnings since version 0.8.  In the case that legacy version files have not
+    yet been updated, these can be modified directly in order to maintain
+    compatibility:
+
+    * :meth:`.Operations.drop_constraint` - "type" (use "type_") and "name"
+      (use "constraint_name")
+
+    * :meth:`.Operations.create_primary_key` - "cols" (use "columns") and
+      "name" (use "constraint_name")
+
+    * :meth:`.Operations.create_unique_constraint` - "name" (use
+      "constraint_name"), "source" (use "table_name") and "local_cols" (use
+      "columns")
+
+    * :meth:`.Operations.batch_create_unique_constraint` - "name" (use
+      "constraint_name")
+
+    * :meth:`.Operations.create_foreign_key` - "name" (use "constraint_name"),
+      "source" (use "source_table"), "referent" (use "referent_table")
+
+    * :meth:`.Operations.batch_create_foreign_key` - "name" (use
+      "constraint_name"), "referent" (use "referent_table")
+
+    * :meth:`.Operations.create_check_constraint` - "name" (use
+      "constraint_name"), "source" (use "table_name")
+
+    * :meth:`.Operations.batch_create_check_constraint` - "name" (use
+      "constraint_name")
+
+    * :meth:`.Operations.create_index` - "name" (use "index_name")
+
+    * :meth:`.Operations.drop_index` - "name" (use "index_name"), "tablename"
+      (use "table_name")
+
+    * :meth:`.Operations.batch_drop_index` - "name" (use "index_name"),
+
+    * :meth:`.Operations.create_table` - "name" (use "table_name")
+
+    * :meth:`.Operations.drop_table` - "name" (use "table_name")
+
+    * :meth:`.Operations.alter_column` - "name" (use "new_column_name")
 
-    Removed of old deprecated code:
 
-      * ``--head_only`` option to the ``alembic current`` command
-      * legacy argument names in operations, deprecated since version 0.8