o
    ‹ôjˆ˜  ã                   @   sþ  U d Z ddlZddlZddlZddl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dlmZmZmZmZmZmZmZmZmZmZmZmZmZ ddlZdd	lm Z m!Z!m"Z" dd
l#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9 ddl:m;Z;m<Z<m=Z=m>Z>m?Z? ddl@mAZA ddlBmCZCmDZDmEZEmFZF ddlGmHZHmIZImJZJmKZKmLZLmMZMmNZNmOZOmPZP dZQeeRd< edef ZSdeTdefdd„ZUdeTdefdd„ZVd4dd„ZWG dd„ dƒZXeWƒ  ede=deeeT eTf deeeeY  eeY f dee=ddf fdd „ƒZZede=dee=ddf fd!d"„ƒZ[ede<dee<ddf fd#d$„ƒZ\efd%ee; d&eYd'ed(ed)ede=fd*d+„Z]d)ed(ed'ed&eYd%eeA de=fd,d-„Z^	.d5d/e<d(eTd0eYd1eYdeee= eeTe_f f f
d2d3„Z`dS )6zOmegaConf moduleé    N)Údefaultdict)Úcontextmanager)ÚEnum)Údedent)ÚIOÚAnyÚCallableÚDictÚ	GeneratorÚIterableÚListÚOptionalÚSetÚTupleÚTypeÚUnionÚoverloadé   )Ú
DictConfigÚDictKeyTypeÚ
ListConfig)Ú_DEFAULT_MARKER_Ú_ensure_containerÚ
_get_valueÚformat_and_raiseÚget_dict_key_value_typesÚget_list_element_typeÚget_omega_conf_dumperÚget_type_ofÚis_attr_classÚis_dataclassÚis_dict_annotationÚis_intÚis_list_annotationÚis_primitive_containerÚis_primitive_dictÚis_primitive_listÚis_structured_configÚis_tuple_annotationÚis_union_annotationÚnullcontextÚ	split_keyÚtype_str)ÚBoxÚ	ContainerÚNodeÚSCModeÚ	UnionNode)ÚBaseContainer)ÚMissingMandatoryValueÚOmegaConfBaseExceptionÚUnsupportedInterpolationTypeÚValidationError)	ÚAnyNodeÚBooleanNodeÚ	BytesNodeÚEnumNodeÚ	FloatNodeÚIntegerNodeÚPathNodeÚ
StringNodeÚ	ValueNodez???ÚMISSING.ÚinterpolationÚreturnc                 C   s   d|  d S )zt
    Equivalent to ``${interpolation}``

    :param interpolation:
    :return: input ``${node}`` with type Any
    ú${Ú}© ©rA   rE   rE   úf/var/www/html/academy/tools/voices/clone/cosy-venv/lib/python3.10/site-packages/omegaconf/omegaconf.pyÚIIQ   s   rH   c                 C   s   | S )z¸
    Use this for String interpolation, for example ``"http://${host}:${port}"``

    :param interpolation: interpolation string
    :return: input interpolation with type ``Any``
    rE   rF   rE   rE   rG   ÚSI[   ó   rI   c                  C   sv   ddl m}  t d| j¡ t d| j¡ t d| j¡ t d| j¡ t d| j¡ t d| j	j
¡ t d	| j	j¡ d S )
Nr   ©Úocz	oc.createz	oc.decodezoc.deprecatedzoc.envz	oc.selectzoc.dict.keyszoc.dict.values)Zomegaconf.resolversrL   Ú	OmegaConfÚregister_new_resolverÚcreateÚdecodeÚ
deprecatedÚenvÚselectÚdictÚkeysÚvaluesrK   rE   rE   rG   Úregister_default_resolverse   s   rW   c                   @   s  e Zd ZdZd�dd„Ze		d‚dedee dee	e
ef  defd	d
„ƒZee		d‚de
dee dee	e
ef  deeef fdd„ƒƒZee		d‚deee eedf f dee dee	e
ef  defdd„ƒƒZee		d‚dedee dee	e
ef  defdd„ƒƒZee		d‚dedee dee	e
ef  defdd„ƒƒZee			dƒdee	eef  dee dee	e
ef  defdd„ƒƒZeeddfdedee dee	e
ef  deeef fdd„ƒZedee
ejee f deeef fdd„ƒZe	d„dedee
ejee f deddfdd„ƒZed…deee
  defdd„ƒZedee
 defd d!„ƒZed"eeee	eef ee eedf ef deeef fd#d$„ƒZed"eeee	eef ee eedf ef deeef fd%d&„ƒZed'e
d(eddfd)d*„ƒZ ed'e
d(eddfd+d,„ƒZ!eddd-œd'e
d(ed.ed/eddf
d0d1„ƒZ"e#d'e
defd2d3„ƒZ$ed�d4d5„ƒZ%e#d'e
defd6d7„ƒZ&ed8ede	e
ef fd9d:„ƒZ'ed8ed;e	e
ef ddfd<d=„ƒZ(ed8eddfd>d?„ƒZ)ed@edAeddfdBdC„ƒZ*ed8e+dDee ddfdEdF„ƒZ,ed8e+dee fdGdH„ƒZ-ed8e.dDee ddfdIdJ„ƒZ/ed8e.dee fdKdL„ƒZ0ed8edMee
ee
 f defdNdO„ƒZ1eddde2j3dPœdQededRedSedTe2dee	eef ee de
ef fdUdV„ƒZ4edQedee	eef ee de
ef fdWdX„ƒZ5edQedYedefdZd[„ƒZ6ed…d\edYeee7e
f  defd]d^„ƒZ8ededefd_d`„ƒZ9ededefdadb„ƒZ:ededefdcdd„ƒZ;ed…dedYee
 dee<e  fdedf„ƒZ=eedgddhœdQe.dYe
