- 1.5.5

docs/build/changelog.rst

@@ -5,7 +5,39 @@ Changelog
 
 .. changelog::
     :version: 1.5.5
-    :include_notes_from: unreleased
+    :released: February 20, 2021
+
+    .. change::
+        :tags: bug
+
+        Adjusted the use of SQLAlchemy's ".copy()" internals to use "._copy()"
+        for version 1.4.0, as this method is being renamed.
+
+    .. change::
+        :tags: bug, environment
+        :tickets: 797
+
+        Added new config file option ``prepend_sys_path``, which is a series of
+        paths that will be prepended to sys.path; the default value in newly
+        generated alembic.ini files is ".".  This fixes a long-standing issue
+        where for some reason running the alembic command line would not place the
+        local "." path in sys.path, meaning an application locally present in "."
+        and importable through normal channels, e.g. python interpreter, pytest,
+        etc. would not be located by Alembic, even though the ``env.py`` file is
+        loaded relative to the current path when ``alembic.ini`` contains a
+        relative path. To enable for existing installations, add the option to the
+        alembic.ini file as follows::
+
+          # sys.path path, will be prepended to sys.path if present.
+          # defaults to the current working directory.
+          prepend_sys_path = .
+
+        .. seealso::
+
+            :ref:`installation` - updated documentation reflecting that local
+            installation of the project is not necessary if running the Alembic cli
+            from the local path.
+
 
 .. changelog::
     :version: 1.5.4

docs/build/conf.py

@@ -85,8 +85,8 @@
 # The short X.Y version.
 version = alembic.__version__
 # The full version, including alpha/beta/rc tags.
-release = "1.5.4"
-release_date = "February 3, 2021"
+release = "1.5.5"
+release_date = "February 20, 2021"
 
 
 # The language for content autogenerated by Sphinx. Refer to documentation