alembic 1.16.5__tar.gz → 1.17.0__tar.gz

{alembic-1.16.5 → alembic-1.17.0}/MANIFEST.in

@@ -4,7 +4,7 @@ recursive-include alembic/templates *.mako README *.py *.pyi
 recursive-include alembic *.py *.pyi py.typed
 recursive-include tools *.py
 
-include README* LICENSE CHANGES* tox.ini
+include README* LICENSE CHANGES* tox.ini noxfile.py
 
 prune docs/build/output
 

{alembic-1.16.5/alembic.egg-info → alembic-1.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alembic
-Version: 1.16.5
+Version: 1.17.0
 Summary: A database migration tool for SQLAlchemy.
 Author-email: Mike Bayer <mike_mp@zzzcomputing.com>
 License-Expression: MIT
@@ -15,7 +15,6 @@ Classifier: Environment :: Console
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -23,7 +22,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Topic :: Database :: Front-Ends
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: SQLAlchemy>=1.4.0

{alembic-1.16.5 → alembic-1.17.0}/alembic/__init__.py

@@ -1,4 +1,4 @@
 from . import context
 from . import op
 
-__version__ = "1.16.5"
+__version__ = "1.17.0"

{alembic-1.16.5 → alembic-1.17.0}/alembic/ddl/mssql.py

@@ -96,7 +96,9 @@ class MSSQLImpl(DefaultImpl):
         type_: Optional[TypeEngine] = None,
         schema: Optional[str] = None,
         existing_type: Optional[TypeEngine] = None,
-        existing_server_default: Optional[_ServerDefault] = None,
+        existing_server_default: Union[
+            _ServerDefault, Literal[False], None
+        ] = None,
         existing_nullable: Optional[bool] = None,
         **kw: Any,
     ) -> None:

{alembic-1.16.5 → alembic-1.17.0}/alembic/script/base.py

@@ -38,12 +38,8 @@ if TYPE_CHECKING:
     from ..runtime.migration import StampStep
 
 try:
-    if compat.py39:
-        from zoneinfo import ZoneInfo
-        from zoneinfo import ZoneInfoNotFoundError
-    else:
-        from backports.zoneinfo import ZoneInfo  # type: ignore[import-not-found,no-redef] # noqa: E501
-        from backports.zoneinfo import ZoneInfoNotFoundError  # type: ignore[no-redef] # noqa: E501
+    from zoneinfo import ZoneInfo
+    from zoneinfo import ZoneInfoNotFoundError
 except ImportError:
     ZoneInfo = None  # type: ignore[assignment, misc]
 

{alembic-1.16.5 → alembic-1.17.0}/alembic/script/write_hooks.py

@@ -10,11 +10,7 @@ import subprocess
 import sys
 from typing import Any
 from typing import Callable
-from typing import Dict
-from typing import List
-from typing import Optional
 from typing import TYPE_CHECKING
-from typing import Union
 
 from .. import util
 from ..util import compat
@@ -49,7 +45,7 @@ def register(name: str) -> Callable:
 
 def _invoke(
     name: str,
-    revision_path: Union[str, os.PathLike[str]],
+    revision_path: str | os.PathLike[str],
     options: PostWriteHookConfig,
 ) -> Any:
     """Invokes the formatter registered for the given name.
@@ -72,7 +68,7 @@ def _invoke(
 
 
 def _run_hooks(
-    path: Union[str, os.PathLike[str]], hooks: list[PostWriteHookConfig]
+    path: str | os.PathLike[str], hooks: list[PostWriteHookConfig]
 ) -> None:
     """Invoke hooks for a generated revision."""
 
@@ -92,7 +88,7 @@ def _run_hooks(
                 _invoke(type_, path, hook)
 
 
-def _parse_cmdline_options(cmdline_options_str: str, path: str) -> List[str]:
+def _parse_cmdline_options(cmdline_options_str: str, path: str) -> list[str]:
     """Parse options from a string into a list.
 
     Also substitutes the revision script token with the actual filename of