diedjedRedefdkdl„ƒZ>e	d…dgddmœdQe.dYe
dDednedoeddfdpdq„ƒZ?edddrœdQededsede
fdtdu„ƒZ@edQe.ddfdvdw„ƒZAedQedeBe
 fdxdy„ƒZCeeddfdedee dee	e
ef  deeef fdzd{„ƒZDed|edee<e  fd}d~„ƒZEed'e
deeFe.e.e+eedf ee
df gef  fdd€„ƒZGdS )†rM   zOmegaConf primary classrB   Nc                 C   s   t dƒ‚)Nz,Use one of the static construction functions)ÚNotImplementedError)ÚselfrE   rE   rG   Ú__init__t   s   zOmegaConf.__init__ÚobjÚparentÚflagsc                 C   s   t  | ||¡S ©N)rM   rO   ©r[   r\   r]   rE   rE   rG   Ú
structuredw   s   zOmegaConf.structuredc                 C   ó   d S r^   rE   r_   rE   rE   rG   rO      rJ   zOmegaConf.create.c                 C   ra   r^   rE   r_   rE   rE   rG   rO   ˆ   rJ   c                 C   ra   r^   rE   r_   rE   rE   rG   rO   ‘   rJ   c                 C   ra   r^   rE   r_   rE   rE   rG   rO   š   rJ   c                 C   ra   r^   rE   r_   rE   rE   rG   rO   £   rJ   c                 C   s   t j| ||d�S )Nr_   )rM   Ú_create_implr_   rE   rE   rG   rO   ¬   s
   ýÚfile_c                 C   sÚ   ddl m} t| ttjfƒr3tjtj	 
| ¡ddd��}tj||ƒ d�}W d   ƒ n1 s-w   Y  nt| dd ƒrBtj| |ƒ d�}ntdƒ‚|d ur\t|tttfƒs\td	t|ƒj› �ƒ‚|d u rft ¡ }|S t |¡}|S )
Nr   ©Úget_yaml_loaderÚrúutf-8©Úencoding©ÚLoaderÚreadúUnexpected file typezInvalid loaded object type: )Ú_utilsre   Ú
isinstanceÚstrÚpathlibÚPathÚioÚopenÚosÚpathÚabspathÚyamlÚloadÚgetattrÚ	TypeErrorÚlistrT   ÚIOErrorÚtypeÚ__name__rM   rO   )rc   re   Úfr[   ÚretrE   rE   rG   ry   ¸   s$   ÿ€ÿ
ÿzOmegaConf.loadFÚconfigr€   Úresolvec                 C   s¨   t | ƒst| ƒrt | ¡} tj| |d�}t|ttjfƒr@t	j
tj |¡ddd��}| |¡ W d  ƒ dS 1 s9w   Y  dS t|dƒrP| |¡ | ¡  dS tdƒ‚)zù
        Save as configuration object to a file

        :param config: omegaconf.Config object (DictConfig or ListConfig).
        :param f: filename or file object
        :param resolve: True to save a resolved config (defaults to False)
        )rƒ   Úwrg   rh   NÚwriterm   )r    r   rM   rO   Úto_yamlro   rp   rq   rr   rs   rt   ru   rv   rw   r…   ÚhasattrÚflushr{   )r‚   r€   rƒ   ÚdataÚfilerE   rE   rG   ÚsaveÐ   s   
"ÿ

