(h j d dl mZ d dlmZ d dlmZ d dlmZ d dlZd dlZd dl Z d dl
m Z d dl
m Z d dl
m
Z
d d l
mZ d d
l
mZ d d l
mZ d d l
mZ d d
l
mZ d dlmZ ddlmZ ddlmZ ddlmZ ddlmZ G d d Z G d ded Z G d d Z d d Z e d k r e dS dS ) ) annotations)ArgumentParser) Namespace) ConfigParserN)Any)cast)Dict)Mapping)Optional)overload)TextIO)Union) TypedDict ) __version__)command)util)compatc e Zd ZU dZdddej d ej dfd4dZdZ d
e
d < dZ de
d< dZ de
d< ej
d Zd5dZej
d Zd6dZe d7d8d Zed9d" Zed:d% Z d;dd*Zd?d,Z d;d@d.ZedAd/ Ze d;dBd0 Zd;d1Zej
dCd3 ZdS )DConfiga_ 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("sqlalchemy.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::
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``.
: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 ``ConfigParser()``
to parse the .ini file.
:param attributes: optional dictionary of arbitrary Python keys/values,
which will be populated into the :attr:`.Config.attributes` dictionary.
.. seealso::
:ref:`connection_sharing`
Nalembicfile_"Union[str, os.PathLike[str], None] ini_sectionstr
output_bufferOptional[TextIO]stdoutr
cmd_optsOptional[Namespace] config_argsMapping[str, Any]
attributesOptional[dict]returnNonec || _ || _ || _ || _ || _ t | | _ |r | j | dS dS )z Construct a new :class:`.Config`N) config_file_nameconfig_ini_sectionr r r dictr! r# update)selfr r r r r r! r# s `/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/alembic/config.py__init__zConfig.__init__d sh !& "- *
,, / O " ": . . . . . / / r( r) c i S )a 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.
.. seealso::
:ref:`connection_sharing`
:paramref:`.Config.attributes`
r, s r- r# zConfig.attributes s $ r/ textc |rt | |z }nt | }t j | j |dfi | j dS )a Render a message to standard out.
When :meth:`.Config.print_stdout` is called with additional args
those arguments will formatted against the provided text,
otherwise we simply output the provided text verbatim.
This is a no-op when the``quiet`` messaging option is enabled.
e.g.::
>>> config.print_stdout('Some text %s', 'arg')
Some Text arg
N)r r write_outstreamr messaging_opts)r, r3 argoutputs r- print_stdoutzConfig.print_stdout sP YY_FFYYF T[&$NN$:MNNNNNr/ c R | j rBt j t j | j }nd}|| j d< t
| j }| j r | | j g n| | j |S )a 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.
here)
r( ospathabspathdirnamer! r read add_sectionr) )r, r= file_configs r- rD zConfig.file_config s 7??27??43H#I#IJJDDD#' "4#344 = d 3 4 5 5 5 5 # #D$; < < <r/ c ddl }t j t j |j }t j |d S )zReturn the directory where Alembic setup templates are found.
This method is used by the alembic ``init`` and ``list_templates``
commands.
r N templates)r r> r? r@ rA __file__join)r, r package_dirs r- get_template_directoryz Config.get_template_directory sG goobgoog6F&G&GHH w||K555r/ .namedefaultOptional[Dict[str, str]]c d S Nr1 r, rK rL s r- get_sectionzConfig.get_section r/ Dict[str, str]c d S rO r1 rP s r- rQ zConfig.get_section rR r/ Mapping[str, str](Union[Dict[str, str], Mapping[str, str]]c d S rO r1 rP s r- rQ zConfig.get_section rR r/ Optional[Mapping[str, str]]c | j | s|S t | j | S )zReturn all the configuration options from a given .ini file section
as a dictionary.
If the given section does not exist, the value of ``default``
is returned, which is expected to be a dictionary or other mapping.
)rD has_sectionr* itemsrP s r- rQ zConfig.get_section sA ++D11 ND$**400111r/ valuec > | | j || dS )a: Set an option programmatically within the 'main' section.
This overrides whatever was in the .ini file.
:param name: name of the value
:param value: the value. Note that this value is passed to
``ConfigParser.set``, which supports variable interpolation using
pyformat (e.g. ``%(some_value)s``). A raw percent sign not part of
an interpolation symbol must therefore be escaped, e.g. ``%%``.
The given value may refer to another value already in the file
using the interpolation format.
N)set_section_optionr) )r, rK r\ s r- set_main_optionzConfig.set_main_option s%
7uEEEEEr/ c F | j | j | d S rO )rD
remove_optionr) )r, rK s r- remove_main_optionzConfig.remove_main_option s$ &&t'>EEEEEr/ sectionc | j | s| j | | j ||| dS )a 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.
:param section: name of the section
:param name: name of the value
:param value: the value. Note that this value is passed to
``ConfigParser.set``, which supports variable interpolation using
pyformat (e.g. ``%(some_value)s``). A raw percent sign not part of
an interpolation symbol must therefore be escaped, e.g. ``%%``.
The given value may refer to another value already in the file
using the interpolation format.
N)rD rZ rC set)r, rc rK r\ s r- r^ zConfig.set_section_option sU ( ++G44 2 ( ( 1 1 1 WdE22222r/
Optional[str]c | j | s t j d| j d|d | j || r| j || S |S )z9Return an option from the given section of the .ini file.zNo config file z found, or file has no '[z
]' section)rD rZ r CommandErrorr(
has_optionget)r, rc rK rL s r- get_section_optionzConfig.get_section_option- s ++G44 ##$($9$9$9777D
& &w 5 5 #''66 6Nr/ c d S rO r1 rP s r- get_main_optionzConfig.get_main_option; s r/ c d S rO r1 rP s r- rm zConfig.get_main_option? rR r/ c : | | j || S )zReturn 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.
)rk r) rP s r- rm zConfig.get_main_optionE s &&t'>gNNNr/ MessagingOptionsc | t t t j dt | j dd i S )zThe messaging options.quietF)r rp r
immutabledictgetattrr r2 s r- r7 zConfig.messaging_optsO s? '$-%@@A
r/ )r r r r r r r r
r r r! r" r# r$ r% r& )r3 r r% r& )r% r ).)rK r rL r& r% rM )rK r rL rS r% rS )rK r rL rU r% rV rO )rK r rL rX r% rX )rK r r\ r r% r& )rK r r% r& )rc r rK r r\ r r% r& )rc r rK r rL rf r% rf )rK r rL r r% r )rK r rL rf r% rf )r% rp )__name__
__module__ __qualname____doc__sysr r rs r. r __annotations__r( r) memoized_propertyr# r: rD rJ r rQ r_ rb r^ rk rm r7 r1 r/ r- r r s F FT 59$*. (,););)=)=%)/ / / / /( %)H(((( <@????2 """""
&O O O O.
,
6
6
6
6 ), X X
X AE
2
2
2
2
2 F F F F"F F F F3 3 3 32 AE X 26 X
O O O O
r/ r c e Zd ZU ded< dS )rp boolrr N)ru rv rw rz r1 r/ r- rp rp Z s KKKKKr/ rp F)totalc 0 e Zd ZdddZddZdd Zdd
ZdS ) CommandLineNprogrf r% r& c 0 | | d S rO )_generate_args)r, r s r- r. zCommandLine.__init___ s D!!!!!r/ c J
fd}t | }| dddt z | ddt t j d d
d | d
dt dd | ddd | ddd | dddd | }t j dd ii d t t D D ]y t j ra j
d d k rO j d k rCt j }|d! I|d d"t# |d! }|d t# |d! d }n|d d"d }g } v r fd#|D } j }|rXg } | d$ D ]?}
|
s n(| |
@ng } | j
d% | &
|
||
||f' {|| _ d S )(Nc ` i dddt dt d fddd t t d
fd d
t dd fddt t d fddt t d fddt dd fddt d d fd d t t d fd!d"t t d# fd$d%t t d& fd'd(d)t dd* fd+d,t dd- fd.d/t dd0 fd1d2d3t d4d5 fd6d7d8t dd9 fd:d;t dd< fd=d>t dd? f}d@dAdBdC}|D ]-}||v r'|| }|dDdE |dE }} |j |i | .|D ]t}|dFk s| v r> | | dFk r,
dFdG| dF H J
|| | I ud S )JNtemplatez-tz
--templategenericz"Setup template for use with 'init')rL typehelpmessagez-mz --messagez%Message string to use with 'revision')r r sqlz--sql
store_truez\Don't emit SQL to database - dump to standard output/file instead. See docs on offline mode.actionr tagz--tagz@head to base new revision on.splicez--splicez6Allow a non-head revision as the 'head' to splice onto
depends_onz --depends-onappendzNSpecify one or more revision identifiers which this revision should depend on.rev_idz--rev-idz9Specify a hardcoded revision id instead of generating one version_pathz--version-pathz2Specify specific path from config for version file branch_labelz--branch-labelz3Specify a branch label to apply to the new revisionverbosez-vz --verbosezUse more verbose outputresolve_dependenciesz--resolve-dependenciesz+Treat dependency versions as down revisions autogeneratez--autogeneratezgPopulate revision script with candidate migration operations, based on comparison of database to model. rev_rangez-rz --rev-rangestorez1Specify a revision range; format is [start]:[end]indicate_currentz-iz--indicate-currentz Indicate the current revisionpurgez--purgez7Unconditionally erase the version table before stampingpackagez --packagezFWrite empty __init__.py files to the environment and version locationsz location of scripts directoryzrevision identifierz/one or more revisions, or 'heads' for all heads) directoryrevision revisionsr r +)nargsr r )r* r add_argumentrj ) fnparser
positionalkwargs kwargs_optspositional_helpr8 argskwpositional_translations subparsers r- add_optionsz/CommandLine._generate_args..add_optionsc s< H ) A H 'N H" + ( #H4 1 5HD 3 EHT + 0 UHd " ' @ eHt ) uHD $ ' !EHT $ ' !UHd 3LMMM eHn ', + J )oH| $ + 0 !}HN ! & 2 OH` #( + < %aHp + * qH@ + < AHKT = 1 N O
5
5+%%&s+D #AbDz48"D'F'4444!
O
O;&& 444/3C8KGG **# ! , 0 0 = = + **3_5H5H5M5M*NNNN
O
Or/ r z --versionversionz %%(prog)s %s)r r z-cz--configALEMBIC_CONFIGz alembic.inizaAlternate config file; defaults to value of ALEMBIC_CONFIG environment variable, or "alembic.ini")r rL r z-nz--namer z6Name of section in .ini file to use for Alembic configz-xr zlAdditional arguments consumed by custom env.py scripts, e.g. -x setting1=somesetting -x setting2=somesettingr z
--raiseerrr z!Raise a full stack trace on errorz-qz--quietzDo not log to std output.r r c 8 g | ]}t t | S r1 )rt r ).0ns r-
z.CommandLine._generate_args..0 s" ===177A&&===r/ r _zalembic.command r c H g | ] } || S r1 )rj )r rK r r s r- r z.CommandLine._generate_args..@ s> " " " 0377dCC" " "r/ r5 r )cmd)r r r r r> environrj add_subparsersr stampdirinspect
isfunctionru rv r inspect_getfullargspeclenrx splitstripr
add_parserrH set_defaultsr )r, r r r
subparsersspecr kwarghelp_ help_textliner r r s @@@r- r zCommandLine._generate_argsb sY a O a O a O a O a O a OF T*** >K3O
JNN#3]CCD
L
;
4
,
**,,
#*=:{2K"L ==G === $ D $ DB"2&&#
DKNc))M%666 4R887&!%ac$q'll]):!;J GSa\\MOO 4EE!%aJ E000" " " " "$." " "J
# "I % D 1 1 ; ; #zz|| ; !E % , ,TZZ\\ : : : : "I & 1 1Kchhy&9&9 2 B :u===&&B
E+B&CCC r/ configr optionsr c j \ }}} ||gfd|D R i fd|D d S # t j $ r7}j r t j t | fi |j Y d }~d S d }~ww xY w)Nc 2 g | ]}t |d S rO rt r kr s r- r z'CommandLine.run_cmd..] s% @@@''1d++@@@r/ c 4 i | ]}|t |d S rO r r s r-
z'CommandLine.run_cmd..^ s' ???A1ggq$//???r/ )r r rh raiseerrerrr r7 )r, r r r r r es ` r- run_cmdzCommandLine.run_cmdW s ' J
: B
@@@@Z@@@
@??????
: : :
:Q996#8999999999 :s $4 A:,A55A:c | j | }t |d s | j d d S t |j |j | }| || d S )Nr ztoo few arguments)r r r )r
parse_argshasattrerrorr r rK r )r, argvr cfgs r- mainzCommandLine.mainf s +((..w&&
'
K 1 2 2 2 2 2 n #L C
LLg & & & & &r/ rO )r rf r% r& )r r r r r% r& )ru rv rw r. r r r r1 r/ r- r r ^ sn " " " " "s s s s j
:
:
:
: ' ' ' ' ' 'r/ r c N t | | dS )z(The console runner function for Alembic.r )r N)r r )r r r s r- r r u s, T T *****r/ __main__)NN)
__future__r argparser r configparserr r r> ry typingr r r r
r r r
r typing_extensionsr r< r r r r r rp r r ru r1 r/ r- r s " " " " " " # # # # # # % % % % % %
' ' ' ' ' ' }
}
}
}
}
}
}
}
@
y T' T' T' T' T' T' T' T'n+ + + + zDFFFFF r/