From: Mike Bayer <mike_mp@zzzcomputing.com>
Date: Sun, 27 Dec 2015 23:48:26 +0000 (-0500)
Subject: - add a note referring to if programmatic config is used,
X-Git-Tag: rel_0_8_5~15
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=6c9f34851dbd765e005b13fb9c5b8544892f22c5;p=thirdparty%2Fsqlalchemy%2Falembic.git

- add a note referring to if programmatic config is used,
logging might not work, fixes #45
---

diff --git a/alembic/config.py b/alembic/config.py
index 9534fcc9..ada59ddf 100644
--- a/alembic/config.py
+++ b/alembic/config.py
@@ -43,6 +43,14 @@ class Config(object):
         alembic_cfg.set_main_option("url", "postgresql://foo/bar")
         alembic_cfg.set_section_option("mysection", "foo", "bar")
 
+    .. warning::
+
+       When using programmatic configuration, make sure the
+       ``env.py`` file in use is compatible with the target configuration;
+       including that the call to Python ``logging.fileConfig()`` is
+       omitted if the programmatic configuration doesn't actually include
+       logging directives.
+
     For passing non-string values to environments, such as connections and
     engines, use the :attr:`.Config.attributes` dictionary::