zOmegaConf.saveÚ	args_listc                 C   s    | d u rt jdd … } t | ¡S )Nr   )ÚsysÚargvrM   Úfrom_dotlist)rŒ   rE   rE   rG   Úfrom_cliç   s   
zOmegaConf.from_cliÚdotlistc                 C   s   t  ¡ }| | ¡ |S )a  
        Creates config from the content sys.argv or from the specified args list of not None

        :param dotlist: A list of dotlist-style strings, e.g. ``["foo.bar=1", "baz=qux"]``.
        :return: A ``DictConfig`` object created from the dotlist.
        )rM   rO   Úmerge_with_dotlist)r‘   ÚconfrE   rE   rG   r�   î   s   
zOmegaConf.from_dotlistÚconfigsc                  G   s˜   t | ƒdksJ ‚t | d ¡}t|ƒ}t|ttfƒsJ ‚t|ddƒ� |j| dd… Ž  | 	d¡du }W d  ƒ n1 s=w   Y  |rJt
 |d¡ |S )z 
        Merge a list of previously created configs into a single one

        :param configs: Input configs
        :return: the merged config object.
        r   ÚreadonlyFr   NT)ÚlenÚcopyÚdeepcopyr   ro   r   r   Úflag_overrideÚ
merge_withÚ	_get_flagrM   Úset_readonly©r”   ÚtargetZturned_readonlyrE   rE   rG   Úmergeú   s   þzOmegaConf.mergec                  G   sš   t | ƒdksJ ‚| d }t|ƒ}t|ttfƒsJ ‚t|ddgddgƒ� |j| dd… Ž  | d¡du }W d  ƒ n1 s>w   Y  |rKt 	|d¡ |S )a^  
        Merge a list of previously created configs into a single one
        This is much faster than OmegaConf.merge() as the input configs are not copied.
        However, the input configs must not be used after this operation as will become inconsistent.

        :param configs: Input configs
        :return: the merged config object.
        r   r•   Úno_deepcopy_set_nodesFTr   N)
r–   r   ro   r   r   r™   rš   r›   rM   rœ   r�   rE   rE   rG   Úunsafe_merge  s   ÿüzOmegaConf.unsafe_mergeÚnameÚresolverc                 C   s   t jtdƒdd� t | |¡S )Nz”            register_resolver() is deprecated.
            See https://github.com/omry/omegaconf/issues/426 for migration instructions.
            é   )Ú
stacklevel)ÚwarningsÚwarnr   rM   Úlegacy_register_resolver©r¢   r£   rE   rE   rG   Úregister_resolver<  s   ÿù	zOmegaConf.register_resolverc                    sp   t ˆƒsJ dƒ‚ˆ tjvsJ dˆ › d�ƒ‚dtdtdtdttdf d	ttdf d
tf‡ ‡fdd„}|tjˆ < d S )Núresolver must be callableú
resolver 'ú' is already registeredr‚   r\   ÚnodeÚargs.Úargs_strrB   c           
         s„   t  | ¡ˆ  }dd„ |D ƒ}ztdd„ |D ƒƒ}W n	 ty"   Y nw tdˆ › d|› d�ƒ‚|}||v r8|| nˆ|Ž }	|	||< |	S )Nc                 S   s    g | ]}|  d d¡  dd¡‘qS )z\ ú z\,ú,)Úreplace)Ú.0ÚxrE   rE   rG   Ú
<listcomp>[  s     zPOmegaConf.legacy_register_resolver.<locals>.resolver_wrapper.<locals>.<listcomp>c                 s   s   � | ]	}d |v r|V  qdS )rC   NrE   )r´   ÚirE   rE   rG   Ú	<genexpr>a  s   € zOOmegaConf.legacy_register_resolver.<locals>.resolver_wrapper.<locals>.<genexpr>z
Resolver 'z' was called with argument 'a  ' that appears to be an interpolation. Nested interpolations are not supported for resolvers registered with `[legacy_]register_resolver()`, please use `register_new_resolver()` instead (see https://github.com/omry/omegaconf/issues/426 for migration instructions).)rM   Ú	get_cacheÚnextÚStopIterationÚ
ValueError)
r‚   r\   r®   r¯   r°   ÚcacheZ
args_unescÚbad_argÚkeyÚvalr©   rE   rG   Úresolver_wrapperR  s   ÿÿz<OmegaConf.legacy_register_resolver.<locals>.resolver_wrapper)Úcallabler2   Ú
_resolversr/   r   r   rp   )r¢   r£   rÁ   rE   r©   rG   r¨   J  s$   
ÿÿþý
ü
ûú z"OmegaConf.legacy_register_resolver)r³   Ú	use_cacher³   rÄ   c                   sÞ   t ˆƒstdƒ‚ˆ stdƒ‚|st ˆ ¡rtdˆ › d�ƒ‚zt ˆ¡‰W n ty/   d‰Y nw dtdtf‡‡fdd	„}|d
ƒ‰|dƒ‰|dƒ‰dt	dt
dtdttdf dttdf dtf‡ ‡‡‡‡‡fdd„}|t	jˆ < dS )aë  
        Register a resolver.

        :param name: Name of the resolver.
        :param resolver: Callable whose arguments are provided in the interpolation,
            e.g., with ${foo:x,0,${y.z}} these arguments are respectively "x" (str),
            0 (int) and the value of ``y.z``.
        :param replace: If set to ``False`` (default), then a ``ValueError`` is raised if
            an existing resolver has already been registered with the same name.
            If set to ``True``, then the new resolver replaces the previous one.
            NOTE: The cache on existing config objects is not affected, use
            ``OmegaConf.clear_cache(cfg)`` to clear it.
        :param use_cache: Whether the resolver's outputs should be cached. The cache is
            based only on the string literals representing the resolver arguments, e.g.,
            ${foo:${bar}} will always return the same value regardless of the value of
            ``bar`` if the cache is enabled for ``foo``.
        r«   z!cannot use an empty resolver namer¬   r­   NÚspecialrB   c                    s,   ˆ d uo| ˆ j v }|rˆrtd| › �ƒ‚|S )Nz?use_cache=True is incompatible with functions that receive the )Ú
