rPjjUddlmZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl mZddlmZmZmZmZmZmZmZddlmZddlmZmZmZdd lmZdd lm Z m!Z!dd l"m#Z#dd l$m%Z%dd l&m'Z'ddl(m)Z)ddl*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;mZ>ddl?m@Z@mAZAmBZBmCZCmDZDmEZEddlFmGZGmHZHedZIeZJdeKd<eZLdeKd<ejZNGddedZOeePeOjjzZGdde'ZRGddZSy) ) annotationsN) Namespace)Mapping)SimpleNamespace)AnyClassVarLiteralSelfTextIOTypeVarcast)WeakKeyDictionary) AliasChoices AliasPath ConfigDict) config_keys) deep_updateis_model_class)is_pydantic_dataclass) FieldInfo) BaseModel) SettingsError)ENV_FILE_SENTINELCliSettingsSourceConfigFileSourceTypeDefaultSettingsSourceDotenvFilteringDotEnvSettingsSource DotenvTypeEnvPrefixTargetEnvSettingsSourceInitSettingsSourceJsonConfigSettingsSourceNestedSecretsSettingsSourcePathTypePydanticBaseSettingsSource PydanticModel!PyprojectTomlConfigSettingsSourceSecretsSettingsSourceTomlConfigSettingsSourceYamlConfigSettingsSourceget_subcommand) InitState_get_alias_names_get_model_config_validate_by_alias_enabled_validate_by_name_enabled_warn_if_field_info_incomplete)_settings_debug_enabledloggerTz3WeakKeyDictionary[type[BaseSettings], BaseSettings]_settings_cachez5WeakKeyDictionary[type[BaseSettings], threading.Lock]_settings_cache_locksceZdZUded<ded<ded<ded<d ed <d ed <d ed<ded<d ed<ded<d ed<ded<d ed<ded<d ed<ded<ded<ded<ded<ded<ded<ded<ded <d!ed"<ded#<d$ed%<d&ed'<d(ed)<d*ed+<ded,<ded-<d ed.<d ed/<ded0<d1ed2<d ed3<d1ed4<d ed5<d ed6< d7ed8< d7ed9< d:ed;< d1ed<<d:ed=< ded><y?)@SettingsConfigDictboolcase_sensitive bool | None#nested_model_default_partial_updatestr env_prefixr!env_prefix_targetDotenvType | Noneenv_file str | Noneenv_file_encodingzDotenvFiltering | Nonedotenv_filteringenv_ignore_emptyenv_nested_delimiter int | Noneenv_nested_max_splitenv_parse_none_strenv_parse_enums cli_prog_name)bool | list[str] | tuple[str, ...] | Nonecli_parse_argscli_parse_none_strcli_hide_none_typecli_avoid_jsoncli_enforce_requiredcli_use_class_docs_for_groupscli_show_env_varscli_exit_on_error cli_prefixcli_flag_prefix_char'bool | Literal['dual', 'toggle'] | Nonecli_implicit_flagscli_ignore_unknown_args(bool | Literal['all', 'no_enums'] | Nonecli_kebab_case$Mapping[str, str | list[str]] | None cli_shortcutsPathType | None secrets_dirz%Literal['ok', 'warn', 'error'] | Nonesecrets_dir_missingsecrets_dir_max_sizesecrets_case_sensitivesecrets_prefixsecrets_nested_delimitersecrets_nested_subdirzConfigFileSourceType | None json_filejson_file_encoding yaml_fileyaml_file_encodingyaml_config_sectionintenv_file_depthpyproject_toml_depthtuple[str, ...]pyproject_toml_table_header toml_filetoml_table_headerenable_decodingN)__name__ __module__ __qualname____annotations__[/home/oem/CyberBrain26-unified/.venv/lib/python3.12/site-packages/pydantic_settings/main.pyr:r:>s1)44O&&!!,,$$$$""  ==""#''O??((<<77  >>$$''((&&**""**""## "10 +*&& rzr:F)totalceZdZUdZddddedddddddddddddddddddddddddf dCfd ZedDdZedEdZe dFdZ eddddedddddddddddddddddddddddddf dGdZ e dHdZ edId Z e dJd Ze dKd ZedLid dddddddddddddddddddddddddd dd!dd"dd#dd$dd%dd&dd'dd(dd)dd*dd+dd,d-d.dd/dd0dd1dd2dd3dd4dd5dd6dd7dd8dd9dd:dd;dddd?d@dAdZdBed <xZS)M BaseSettingsa( Base class for settings, allowing values to be overridden by environment variables. This is useful in production for secrets you do not wish to save in code, it plays nicely with docker(-compose), Heroku and any 12 factor app design. All the below attributes can be set via `model_config`. Args: _case_sensitive: Whether environment and CLI variable names should be read with case-sensitivity. Defaults to `None`. _nested_model_default_partial_update: Whether to allow partial updates on nested model default object fields. Defaults to `False`. _env_prefix: Prefix for all environment variables. Defaults to `None`. _env_prefix_target: Targets to which `_env_prefix` is applied. Default: `variable`. _env_file: The env file(s) to load settings values from. Defaults to `Path('')`, which means that the value from `model_config['env_file']` should be used. You can also pass `None` to indicate that environment variables should not be loaded from an env file. _env_file_encoding: The env file encoding, e.g. `'latin-1'`. Defaults to `None`. _env_file_depth: The number of parent directories of the current working directory to search for the env file if it is not found there. Defaults to `0` (no search). _env_ignore_empty: Ignore environment variables where the value is an empty string. Default to `False`. _env_nested_delimiter: The nested env values delimiter. Defaults to `None`. _env_nested_max_split: The nested env values maximum nesting. Defaults to `None`, which means no limit. _env_parse_none_str: The env string value that should be parsed (e.g. "null", "void", "None", etc.) into `None` type(None). Defaults to `None` type(None), which means no parsing should occur. _env_parse_enums: Parse enum field names to values. Defaults to `None.`, which means no parsing should occur. _cli_prog_name: The CLI program name to display in help text. Defaults to `None` if _cli_parse_args is `None`. Otherwise, defaults to sys.argv[0]. _cli_parse_args: The list of CLI arguments to parse. Defaults to None. If set to `True`, defaults to sys.argv[1:]. _cli_settings_source: Override the default CLI settings source with a user defined instance. Defaults to None. _cli_parse_none_str: The CLI string value that should be parsed (e.g. "null", "void", "None", etc.) into `None` type(None). Defaults to _env_parse_none_str value if set. Otherwise, defaults to "null" if _cli_avoid_json is `False`, and "None" if _cli_avoid_json is `True`. _cli_hide_none_type: Hide `None` values in CLI help text. Defaults to `False`. _cli_avoid_json: Avoid complex JSON objects in CLI help text. Defaults to `False`. _cli_enforce_required: Enforce required fields at the CLI. Defaults to `False`. _cli_use_class_docs_for_groups: Use class docstrings in CLI group help text instead of field descriptions. Defaults to `False`. _cli_show_env_vars: Show resolved environment variable names in CLI help text. Defaults to `False`. _cli_exit_on_error: Determines whether or not the internal parser exits with error info when an error occurs. Defaults to `True`. _cli_prefix: The root parser command line arguments prefix. Defaults to "". _cli_flag_prefix_char: The flag prefix character to use for CLI optional arguments. Defaults to '-'. _cli_implicit_flags: Controls how `bool` fields are exposed as CLI flags. - False (default): no implicit flags are generated; booleans must be set explicitly (e.g. --flag=true). - True / 'dual': optional boolean fields generate both positive and negative forms (--flag and --no-flag). - 'toggle': required boolean fields remain in 'dual' mode, while optional boolean fields generate a single flag aligned with the default value (if default=False, expose --flag; if default=True, expose --no-flag). _cli_ignore_unknown_args: Whether to ignore unknown CLI args and parse only known ones. Defaults to `False`. _cli_kebab_case: CLI args use kebab case. Defaults to `False`. _cli_shortcuts: Mapping of target field name to alias names. Defaults to `None`. _secrets_dir: The secret files directory or a sequence of directories. Defaults to `None`. _build_sources: Pre-initialized sources and init kwargs to use for building instantiation values. Defaults to `None`. Nc N||ns|jjdid|d|d|d|d|d|d|d|d | d | d | d | d | d|d|d|d|d|d|d|d|d|d|d|d|d|d|d|d|d|\} }!t"| di|jj | |!y) N_case_sensitive$_nested_model_default_partial_update _env_prefix_env_prefix_target _env_file_env_file_encoding_env_file_depth_env_ignore_empty_env_nested_delimiter_env_nested_max_split_env_parse_none_str_env_parse_enums_cli_prog_name_cli_parse_args_cli_settings_source_cli_parse_none_str_cli_hide_none_type_cli_avoid_json_cli_enforce_required_cli_use_class_docs_for_groups_cli_show_env_vars_cli_exit_on_error _cli_prefix_cli_flag_prefix_char_cli_implicit_flags_cli_ignore_unknown_args_cli_kebab_case_cli_shortcuts _secrets_dir _init_kwargsry) __class___settings_init_sourcessuper__init___settings_build_values)#__pydantic_self__rrrrrrrrrrrrrrrrrrrrrrrrrrrrr_build_sourcesvaluessources init_kwargsrs# r{rzBaseSettings.__init__sH) C",,CC /5Y($6  $  $6 !0#4'<'<%8"2 .!0&: %8!"%8#$!0%&'<'(0N)*$6+,$6-.(/0'<12%834*B56!078 .9:*;<$= J d,66MMgWbcdrzc t5tj|}|tt|cdddSt j|}|(t j |tj}ddd5t5tj|}ddd|}t5|t|<dddtt|cdddS#1swYjxYw#1swYOxYw#1swY:xYw#1swYyxYw)zReturn the cached default settings instance for this settings class. The instance is constructed on first use and reused afterwards. Subclasses are cached separately, so caching a class does not affect its parents or children. N) _settings_cache_guardr7getr r r8 setdefault threadingLock)clssettingslocks r{settings_cachedzBaseSettings.settings_cached&s# O&**3/H#D(+ O O),,S1D|,77Y^^=MN  O (& 4*..s3 45*4+3OC(4h' ( ( O O 4 444  ( (sL'C ?C DC,D5 C8?D C),C5 1D8D =DD cft5tj|ddddy#1swYyxYw)aRemove the cached default settings instance for this settings class, if any. Only the cache entry for this exact class is removed. Subclasses keep their own cached instances and must be cleared individually. A `settings_cached()` call already in flight may still return the instance it was building, so clearing does not retroactively invalidate references other threads hold. N)rr7pop)rs r{settings_clear_cachez!BaseSettings.settings_clear_cacheBs,# +   T * + + +s'0c||||fS)a Define the sources and their order for loading the settings values. Args: settings_cls: The Settings class. init_settings: The `InitSettingsSource` instance. env_settings: The `EnvSettingsSource` instance. dotenv_settings: The `DotEnvSettingsSource` instance. file_secret_settings: The `SecretsSettingsSource` instance. Returns: A tuple containing the sources and their order for loading the settings values. ry)r settings_cls init_settings env_settingsdotenv_settingsfile_secret_settingss r{settings_customise_sourcesz'BaseSettings.settings_customise_sourcesOs,lO=QQQrzcF ||n|jjd}||n|jjd} ||n|jjd}!||n|jjd}"|tk7r|n|jjd}#||n|jjd}$||n|jjd}%||n|jjd}&| | n|jjd }'| | n|jjd }(| | n|jjd })| | n|jjd }*| | n|jjd }+||n|jjd},||n|jjd}-||n|jjd}.|)s|.n|)}.||n|jjd}/||n|jjd}0||n|jjd}1||n|jjd}2||n|jjd}3||n|jjd}4||n|jjd}5||n|jjd}6||n|jjd}7||n|jjd}8||n|jjd}9||n|jjd}:||n|jjd};dti}t||| |!|'|(|&|)|*|>j ! }?t||#|$|%|| |!|'|(|&|)|*|?j " }@t||;|| |!|@j #}A|j||>|?|@|A$|=fz}B|BDCcgc]}Ct|CtsC}D}Ct|Dsqt|-tr|-fBz}Bny|,wtt|fid%Aj d |+d|,d|.d|/d|0d|1d|2d|3d|4d|5d|6d|7d|8d|9d|:d|d&|?}E|EfBz}Bn|,d'vrDd(js Dd(|,)|j!B|j|B||fSifScc}Cw)*Nr<r@rAr>rCrErnrGrHrJrKrLrMrOcli_settings_sourcerPrQrRrSrTrUrVrWrXrZr[r]r_rafield_info_ids)r> _init_state)rr>r) r<r@rArHrJrGrKrLr) rCrErnr<r@rArHrJrGrKrLr)rar<r@rAr)rrrrr_env_settings_sourceNFrargs) model_configrrsetrr#rr"rr*r isinstanceranyrenv_vars!_settings_warn_unused_config_keys)Frrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr<r@rAr>rCrErnrGrHrJrKrLrMrOrrPrQrRrSrTrUrVrWrXrZr[r]r_ra init_statedefault_settingsrrrrrsourcecustom_cli_sources cli_settingssF r{rz#BaseSettings._settings_init_sourcesgsqF-<,GSM]M]MaMabrMs$/$;[AQAQAUAUVbAc "4"@ cFVFVFZFZ[nFo  4? 1!!%%&KL , !*-> >9CDTDTDXDXYcDd"4"@ cFVFVFZFZ[nFo -<,GSM]M]MaMabrMs!2!> CDTDTDXDXYkDl &;%F !CL\L\L`L`awLx &;%F !CL\L\L`L`awLx $7#B HXHXH\H\]qHr /?.J*PSP`P`PdPdevPw*8*D#JZJZJ^J^_nJo ,;,GSM]M]MaMabrMs$8$D #JZJZJ^J^_tJu $7#B HXHXH\H\]qHr 8J/Oa#6#B HXHXH\H\]qHr -<,GSM]M]MaMabrMs%:%F !CL\L\L`L`awLx  .9 +!!%%&EF & #5"@ cFVFVFZFZ[nFo #5"@ cFVFVFZFZ[nFo %0$;[AQAQAUAUVbAc %:%F !CL\L\L`L`awLx $7#B HXHXH\H\]qHr  (3 %!!%%&?@ -<,GSM]M]MaMabrMs*8*D#JZJZJ^J^_nJo &2&>lCDTDTDXDXYfDg "235 9 0 5Xfp + (4(@ b0S(44  ) )!/!5!5-1+%11  / /))!/!5!5-1+$00  5 #)!/'33  00 '%+!5 1    4;djQb>cfdd%&-/@A.07:+05  4 @ @ #0 $2   (:   (:  $2 *> 3P '8 '8  * *> (: -D  $2! "#0# $$2% &*6'  *(/G3 = 09KA9N9W9W ! q !~ 6 --gs7G7GH (@ HHbHHCes TTc|rEi}i}i}|D]}t|tr"|j||j|t |dr |j nt |j }|}t|tr|}|||<t||}|jD cic]\} } | |vs || | k7s| | }} } tr4tjtjr|j||d} t| tr | j n t#} |j%|||| |SiScc} } w)Nru)rr'_set_current_state_set_settings_sources_datahasattrrutyperritemsr4r5 isEnabledForloggingDEBUG_settings_log_debugrr."_settings_restore_init_kwarg_names) rrrstatedefaultsstatesr source_name source_statekeyval last_sourcers r{rz#BaseSettings._settings_build_values.sD $&E')H02F! 9f&@A--e455f=181LfooRVW]R^RgRg %x f&;<+H&2{##L%8 9/4kkmk(#ss(?RV^_bVcgjVjS#XkEk&(V-@-@-O''/""+K4>{Lf4g00mvmxJ  2 23 UJ WL ls -E E cd|jdg}|jD]\}}|jd|d|tjdj |y)aLog the data collected by each settings source in priority order. Enabled by setting the ``PYDANTIC_SETTINGS_DEBUG`` environment variable to a truthy value. This is emitted at ``DEBUG`` level on the ``pydantic_settings`` logger. Warning: the output may contain sensitive values loaded from the environment, dotenv files, or secret files. Only enable it in a trusted debugging context. zResolving settings for z, (sources in priority order, highest first):z z:  N)rurappendr5debugjoin)rrlinesnamers r{rz BaseSettings._settings_log_debugTsd+3<<*::fgh"(,,. 8 D, LL2dV2l%56 7 8 TYYu%&rzc|rD|r@t|j}t|j}t|j}|jj D]\}}t |||t|||^} } t| } t|jr| j||| z} || z| sasdtt| } tfd| Dd}||vr|ntt}|j|}|hz D]}|j|d||| <yyy)z Restore the init_kwarg key names to the final merged state dictionary. This function renames keys in state to match the original init_kwargs key names, preserving the merged values from the source priority order. )validate_by_aliasc3,K|] }|vs| ywNry).0aliasstate_kwarg_names r{ zBBaseSettings._settings_restore_init_kwarg_names..s&cRbIbu&cs N) rkeysr1r model_fieldsrr3r/r2addnextiterr)rrrrstate_kwarg_namesinit_kwarg_namesr field_name field_info alias_names_matchable_namesinit_kwarg_name target_key source_keyvaluerrs @r{rz/BaseSettings._settings_restore_init_kwarg_namescsP 5 #EJJL 1 ";#3#3#56  :<;T;T U *6*C*C*I*I*K .& J.z:zR"2:z]n"o a"%k"2,\-F-FG#'' 3"2_"D#4#F "'7"&d?&;!AQ3QZW[\`aq\rWs !IIj1E/:,>- #t,-(-E*%3 . !;rzrcdfd }|td|td|td|td|tdy) a Warns if any values in model_config were set but the corresponding settings source has not been initialised. The list of alternative sources and their config keys can be found here: https://docs.pydantic.dev/latest/concepts/pydantic_settings/#other-settings-source Args: sources: The tuple of configured sources model_config: The model config to check for unused config keys c tfdDsT|D]N}j|tjd|djdjdt dPyy)Nc36K|]}t|ywr)r)rr source_types r{rz[BaseSettings._settings_warn_unused_config_keys..warn_if_not_used..sM6z&+6Msz Config key `z8` is set in model_config but will be ignored because no z5 source is configured. To use this config key, add a zH source to the settings sources via the settings_customise_sources hook.) stacklevel)rrwarningswarnru UserWarning)rrrrrs` r{warn_if_not_usedzHBaseSettings._settings_warn_unused_config_keys..warn_if_not_usedszMWMM C#'',8 *3%/g*3344i*3345??('(  Nrz)rhri)rorq)rrrs)rjrkrl)rbrcrdrerfrgN)rz type[PydanticBaseSettingsSource]rrpreturnNone)r$r)r+r,r%)rrr s`` r{rz.BaseSettings._settings_warn_unused_config_keyssJ  13VW:rCrErnrrGrHrJrKrLrMrOrPrQrRrSrTrUrVrWrX-rZr[r]r_rhrirjrkrlrrrarbrcrdrerfrgprotected_namespaces)model_validate model_dumprrrrtzClassVar[SettingsConfigDict])@rr=rr=rrDrEnvPrefixTarget | NonerrBrrDrrIrr=rrDrrIrrDrr=rrDrrNrCliSettingsSource[Any] | NonerrDrr=rr=rr=rr=rr=rr=rrDrrDrrYrr=rr\rr^rr`rzDtuple[tuple[PydanticBaseSettingsSource, ...], dict[str, Any]] | Nonerrr r )r r r r ) rtype[BaseSettings]rr'rr'rr'rr'r &tuple[PydanticBaseSettingsSource, ...])>rr=rr=rrDrrrrBrrDrrIrr=rrDrrIrrDrr=rrDrrNrrrrDrr=rr=rr=rr=rr=rr=rrDrrDrrYrr=rr\rr^rr`rzdict[str, Any] | Noner z=tuple[tuple[PydanticBaseSettingsSource, ...], dict[str, Any]])rrrdict[str, Any]r r)rzdict[str, dict[str, Any]]r r ) rrrrrrrr.r r )rztuple[object, ...]rr:r r ry)rurvrw__doc__rr classmethodrrrrrr staticmethodrrr:rrx __classcell__)rs@r{r~r~s9@(,<@"&59'8)-&*)-,0,0*.(,%)EI>B*.+/'+-16:*.*."&,0GK04DH?C(,_c?Ge$Ge/:Ge Ge 3 Ge % Ge'Ge$Ge'Ge *Ge *Ge(Ge&Ge#GeCGe ]?Ge@AGeB CGeR((6 + +R(R2R1 R 4 R 9 R 0RR.(,<@"&59'8)-&*)-,0,0*.(,%)EI>B*.+/'+-16:*.*."&,0GK04DH?C(,.2?DI$DI/:DI DI 3 DI % DI'DI$DI'DI *DI *DI(DI&DI#DICDI ,?DI@ GADIDIL#<#KY# ##J ' ').().#).). ).  ).).V' ' R2D4242 $4242 42  42 % 42-24242424242"42"42 4242 !42"#42$ %42&!'42()42*#+42,',-42. /42014223424!5426!7428!&942:;42<=42>?42@ A42BC42D E42F!G42HI42JK42L!M42N"O42P $Q42RS42T"&U42V#W42X Y42fg42L.4rzr~ceZdZUdZiZded<ejdZded<e ddZ e ddZ e dd Z e dd Z e d dd Ze d dd Ze d ddZe d ddZe d ddZy )CliAppz A utility class for running Pydantic `BaseSettings`, `BaseModel`, or `pydantic.dataclasses.dataclass` as CLI applications. z.CliAppBaseSettingsT)r>r<rQrRrSrZr]Nry)rurvrwrr:r) alias_config model_clssr{CliAppBaseSettingsr*s:''G-  48##'#%)#'# Lrzr-) issubclassr~r0rr)r,rrr-r+s` @r{_get_base_settings_clszCliApp._get_base_settings_clssn i .  0 :@@B U$Y/C;x4x J y "!' sA&c|r |jnd}t|trt|jn||gng}||r|j ||S)zDThe inputs a field validates from, in the order pydantic tries them.N)validation_aliasrrlistchoicesr)rrrr(raliasess r{_init_kwarg_aliaseszCliApp._init_kwarg_aliasessV 0A ++d#-e\#BD SXSdjl  =, NN: &rzc|D]E}t|tr|gn |j}|}|D]}t|tr; ||}|cSy#ttt f$rY`wxYw)zXFind the first alias present in `values`, following pydantic's `AliasPath` lookup rules.N)rr?pathKeyError IndexError TypeError)r4rrr7rrs r{_find_init_kwarg_aliaszCliApp._find_init_kwarg_alias"s E(4E7%**DE eS)!#JE     !*i8sA  A$#A$ctt|d)|r%tdtjd|dSt j r t j}|rW|jrGgdfd }tj|}|j|jr dt jSS#t$rd}YwxYw)NError: z class is missing z entrypointc tjy#t$r}j|Yd}~yd}~wwxYwr)asynciorun Exceptionr)ecommandexception_containermodels r{run_coroz%CliApp._run_cli_cmd..run_coroKs96 GEN3$6+221556s A>A)targetrr)getattrrrruinspectiscoroutinefunctionr?get_running_loop RuntimeError is_runningrThreadstartrr@)rEcli_cmd_method_name is_requiredlooprFthreadrCrDs` @@r{ _run_cli_cmdzCliApp._run_cli_cmd3s$u+':DA ?#gd5k.B.B-CCUViUjju$vwwL  & &w / //1)')#6#)):  &-a00 GEN+   EN 9   sC// C=<C=Nc 6t|s$t|std|jdd}|dn|}|/t |t t tfr ||}n0||}n&t |t t tfr tdt|tsFtj|} | j|||||\} } | j| | } | di| } t|}t|}t!|}i}g}| j"j%D]\}}tj'||||}tj)|| }|t+d |Dd}|Lt |t,r-|j/t1t2|j4d t7| |||<|D]}|j9|| ||di|}n$|j|||||\} } || | f }d }t+d | D}||j:|ftj<t?|< tjA||d}tj<t?|=|S#tj<t?|=wxYw)a Runs a Pydantic `BaseSettings`, `BaseModel`, or `pydantic.dataclasses.dataclass` as a CLI application. Running a model as a CLI application requires the `cli_cmd` method to be defined in the model class. Args: model_cls: The model class to run as a CLI application. cli_args: The list of CLI arguments to parse. If `cli_settings_source` is specified, this may also be a namespace or dictionary of pre-parsed CLI arguments. Defaults to `sys.argv[1:]`. cli_settings_source: Override the default CLI settings source with a user defined instance. Defaults to `None`. cli_exit_on_error: Determines whether this function exits on error. If model is subclass of `BaseSettings`, defaults to BaseSettings `cli_exit_on_error` value. Otherwise, defaults to `True`. cli_show_env_vars: Show resolved environment variable names in CLI help text. Defaults to `False`. cli_cmd_method_name: The CLI command method name to run. Defaults to "cli_cmd". model_init_data: The model init data. Returns: The ran instance of model. Raises: SettingsError: If model_cls is not subclass of `BaseModel` or `pydantic.dataclasses.dataclass`. SettingsError: If model_cls does not have a `cli_cmd` entrypoint defined. r=z? is not subclass of BaseModel or pydantic.dataclasses.dataclassNT) parsed_argsrzRError: `cli_args` must be list[str] or None when `cli_settings_source` is not used)rrrrrc3BK|]}t|ts|ywr)rr?)rrs r{rzCliApp.run..s!WE 5RU@V%!Wr)r :subcommandc3BK|]}t|ts|ywr)rr)rrs r{rzCliApp.run..s"if:fVgCh6"irXFrQry)!rrrrurrrdictr.r~r#r/rrr0r1r2rrr5r;rrrr r?r7rHr root_parserr$idrT)r,cli_argsrrVrUrPmodel_init_datarrObase_settings_clsrrrrEconfigrr(alias_path_rootsrrr4rrootrCsubcommand_dest data_models r{r@z CliApp.runasF&i0N94M),,--lm  !)!1x  *.9ot*LM2~N 2G OT(J K tu u)\2 & = =i H #4#K#K .#4#4%1, $L$ G['==g{SF%//E&y1F :6 B 8@  O! *;*H*H*N*N*P H& J 44ZM^`pq55gvF=!!WW!WY]^E} eY/$++Dejjm,DE-4UJ-GOE* H) ? **4> ? 2/2G#,#C#C .#4#4%1, $D$ G[ /EFG'""i"ii1DFYFeFegv0w  G- 6,,W6IW\,]J((G5((G5s I<<Jcbt|tjvr!tjt|\}}}n>tttj t ||}|j}d}| |jn|}g}t|d||}|rS|d} | j@| j4|j(| d|j|} t | | d| tt tt |} |j|| } | j d}| j"} || |ftjt|< tj%||d }tjt|=|S#tjt|=wxYw) a Runs the model subcommand. Running a model subcommand requires the `cli_cmd` method to be defined in the nested model subcommand class. Args: model: The model to run the subcommand from. cli_exit_on_error: Determines whether this function exits with error if no subcommand is found. Defaults to model_config `cli_exit_on_error` value if set. Otherwise, defaults to `True`. cli_show_env_vars: Show resolved environment variable names in CLI help text. Defaults to `False`. cli_cmd_method_name: The CLI command method name to run. Defaults to "cli_cmd". Returns: The ran subcommand model. Raises: SystemExit: When no subcommand is found and cli_exit_on_error=`True` (the default). SettingsError: When no subcommand is found and cli_exit_on_error=`False`. )rUrYNT)rQrV_suppress_errorsrrz .:subcommandr[)r^r#r$rrr/rr]rVr- __context__ __cause__ _format_helpr r _parser_mapdestparserrT)rErVrUrPrrnreerrors subcommanderr error_messagesubcommand_clssubcommand_argsubcommand_parserrfs r{run_subcommandzCliApp.run_subcommands4 e900 0;A;S;STVW\T];^ 8 "3C"8--d5k:"3# )44F+OEVE^/AAdu35# t7H[a  )C&3==+@EXEeEeEq#&%r*=*J*J6*R)S T d3i .D8Id9otJ/?@,88I.Y+001>*114GIZ\k3l  J0 9,,Z9LZ^,_J((J8((J8s FF.ctjt|}tt|j ||||}tj ||S)a Serializes the CLI arguments for a Pydantic data model. Args: model: The data model to serialize. list_style: Controls how list-valued fields are serialized on the command line. - 'json' (default): Lists are encoded as a single JSON array. Example: `--tags '["a","b","c"]'` - 'argparse': Each list element becomes its own repeated flag, following typical `argparse` conventions. Example: `--tags a --tags b --tags c` - 'lazy': Lists are emitted as a single comma-separated string without JSON quoting or escaping. Example: `--tags a,b,c` dict_style: Controls how dictionary-valued fields are serialized. - 'json' (default): The entire dictionary is emitted as a single JSON object. Example: `--config '{"host": "localhost", "port": 5432}'` - 'env': The dictionary is flattened into multiple CLI flags using environment-variable-style assignment. Example: `--config host=localhost --config port=5432` positionals_first: Controls whether positional arguments should be serialized first compared to optional arguments. Defaults to `False`. Returns: The serialized CLI arguments for the data model. ) list_style dict_stylepositionals_first)r#r/rrr_serialized_args_flatten_serialized_args)rErxryrzraserialized_argss r{ serializezCliApp.serializes]R#99$u+F+C01BCTT !!/ U  !99/K\]]rzct|tr|n t|}|ht|ts:t|tjvrtjt|^}}nt tj |}|j|j}|s|Stjjd|S)a Return a string containing a help message for a Pydantic model. Args: model: The model or model class. cli_settings_source: Override the default CLI settings source with a user defined instance. Defaults to `None`. strip_ansi_color: Strips ANSI color codes from the help message when set to `True`. Returns: The help message string for the model. r) rrr^r#r$rr/rkr]r%sub)rErstrip_ansi_colorr,r help_messages r{ format_helpzCliApp.format_help:s$(t4E$u+  &eT*r%yFB!&b&b:bb bb4>B"!&  & :       rzr#)T __future__r _annotationsr?rIrrrrargparsercollections.abcrtypesrtypingrrr r r r r weakrefrpydanticrrrpydantic._internal._configrpydantic._internal._utilsrrpydantic.dataclassesrpydantic.fieldsr pydantic.mainr exceptionsrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r- sources.utilsr.r/r0r1r2r3utilsr4r5r6r7rxr8rrr:rrr~r#ryrzr{rs2 #!FFF%882A6%#%,3 CLGXGZDZO`ObLb& (T5Tz s%55::<== O 9O d} } rz