ɯeiFQ |ddlmZddlZddlZddlZddlZddlZddlmZddl m Z ddl m Z ddl mZmZmZmZmZddlmZddlZddlmZdd lmZdd lmZmZdd lmZmZmZm Z ed Z!ejDe#Z$ejJejLzZ'ejPejRzZ*d Z+d#dZ,GddeZ-GddeZ.GddZ/GddZ0e0dee.ee-ddgZ1e1jedejfe4e1jeddd$d Z5d!Z6gd"Z7y)%) annotationsN)Iterable) methodcaller)Path)AnyCallableLiteral NamedTupleTypeVar)warn)Table) IS_WINDOWS) CONFIG_FILECONNECTIONS_FILE)ConfigManagerErrorConfigSourceErrorErrorMissingConfigOptionError_T3SF_SKIP_WARNING_FOR_READ_PERMISSIONS_ON_CONFIG_FILEcXtjtdjdk(S)zECheck if the warning should be skipped based on environment variable.falsetrue)osgetenvSKIP_WARNING_ENV_VARlowerd/var/www/html/glpi_dashboard/venv/lib/python3.12/site-packages/snowflake/connector/config_manager.py8_should_skip_warning_for_read_permissions_on_config_filer!#s" 99)7 3 9 9 ;v EErc.eZdZUdZdZded<dZded<y)ConfigSliceOptionsz;Class that defines settings individual configuration files.Tboolcheck_permissionsF only_in_sliceN)__name__ __module__ __qualname____doc__r%__annotations__r&rrr r#r#(sE"t"M4rr#c,eZdZUded<ded<ded<y) ConfigSlicerpathr#optionsstrsectionN)r'r(r)r+rrr r-r-/s J  Lrr-ceZdZdZdddddd d dZd dZed dZed dZd dZ d d Z y) ConfigOptionaConfigOption represents a flag/setting. This class knows how to read the value out of all different sources and implements order of precedence between them. It also provides value parsing and verification. Attributes: name: Name of this ConfigOption. parse_str: A function that can turn str to the desired type, useful for reading value from environmental variable. choices: An iterable of all possible values that are allowed for this option. env_name: Environmental variable value should be read from, if not supplied, we'll construct this. False disables reading from environmental variables, None uses the auto generated variable name and explicitly provided string overwrites the default one. default: The value we should resolve to when the option is not defined in any of the sources. When it's None we treat that as there's no default value. _root_manager: Reference to the root manager. Used to efficiently refer to cached config file. Is supplied by the parent ConfigManager. _nest_path: The names of the ConfigManagers that this option is nested in. Used to be able to efficiently resolve where to retrieve value out of the configuration file and construct environment variable name. This is supplied by the parent ConfigManager. N) parse_strchoicesenv_namedefault _root_managerc| td| td||_||_||_||gz|_||_||_||_y)aCreate a config option that can read values from different sources. Args: name: Name to assign to this ConfigOption. parse_str: String parser function for this instance. choices: List of possible values for this instance. env_name: Environmental variable name value should be read from. Providing a string will use that environment variable, False disables reading value from environmental variables and the default None generates an environmental variable name for it using the _nest_path and name. default: Default value for the option. Used in case the value is is not defined in any of the sources. _root_manager: Reference to the root manager. Should be supplied by the parent ConfigManager. _nest_path: The names of the ConfigManagers that this option is nested in. This is supplied by the parent ConfigManager. Nz_root_manager cannot be Nonez_nest_path cannot be None) TypeErrornamer4r5 _nest_pathr8r6r7)selfr;r4r5r6r7r8r<s r __init__zConfigOption.__init__Ssa8  :; ;  78 8 " $v-,9   rc4d}|j\}}|s |j}d}|jr6||jvr(t d|j d|d|j|S#t$r|jd}|j}nYkwxYw)zuRetrieve a value of option. This function implements order of precedence between different sources. zenvironment variablezconfiguration file default_valuez The value of z read from z is not part of )_get_env _get_configrr7r5r option_name)r=source loaded_envvalues r rFzConfigOption.value{s ( MMO E ((*- <dj|jddS)zBUser-friendly name of the config option. Includes self._nest_path..N)joinr<r=s r rCzConfigOption.option_namesxx+,,rcnttd|jdd}ddj|S)z8The default environmental variable name for this option.upperrIN SNOWFLAKE__)maprr<rJ)r=piecess r default_env_namezConfigOption.default_env_names7\'*DOOAB,?@CHHV,-..rcP|jdury|j |j}n |j}tjj |}|y|}|j |j |}t |ttjfrd|jfSd|fS)zGet value from environment variable if possible. Returns whether it was able to load the data and the loaded value itself. F)FNT) r6rRrenvirongetr4 isinstancer tomlkit TOMLDocumentrF)r=r6env_var loaded_vars r rAzConfigOption._get_envs ==E ! == $}}H,,H**..* ?& >> %0J j5'*>*>"? @))) )Zrc|jj0|jj|jj|jj}|#t d|jj d|j ddD]} ||} t|ttjfr |jS|S#tjj$rtd|jdwxYw)zGet value from the cached config file if possible. Since this is the last resource for retrieving the value it raises a MissingConfigOptionError if it's unable to find this option. NzRoot manager 'z' is missing file_pathrIzConfiguration option 'zk' is not defined anywhere, have you forgotten to set it in a configuration file, or environmental variable?)r8conf_file_cache file_path read_configrr;r<rW exceptionsNonExistentKeyrrCrVr rXrF)r=eks r rBzConfigOption._get_configs    . . 6"",,8    * * ,    . . 9$ !3!3!8!8 99OP $ A aD  a%!5!56 777N%%44 .,T-=-=,>?11 s C  7D)r;r0r4zCallable[[str], _T] | Noner5zIterable[Any] | Noner6zstr | None | Literal[False]r7z Any | Noner8zConfigManager | Noner<zlist[str] | NonereturnNone)rcr)rcr0)rcztuple[bool, str | _T | None]) r'r(r)r*r>rFpropertyrCrRrArBrrr r3r35sB15(,04".2&&. & & & . &&,&%& &P0--//  2rr3ceZdZdZddd d dZeddZ d ddZed ddZ dd Z dd Z dd Z dd Z y) ConfigManagera Read a TOML configuration file with managed multi-source precedence. Note that multi-source precedence is actually implemented by ConfigOption. This is done to make sure that special handling can be done for special options. As an example, think of not allowing to provide passwords by command line arguments. This class is updatable at run-time, allowing other libraries to add their own configuration options and sub-managers before resolution. This class can simply be thought of as nestable containers for ConfigOptions. It holds extra information necessary for efficient nesting purposes. Sub-managers allow option groups to exist, e.g. the group "snowflake.cli.output" could have 2 options in it: debug (boolean flag) and format (a string like "json", or "csv"). When a ConfigManager tries to retrieve ConfigOptions' value the _root_manager will read and cache the TOML file from the file it's pointing at, afterwards updating the read cache can be forced by calling read_config. Attributes: name: The name of the ConfigManager. Used for nesting and emitting useful error messages. file_path: Path to the file where this and all child ConfigManagers should read their values out of. Can be omitted for all child managers. Root manager could also miss this value, but this will result in an exception when a value is read that isn't available from a preceding config source. conf_file_cache: Cache to store what we read from the TOML file. _sub_managers: List of ConfigManagers that are nested under the current manager. _sub_parsers: Alias for the old name of _sub_managers in the first release, please use the new name now, as this might get deprecated in the future. _options: List of ConfigOptions that are under the current manager. _root_manager: Reference to the root manager. Used to efficiently propagate to child options. _nest_path: The names of the ConfigManagers that this manager is nested under. Used to efficiently propagate to child options. _slices: List of config slices, where optional sections could be read from. Note that this feature might become deprecated soon. N)r]_slicesc| t}||_||_||_t |_t |_d|_||_|g|_ y)aCreates a new ConfigManager. Args: name: Name of this ConfigManager. file_path: File this manager should read values from. Can be omitted for all child managers. _slices: List of ConfigSlices to consider. A configuration file's slice is a section that can optionally reside in a different file. Note that this feature might get deprecated soon. N) listr;r]rhdict_options _sub_managersr\r8r<)r=r;r]rhs r r>zConfigManager.__init__sS" ?fG " 15 7;v<@-1&rcRtjdtd|jS)z Alias for the old name of ``_sub_managers``. This used to be the original name in the first release, please use the new name, as this might get deprecated in the future. z;_sub_parsers has been deprecated, use _sub_managers instead stacklevel)warningsr DeprecationWarningrmrKs r _sub_parserszConfigManager._sub_parsers!s'  I  !!!rc.|j tdtj}t | }t j |j|dff|jD]\}}}|jr||= |js) tsr|jrf|j!j"t$zdk7rB|j!}t'|j"dd}t)dt|d |ts0|jr$|j!j"t*zdk7s\t-t.d r|j!j0dk7rt|j!j0t/j2k7rEd t|d t|d t4d} t7st9dt|| tjdt| tj:|j=} || }| ||<||_ y#t$r&tjdt|dYwxYw#t>$r} t)dt|d| d} ~ wwxYw)a Read and cache config file contents. This function should be explicitly called if the ConfigManager's cache is outdated. Most likely when someone's doing development and are interactively adding new options to their configuration file. NzDConfigManager is trying to read config file, but it doesn't have oner%z%Fail to read configuration file from z- due to no permission on its parent directoryrzfile 'u' is writable by group or others — this poses a security risk because it allows unauthorized users to modify sensitive settings. Your Permission: getuidz(. * To change owner, run `chown $USER "z1"`. * To restrict permissions, run `chmod 0600 "z6"`. * To skip this warning, set environment variable z=true. zBad owner or permissions on z reading configuration file from z)An unknown error happened while loading '')!r]rrWrXr# itertoolschainrhr&existsPermissionErrorLOGGERdebugr0rr%statst_modeWRITABLE_BY_OTHERSoctrREADABLE_BY_OTHERShasattrrst_uidrxrr!r parse read_text Exceptionr\) r=skip_file_permissions_checkread_config_fileconfig_slice_optionsfilep sliceoptionsr1 file_statfile_permissions chmod_messageread_config_pieceras r r^zConfigManager.read_config0s >> !$ #//1 2"== -6OOnn2D 9 ; LL- 7 > (E<))$W- ||~& 22JJL((+==B!JJL #&y'8'8#9"##> 'SZL)}~N}OP  22JJL((+==BB) ++q0 ++ryy{:#LCPUJ<XJKNOTKUJVVMNbMcck!l OQ7E |M?ST LL;CJ<H I $+MM%//2C$D! #4 ,= )o7 >p 0_#  ;CJ._root_setter_helpers!%!3!3D "oo?DO#1188: 1 #K0 1--..0 H'+'9'9$$(OOf6G6G$G! HrN)rrg)rr;rm)r= new_childrs` @r add_submanagerzConfigManager.add_submanagers; ""9>>2-69>>* H I&rc^tjdtd|j|i|S)Nz=add_subparser has been deprecated, use add_submanager insteadrorp)rrr rsr)r=argsrs r add_subparserzConfigManager.add_subparsers1 K  #t""D3F33rc||jvr|j|jS||jvrtd|d|j|S)zGet either sub-manager, or option in this manager with name. If an option is retrieved, we call get() on it to return its value instead. Args: name: Name to retrieve. z>No ConfigManager, or ConfigOption can be found with the name 'ry)rlrFrmrrs r __getitem__zConfigManager.__getitem__sg 4== ==&,,. . t)) )###'&+ !!$''r)r;r0r]z Path | Nonerhzlist[ConfigSlice] | None)rczdict[str, ConfigManager])F)rr$rcrd)rztype[ConfigOption]rcrd)r;r0rcrd)rrgrcrd)rcrd)r;r0rczConfigOption | ConfigManager)r'r(r)r*r>rertr^r3rrrrrrrr rgrgs'Z"&,0 !! ! * !@ " " -2M0%)M0 M0d*64'4  4, '84(rrgCONFIG_MANAGERTrv connections)r;r]rh)r;r4r7default_connection_namer7)r;r7c td}td}||vr(td|dt|ji||S)NrrzDefault connection with name 'z"' cannot be found, known ones are )rrrjr)def_connection_namers r _get_default_connection_paramsrsh()BC /K+-,-@,AB/K$$&'( *  0k-. //rcz|dk(r"tjdtdtSt dt d|)N CONFIG_PARSERz=CONFIG_PARSER has been deprecated, use CONFIG_MANAGER insteadrorpzmodule z has no attribute )rrr rsrAttributeErrorr')r;s r __getattr__rs@  K   78,.@I JJr)r3rgrr)rcr$)rczdict[str, Any])8 __future__rrzloggingrrrrcollections.abcroperatorrpathlibrtypingrrr r r r rW tomlkit.itemsr snowflake.connector.compatrsnowflake.connector.constantsrrsnowflake.connector.errorsrrrrr getLoggerr'r~S_IRGRPS_IROTHrS_IWGRPS_IWOTHrrr!r#r-r3rgrrrrkrr__all__rrr rsC" $!>>1G T]   8 $\\DLL0\\DLL0LF   * __D|(|(~   "&       mm F  "  0K r