@@ -124,13 +120,13 @@ def _get_required_option(options: dict, name: str) -> str:
 
 
 def _run_hook(
-    path: str, options: dict, ignore_output: bool, command: List[str]
+    path: str, options: dict, ignore_output: bool, command: list[str]
 ) -> None:
-    cwd: Optional[str] = options.get("cwd", None)
+    cwd: str | None = options.get("cwd", None)
     cmdline_options_str = options.get("options", "")
     cmdline_options_list = _parse_cmdline_options(cmdline_options_str, path)
 
-    kw: Dict[str, Any] = {}
+    kw: dict[str, Any] = {}
     if ignore_output:
         kw["stdout"] = kw["stderr"] = subprocess.DEVNULL
 

{alembic-1.16.5/alembic/templates/generic → alembic-1.17.0/alembic/templates/async}/alembic.ini.mako

@@ -18,11 +18,10 @@ script_location = ${script_location}
 # is defined by "path_separator" below.
 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 and tzdata library.
-# Any required deps can installed by adding `alembic[tz]` to the pip requirements
+# If specified, requires the tzdata library which can be installed by adding
+# `alembic[tz]` to the pip requirements.
 # string value is passed to ZoneInfo()
 # leave blank for localtime
 # timezone =
@@ -72,6 +71,7 @@ prepend_sys_path = .
 # Use os.pathsep. Default configuration used for new projects.
 path_separator = os
 
+
 # set to 'true' to search source files recursively
 # in each "version_locations" directory
 # new in Alembic version 1.10

{alembic-1.16.5/alembic/templates/async → alembic-1.17.0/alembic/templates/generic}/alembic.ini.mako

@@ -18,10 +18,11 @@ script_location = ${script_location}
 # is defined by "path_separator" below.
 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 and tzdata library.
-# Any required deps can installed by adding `alembic[tz]` to the pip requirements
+# If specified, requires the tzdata library which can be installed by adding
+# `alembic[tz]` to the pip requirements.
 # string value is passed to ZoneInfo()
 # leave blank for localtime
 # timezone =
@@ -71,7 +72,6 @@ prepend_sys_path = .
 # Use os.pathsep. Default configuration used for new projects.
 path_separator = os
 
-
 # set to 'true' to search source files recursively
 # in each "version_locations" directory
 # new in Alembic version 1.10

{alembic-1.16.5 → alembic-1.17.0}/alembic/templates/multidb/alembic.ini.mako

@@ -20,8 +20,8 @@ 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 and tzdata library.
-# Any required deps can installed by adding `alembic[tz]` to the pip requirements
+# If specified, requires the tzdata library which can be installed by adding
+# `alembic[tz]` to the pip requirements.
 # string value is passed to ZoneInfo()
 # leave blank for localtime
 # timezone =

{alembic-1.16.5/alembic/templates/pyproject_async → alembic-1.17.0/alembic/templates/pyproject}/pyproject.toml.mako

@@ -19,8 +19,8 @@ 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 and tzdata library.
-# Any required deps can installed by adding `alembic[tz]` to the pip requirements
+# If specified, requires the tzdata library which can be installed by adding
+# `alembic[tz]` to the pip requirements.
 # string value is passed to ZoneInfo()
 # leave blank for localtime
 # timezone =

{alembic-1.16.5/alembic/templates/pyproject → alembic-1.17.0/alembic/templates/pyproject_async}/pyproject.toml.mako

@@ -19,8 +19,8 @@ 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 and tzdata library.
-# Any required deps can installed by adding `alembic[tz]` to the pip requirements
+# If specified, requires the tzdata library which can be installed by adding
+# `alembic[tz]` to the pip requirements.
 # string value is passed to ZoneInfo()
 # leave blank for localtime
 # timezone =

{alembic-1.16.5 → alembic-1.17.0}/alembic/testing/fixtures.py

@@ -8,6 +8,9 @@ import re
 import shutil
 from typing import Any
 from typing import Dict
+from typing import Generator
+from typing import Literal
+from typing import overload
 
 from sqlalchemy import Column
 from sqlalchemy import create_mock_engine
@@ -52,7 +55,7 @@ class TestBase(SQLAlchemyTestBase):
                 shutil.rmtree(file_path)
 
     @contextmanager
