- Added :attr:`alembic.config.Config.cmd_opts` attribute,

allows access to the `argparse` options passed to the
`alembic` runner.

- Added new command line argument ``-x``, allows extra arguments
to be appended to the command line which can be consumed
within an ``env.py`` script by looking at
``context.config.cmd_opts.x``.

diff --git a/alembic/config.py b/alembic/config.py
index c1ad7ecca4db6f19a5f034f5fbdcc019d101d6f2..bc3ae7a03b9eec36021ddbf5317daa0c81a7f343 100644 (file)
--- a/alembic/config.py
+++ b/alembic/config.py
@@ -51,7 +51,7 @@ class Config(object):
 
     """
     def __init__(self, file_=None, ini_section='alembic', output_buffer=None,
-                        stdout=sys.stdout):
+                        stdout=sys.stdout, cmd_opts=None):
         """Construct a new :class:`.Config`
 
         """
@@ -59,6 +59,14 @@ class Config(object):
         self.config_ini_section = ini_section
         self.output_buffer = output_buffer
         self.stdout = stdout
+        self.cmd_opts = cmd_opts
+
+    cmd_opts = None
+    """The command-line options passed to the ``alembic`` script.
+
+    ..versionadded:: 0.6.0
+
+    """
 
     config_file_name = None
     """Filesystem path to the .ini file in use."""
@@ -224,6 +232,11 @@ class CommandLine(object):
                             default="alembic",
                             help="Name of section in .ini file to "
                                     "use for Alembic config")
+        parser.add_argument("-x", action="append",
+                            help="Additional arguments consumed by "
+                            "custom env.py scripts, e.g. -x "
+                            "setting1=somesetting -x setting2=somesetting")
+
         subparsers = parser.add_subparsers()
 
         for fn in [getattr(command, n) for n in dir(command)]:
@@ -264,10 +277,14 @@ class CommandLine(object):
             # behavior changed incompatibly in py3.3
             self.parser.error("too few arguments")
         else:
-            cfg = Config(options.config, options.name)
+            cfg = Config(file_=options.config,
+                            ini_section=options.name, cmd_opts=options)
             self.run_cmd(cfg, options)
 
 def main(argv=None, prog=None, **kwargs):
     """The console runner function for Alembic."""
 
     CommandLine(prog=prog).main(argv=argv)
+
+if __name__ == '__main__':
+    main()
\ No newline at end of file

diff --git a/docs/build/changelog.rst b/docs/build/changelog.rst
index 1b54325febad9542d7b1d1b19f96fc5cf40bbdc3..c19e6596f4e16cfde65dd95c7ba948b07ada5631 100644 (file)
--- a/docs/build/changelog.rst
+++ b/docs/build/changelog.rst
@@ -6,6 +6,21 @@ Changelog
 .. changelog::
     :version: 0.6.0
 
+    .. change::
+      :tags: feature
+
+      Added :attr:`alembic.config.Config.cmd_opts` attribute,
+      allows access to the `argparse` options passed to the
+      `alembic` runner.
+
+    .. change::
+      :tags: feature
+
+      Added new command line argument ``-x``, allows extra arguments
+      to be appended to the command line which can be consumed
+      within an ``env.py`` script by looking at
+      ``context.config.cmd_opts.x``.
+
     .. change::
       :tags: bug
       :tickets: 125