parametersr¼   )rÅ   r�   )ÚsigrÄ   rE   rG   Ú_should_passš  s   ÿz5OmegaConf.register_new_resolver.<locals>._should_passÚ_parent_Ú_node_Ú_root_r‚   r\   r®   r¯   .r°   c                    sv   ˆrt  | ¡ˆ  }z|| W S  ty   Y nw i }ˆr ||d< ˆr&||d< ˆr,| |d< ˆ|i |¤Ž}ˆr9|||< |S )NrÉ   rÊ   rË   )rM   r¹   ÚKeyError)r‚   r\   r®   r¯   r°   r½   Úkwargsr�   )r¢   Ú	pass_nodeÚpass_parentÚ	pass_rootr£   rÄ   rE   rG   rÁ   ¦  s$   
ÿz9OmegaConf.register_new_resolver.<locals>.resolver_wrapper)rÂ   r{   r¼   rM   Úhas_resolverÚinspectÚ	signaturerp   Úboolr2   r.   r/   r   r   rÃ   )r¢   r£   r³   rÄ   rÈ   rÁ   rE   )r¢   rÎ   rÏ   rÐ   r£   rÇ   rÄ   rG   rN   t  s:   ÿÿþý
ü
ûúzOmegaConf.register_new_resolverc                 C   s   |   |¡d uS r^   )Ú_get_resolver©Úclsr¢   rE   rE   rG   rÑ   Æ  s   zOmegaConf.has_resolverc                   C   s   i t _tƒ  dS )zh
        Clear(remove) all OmegaConf resolvers, then re-register OmegaConf's default resolvers.
        N)r2   rÃ   rW   rE   rE   rE   rG   Úclear_resolversË  s   
zOmegaConf.clear_resolversc                 C   s   |   |¡rtj |¡ dS dS )ap  
        Clear(remove) any resolver only if it exists.

        Returns a bool: True if resolver is removed and False if not removed.

        .. warning:
            This method can remove deafult resolvers as well.

        :param name: Name of the resolver.
        :return: A bool (``True`` if resolver is removed, ``False`` if not found before removing).
        TF)rÑ   r2   rÃ   ÚpoprÖ   rE   rE   rG   Úclear_resolverÓ  s   
zOmegaConf.clear_resolverr“   c                 C   s   | j jS r^   )Ú	_metadataÚresolver_cache©r“   rE   rE   rG   r¹   ç  s   zOmegaConf.get_cacher½   c                 C   s   t  |¡| j_d S r^   )r—   r˜   rÛ   rÜ   )r“   r½   rE   rE   rG   Ú	set_cacheë  s   zOmegaConf.set_cachec                 C   s   t  | tti ƒ¡ d S r^   )rM   rÞ   r   rT   rÝ   rE   rE   rG   Úclear_cacheï  ó   zOmegaConf.clear_cacheÚfrom_configÚ	to_configc                 C   s   t  |t  | ¡¡ d S r^   )rM   rÞ   r¹   )rá   râ   rE   rE   rG   Ú
copy_cacheó  rà   zOmegaConf.copy_cacheÚvaluec                 C   ó   |   d|¡ d S ©Nr•   ©Ú	_set_flag©r“   rä   rE   rE   rG   rœ   ÷  ó   zOmegaConf.set_readonlyc                 C   ó
   |   d¡S ræ   ©r›   rÝ   rE   rE   rG   Úis_readonlyü  ó   