-    def pushd(self, dirname):
+    def pushd(self, dirname) -> Generator[None, None, None]:
         current_dir = os.getcwd()
         try:
             os.chdir(dirname)
@@ -108,8 +111,24 @@ def capture_db(dialect="postgresql://"):
 _engs: Dict[Any, Any] = {}
 
 
+@overload
 @contextmanager
-def capture_context_buffer(**kw):
+def capture_context_buffer(
+    bytes_io: Literal[True], **kw: Any
+) -> Generator[io.BytesIO, None, None]: ...
+
+
+@overload
+@contextmanager
+def capture_context_buffer(
+    **kw: Any,
+) -> Generator[io.StringIO, None, None]: ...
+
+
+@contextmanager
+def capture_context_buffer(
+    **kw: Any,
+) -> Generator[io.StringIO | io.BytesIO, None, None]:
     if kw.pop("bytes_io", False):
         buf = io.BytesIO()
     else:
@@ -127,7 +146,9 @@ def capture_context_buffer(**kw):
 
 
 @contextmanager
-def capture_engine_context_buffer(**kw):
+def capture_engine_context_buffer(
+    **kw: Any,
+) -> Generator[io.StringIO, None, None]:
     from .env import _sqlite_file_db
     from sqlalchemy import event
 

{alembic-1.16.5 → alembic-1.17.0}/alembic/testing/requirements.py

@@ -113,6 +113,15 @@ class SuiteRequirements(Requirements):
     def computed_columns(self):
         return exclusions.closed()
 
+    @property
+    def computed_columns_warn_no_persisted(self):
+        def go(config):
+            return hasattr(
+                config.db.dialect, "supports_virtual_generated_columns"
+            )
+
+        return exclusions.only_if("postgresql<18") + exclusions.only_if(go)
+
     @property
     def autoincrement_on_composite_pk(self):
         return exclusions.closed()

{alembic-1.16.5 → alembic-1.17.0}/alembic/testing/suite/test_autogen_computed.py

@@ -1,3 +1,5 @@
+from contextlib import nullcontext
+
 import sqlalchemy as sa
 from sqlalchemy import Column
 from sqlalchemy import Integer
@@ -6,7 +8,9 @@ from sqlalchemy import Table
 
 from ._autogen_fixtures import AutogenFixtureTest
 from ... import testing
+from ...testing import config
 from ...testing import eq_
+from ...testing import expect_warnings
 from ...testing import is_
 from ...testing import is_true
 from ...testing import mock
@@ -17,6 +21,13 @@ class AutogenerateComputedTest(AutogenFixtureTest, TestBase):
     __requires__ = ("computed_columns",)
     __backend__ = True
 
+    def _fixture_ctx(self):
+        if config.requirements.computed_columns_warn_no_persisted.enabled:
+            ctx = expect_warnings()
+        else:
+            ctx = nullcontext()
+        return ctx
+
     def test_add_computed_column(self):
         m1 = MetaData()
         m2 = MetaData()
@@ -30,7 +41,8 @@ class AutogenerateComputedTest(AutogenFixtureTest, TestBase):
             Column("foo", Integer, sa.Computed("5")),
         )
 
-        diffs = self._fixture(m1, m2)
+        with self._fixture_ctx():
+            diffs = self._fixture(m1, m2)
 
         eq_(diffs[0][0], "add_column")
         eq_(diffs[0][2], "user")
@@ -54,7 +66,8 @@ class AutogenerateComputedTest(AutogenFixtureTest, TestBase):
 
         Table("user", m2, Column("id", Integer, primary_key=True))
 
-        diffs = self._fixture(m1, m2)
+        with self._fixture_ctx():
+            diffs = self._fixture(m1, m2)
 
         eq_(diffs[0][0], "remove_column")
         eq_(diffs[0][2], "user")
@@ -97,7 +110,7 @@ class AutogenerateComputedTest(AutogenFixtureTest, TestBase):
             Column("foo", Integer, *arg_after),
         )
 
