1.17.1

Released: October 28, 2025

usecase

• [usecase] [commands] Added command.current.check_heads parameter to
  command.current() command, available from the command line via the
  --check-heads option to alembic current. This tests if all head
  revisions are applied to the database and raises DatabaseNotAtHead
  (or from the command line, exits with a non-zero exit code) if this is not
  the case. The parameter operates equvialently to the cookbook recipe
  cookbook_check_heads. Pull request courtesy Stefan Scherfke.

  References: #1705

bug

• [bug] [commands] Disallow ':' character in custom revision identifiers. Previously, using a
  colon in a revision ID (e.g., 'REV:1') would create the revision, however
  revisions with colons in them are not correctly interpreted by other
  commands, as it overlaps with the revision range syntax. Pull request
  courtesy Kim Wooseok with original implementation by Hrushikesh Patil.

  References: #1540