zOmegaConf.is_readonlyc                 C   rå   ©NÚstructrç   ré   rE   rE   rG   Ú
set_struct  rê   zOmegaConf.set_structc                 C   rë   rï   rì   rÝ   rE   rE   rG   Ú	is_struct  rî   zOmegaConf.is_structrU   c                 C   sP   ddl m} t| |ƒstdƒ‚t|tƒr|g}dd„ | jd|d�D ƒ}||d�S )	zè
        Create a masked copy of of this config that contains a subset of the keys

        :param conf: DictConfig object
        :param keys: keys to preserve in the copy
        :return: The masked ``DictConfig`` object.
        r   ©r   z,masked_copy is only supported for DictConfigc                 S   s   i | ]\}}||“qS rE   rE   )r´   r¿   rä   rE   rE   rG   Ú
<dictcomp>  ó    z)OmegaConf.masked_copy.<locals>.<dictcomp>F)rƒ   rU   )Úcontent)Ú
dictconfigr   ro   r¼   rp   Úitems_ex)r“   rU   r   rö   rE   rE   rG   Úmasked_copy  s   	


zOmegaConf.masked_copy©rƒ   Úthrow_on_missingÚenum_to_strÚstructured_config_modeÚcfgrû   rü   rý   c                C   s6   t  | ¡stdtt| ƒƒ› d�ƒ‚tj| ||||d�S )a™  
        Resursively converts an OmegaConf config to a primitive container (dict or list).

        :param cfg: the config to convert
        :param resolve: True to resolve all values
        :param throw_on_missing: When True, raise MissingMandatoryValue if any missing values are present.
            When False (the default), replace missing values with the string "???" in the output container.
        :param enum_to_str: True to convert Enum keys and values to strings
        :param structured_config_mode: Specify how Structured Configs (DictConfigs backed by a dataclass) are handled.
            - By default (``structured_config_mode=SCMode.DICT``) structured configs are converted to plain dicts.
            - If ``structured_config_mode=SCMode.DICT_CONFIG``, structured config nodes will remain as DictConfig.
            - If ``structured_config_mode=SCMode.INSTANTIATE``, this function will instantiate structured configs
              (DictConfigs backed by a dataclass), by creating an instance of the underlying dataclass.

          See also OmegaConf.to_object.
        :return: A dict or a list representing this config as a primitive container.
        z-Input cfg is not an OmegaConf config object (ú)rú   )rM   Ú	is_configr¼   r,   r~   r2   Ú_to_content©rþ   rƒ   rû   rü   rý   rE   rE   rG   Úto_container  s   
ÿûzOmegaConf.to_containerc                 C   s   t j| dddtjd�S )a  
        Resursively converts an OmegaConf config to a primitive container (dict or list).
        Any DictConfig objects backed by dataclasses or attrs classes are instantiated
        as instances of those backing classes.

        This is an alias for OmegaConf.to_container(..., resolve=True, throw_on_missing=True,
                                                    structured_config_mode=SCMode.INSTANTIATE)

        :param cfg: the config to convert
        :return: A dict or a list or dataclass representing this config.
        TFr  )rM   r  r0   ÚINSTANTIATE©rþ   rE   rE   rG   Ú	to_objectE  s   ûzOmegaConf.to_objectr¿   c              
   C   sZ   t | tƒsJ ‚z|  |¡}|d u rW dS t |tƒsJ ‚| ¡ W S  tttfy,   Y dS w ©NF)ro   r.   Ú
_get_childr/   Ú_is_missingr5   rÌ   ÚAttributeError)rþ   r¿   r®   rE   rE   rG   Ú
is_missingZ  s   

ÿzOmegaConf.is_missingr®   c                 C   sH   |d urt | tƒsJ ‚|  |¡}n| }|d ur"t |tƒsJ ‚| ¡ S dS r  )ro   r.   r  r/   Ú_is_interpolation)r®   r¿   rž   rE   rE   rG   Úis_interpolationf  s   zOmegaConf.is_interpolationc                 C   ó   ddl m} t| |ƒS )Nr   ©r   )Ú r   ro   )r[   r   rE   rE   rG   Úis_listr  ó   
zOmegaConf.is_listc                 C   r  )Nr   ró   )r  r   ro   )r[   r   rE   rE   rG   Úis_dictx  r  zOmegaConf.is_dictc                 C   r  )Nr   )r.   )r  r.   ro   )r[   r.   rE   rE   rG   r   ~  r  zOmegaConf.is_configc                 C   s"   |d ur
|   |¡}n| }t |¡S r^   )r  rM   Ú_get_obj_type)r[   r¿   ÚcrE   rE   rG   Úget_type„  s   
zOmegaConf.get_typeT)ÚdefaultÚthrow_on_resolution_failurerû   r  r  c             
   C   s^   ddl m} z
