Current File : //proc/227033/root/opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyo
�
�M!Vc @ s� d d l m Z d d l m Z d d l Z d d l Z d d l Z d d l m Z d d l m Z d d l m
Z
d d l m Z d e f d
� � YZ
d e f d � � YZ d d d
� Z e d k r� e � n d S( i����( t ArgumentParseri ( t SafeConfigParserN( t command( t util( t package_dir( t compatt Configc B s� e Z d Z d
d d
e j d
e j � d
d � Z d
Z d
Z
d
Z e j d � � Z
d � Z e j d � � Z d � Z d � Z d � Z d � Z d
� Z d
d � Z d
d � Z RS( sk
Represent an Alembic configuration.
Within an ``env.py`` script, this is available
via the :attr:`.EnvironmentContext.config` attribute,
which in turn is available at ``alembic.context``::
from alembic import context
some_param = context.config.get_main_option("my option")
When invoking Alembic programatically, a new
:class:`.Config` can be created by passing
the name of an .ini file to the constructor::
from alembic.config import Config
alembic_cfg = Config("/path/to/yourapp/alembic.ini")
With a :class:`.Config` object, you can then
run Alembic commands programmatically using the directives
in :mod:`alembic.command`.
The :class:`.Config` object can also be constructed without
a filename. Values can be set programmatically, and
new sections will be created as needed::
from alembic.config import Config
alembic_cfg = Config()
alembic_cfg.set_main_option("script_location", "myapp:migrations")
alembic_cfg.set_main_option("url", "postgresql://foo/bar")
alembic_cfg.set_section_option("mysection", "foo", "bar")
For passing non-string values to environments, such as connections and
engines, use the :attr:`.Config.attributes` dictionary::
with engine.begin() as connection:
alembic_cfg.attributes['connection'] = connection
command.upgrade(alembic_cfg, "head")
:param file_: name of the .ini file to open.
:param ini_section: name of the main Alembic section within the
.ini file
:param output_buffer: optional file-like input buffer which
will be passed to the :class:`.MigrationContext` - used to redirect
the output of "offline generation" when using Alembic programmatically.
:param stdout: buffer where the "print" output of commands will be sent.
Defaults to ``sys.stdout``.
.. versionadded:: 0.4
:param config_args: A dictionary of keys and values that will be used
for substitution in the alembic config file. The dictionary as given
is **copied** to a new one, stored locally as the attribute
``.config_args``. When the :attr:`.Config.file_config` attribute is
first invoked, the replacement variable ``here`` will be added to this
dictionary before the dictionary is passed to ``SafeConfigParser()``
to parse the .ini file.
.. versionadded:: 0.7.0
:param attributes: optional dictionary of arbitrary Python keys/values,
which will be populated into the :attr:`.Config.attributes` dictionary.
.. versionadded:: 0.7.5
.. seealso::
:ref:`connection_sharing`
t alembicc C sY | | _ | | _ | | _ | | _ | | _ t | � | _ | rU | j j | � n d S( s* Construct a new :class:`.Config`
N( t config_file_namet config_ini_sectiont
output_buffert stdoutt cmd_optst dictt config_argst
attributest update( t selft file_t ini_sectionR
R R R R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyt __init__U s c C s i S( s A Python dictionary for storage of additional state.
This is a utility dictionary which can include not just strings but
engines, connections, schema objects, or anything else.
Use this to pass objects into an env.py script, such as passing
a :class:`sqlalchemy.engine.base.Connection` when calling
commands from :mod:`alembic.command` programmatically.
.. versionadded:: 0.7.5
.. seealso::
:ref:`connection_sharing`
:paramref:`.Config.attributes`
( ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyR } s c G s' t j | j t j | � | d � d S( s! Render a message to standard out.s
N( R t write_outstreamR R t text_type( R t textt arg( ( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyt print_stdout� s c C s� | j r- t j j t j j | j � � } n d } | | j d <t | j � } | j rn | j | j g � n | j | j � | S( s Return the underlying ``ConfigParser`` object.
Direct access to the .ini file is available here,
though the :meth:`.Config.get_section` and
:meth:`.Config.get_main_option`
methods provide a possibly simpler interface.
t t here(
R t ost patht abspatht dirnameR R t readt add_sectionR ( R R t file_config( ( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyR" � s $
c C s t j j t d � S( s� Return the directory where Alembic setup templates are found.
This method is used by the alembic ``init`` and ``list_templates``
commands.
t templates( R R t joinR ( R ( ( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyt get_template_directory� s c C s t | j j | � � S( sf Return all the configuration options from a given .ini file section
as a dictionary.
( R
R" t items( R t name( ( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyt get_section� s c C s | j j | j | | � d S( sz Set an option programmatically within the 'main' section.
This overrides whatever was in the .ini file.
N( R" t setR ( R R' t value( ( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyt set_main_option� s c C s | j j | j | � d S( N( R" t
remove_optionR ( R R' ( ( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyt remove_main_option� s c C s? | j j | � s% | j j | � n | j j | | | � d S( s� Set an option programmatically within the given section.
The section is created if it doesn't exist already.
The value here will override whatever was in the .ini
file.
N( R" t has_sectionR! R) ( R t sectionR' R* ( ( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyt set_section_option� s c C sa | j j | � s1 t j d | j | f � � n | j j | | � rY | j j | | � S| Sd S( sC Return an option from the given section of the .ini file.
s6 No config file %r found, or file has no '[%s]' sectionN( R" R. R t CommandErrorR t
has_optiont get( R R/ R' t default( ( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyt get_section_option� s c C s | j | j | | � S( s� Return an option from the 'main' section of the .ini file.
This defaults to being a key from the ``[alembic]``
section, unless the ``-n/--name`` flag were used to
indicate a different section.
( R5 R ( R R' R4 ( ( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyt get_main_option� s N( t __name__t
__module__t __doc__t Nonet sysR R t
immutabledictR R R R t memoized_propertyR R R" R% R( R+ R- R0 R5 R6 ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyR
s" F
t CommandLinec B s2 e Z d d � Z d � Z d � Z d d � Z RS( c C s | j | � d S( N( t _generate_args( R t prog( ( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyR � s c
s� � f d � } t d | � } | j d d d t d d d d �| j d
d d t d d d d
�| j d d d d d �| j d d d d d �| j � } x
g t t � D] } t t | � ^ q� D]� } t j | � r� | j d d k r� | j
d k r� t j | � } | d rQ| d d t | d � !} | d t | d � } n | d d } g } | j
| j d | j �� | � | | � � j d | | | f � q� q� W| | _ d S( Nc
s� i d d t d d d t d d � f d 6d d
t d t d d � f d 6d
t d d d d � f d 6d t d t d d � f d 6d t d t d d � f d 6d t d d d d � f d 6d t d d d d � f d 6d t d t d d � f d! 6d" t d t d d# � f d$ 6d% t d t d d& � f d' 6d( d) t d d d d* � f d+ 6d, t d d d d- � f d. 6d/ t d d d d0 � f d1 6d2 t d d d d3 � f d4 6d5 d6 t d d7 d d8 � f d9 6} i d: d; 6d< d= 6d> d? 6} xO | D]G } | | k r�| | } | d@ dA !| dA } } | j | | � q�q�Wx[ | D]S } | d? k rg� j | dB dC d | j | � �q0� j | d | j | � �q0Wd S(D Ns -ts
--templateR4 t generict typet helps" Setup template for use with 'init't templates -ms --messages% Message string to use with 'revision't messages --sqlt actiont
store_truesA Don't emit SQL to database - dump to standard output/file insteadt sqls --tags< Arbitrary 'tag' name - can be used by custom env.py scripts.t tags --headsC Specify head revision or <branchname>@head to base new revision on.t heads --splices6 Allow a non-head revision as the 'head' to splice ontot splices --depends-ont appendsN Specify one or more revision identifiers which this revision should depend on.t
depends_ons --rev-ids9 Specify a hardcoded revision id instead of generating onet rev_ids --version-paths2 Specify specific path from config for version filet version_paths --branch-labels3 Specify a branch label to apply to the new revisiont branch_labels -vs --verboses Use more verbose outputt verboses --resolve-dependenciess+ Treat dependency versions as down revisionst resolve_dependenciess --autogeneratesg Populate revision script with candidate migration operations, based on comparison of database to model.t autogenerates --head-onlys0 Deprecated. Use --verbose for additional outputt head_onlys -rs --rev-ranget stores1 Specify a revision range; format is [start]:[end]t rev_ranges location of scripts directoryt directorys revision identifiert revisions/ one or more revisions, or 'heads' for all headst revisionsi i����t nargst +( R
t strt add_argumentR3 ( t parsert
positionalt kwargst kwargs_optst positional_helpR t argst kw( t subparser( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyt add_options� s�
R@ s -cs --configRB R4 s alembic.iniRC s Alternate config files -ns --nameR s6 Name of section in .ini file to use for Alembic configs -xRF RL sl Additional arguments consumed by custom env.py scripts, e.g. -x setting1=somesetting -x setting2=somesettings
--raiseerrRG s! Raise a full stack trace on errori t _s alembic.commandi i t cmd( R R] R\ t add_subparserst dirR t getattrt inspectt
isfunctionR7 R8 t
getargspect lent
add_parserR9 t set_defaultsR^ (
R R@ Rf R^ t
subparserst nt fnt specR_ t kwarg( ( Re s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyR? � s> � /
c s� � j \ } } } yF | | g | D] } t � | � ^ q" t � f d � | D� � � Wn8 t j k
r� } � j r| � q� t j t | � � n Xd S( Nc 3 s$ | ] } | t � | � f Vq d S( N( Rk ( t .0t k( t options( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pys <genexpr>� s ( Rh Rk R
R R1 t raiseerrt errR\ ( R t configRy Rt R_ Rv Rx t e( ( Ry s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyt run_cmd� s ! c C si | j j | � } t | d � s4 | j j d � n1 t d | j d | j d | � } | j | | � d S( NRh s too few argumentsR R R ( R^ t
parse_argst hasattrt errorR R| R' R~ ( R t argvRy t cfg( ( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyt main� s N( R7 R8 R: R R? R~ R� ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyR> � s � c K s t d | � j d | � d S( s( The console runner function for Alembic.R@ R� N( R> R� ( R� R@ R` ( ( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyR� � s t __main__( t argparseR t util.compatR Rl R R; R R R R R t objectR R> R: R� R7 ( ( ( s? /opt/alt/python27/lib/python2.7/site-packages/alembic/config.pyt <module> s ��
Mini Shell