-        with mock.patch("alembic.util.warn") as mock_warn:
+        with mock.patch("alembic.util.warn") as mock_warn, self._fixture_ctx():
             diffs = self._fixture(m1, m2)
 
         eq_(
@@ -137,7 +150,7 @@ class AutogenerateComputedTest(AutogenFixtureTest, TestBase):
             Column("foo", Integer, *arg_after),
         )
 
-        with mock.patch("alembic.util.warn") as mock_warn:
+        with mock.patch("alembic.util.warn") as mock_warn, self._fixture_ctx():
             diffs = self._fixture(m1, m2)
         eq_(mock_warn.mock_calls, [])
 

{alembic-1.16.5 → alembic-1.17.0}/alembic/util/compat.py

@@ -3,6 +3,8 @@
 from __future__ import annotations
 
 from configparser import ConfigParser
+from importlib import metadata
+from importlib.metadata import EntryPoint
 import io
 import os
 from pathlib import Path
@@ -10,10 +12,7 @@ import sys
 import typing
 from typing import Any
 from typing import Iterator
-from typing import List
-from typing import Optional
 from typing import Sequence
-from typing import Union
 
 if True:
     # zimports hack for too-long names
@@ -30,8 +29,6 @@ py314 = sys.version_info >= (3, 14)
 py313 = sys.version_info >= (3, 13)
 py312 = sys.version_info >= (3, 12)
 py311 = sys.version_info >= (3, 11)
-py310 = sys.version_info >= (3, 10)
-py39 = sys.version_info >= (3, 9)
 
 
 # produce a wrapper that allows encoded text to stream
@@ -42,19 +39,6 @@ class EncodedIO(io.TextIOWrapper):
         pass
 
 
-if py39:
-    from importlib import resources as _resources
-
-    importlib_resources = _resources
-    from importlib import metadata as _metadata
-
-    importlib_metadata = _metadata
-    from importlib.metadata import EntryPoint as EntryPoint
-else:
-    import importlib_resources  # type:ignore # noqa
-    import importlib_metadata  # type:ignore # noqa
-    from importlib_metadata import EntryPoint  # type:ignore # noqa
-
 if py311:
     import tomllib as tomllib
 else:
@@ -109,15 +93,18 @@ else:
 
 
 def importlib_metadata_get(group: str) -> Sequence[EntryPoint]:
-    ep = importlib_metadata.entry_points()
-    if hasattr(ep, "select"):
-        return ep.select(group=group)
-    else:
-        return ep.get(group, ())  # type: ignore
+    """provide a facade for metadata.entry_points().
+
+    This is no longer a "compat" function as of Python 3.10, however
+    the function is widely referenced in the test suite and elsewhere so is
+    still in this module for compatibility reasons.
+
+    """
+    return metadata.entry_points().select(group=group)
 
 
 def formatannotation_fwdref(
-    annotation: Any, base_module: Optional[Any] = None
+    annotation: Any, base_module: Any | None = None
 ) -> str:
     """vendored from python 3.7"""
     # copied over _formatannotation from sqlalchemy 2.0
@@ -138,9 +125,6 @@ def formatannotation_fwdref(
 
 def read_config_parser(
     file_config: ConfigParser,
-    file_argument: Sequence[Union[str, os.PathLike[str]]],
-) -> List[str]:
-    if py310:
-        return file_config.read(file_argument, encoding="locale")
-    else:
-        return file_config.read(file_argument)
+    file_argument: list[str | os.PathLike[str]],
+) -> list[str]:
+    return file_config.read(file_argument, encoding="locale")

{alembic-1.16.5 → alembic-1.17.0}/alembic/util/pyfiles.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 import atexit
 from contextlib import ExitStack
 import importlib
+from importlib import resources
 import importlib.machinery
 import importlib.util
 import os
@@ -17,7 +18,6 @@ from typing import Union
 from mako import exceptions
 from mako.template import Template
 
-from . import compat
 from .exc import CommandError
 
 
@@ -68,11 +68,11 @@ def coerce_resource_to_filename(fname_or_resource: str) -> pathlib.Path:
         file_manager = ExitStack()
         atexit.register(file_manager.close)
 