|| ||||d�W S  ty. } zt| |d|t|ƒd� W Y d}~dS d}~ww )a  
        :param cfg: Config node to select from
        :param key: Key to select
        :param default: Default value to return if key is not found
        :param throw_on_resolution_failure: Raise an exception if an interpolation
               resolution error occurs, otherwise return None
        :param throw_on_missing: Raise an exception if an attempt to select a missing key (with the value '???')
               is made, otherwise return None
        :return: selected value or None if not found.
        r   )Úselect_value)rþ   r¿   r  r  rû   N)r®   r¿   rä   ÚcauseÚmsg)Ú_implr  Ú	Exceptionr   rp   )rþ   r¿   r  r  rû   r  ÚerE   rE   rG   rS   Œ  s   û$€ÿzOmegaConf.select)rŸ   Ú	force_addrŸ   r  c             	   C   sÎ  t |ƒ}| }tt|ƒd ƒD ]9}|| }t||dd�\}	}
t|	tƒsC|r?t|ddƒ� i ||
< W d  ƒ n1 s9w   Y  ni ||
< ||
 }q|d }t|tƒs[J dt|ƒj› �ƒ‚|}t|t	ƒrft
|ƒ}|rnt|ddƒntƒ }|�j |r¥t |¡st|ƒr¥t|tƒs†J ‚| |¡}t |¡r¥t|tƒs—J ‚| |¡ 	 W d  ƒ dS t |¡r¸t|tƒs±J ‚| ||¡ nt |¡rËt|t
ƒsÄJ ‚| ||¡ n
J ‚W d  ƒ dS W d  ƒ dS 1 sàw   Y  dS )a5  
        Updates a dot separated key sequence to a value

        :param cfg: input config to update
        :param key: key to update (can be a dot separated path)
        :param value: value to set, if value if a list or a dict it will be merged or set
            depending on merge_config_values
        :param merge: If value is a dict or a list, True (default) to merge
                      into the destination, False to replace the destination.
        :param force_add: insert the entire path regardless of Struct flag or Structured Config nodes.
        r   F)rû   rð   NéÿÿÿÿzUnexpected type for root: )r+   Úranger–   Ú_select_onero   r.   r™   r~   r   r   Úintr*   rM   r   r$   r2   r  rš   r  rp   Ú__setattr__r  Ú__setitem__)rþ   r¿   rä   rŸ   r  ÚsplitÚrootr·   ÚkZ	next_rootÚkey_ÚlastÚlast_keyÚctxr®   rE   rE   rG   Úupdate¬  sV   

ÿ€
ÿþ



ù
	
ûõ"òzOmegaConf.update)rƒ   Ú	sort_keysr.  c                C   s.   t | ƒ} tj| |dd�}tj|dd|tƒ d�S )a¤  
        returns a yaml dump of this config object.

        :param cfg: Config object, Structured Config type or instance
        :param resolve: if True, will return a string with the interpolations resolved, otherwise
            interpolations are preserved
        :param sort_keys: If True, will print dict keys in sorted order. default False.
        :return: A string containing the yaml representation.
        T)rƒ   rü   F)Údefault_flow_styleÚallow_unicoder.  ÚDumper)r   rM   r  rx   Údumpr   )rþ   rƒ   r.  Ú	containerrE   rE   rG   r†   ì  s   ûzOmegaConf.to_yamlc                 C   s8   ddl }t | ¡stdt| ƒj› d�ƒ‚|j | ¡ dS )zò
        Resolves all interpolations in the given config object in-place.

        :param cfg: An OmegaConf container (DictConfig, ListConfig)
                    Raises a ValueError if the input object is not an OmegaConf container.
        r   NzInvalid config type (z"), expected an OmegaConf Container)Zomegaconf._implrM   r   r¼   r~   r   r  Ú_resolve)rþ   Ú	omegaconfrE   rE   rG   rƒ     s   
ÿzOmegaConf.resolvec                    s2   t | ƒ} tƒ ‰dtddf‡ ‡fdd„‰ ˆ | ƒ ˆS )aA  
        Returns a set of missing keys in a dotlist style.

        :param cfg: An ``OmegaConf.Container``,
                    or a convertible object via ``OmegaConf.create`` (dict, list, ...).
        :return: set of strings of the missing keys.
        :raises ValueError: On input not representing a config.
        Ú_cfgrB   Nc                    sb   t | tƒrtt| ƒƒ}n| }|D ]}t | |¡r!ˆ |  |¡¡ qt | | ¡r.ˆ | | ƒ qd S r^   )	ro   r   r!  r–   rM   r  ÚaddÚ_get_full_keyr   )r6  Úitrr¿   ©ÚgatherZmissingsrE   rG   r;     s   
