EhSSKJr SSKJr SSKJr SSKJr SSKrSSKrSSK J r SSK r SSK r SSK Jr SSK Jr SS K Jr SS K Jr SS K Jr SS K Jr SS K Jr SSK Jr SSK Jr SSK Jr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJ r "SS5r!\\"\"4r#"SS\SS9r$"SS\5r%"S S!5r&S$S%S"jjr'\(S#:Xa\'"5 gg)&) annotations)ArgumentParser) Namespace) ConfigParserN)Path)Any)cast)Dict)Mapping)Optional)overload)Protocol)Sequence)TextIO)Union) TypedDict) __version__)command)util)compat)_preserving_path_as_strc\\rSrSr%SrSSSS\R S\R"5S4S+Sjjr Sr S\ S'Sr S \ S 'Sr S \ S '\S,S j5r\S,S j5rSrS\ S'\R$S-Sj5rS.Sjr\R$S/Sj5r\R$S0Sj5rS1SjrS2Sjr\S3S4Sjj5r\S5Sj5r\S6Sj5rS7S8SjjrS9SjrS:SjrS;SjrS7SSjj5rS7S>Sjjr\S=S j5r \S7S>S!jj5r S7S?S"jjr S@S#jr!S7SAS$jjr"\R$SBS%j5r#SCS&jr$SDS'jr%SDS(jr&SES)jr'S*r(g)FConfiga? 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 programmatically, 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 if an ``alembic.ini`` is to be used. This should refer to the ``alembic.ini`` file, either as a filename or a full path to the file. This filename if passed must refer to an **ini file in ConfigParser format** only. :param toml\_file: name of the pyproject.toml file to open if a ``pyproject.toml`` file is to be used. This should refer to the ``pyproject.toml`` file, either as a filename or a full path to the file. This file must be in toml format. Both :paramref:`.Config.file\_` and :paramref:`.Config.toml\_file` may be passed simultaneously, or exclusively. .. versionadded:: 1.16.0 :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, as well as the pyproject.toml file, depending on which / both are used. The dictionary as given is **copied** to two new, independent dictionaries, stored locally under the attributes ``.config_args`` and ``.toml_args``. Both of these dictionaries will also be populated with the replacement variable ``%(here)s``, which refers to the location of the .ini and/or .toml file as appropriate. :param attributes: optional dictionary of arbitrary Python keys/values, which will be populated into the :attr:`.Config.attributes` dictionary. .. seealso:: :ref:`connection_sharing` Nalembicstrcmd_optsOptional[Namespace]c U(a [U5OSUlU(a [U5OSUlX0lX@lXPlX`l[U5Ul[U5Ul U(aURRU5 gg)z Construct a new :class:`.Config`N) rconfig_file_nametoml_file_nameconfig_ini_section output_bufferstdoutrdict config_args toml_args attributesupdate) selffile_ toml_file ini_sectionr$r%rr'r)s Q/home/kali/devsecops-assessor/venv/lib/python3.13/site-packages/alembic/config.py__init__Config.__init__vs{/4 #E * 3< #I . #.*   ,k*  OO " ": .  Optional[str]r!r"cHURcg[UR5$N)r!rr+s r/_config_file_pathConfig._config_file_paths"  (D))**r2cHURcg[UR5$r5)r"rr6s r/_toml_file_pathConfig._toml_file_paths"    &D''((r2r#c0$)aA 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` r6s r/r)Config.attributess $ r2cU(a[U5U-nO [U5n[R"URUS40URD6 g)adRender 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)rrwrite_outstreamr%messaging_opts)r+textargoutputs r/ print_stdoutConfig.print_stdouts> Y_FYF T[[&$N$:M:MNr2cUR(a%URR5RnO [5nUR 5UR S'[ UR 5nUR(a#[R"X R/5 U$URUR5 U$)zReturn the underlying ``ConfigParser`` object. Dir*-ect 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) r7absoluteparentras_posixr'rrread_config_parser add_sectionr#)r+rI file_configs r/rOConfig.file_configs  ! !))224;;D6D#'==? "4#3#34  ! !  % %k4J4J3K L  # #D$;$; <r2c&UR(aURR5(aURR5RnUR 5UR S'[ URS5n[RRU5nURS05RS05n[U[5(d[R"S5eUsSSS5 $0$!,(df  g=f)zEReturn a dictionary of the [tool.alembic] section from pyproject.tomlrIrbtoolrzIncorrect TOML formatN)r:existsrJrKrLr(openrtomllibloadget isinstancer&r CommandError)r+rIf toml_datadatas r/toml_alembic_configConfig.toml_alembic_configs   D$8$8$?$?$A$A''00299D%)]]_DNN6 "d**D1Q"NN//2  }}VR044YC!$--++,CDD 21I21s A.D DcSSKn[UR5R5Rn[ US- 5$)zReturn the directory where Alembic setup templates are found. This method is used by the alembic ``init`` and ``list_templates`` commands. rN templates)rr__file__rJrKr)r+r package_dirs r/get_template_directoryConfig.get_template_directorys6 7++,557>> ;,--r2c4[UR55$)zReturn the directory where Alembic setup templates are found. This method is used by the alembic ``init`` and ``list_templates`` commands. .. versionadded:: 1.16.0 )rrdr6s r/_get_template_pathConfig._get_template_pathsD//122r2cgr5r=r+namedefaults r/ get_sectionConfig.get_section(s$'r2cgr5r=rjs r/rmrn0sr2cgr5r=rjs r/rmrn5s47r2cURRU5(dU$[URRU55$)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. )rO has_sectionr&itemsrjs r/rmrn:s<++D11ND$$**4011r2c<URURX5 g)aSet 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+rkvalues r/set_main_optionConfig.set_main_optionIs  7 7Er2cPURRURU5 gr5)rO remove_optionr#)r+rks r/remove_main_optionConfig.remove_main_optionZs &&t'>'>Er2cURRU5(dURRU5 URRXU5 g)aSet 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. Does **NOT** consume from the pyproject.toml file. .. seealso:: :meth:`.Config.get_alembic_option` - includes pyproject support :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)rOrrrNset)r+sectionrkrws r/ruConfig.set_section_option]sE4++G44    ( ( 1 WE2r2cURRU5(d)[R"SUR<SU<S35eURR X5(aURR X5$U$)z9Return an option from the given section of the .ini file.zNo config file z found, or file has no '[z ]' section)rOrrrrZr! has_optionrX)r+rrkrls r/get_section_optionConfig.get_section_option{st++G44##$($9$97D     & &w 5 5##''6 6Nr2cgr5r=rjs r/get_main_optionConfig.get_main_options?Br2cgr5r=rjs r/rrr2c:URURX5$)aJReturn 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. Does **NOT** consume from the pyproject.toml file. .. seealso:: :meth:`.Config.get_alembic_option` - includes pyproject support )rr#rjs r/rrs &&t'>'>NNr2cgr5r=rjs r/get_alembic_optionConfig.get_alembic_optionsBEr2cgr5r=rjs r/rrrr2cURRURU5(a&URRURU5$UR XS9$)aIReturn an option from the "[alembic]" or "[tool.alembic]" section of the configparser-parsed .ini file (e.g. ``alembic.ini``) or toml-parsed ``pyproject.toml`` file. The value returned is expected to be None, string, list of strings, or dictionary of strings. Within each type of string value, the ``%(here)s`` token is substituted out with the absolute path of the ``pyproject.toml`` file, as are other tokens which are extracted from the :paramref:`.Config.config_args` dictionary. Searches always prioritize the configparser namespace first, before searching in the toml namespace. If Alembic was run using the ``-n/--name`` flag to indicate an alternate main section name, this is taken into account **only** for the configparser-parsed .ini file. The section name in toml is always ``[tool.alembic]``. .. versionadded:: 1.16.0 )rl)rOrr#rX_get_toml_config_valuerjs r/rrsV8    & &t'>'> E E##''(?(?F F..t.E Er2cDURRURU5(a)URRURU5S:H$URRUS5n[ U[ 5(d[R"SU<35eU$)NtrueFz*boolean value expected for TOML parameter ) rOrr#rXr^rYboolrrZrvs r/get_alembic_boolean_option!Config.get_alembic_boolean_options    & &t'>'> E E  $$T%<%[SUR5VVs0sHupgXgUR -_M snn5nU$[U[5(aU$[R"SU<35eU$s snnfs snnnfs snfs snnf)Nr list[str]zdict[str, str]z%unsupported TOML value type for key: ) objectr^rXrYrr(listr&rsr intrrZ)r+rkrl USE_DEFAULTrwdvkvs r/rConfig._get_toml_config_values h  $ $ ( ( ;   N  %%%0, +E4((Za$77#("'B>@XXZHZTQ00ZH"'& !#E%JEq4>>&:E%JE E4(($9>GQT^^,,G E3'' '';D8D %I &K Hs$F (FF F +F F c x[[[R"S[ UR SS5055$)zThe messaging options.quietF)r MessagingOptionsr immutabledictgetattrrr6s r/rBConfig.messaging_optss7    '$--%@A   r2cUHnURU5nUcM O gSS[RSSS.nXCnUS:Xa[R"S5 U$![ an[ SU<S U<S 35UeSnAff=f) N r@:;)spacenewlineosrrversion_path_separatorz[The version_path_separator configuration parameter is deprecated; please use path_separator'z' is not a valid value for z-; expected 'space', 'newline', 'os', ':', ';')rrpathseprwarn_deprecatedKeyError ValueError)r+namesrk separator split_on_pathsepkes r/_get_file_separator_charConfig._get_file_separator_charsD,,T2I$ **   *C//$$?J d$   sA A>$A99A>cURRURSSS9nU(aURSS5nUc=[R "S5 [ R"S5nURU5$URU5Vs/sHnU(dM UR5PM sn$[SURSS55$s snf)Nversion_locationsfallbackpath_separatorrzNo path_separator found in configuration; falling back to legacy splitting on spaces/commas for version_locations. Consider adding path_separator=os to Alembic config. , *|(?: +)r rOrXr#rrrrecompilesplitstripr r)r+version_locations_str split_char_split_on_space_commaxs r/get_version_locations_list!Config.get_version_locations_list(s $ 0 0 4 4  # #%84!5!  !66 ":J!$$;)+ =(A%,223HII388DDAGGID ++,?F  s  C!CcURRURSSS9nU(aURS5nUc=[R "S5 [ R"S5nURU5$URU5Vs/sHnU(dM UR5PM sn$[SURSS55$s snf)Nprepend_sys_pathrrzNo path_separator found in configuration; falling back to legacy splitting on spaces, commas, and colons for prepend_sys_path. Consider adding path_separator=os to Alembic config.z , *|(?: +)|\:rr)r+prepend_sys_path_strr_split_on_space_comma_colonrs r/get_prepend_sys_paths_list!Config.get_prepend_sys_paths_listKs#//33  # #%7$ 4  667GHJ!$$;/1jj9I.J+2889MNN277 CCAGGIC ++,>E  s  C Cc`/nURRS5(dW[SURS/55nUH3n[ U5nUR S5US'UR U5 M5 U$[R"S5nURS05nURURSS55nUH`nU(dM UV s0sH2n U RUS-5(dMU [U5S -SXi_M4 nn XS'UR U5 Mb U$s sn f) Npost_write_hookszlist[dict[str, str]]rk _hook_namerhooks.r)rOrrr rr&popappendrrrmrrX startswithlen) r+rtoml_hook_configcfgoptsrini_hook_configrrkkeys r/get_hooks_listConfig.get_hooks_listks<+-++,>??#&++,>C  (Cy%)XXf%5\" T"(0 %%'JJ}$= !"../A2FO)//##GR0E /.~~dSj1?CD A (/*>>. &*\" T" s D+6D+)rr'r!r#r$r%r(r")r,"Union[str, os.PathLike[str], None]r-rr.rr$zOptional[TextIO]r%rrrr'Mapping[str, Any]r)zOptional[Dict[str, Any]]returnNone)rzOptional[Path])rzDict[str, Any])rCrrDrrr)rr)rr)rr)rr).)rkrrlrrzOptional[Dict[str, str]])rkrrlDict[str, str]rr)rkrrlzMapping[str, str]rz(Union[Dict[str, str], Mapping[str, str]]r5)rkrrlOptional[Mapping[str, str]]rr)rkrrwrrr)rkrrr)rrrkrrwrrr)rrrkrrlr3rr3)rkrrlrrr)rkrrlr3rr3)rkrrlr3rFUnion[None, str, list[str], dict[str, str], list[dict[str, str]], int])rkrrr)rkrrlz Optional[Any]rr)rr)rrrr3)rzOptional[list[str]])rzlist[PostWriteHookConfig]))__name__ __module__ __qualname____firstlineno____doc__sysr%rrr0r__annotations__r!r"propertyr7r:r#memoized_propertyr)rFrOr^rdrgr rmrxr|rurrrrrrBrrrr__static_attributes__r=r2r/rrsbTp598<$*.(,)-););)=/3/1/6/ / ( /  /&/'/-/ /6%)H!( '+m*2$(NM( ++ )) #" &O. , & . 3),''"&' !''"0 77"37 177 AE 2 2"= 2 $ 2F"F3>AE  "% 0=   BB 26"/  37OO"/O O$EE 26"/  37FF"/F FB 37##"/# #J   @!F@!r2rc \rSrSr%S\S'Srg)rirrr=N)rrrrrrr=r2r/rrs Kr2rF)totalc.\rSrSr%SrS\S'SSjrSrg) CommandFunctionizA function that may be registered in the CLI as an alembic command. It must be a named function and it must accept a :class:`.Config` object as the first argument. .. versionadded:: 1.15.3 rrcgr5r=)r+configargskwargss r/__call__CommandFunction.__call__s#r2r=N)rrrrrrrr)rrrrrrrrr=r2r/rrsMMr2rc \rSrSr%SrSVSWSjjr0SSS\"S\S S 94_S S S \"\SS94_SS\"SSS94_SS\"\SS94_SS\"\SS94_SS\"SSS94_SS\"S S!S94_S"S#\"\S$S94_S%S&\"\S'S94_S(S)\"\S*S94_S+S,S-\"SS.S94_S/S0\"SS1S94_S2S3\"SS4S94_S5S6S7\"S8S9S94_S:S;S<\"SS=S94_S>S?\"SS@S94_SASB\"SSCS94_r\"SDSE9\"SFSE9\"SGSHSI9SJ.r \ RSKSL00r SM\ SN'SWSOjrSXSPjrSYSQjrSZSRjrS[SSjrSVS\STjjrSUrg)] CommandLineiz/Provides the command line interface to Alembic.Nc&URU5 gr5)_generate_args)r+progs r/r0CommandLine.__init__s D!r2templatez-tz --templategenericz"Setup template for use with 'init')rltypehelpmessagez-mz --messagez%Message string to use with 'revision')rrsqlz--sql store_truez\Don't emit SQL to database - dump to standard output/file instead. See docs on offline mode.actionrtagz--tagz@head to base new revision on.splicez--splicez6Allow a non-head revision as the 'head' to splice onto depends_onz --depends-onrzNSpecify 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-currentzIndicate the current revisionpurgez--purgez7Unconditionally erase the version table before stampingpackagez --packagezFWrite empty __init__.py files to the environment and version locationszlocation of scripts directoryrzrevision identifier+z/one or more revisions, or 'heads' for all heads)nargsr) directoryrevision revisionsr r!zdict[Any, dict[str, str]]_POSITIONAL_TRANSLATIONSc[US9nURSSS[-S9 URSSSS S 9 URS S [S SS9 URSSSS 9 URSSSS 9 URSSSSS 9 UR 5UlSS[ [555nUHnURU5 M X l g)Nrz --versionversionz %%(prog)s %s)r r%z-cz--configrzAlternate config file; defaults to value of ALEMBIC_CONFIG environment variable, or "alembic.ini". May also refer to pyproject.toml file. May be specified twice to reference both files separatelyr z-nz--namerzfName of section in .ini file to use for Alembic config (only applies to configparser config, not toml))rrlrz-xzlAdditional arguments consumed by custom env.py scripts, e.g. -x setting1=somesetting -x setting2=somesettingz --raiseerrr z!Raise a full stack trace on errorz-qz--quietzDo not log to std output.c3# UHYn[R"U5(dM URSS:wdM5URS:XdMG[ [ U5v M[ g7f)r_zalembic.commandN)inspect isfunctionrrr r).0fns r/ -CommandLine._generate_args..es\ G""2& &KKNc) & MM%66 &D" % %GsA#A#A# A#c3B# UHn[[U5v M g7fr5)rr)r*rks r/r,r-gsG,$ww--,s) r add_argumentrradd_subparsers subparsersdirrregister_commandparser)r+rr4alembic_commandsr+s r/rCommandLine._generate_args:sT*  >K3O     1     >    ;    4    ,  !//1 G#g,G #B  ! !" %# r2cURU5up#nURRURUS9nUR XU4S9 UH>nX`R ;dMUR UnUSSUSpUR "U0U D6 M@ UH2nURRU05n UR "U40U D6 M4 g)zRegisters a function as a CLI subcommand. The subcommand name matches the function name, the arguments are extracted from the signature and the help text is read from the docstring. .. versionadded:: 1.15.3 .. seealso:: :ref:`custom_commandline` r)cmdrN) _inspect_functionr1 add_parserr set_defaults _KWARGS_OPTSr/_POSITIONAL_OPTSrX) r+r+ positionalkwarg help_text subparserrD kwarg_optrrs r/r3CommandLine.register_commandts(,'='=b'A$ 9OO..r{{.K BE#:;C''' --c2 &q_imd&&55  C((,,S"5D  " "3 /$ /r2c[R"U5nUSb+USS[US5*nUS[US5*SnO USSSn/nXR;a.UVs/sH!nURUR XU5PM# nnUR nU(aQ/nUR S5H9nUR5(d O&URUR55 M; O/nSRU5n X4U 4$s snf)Nrrr@r) rinspect_getfullargspecrr"rXrrrrjoin) r+r+specr?r@rkhelp_ help_lineslinerAs r/r:CommandLine._inspect_functions,,R0 7 ac$q'l]3JGSa\MO,EaJE .. .'&D--b155dA&    J D)zz||%%djjl3 * JHHZ( )++'s%(D c vURup4nU"U/UVs/sHn[X&S5PM snQ70UVs0sHof[X&S5_M snD6 gs snfs snf![RaFnUR(ae[R "[ U540URD6 SnAgSnAff=fr5)r8rrrZraiseerrerrrrB)r+roptionsr+r?r@res r/run_cmdCommandLine.run_cmds '  :  5?@Z''d+Z@ :??Agg$//? @?   :Q96#8#89  :s2AA AA A AB82rstampr"rrr3r:rSr_rfrr=r2r/rrs9"A   !9  A    c G H A   #   A0   )  1A@   +  AAP   #M  QA^   8  _An   !  oA~   I  AL   J  MAZ     +D E [Ad  $ #B ! eAr   #(  sAD    H  EAT   #4  UAd   #N  eAr   #4  sALF>?& B   K0;78t06,> :& P''r2rc 0[US9RUS9 g)z(The console runner function for Alembic.r$)reN)rrf)rerrs r/rfrfsTT*r2__main__)NN)rerhrr3rrrr)) __future__rargparserr configparserrr(rpathlibrrrtypingrr r r r r rrrrtyping_extensionsrrrrrr util.pyfilesrrrPostWriteHookConfigrrrrfrr=r2r/rts"#%  '1m m `c3h'y Nh NP'P'h %)+ !+ ++ + zFr2