alembic 1.13.3__tar.gz → 1.14.1__tar.gz

{alembic-1.13.3 → alembic-1.14.1}/LICENSE

@@ -1,4 +1,4 @@
-Copyright 2009-2024 Michael Bayer.
+Copyright 2009-2025 Michael Bayer.
 
 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

{alembic-1.13.3/alembic.egg-info → alembic-1.14.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: alembic
-Version: 1.13.3
+Version: 1.14.1
 Summary: A database migration tool for SQLAlchemy.
 Home-page: https://alembic.sqlalchemy.org
 Author: Mike Bayer
@@ -35,6 +35,7 @@ Requires-Dist: importlib-resources; python_version < "3.9"
 Requires-Dist: typing-extensions>=4
 Provides-Extra: tz
 Requires-Dist: backports.zoneinfo; python_version < "3.9" and extra == "tz"
+Requires-Dist: tzdata; extra == "tz"
 
 Alembic is a database migrations tool written by the author
 of `SQLAlchemy <http://www.sqlalchemy.org>`_.  A migrations tool

{alembic-1.13.3 → alembic-1.14.1}/alembic/__init__.py

@@ -1,4 +1,4 @@
 from . import context
 from . import op
 
-__version__ = "1.13.3"
+__version__ = "1.14.1"

{alembic-1.13.3 → alembic-1.14.1}/alembic/autogenerate/api.py

@@ -277,7 +277,7 @@ class AutogenContext:
     """Maintains configuration and state that's specific to an
     autogenerate operation."""
 
-    metadata: Optional[MetaData] = None
+    metadata: Union[MetaData, Sequence[MetaData], None] = None
     """The :class:`~sqlalchemy.schema.MetaData` object
     representing the destination.
 
@@ -332,7 +332,7 @@ class AutogenContext:
     def __init__(
         self,
         migration_context: MigrationContext,
-        metadata: Optional[MetaData] = None,
+        metadata: Union[MetaData, Sequence[MetaData], None] = None,
         opts: Optional[Dict[str, Any]] = None,
         autogenerate: bool = True,
     ) -> None:

{alembic-1.13.3 → alembic-1.14.1}/alembic/autogenerate/render.py

@@ -831,7 +831,10 @@ def _repr_type(
 
     mod = type(type_).__module__
     imports = autogen_context.imports
-    if mod.startswith("sqlalchemy.dialects"):
+
+    if not _skip_variants and sqla_compat._type_has_variants(type_):
+        return _render_Variant_type(type_, autogen_context)
+    elif mod.startswith("sqlalchemy.dialects"):
         match = re.match(r"sqlalchemy\.dialects\.(\w+)", mod)
         assert match is not None
         dname = match.group(1)
@@ -843,8 +846,6 @@ def _repr_type(
             return "%s.%r" % (dname, type_)
     elif impl_rt:
         return impl_rt
-    elif not _skip_variants and sqla_compat._type_has_variants(type_):
-        return _render_Variant_type(type_, autogen_context)
     elif mod.startswith("sqlalchemy."):
         if "_render_%s_type" % type_.__visit_name__ in globals():
             fn = globals()["_render_%s_type" % type_.__visit_name__]

{alembic-1.13.3 → alembic-1.14.1}/alembic/ddl/base.py

@@ -175,7 +175,7 @@ class ColumnComment(AlterColumn):
         self.comment = comment
 
 
-@compiles(RenameTable)  # type: ignore[misc]
+@compiles(RenameTable)
 def visit_rename_table(
     element: RenameTable, compiler: DDLCompiler, **kw
 ) -> str:
@@ -185,7 +185,7 @@ def visit_rename_table(
     )
 
 
-@compiles(AddColumn)  # type: ignore[misc]
+@compiles(AddColumn)
 def visit_add_column(element: AddColumn, compiler: DDLCompiler, **kw) -> str:
     return "%s %s" % (
         alter_table(compiler, element.table_name, element.schema),
@@ -193,7 +193,7 @@ def visit_add_column(element: AddColumn, compiler: DDLCompiler, **kw) -> str:
     )
 
 
-@compiles(DropColumn)  # type: ignore[misc]
+@compiles(DropColumn)
 def visit_drop_column(element: DropColumn, compiler: DDLCompiler, **kw) -> str:
     return "%s %s" % (
         alter_table(compiler, element.table_name, element.schema),
@@ -201,7 +201,7 @@ def visit_drop_column(element: DropColumn, compiler: DDLCompiler, **kw) -> str:
     )
 
 
-@compiles(ColumnNullable)  # type: ignore[misc]
+@compiles(ColumnNullable)
 def visit_column_nullable(
     element: ColumnNullable, compiler: DDLCompiler, **kw
 ) -> str:
@@ -212,7 +212,7 @@ def visit_column_nullable(
     )
 
 
-@compiles(ColumnType)  # type: ignore[misc]
+@compiles(ColumnType)
 def visit_column_type(element: ColumnType, compiler: DDLCompiler, **kw) -> str:
     return "%s %s %s" % (
         alter_table(compiler, element.table_name, element.schema),
@@ -221,7 +221,7 @@ def visit_column_type(element: ColumnType, compiler: DDLCompiler, **kw) -> str:
     )
 
 
-@compiles(ColumnName)  # type: ignore[misc]
+@compiles(ColumnName)
 def visit_column_name(element: ColumnName, compiler: DDLCompiler, **kw) -> str:
     return "%s RENAME %s TO %s" % (
         alter_table(compiler, element.table_name, element.schema),
@@ -230,7 +230,7 @@ def visit_column_name(element: ColumnName, compiler: DDLCompiler, **kw) -> str:
     )
 
 
-@compiles(ColumnDefault)  # type: ignore[misc]
+@compiles(ColumnDefault)
 def visit_column_default(
     element: ColumnDefault, compiler: DDLCompiler, **kw
 ) -> str:
@@ -245,7 +245,7 @@ def visit_column_default(
     )
 
 
-@compiles(ComputedColumnDefault)  # type: ignore[misc]
+@compiles(ComputedColumnDefault)
 def visit_computed_column(
     element: ComputedColumnDefault, compiler: DDLCompiler, **kw
 ):
@@ -255,7 +255,7 @@ def visit_computed_column(
     )
 
 
-@compiles(IdentityColumnDefault)  # type: ignore[misc]
+@compiles(IdentityColumnDefault)
 def visit_identity_column(
     element: IdentityColumnDefault, compiler: DDLCompiler, **kw
 ):

{alembic-1.13.3 → alembic-1.14.1}/alembic/ddl/impl.py

@@ -21,7 +21,12 @@ from typing import TYPE_CHECKING
 from typing import Union
 
 from sqlalchemy import cast
+from sqlalchemy import Column
+from sqlalchemy import MetaData
+from sqlalchemy import PrimaryKeyConstraint
 from sqlalchemy import schema
+from sqlalchemy import String
+from sqlalchemy import Table
 from sqlalchemy import text
 
 from . import _autogen
@@ -43,11 +48,9 @@ if TYPE_CHECKING:
     from sqlalchemy.sql import Executable
     from sqlalchemy.sql.elements import ColumnElement
     from sqlalchemy.sql.elements import quoted_name
-    from sqlalchemy.sql.schema import Column
     from sqlalchemy.sql.schema import Constraint
     from sqlalchemy.sql.schema import ForeignKeyConstraint
     from sqlalchemy.sql.schema import Index
-    from sqlalchemy.sql.schema import Table
     from sqlalchemy.sql.schema import UniqueConstraint
     from sqlalchemy.sql.selectable import TableClause
     from sqlalchemy.sql.type_api import TypeEngine
@@ -136,6 +139,40 @@ class DefaultImpl(metaclass=ImplMeta):
         self.output_buffer.write(text + "\n\n")
         self.output_buffer.flush()
 
+    def version_table_impl(
+        self,
+        *,
+        version_table: str,
+        version_table_schema: Optional[str],
+        version_table_pk: bool,
+        **kw: Any,
+    ) -> Table:
+        """Generate a :class:`.Table` object which will be used as the
+        structure for the Alembic version table.
+
+        Third party dialects may override this hook to provide an alternate
+        structure for this :class:`.Table`; requirements are only that it
+        be named based on the ``version_table`` parameter and contains
+        at least a single string-holding column named ``version_num``.
+
+        .. versionadded:: 1.14
+
+        """
+        vt = Table(
+            version_table,
+            MetaData(),
+            Column("version_num", String(32), nullable=False),
+            schema=version_table_schema,
+        )
+        if version_table_pk:
+            vt.append_constraint(
+                PrimaryKeyConstraint(
+                    "version_num", name=f"{version_table}_pkc"
+                )
+            )
+
+        return vt
+
     def requires_recreate_in_batch(
         self, batch_op: BatchOperationsImpl
     ) -> bool:

{alembic-1.13.3 → alembic-1.14.1}/alembic/ddl/postgresql.py

@@ -16,6 +16,7 @@ from typing import TYPE_CHECKING
 from typing import Union
 
 from sqlalchemy import Column
+from sqlalchemy import Float
 from sqlalchemy import literal_column
 from sqlalchemy import Numeric
 from sqlalchemy import text
@@ -132,7 +133,7 @@ class PostgresqlImpl(DefaultImpl):
         metadata_default = metadata_column.server_default.arg
 
         if isinstance(metadata_default, str):
-            if not isinstance(inspector_column.type, Numeric):
+            if not isinstance(inspector_column.type, (Numeric, Float)):
                 metadata_default = re.sub(r"^'|'$", "", metadata_default)
                 metadata_default = f"'{metadata_default}'"
 

{alembic-1.13.3 → alembic-1.14.1}/alembic/ddl/sqlite.py

@@ -16,6 +16,8 @@ from sqlalchemy import schema
 from sqlalchemy import sql
 
 from .base import alter_table
+from .base import ColumnName
+from .base import format_column_name
 from .base import format_table_name
 from .base import RenameTable
 from .impl import DefaultImpl
@@ -207,6 +209,15 @@ def visit_rename_table(
     )
 
 
+@compiles(ColumnName, "sqlite")
+def visit_column_name(element: ColumnName, compiler: DDLCompiler, **kw) -> str:
+    return "%s RENAME COLUMN %s TO %s" % (
+        alter_table(compiler, element.table_name, element.schema),
+        format_column_name(compiler, element.column_name),
+        format_column_name(compiler, element.newname),
+    )
+
+
 # @compiles(AddColumn, 'sqlite')
 # def visit_add_column(element, compiler, **kw):
 #    return "%s %s" % (

{alembic-1.13.3 → alembic-1.14.1}/alembic/runtime/migration.py

@@ -24,10 +24,6 @@ from typing import Union
 
 from sqlalchemy import Column
 from sqlalchemy import literal_column
-from sqlalchemy import MetaData
-from sqlalchemy import PrimaryKeyConstraint
-from sqlalchemy import String
-from sqlalchemy import Table
 from sqlalchemy.engine import Engine
 from sqlalchemy.engine import url as sqla_url
 from sqlalchemy.engine.strategies import MockEngineStrategy
@@ -36,6 +32,7 @@ from .. import ddl
 from .. import util
 from ..util import sqla_compat
 from ..util.compat import EncodedIO
+from ..util.sqla_compat import _select
 
 if TYPE_CHECKING:
     from sqlalchemy.engine import Dialect
@@ -190,18 +187,6 @@ class MigrationContext:
         self.version_table_schema = version_table_schema = opts.get(
             "version_table_schema", None
         )
-        self._version = Table(
-            version_table,
-            MetaData(),
-            Column("version_num", String(32), nullable=False),
-            schema=version_table_schema,
-        )
-        if opts.get("version_table_pk", True):
-            self._version.append_constraint(
-                PrimaryKeyConstraint(
-                    "version_num", name="%s_pkc" % version_table
-                )
-            )
 
         self._start_from_rev: Optional[str] = opts.get("starting_rev")
         self.impl = ddl.DefaultImpl.get_by_dialect(dialect)(
@@ -212,6 +197,13 @@ class MigrationContext:
             self.output_buffer,
             opts,
         )
+
+        self._version = self.impl.version_table_impl(
+            version_table=version_table,
+            version_table_schema=version_table_schema,
+            version_table_pk=opts.get("version_table_pk", True),
+        )
+
         log.info("Context impl %s.", self.impl.__class__.__name__)
         if self.as_sql:
             log.info("Generating static SQL")
@@ -540,7 +532,10 @@ class MigrationContext:
                 return ()
         assert self.connection is not None
         return tuple(
-            row[0] for row in self.connection.execute(self._version.select())
+            row[0]
+            for row in self.connection.execute(
+                _select(self._version.c.version_num)
+            )
         )
 
     def _ensure_version_table(self, purge: bool = False) -> None:

{alembic-1.13.3 → alembic-1.14.1}/alembic/templates/async/alembic.ini.mako

@@ -15,7 +15,7 @@ prepend_sys_path = .
 
 # timezone to use when rendering the date within the migration file
 # as well as the filename.
-# If specified, requires the python>=3.9 or backports.zoneinfo library.
+# If specified, requires the python>=3.9 or backports.zoneinfo library and tzdata library.
 # Any required deps can installed by adding `alembic[tz]` to the pip requirements
 # string value is passed to ZoneInfo()
 # leave blank for localtime
@@ -48,7 +48,9 @@ prepend_sys_path = .
 # version_path_separator = ;
 # version_path_separator = space
 # version_path_separator = newline
-version_path_separator = os  # Use os.pathsep. Default configuration used for new projects.
+#
+# Use os.pathsep. Default configuration used for new projects.
+version_path_separator = os
 
 # set to 'true' to search source files recursively
 # in each "version_locations" directory
@@ -90,12 +92,12 @@ keys = console
 keys = generic
 
 [logger_root]
-level = WARN
+level = WARNING
 handlers = console
 qualname =
 
 [logger_sqlalchemy]
-level = WARN
+level = WARNING
 handlers =
 qualname = sqlalchemy.engine
 

{alembic-1.13.3 → alembic-1.14.1}/alembic/templates/generic/alembic.ini.mako

@@ -17,7 +17,7 @@ prepend_sys_path = .
 
 # timezone to use when rendering the date within the migration file
 # as well as the filename.
-# If specified, requires the python>=3.9 or backports.zoneinfo library.
+# If specified, requires the python>=3.9 or backports.zoneinfo library and tzdata library.
 # Any required deps can installed by adding `alembic[tz]` to the pip requirements
 # string value is passed to ZoneInfo()
 # leave blank for localtime
@@ -50,7 +50,9 @@ prepend_sys_path = .
 # version_path_separator = ;
 # version_path_separator = space
 # version_path_separator = newline
-version_path_separator = os  # Use os.pathsep. Default configuration used for new projects.
+#
+# Use os.pathsep. Default configuration used for new projects.
+version_path_separator = os
 
 # set to 'true' to search source files recursively
 # in each "version_locations" directory
@@ -92,12 +94,12 @@ keys = console
 keys = generic
 
 [logger_root]
-level = WARN
+level = WARNING
 handlers = console
 qualname =
 
 [logger_sqlalchemy]
-level = WARN
+level = WARNING
 handlers =
 qualname = sqlalchemy.engine
 

{alembic-1.13.3 → alembic-1.14.1}/alembic/templates/multidb/alembic.ini.mako

@@ -17,7 +17,7 @@ prepend_sys_path = .
 
 # timezone to use when rendering the date within the migration file
 # as well as the filename.
-# If specified, requires the python>=3.9 or backports.zoneinfo library.
+# If specified, requires the python>=3.9 or backports.zoneinfo library and tzdata library.
 # Any required deps can installed by adding `alembic[tz]` to the pip requirements
 # string value is passed to ZoneInfo()
 # leave blank for localtime
@@ -50,7 +50,9 @@ prepend_sys_path = .
 # version_path_separator = ;
 # version_path_separator = space
 # version_path_separator = newline
-version_path_separator = os  # Use os.pathsep. Default configuration used for new projects.
+#
+# Use os.pathsep. Default configuration used for new projects.
+version_path_separator = os
 
 # set to 'true' to search source files recursively
 # in each "version_locations" directory
@@ -97,12 +99,12 @@ keys = console
 keys = generic
 
 [logger_root]
-level = WARN
+level = WARNING
 handlers = console
 qualname =
 
 [logger_sqlalchemy]
-level = WARN
+level = WARNING
 handlers =
 qualname = sqlalchemy.engine
 

{alembic-1.13.3 → alembic-1.14.1}/alembic/testing/env.py

@@ -118,7 +118,7 @@ keys = root,sqlalchemy
 keys = console
 
 [logger_root]
-level = WARN
+level = WARNING
 handlers = console
 qualname =
 
@@ -171,7 +171,7 @@ keys = root
 keys = console
 
 [logger_root]
-level = WARN
+level = WARNING
 handlers = console
 qualname =
 
@@ -216,7 +216,7 @@ keys = root
 keys = console
 
 [logger_root]
-level = WARN
+level = WARNING
 handlers = console
 qualname =
 
@@ -497,7 +497,7 @@ keys = root
 keys = console
 
 [logger_root]
-level = WARN
+level = WARNING
 handlers = console
 qualname =
 

{alembic-1.13.3 → alembic-1.14.1}/alembic/util/compat.py

@@ -24,6 +24,7 @@ if True:
 
 is_posix = os.name == "posix"
 
+py313 = sys.version_info >= (3, 13)
 py311 = sys.version_info >= (3, 11)
 py310 = sys.version_info >= (3, 10)
 py39 = sys.version_info >= (3, 9)

{alembic-1.13.3 → alembic-1.14.1/alembic.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: alembic
-Version: 1.13.3
+Version: 1.14.1
 Summary: A database migration tool for SQLAlchemy.
 Home-page: https://alembic.sqlalchemy.org
 Author: Mike Bayer
@@ -35,6 +35,7 @@ Requires-Dist: importlib-resources; python_version < "3.9"
 Requires-Dist: typing-extensions>=4
 Provides-Extra: tz
 Requires-Dist: backports.zoneinfo; python_version < "3.9" and extra == "tz"
+Requires-Dist: tzdata; extra == "tz"
 
 Alembic is a database migrations tool written by the author
 of `SQLAlchemy <http://www.sqlalchemy.org>`_.  A migrations tool

{alembic-1.13.3 → alembic-1.14.1}/alembic.egg-info/SOURCES.txt

@@ -150,16 +150,13 @@ docs/_static/webpack-macros.html
 docs/_static/images/logo_colab.png
 docs/_static/scripts/bootstrap.js
 docs/_static/scripts/bootstrap.js.LICENSE.txt
+docs/_static/scripts/fontawesome.js
+docs/_static/scripts/fontawesome.js.LICENSE.txt
 docs/_static/scripts/pydata-sphinx-theme.js
 docs/_static/scripts/sphinx-book-theme.js
-docs/_static/styles/bootstrap.css
 docs/_static/styles/pydata-sphinx-theme.css
 docs/_static/styles/sphinx-book-theme.css
 docs/_static/styles/theme.css
-docs/_static/vendor/fontawesome/6.5.2/LICENSE.txt
-docs/_static/vendor/fontawesome/6.5.2/css/all.min.css
-docs/_static/vendor/fontawesome/6.5.2/js/all.min.js
-docs/_static/vendor/fontawesome/6.5.2/js/all.min.js.LICENSE.txt
 docs/api/autogenerate.html
 docs/api/commands.html
 docs/api/config.html

{alembic-1.13.3 → alembic-1.14.1}/alembic.egg-info/requires.txt

@@ -7,6 +7,7 @@ importlib-metadata
 importlib-resources
 
 [tz]
+tzdata
 
 [tz:python_version < "3.9"]
 backports.zoneinfo

{alembic-1.13.3 → alembic-1.14.1}/docs/_sources/autogenerate.rst

@@ -1,10 +1,12 @@
 Auto Generating Migrations
 ===========================
 
-Alembic can view the status of the database and compare against the table metadata
-in the application, generating the "obvious" migrations based on a comparison.  This
-is achieved using the ``--autogenerate`` option to the ``alembic revision`` command,
-which places so-called *candidate* migrations into our new migrations file.  We
+Alembic can view the status of the database (pointed to by ``sqlalchemy.url`` in
+your ``alembic.ini`` file using the *current* schema) and compare against the
+table metadata in the application (your ORM which defines the *proposed* schema),
+generating the "obvious" migrations based on a comparison.  This is achieved
+using the ``--autogenerate`` option to the ``alembic revision`` command, which
+places so-called *candidate* migrations into our new migrations file.  We
 review and modify these by hand as needed, then proceed normally.
 
 To use autogenerate, we first need to modify our ``env.py`` so that it gets access
@@ -728,8 +730,8 @@ hook runner:
 The following configuration option is specific to the ``"exec"`` hook runner:
 
 * ``executable`` - the name of the executable to invoke.  Can be either a
-bare executable name which will be searched in ``$PATH``, or a full pathname
-to avoid potential issues with path interception.
+  bare executable name which will be searched in ``$PATH``, or a full pathname
+  to avoid potential issues with path interception.
 
 The following options are supported by both ``"console_scripts"`` and ``"exec"``:
 

{alembic-1.13.3 → alembic-1.14.1}/docs/_sources/changelog.rst

@@ -3,6 +3,51 @@
 Changelog
 ==========
 
+.. changelog::
+    :version: 1.14.1
+    :released: January 19, 2025
+
+    .. change::
+        :tags: bug, environment
+        :tickets: 1556
+
+        Added `tzdata` to `tz` extras, which is required on some platforms such as
+        Windows.  Pull request courtesy Danipulok.
+
+    .. change::
+        :tags: usecase, sqlite
+        :tickets: 1576
+
+        Modified SQLite's dialect to render "ALTER TABLE <t> RENAME COLUMN" when
+        :meth:`.Operations.alter_column` is used with a straight rename, supporting
+        SQLite's recently added column rename feature.
+
+    .. change::
+        :tags: bug, autogenerate
+        :tickets: 1585
+
+        Fixed bug where autogen render of a "variant" type would fail to catch the
+        variants if the leading type were a dialect-specific type, rather than a
+        generic type.
+
+
+.. changelog::
+    :version: 1.14.0
+    :released: November 4, 2024
+
+    .. change::
+        :tags: usecase, runtime
+        :tickets: 1560
+
+        Added a new hook to the :class:`.DefaultImpl`
+        :meth:`.DefaultImpl.version_table_impl`.  This allows third party dialects
+        to define the exact structure of the alembic_version table, to include use
+        cases where the table requires special directives and/or additional columns
+        so that it may function correctly on a particular backend.  This is not
+        intended as a user-expansion hook, only a dialect implementation hook to
+        produce a working alembic_version table. Pull request courtesy Maciek
+        Bryński.
+
 .. changelog::
     :version: 1.13.3
     :released: September 23, 2024

{alembic-1.13.3/docs/build → alembic-1.14.1/docs/_sources}/naming.rst

@@ -164,6 +164,8 @@ parameter in ``env.py``, which is normally configured when autogenerate is
 used::
 
     # in your application's model:
+    from sqlalchemy import MetaData
+    from sqlalchemy.orm import DeclarativeBase
 
     class Base(DeclarativeBase):
         metadata = MetaData(naming_convention={

{alembic-1.13.3 → alembic-1.14.1}/docs/_sources/tutorial.rst

@@ -141,7 +141,7 @@ The file generated with the "generic" configuration looks like::
 
     # timezone to use when rendering the date within the migration file
     # as well as the filename.
-    # If specified, requires the python>=3.9 or backports.zoneinfo library.
+    # If specified, requires the python>=3.9 or backports.zoneinfo library and tzdata library.
     # Any required deps can installed by adding `alembic[tz]` to the pip requirements
     # string value is passed to ZoneInfo()
     # leave blank for localtime
@@ -204,7 +204,7 @@ The file generated with the "generic" configuration looks like::
     # hooks = ruff
     # ruff.type = exec
     # ruff.executable = %(here)s/.venv/bin/ruff
-    # ruff.options = --fix REVISION_SCRIPT_FILENAME
+    # ruff.options = check --fix REVISION_SCRIPT_FILENAME
 
     # Logging configuration
     [loggers]
@@ -217,12 +217,12 @@ The file generated with the "generic" configuration looks like::
     keys = generic
 
     [logger_root]
-    level = WARN
+    level = WARNING
     handlers = console
     qualname =
 
     [logger_sqlalchemy]
-    level = WARN
+    level = WARNING
     handlers =
     qualname = sqlalchemy.engine
 
@@ -299,9 +299,9 @@ This file contains the following features:
 * ``timezone`` - an optional timezone name (e.g. ``UTC``, ``EST5EDT``, etc.)
   that will be applied to the timestamp which renders inside the migration
   file's comment as well as within the filename. This option requires Python>=3.9
-  or installing the ``backports.zoneinfo`` library. If ``timezone`` is specified,
-  the create date object is no longer derived from ``datetime.datetime.now()``
-  and is instead generated as::
+  or installing the ``backports.zoneinfo`` library and the ``tzdata`` library. 
+  If ``timezone`` is specified, the create date object is no longer derived
+  from ``datetime.datetime.now()`` and is instead generated as::
 
       datetime.datetime.utcnow().replace(
         tzinfo=datetime.timezone.utc