€üz&OmegaConf.missing_keys.<locals>.gather)r   Úsetr.   r  rE   r:  rG   Úmissing_keys  s
   
zOmegaConf.missing_keysc           
   
   C   sò  zßddl m} ddlm} ddlm} | tu ri } t| tƒrUt	j
| |ƒ d�} | d u r3tji ||d�W S t| tƒrCtj| d i||d�W S t| ttfƒsLJ ‚tj| ||d�W S t| ƒsft | ¡sft| ƒsf| d u r”t| |ƒr|| || jj| jj| jj| jj|d�W S t | ¡}t|ƒ\}}|| ||||d�W S t| ƒs�t | ¡rÇt| |ƒr³|| || jj| jj| jj|d	�W S t | ¡}t|ƒ}|| ||td
|d	�W S t| tƒrÕtd| j› d�ƒ‚tdt| ƒj› d�ƒ‚ t yø }	 zt!d d d t|	ƒ|	d� J ‚d }	~	ww )Nr   rd   ró   r  rj   )r\   r]   )rö   r\   Úref_typeÚis_optionalÚkey_typeÚelement_typer]   )rö   r\   r@  rA  r]   )rö   r\   rA  r>  r?  r]   TzInput class 'zK' is not a structured config. did you forget to decorate it as a dataclass?zObject of unsupported type: 'ú')r®   r¿   rä   r  r  )"rn   re   r÷   r   Ú
listconfigr   r   ro   rp   rx   ry   rM   rO   r|   rT   r%   r  r'   rÛ   r>  Úoptionalr@  rA  r  r   r&   r  r   r   r~   r6   r   r4   r   )
r[   r\   r]   re   r   r   Úobj_typer@  rA  r  rE   rE   rG   rb   2  s�   

ÿþý
ù

û
ú
	ú
	ÿÿ€þzOmegaConf._create_implr  c                 C   s¸   t | ƒrt| ƒS | d u rd S t| tƒr+|  ¡ rd S |  ¡ rd S t | jjƒr)| jjS tS t| t	ƒr2t
S t| tƒr=t|  ¡ ƒS t| tƒrHtt| ƒƒS t| tƒrOtS t| t
tfƒrXt
S t| ƒS r^   )r'   r   ro   r   Ú_is_noner	  rÛ   Úobject_typerT   r   r|   r?   r~   Ú_valuer1   r   Útuple)r  rE   rE   rG   r  ‡  s.   




