U /eO@sxUddlmZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z m Z ddlmZmZddlZdZddZeZdejkrejdZnejejd d d ZiZd ed <eZe ZgZded<dd ddddZ dbd ddd dddZ!dd dddZ"ddddd Z#efd!d"d#d$d%Z$dcd&d d'd(d)Z%dddd+d,d-d.d/d0Z&Gd1d2d2Z'edfd3d&d d4d5d6Z(eefd dd-d7d8d9Z)eedfdd:d d;d:d<d=d>Z*efdd d-d?d@dAZ+eefdd dd-dBdCdDZ,d:d:dEdFdGZ-dHdIdJdKdLdMdNdOdPdQdRdSdTdUdVZ.e.fdd ddWdXdYZ/d:ddZd[d\Z0dd:dZd]d^Z1d-d_d`daZ2e)e2dS)e) annotationsN)MappingSequence)AnyLiteralZ__no_default__cCs~tddtjtjddfddtjDtjtjdddf}d tj kr`| tj d t t t t t |}|S) z~Get locations to search for YAML configuration files. This logic exists as a separate function for testing purposes. ZDASK_ROOT_CONFIGz /etc/dasketcdaskcSsg|]}tj|ddqS)rr)ospathjoin).0prefixr//tmp/pip-unpacked-wheel-dbjnr7gq/dask/config.py sz_get_paths..~.config DASK_CONFIG)r getenvr r sysr sitePREFIXES expanduserenvironappendlistreverseddictfromkeyspathsrrr _get_pathss  r!rrrrrconfigz list[Mapping]defaultsstr)kr"returncCs\z||kr|WSWntk r*|YSXd|kr@|ddn |dd}||krX|S|S)a@Return the canonical name for a key. Handles user choice of '-' or '_' conventions by standardizing on whichever version was set first. If a key already exists in either hyphen or underscore form, the existing version is the canonical name. If neither version exists the original key is used as is. _-) TypeErrorreplace)r%r"Zaltkrrrcanonical_name;s   r+newrzLiteral[('old', 'new')])oldr,priorityr&cCsr|D]d\}}t||}t|trT||ks8||dkr@i||<t||||dq|dksd||kr|||<q|S)aUpdate a nested dictionary with values from another This is like dict.update except that it smoothly merges nested values This operates in-place and modifies old Parameters ---------- priority: string {'old', 'new'} If new (default) then the new dictionary has preference. Otherwise the old dictionary does. Examples -------- >>> a = {'x': 1, 'y': {'a': 2}} >>> b = {'x': 2, 'y': {'b': 3}} >>> update(a, b) # doctest: +SKIP {'x': 2, 'y': {'a': 2, 'b': 3}} >>> a = {'x': 1, 'y': {'a': 2}} >>> b = {'x': 2, 'y': {'b': 3}} >>> update(a, b, priority='old') # doctest: +SKIP {'x': 1, 'y': {'a': 2, 'b': 3}} See Also -------- dask.config.merge Nr.r,)itemsr+ isinstancerupdate)r-r,r.r%vrrrr2Rs   r2)dictsr&cGsi}|D]}t||q|S)aSUpdate a sequence of nested dictionaries This prefers the values in the latter dictionaries to those in the former Examples -------- >>> a = {'x': 1, 'y': {'a': 2}} >>> b = {'y': {'b': 3}} >>> merge(a, b) # doctest: +SKIP {'x': 1, 'y': {'a': 2, 'b': 3}} See Also -------- dask.config.update )r2)r4resultdrrrmerge}s r7z dict | None)r r&c Csz&t|}t|}W5QRXWnLtk r<YdStk rr}ztd|d|dW5d}~XYnX|dk rt|tstd|dt |j d|S)zhA helper for loading a config file from a path, and erroring appropriately if the file is malformed.NzA dask config file at z( is malformed, original error message: zM is malformed - config files must have a dict as the top level object, got a z instead) openyaml safe_loadreadOSError Exception ValueErrorr1rtype__name__)r fr"excrrr_load_config_files  rC Sequence[str]z list[dict])r r&c sg}|D]dtjrtjrbz&|tfddtDWqltk r^YqlXq|qg}|D]t }|dk rv||qv|S)zCollect configuration from yaml files This searches through a list of paths, expands to find all yaml or json files, and then parses each file. c3s4|],}tj|ddkrtj|VqdS))z.jsonz.yamlz.ymlN)r r splitextlowerr )r pr rr s zcollect_yaml..N) r r existsisdirextendsortedlistdirr<rrC)r Z file_pathsconfigsr"rrIr collect_yamls&     rQzMapping[str, str] | None)envr&c Cs|dkrtj}d|kr$t|d}ni}|D]^\}}|dr0|dddd}zt|||<Wq0t t fk r|||<Yq0Xq0i}t ||d|S)aCollect config from environment variables This grabs environment variables of the form "DASK_FOO__BAR_BAZ=123" and turns these into config variables of the form ``{"foo": {"bar-baz": 123}}`` It transforms the key and value in the following way: - Lower-cases the key text - Treats ``__`` (double-underscore) as nested access - Calls ``ast.literal_eval`` on the value Any serialized config passed via ``DASK_INTERNAL_INHERIT_CONFIG`` is also set here. NZDASK_INTERNAL_INHERIT_CONFIGZDASK___.r") r r deserializer0 startswithrGr*ast literal_eval SyntaxErrorr>set)rRr6namevaluevarnamer5rrr collect_envs  r`Tz str | NoneboolNone)source destinationcommentr&c Cs|dkr t}tj|rdS|}tj|tj|}ztj|stj|ddd|tf}t |}t |}W5QRX|rdd|D}t |d}| d|W5QRXzt ||Wnt k rt|YnXWnt k rYnXdS) a  Copy file to default location if it does not already exist This tries to move a default configuration file to a default location if if does not already exist. It also comments out that file by default. This is to be used by downstream modules (like dask.distributed) that may have default configuration files that they wish to include in the default configuration path. Parameters ---------- source : string, filename Source configuration file, typically within a source directory. destination : string, directory Destination directory. Configurable by ``DASK_CONFIG`` environment variable, falling back to ~/.config/dask. comment : bool, True by default Whether or not to comment out the config file when copying. NT)exist_okz %s.tmp.%dcSs*g|]"}|r"|ds"d|n|qS)#z# )striprX)r linerrrr!szensure_file..w)PATHr r isfiler basenamerKmakedirsgetpidr8rwriterenamer<remove)rcrdre directorytmprAlinesrrr ensure_files0    rwc@sfeZdZUdZded<ded<deefdddd d d Zd d ZddZ ddddddddddZ dS)r\aTemporarily set configuration values within a context manager Parameters ---------- arg : mapping or None, optional A mapping of configuration key-value pairs to set. **kwargs : Additional key-value pairs to set. If ``arg`` is provided, values set in ``arg`` will be applied before those in ``kwargs``. Double-underscores (``__``) in keyword arguments will be replaced with ``.``, allowing nested values to be easily set. Examples -------- >>> import dask Set ``'foo.bar'`` in a context, by providing a mapping. >>> with dask.config.set({'foo.bar': 123}): ... pass Set ``'foo.bar'`` in a context, by providing a keyword argument. >>> with dask.config.set(foo__bar=123): ... pass Set ``'foo.bar'`` globally. >>> dask.config.set(foo__bar=123) # doctest: +SKIP See Also -------- dask.config.get rr"zAlist[tuple[Literal[('insert', 'replace')], tuple[str, ...], Any]]_recordNzMapping | Nonezthreading.Lock)argr"lockc Ks|||_g|_|dk rH|D]$\}}t|}||d||q"|r|D]0\}}|dd}t|}||d||qTW5QRXdS)NrUrT)r"rxr0check_deprecations_assignsplitr*)selfryr"rzkwargskeyr^rrr__init__Ys z set.__init__cCs|jSNrV)r~rrr __enter__nsz set.__enter__c Cst|jD]\}}}|j}|dkrN|ddD]}||i}q.|||d<q |ddD],}z ||}WqZtk rYq YqZXqZ||ddq dS)Nr*)rrxr" setdefaultKeyErrorpop)r~r?r^ tracebackopr r6rrrr__exit__qs z set.__exit__rTrDrztuple[str, ...]rarb)keysr^r6r recordr&cCst|d|}||f}t|dkrd|rZ||krH|jd|||fn|jd|df|||<nJ||kr|r|jd|dfi||<d}|j|dd|||||ddS)aAssign value into a nested configuration dictionary Parameters ---------- keys : Sequence[str] The nested path of keys to assign the value. value : object d : dict The part of the nested dictionary into which we want to assign the value path : tuple[str], optional The path history up to this point. record : bool, optional Whether this operation needs to be recorded to allow for rollback. rrEr*insertNF)r)r+lenrxrr|)r~rr^r6r rrrrrr|s   z set._assign)rT) r@ __module__ __qualname____doc____annotations__r" config_lockrrrr|rrrrr\1s #r\z list[str])r rRr&cCs0|dkrtj}t|d}|t|dt|S)a Collect configuration from paths and environment variables Parameters ---------- paths : list[str] A list of paths to search for yaml config files env : Mapping[str, str] The system environment variables Returns ------- config: dict See Also -------- dask.config.refresh: collect configuration and update into primary config Nr)rR)r rrQrr`r7)r rRrPrrrcollects  r)r"r#r&cKs4||D]}t||ddq t|tf|dS)a Update configuration by re-reading yaml files and env variables This mutates the global dask.config.config, or the config parameter if passed in. This goes through the following stages: 1. Clearing out all old configuration 2. Updating from the stored defaults from downstream libraries (see update_defaults) 3. Updating from yaml files and environment variables Note that some functionality only checks configuration once at startup and may not change behavior, even if configuration changes. It is recommended to restart your python process if convenient to ensure that new configuration changes take place. See Also -------- dask.config.collect: for parameters dask.config.update_defaults r-r/N)clearr2r)r"r#rr6rrrrefreshsrrz Any | None)rdefaultr" override_withr&c Csp|dk r |S|d}|}|D]L}t||}z ||}Wqtttfk rh|tk rb|YSYqXq|S)a Get elements from global config If ``override_with`` is not None this value will be passed straight back. Useful for getting kwarg defaults from Dask config. Use '.' for nested access Examples -------- >>> from dask import config >>> config.get('foo') # doctest: +SKIP {'x': 1, 'y': 2} >>> config.get('foo.x') # doctest: +SKIP 1 >>> config.get('foo.x.y', default=123) # doctest: +SKIP 123 >>> config.get('foo.y', override_with=None) # doctest: +SKIP 2 >>> config.get('foo.y', override_with=3) # doctest: +SKIP 3 See Also -------- dask.config.set NrU)r}r+r) IndexErrorr no_default)rrr"rrr5r%rrrgets$     r)aliasesr"r&cCshg}i}|D]0\}}t|d|d}|dk r|||||<q|D]}|t||=qFt||ddS)z_Rename old keys to new keys This helps migrate older configuration versions over time NrV)r0rrr+r\)rr"r-r,onr^r%rrrrr s  rr)r,r"r#r&cCs||t||dddS)aAdd a new set of defaults to the configuration It does two things: 1. Add the defaults to a global collection to be used by refresh later 2. Updates the global config with the new configuration prioritizing older values over newer ones r-r/N)rr2)r,r"r#rrrupdate_defaults3s r)r"r&cCsbt|trdd|DSt|tr2tj|St|ttt j frZt |dd|DS|SdS)aExpand environment variables in a nested config dictionary This function will recursively search through any nested dictionaries and/or lists. Parameters ---------- config : dict, iterable, or str Input object to search for environment variables Returns ------- config : same type as input Examples -------- >>> expand_environment_variables({'x': [1, 2, '$USER']}) # doctest: +SKIP {'x': [1, 2, 'my-username']} cSsi|]\}}|t|qSrexpand_environment_variables)r r%r3rrr Wsz0expand_environment_variables..css|]}t|VqdSrr)r r3rrrrJ[sz/expand_environment_variables..N) r1rr0r$r r expandvarsrtuplebuiltinsr\r?rVrrrrBs   rzoptimization.fuse.ave-widthzoptimization.fuse.max-heightzoptimization.fuse.max-widthzoptimization.fuse.subgraphszoptimization.fuse.rename-keysz%optimization.fuse.max-depth-new-edgeszdistributed.ucx.cuda_copyzdistributed.ucx.tcpzdistributed.ucx.nvlinkzdistributed.ucx.infinibandzdistributed.ucx.rdmacmzdistributed.ucx.net-deviceszdistributed.ucx.reuse-endpointszdistributed.rmm.pool-size)Zfuse_ave_widthZfuse_max_heightZfuse_max_widthZfuse_subgraphsZfuse_rename_keysZfuse_max_depth_new_edgesz ucx.cuda_copyzucx.tcpz ucx.nvlinkzucx.infinibandz ucx.rdmacmzucx.net-deviceszucx.reuse-endpointsz rmm.pool-size)r deprecationsr&cCsD||kr<||}|r*td|||Std|dn|SdS)anCheck if the provided value has been renamed or removed Parameters ---------- key : str The configuration key to check deprecations : Dict[str, str] The mapping of aliases Examples -------- >>> deprecations = {"old_key": "new_key", "invalid": None} >>> check_deprecations("old_key", deprecations=deprecations) # doctest: +SKIP UserWarning: Configuration key "old_key" has been deprecated. Please use "new_key" instead. >>> check_deprecations("invalid", deprecations=deprecations) Traceback (most recent call last): ... ValueError: Configuration value "invalid" has been removed >>> check_deprecations("another_key", deprecations=deprecations) 'another_key' Returns ------- new: str The proper key, whether the original (if no deprecation) or the aliased value zCConfiguration key "{}" has been deprecated. Please use "{}" insteadzConfiguration value "z" has been removedN)warningswarnformatr>)rrr,rrrr{ssr{)datar&cCstt|S)aFSerialize config data into a string. Typically used to pass config via the ``DASK_INTERNAL_INHERIT_CONFIG`` environment variable. Parameters ---------- data: json-serializable object The data to serialize Returns ------- serialized_data: str The serialized data as a string )base64urlsafe_b64encodejsondumpsencodedecoderrrr serializesrcCstt|S)aWDe-serialize config data into the original object. Typically when receiving config via the ``DASK_INTERNAL_INHERIT_CONFIG`` environment variable. Parameters ---------- data: str String serialized by :func:`dask.config.serialize` Returns ------- deserialized_data: obj The de-serialized data )rloadsrurlsafe_b64decoderrrrrrrWsrW)r&c Cs@tjtjtd}t|}t|}W5QRXt|dS)Nz dask.yaml) r r r dirname__file__r8r9r:r)fnrA _defaultsrrr _initializes r)r,)N)NT)3 __future__rrYrrrr rr threadingrcollections.abcrrtypingrrr9rr!r rrlr r rr"rZ global_configLockrr#r+r2r7rCrQr`rwr\rrrrrrrrr{rrWrrrrrs     +%%?|$4,