-        ref = compat.importlib_resources.files(tokens[0])
+        ref = resources.files(tokens[0])
         for tok in tokens[1:]:
             ref = ref / tok
         fname_or_resource = file_manager.enter_context(  # type: ignore[assignment]  # noqa: E501
-            compat.importlib_resources.as_file(ref)
+            resources.as_file(ref)
         )
     return pathlib.Path(fname_or_resource)
 

{alembic-1.16.5 → alembic-1.17.0}/alembic/util/sqla_compat.py

@@ -70,6 +70,7 @@ _vers = tuple(
 sqla_14_18 = _vers >= (1, 4, 18)
 sqla_14_26 = _vers >= (1, 4, 26)
 sqla_2 = _vers >= (2,)
+sqla_2_1 = _vers >= (2, 1)
 sqlalchemy_version = __version__
 
 if TYPE_CHECKING:
@@ -493,3 +494,9 @@ def is_expression(expr: Any) -> bool:
     if not isinstance(expr, ColumnClause) or expr.is_literal:
         return True
     return False
+
+
+def _inherit_schema_deprecated() -> bool:
+    # at some point in 2.1 inherit_schema was replaced with a property
+    # so that's preset at the class level, while before it wasn't.
+    return sqla_2_1 and hasattr(sqltypes.Enum, "inherit_schema")

{alembic-1.16.5 → alembic-1.17.0/alembic.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alembic
-Version: 1.16.5
+Version: 1.17.0
 Summary: A database migration tool for SQLAlchemy.
 Author-email: Mike Bayer <mike_mp@zzzcomputing.com>
 License-Expression: MIT
@@ -15,7 +15,6 @@ Classifier: Environment :: Console
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -23,7 +22,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Topic :: Database :: Front-Ends
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: SQLAlchemy>=1.4.0

{alembic-1.16.5 → alembic-1.17.0}/alembic.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ LICENSE
 MANIFEST.in
 README.rst
 README.unittests.rst
+noxfile.py
 pyproject.toml
 setup.cfg
 setup.py
@@ -327,4 +328,6 @@ tests/test_stubs.py
 tests/test_suite.py
 tests/test_version_table.py
 tests/test_version_traversal.py
+tools/toxnox.py
+tools/warn_tox.py
 tools/write_pyi.py

{alembic-1.16.5 → alembic-1.17.0}/docs/_sources/changelog.rst

@@ -3,6 +3,24 @@
 Changelog
 ==========
 
+.. changelog::
+    :version: 1.17.0
+    :released: October 11, 2025
+
+    .. change::
+        :tags: change, tests
+
+        The top-level test runner has been changed to use ``nox``, adding a
+        ``noxfile.py`` as well as some included modules.   The ``tox.ini`` file
+        remains in place so that ``tox`` runs will continue to function in the near
+        term, however it will be eventually removed and improvements and
+        maintenance going forward will be only towards ``noxfile.py``.
+
+    .. change::
+        :tags: change, general
+
+        The minimum Python version is now 3.10, as Python 3.9 is EOL.
+
 .. changelog::
     :version: 1.16.5
     :released: August 27, 2025

{alembic-1.16.5/docs/build → alembic-1.17.0/docs/_sources}/tutorial.rst

@@ -45,7 +45,7 @@ The structure of this environment, including some generated migration scripts, l
 
 The directory includes these directories/files:
 
-* ``alembic.ini`` - this is Alembic's main configuration file which is genereated by all templates.
+* ``alembic.ini`` - this is Alembic's main configuration file which is generated by all templates.
   A detailed walkthrough of this file is later in the section :ref:`tutorial_alembic_ini`.
 * ``pyproject.toml`` - most modern Python projects have a ``pyproject.toml`` file.  Alembic may
   optionally store project related configuration in this file as well; to use a ``pyproject.toml``

{alembic-1.16.5 → alembic-1.17.0}/docs/_static/documentation_options.js

@@ -1,5 +1,5 @@
 const DOCUMENTATION_OPTIONS = {
-    VERSION: '1.16.5',
+    VERSION: '1.17.0',
     LANGUAGE: 'en',
     COLLAPSE_INDEX: false,
     BUILDER: 'html',