zOmegaConf._get_obj_typec                 C   s   | t jv r
t j|  S d S r^   )r2   rÃ   )r¢   rE   rE   rG   rÕ   ¤  s   ÿÿzOmegaConf._get_resolver©rB   N)NN)NNN)Fr^   )Hr   Ú
__module__Ú__qualname__Ú__doc__rZ   Ústaticmethodr   r   r2   r	   rp   rÔ   r`   r   r   r   r   rO   r   r   r   rq   rr   r   ry   r‹   r�   r�   r   rŸ   r¡   ÚResolverrª   r¨   rN   ÚclassmethodrÑ   rØ   rÚ   r¹   rÞ   rß   rã   r/   rœ   rí   r.   rñ   rò   rù   r0   ÚDICTr  r  r  r#  r  r  r  r   r   r  rS   r-  r†   rƒ   r   r=  rb   r  r   rÕ   rE   rE   rE   rG   rM   q   s2   
ýÿþýüýÿþý
üýÿþýüýÿþýüýÿþýüýÿþýüýÿþý
ü,ÿÿÿÿþ

ûÿÿ
	÷

ûÿÿ
	÷")ûÿþüûúQ $úÿýüûúù&.&&úÿþüûúùýúÿþýûúù?$ýÿþý
üTÿÿÿÿþrM   r‚   ÚnamesrV   c              
   #   sp   � t |tƒr	|g}|d u st |tƒr|g}‡ fdd„|D ƒ}zˆ  ||¡ ˆ V  W ˆ  ||¡ d S ˆ  ||¡ w )Nc                    s   g | ]}ˆ   |¡‘qS rE   )Ú_get_node_flag)r´   r¢   ©r‚   rE   rG   r¶   Â  rõ   z!flag_override.<locals>.<listcomp>)ro   rp   rÔ   rè   )r‚   rR  rV   Zprev_statesrE   rT  rG   r™   ·  s   €
r™   c              
   c   ó@   � |   d¡}zt | d¡ | V  W t | |¡ d S t | |¡ w )Nr•   F)rS  rM   rœ   ©r‚   Ú
prev_staterE   rE   rG   Ú
read_writeË  ó   €
rX  c              
   c   rU  )Nrð   F)rS  rM   rñ   rV  rE   rE   rG   Ú	open_dictÕ  rY  rZ  r\   r?  rä   r¿   r>  c              	   C   sV  t |ƒst|ƒr|tu rt|ƒ\}}t||| ||||d�}|S t|ƒs3t|ƒs3t|ƒtt	fv rC|tu rCt
|ƒ}t||| |||d�}|S t|ƒsKt|ƒr^t|ƒ\}}t||||| ||d�}|S t|ƒrmt||||| d�}|S |tksu|d u r~t||| d�}|S t|tƒr“t|tƒr“t|||| |d�}|S |tkr¡t||| |d�}|S |tkr¯t||| |d�}|S |tkr½t||| |d�}|S |tkrËt||| |d�}|S |tkrÙt||| |d�}|S |tjkrèt ||| |d�}|S | d u�r"|  !d¡d	u �r"t|ƒtt	fv �r	t||| ||d
�}|S t|ƒ�rt||| ||d
�}|S t||| d�}|S t"dt#|ƒ› �ƒ‚)N)rö   r¿   r\   r>  r?  r@  rA  )rö   r¿   r\   r?  rA  r>  )r>  r?  rö   r¿   r\   r@  rA  )rö   r>  r?  r¿   r\   )rä   r¿   r\   )Ú	enum_typerä   r¿   r\   r?  )rä   r¿   r\   r?  Úallow_objectsT)rö   r¿   r\   r>  r?  zUnexpected type annotation: )$r!   r%   r   r   r   r#   r(   r~   r|   rI  r   r   r'   r)   r1   r7   ro   Ú
issubclassr   r:   r#  r<   Úfloatr;   rÔ   r8   rp   r>   Úbytesr9   rq   rr   r=   r›   r6   r,   )r\   r?  rä   r¿   r>  r@  rA  r®   rE   rE   rG   Ú
_node_wrapâ  sÂ   ùTµúGÁù=Ìû3Ô+Öû)Þ!àâäæ
èëû
ôûýÿr`  c                 C   s4   t |tƒr| |¡ | |¡ |S t| ||||d�S )N)r>  r\   r?  rä   r¿   )ro   r/   Ú_set_keyÚ_set_parentr`  )r>  r¿   rä   r?  r\   rE   rE   rG   Ú_maybe_wrapC  s   
	

ûrc  Tr  rû   Úthrow_on_type_errorc                 C   sD  ddl m} ddlm} |}t| tƒsJ d| › �ƒ‚|  ¡ r"d |fS t| |ƒr6t|tƒs.J ‚| j|dd�}n>t| |ƒrrt|tƒsBJ ‚t	|ƒsY|rVt
d|› dt|ƒj› d	�ƒ‚d }nt|ƒ}|d
k si|d t| ƒkrld }n|  |¡}nJ ‚|d ur“t|tƒsJ ‚| ¡ r“|r�td|  |¡› �ƒ‚||fS |d u sžt|tƒsžJ ‚||fS )Nr   ró   r  zUnexpected type: F)Úvalidate_accesszIndex 'z' (z) is not an intr   zMissing mandatory value: )r÷   r   rC  r   ro   r.   rF  rp   r  r"   r{   r~   r   r#  r–   r/   r	  r3   r8  )r  r¿   rû   rd  r   r   Zret_keyrÀ   rE   rE   rG   r"  Z  s@   

ÿÿr"  rJ  )T)arM  r—   rÒ   rs   ru   rq   r�   r¦   Úcollectionsr   Ú
contextlibr   Úenumr   Útextwrapr   Útypingr   r   r   r	   r
   r   r   r   r   r   r   r   r   rx   r  r   r   r   rn   r   r   r   r   r   r   r   r   r   r    r!   r"   r#   r$   r%   r&   r'   r(   r)   r*   r+   r,   Úbaser-   r.   r/   r0   r1   Úbasecontainerr2   Úerrorsr3   r4   r5   r6   Únodesr7   r8   r9   r:   r;   r<   r=   r>   r?   r@   Ú__annotations__rO  rp   rH   rI   rW   rM   rÔ   r™   rX  rZ  r`  rc  r#  r"  rE   rE   rE   rG   Ú<module>   s¬    <`,


      Iÿþýü	ûÿþýüû
úaÿþýüû
úÿÿÿÿÿþ