h:SSKrSSKrSSKrSSKrSSKJr S/r\"SSSSSS9"SS55rSr\RRR\5 "S S \SS 9r "S S \5r g)N) dataclassConfigFT)initeqslotskw_only match_argsc\rSrSrSrSSjrSrSrSrSr Sr S r S r S r S rS rSrSrSr\ rSSjrSrSrSrSrSr\S5rSrSrSrSrg)r aThe base class for NetworkX configuration. There are two ways to use this to create configurations. The recommended way is to subclass ``Config`` with docs and annotations. >>> class MyConfig(Config): ... '''Breakfast!''' ... ... eggs: int ... spam: int ... ... def _on_setattr(self, key, value): ... assert isinstance(value, int) and value >= 0 ... return value >>> cfg = MyConfig(eggs=1, spam=5) Another way is to simply pass the initial configuration as keyword arguments to the ``Config`` instance: >>> cfg1 = Config(eggs=1, spam=5) >>> cfg1 Config(eggs=1, spam=5) Once defined, config items may be modified, but can't be added or deleted by default. ``Config`` is a ``Mapping``, and can get and set configs via attributes or brackets: >>> cfg.eggs = 2 >>> cfg.eggs 2 >>> cfg["spam"] = 42 >>> cfg["spam"] 42 For convenience, it can also set configs within a context with the "with" statement: >>> with cfg(spam=3): ... print("spam (in context):", cfg.spam) spam (in context): 3 >>> print("spam (after context):", cfg.spam) spam (after context): 42 Subclasses may also define ``_on_setattr`` (as done in the example above) to ensure the value being assigned is valid: >>> cfg.spam = -1 Traceback (most recent call last): ... AssertionError If a more flexible configuration object is needed that allows adding and deleting configurations, then pass ``strict=False`` when defining the subclass: >>> class FlexibleConfig(Config, strict=False): ... default_greeting: str = "Hello" >>> flexcfg = FlexibleConfig() >>> flexcfg.name = "Mr. Anderson" >>> flexcfg FlexibleConfig(default_greeting='Hello', name='Mr. Anderson') cXlgN)_strict)clsstricts H/var/www/html/env/lib/python3.13/site-packages/networkx/utils/configs.py__init_subclass__Config.__init_subclass__Hs c UnU[La9[URU4SUVs0sHo3[R_M sn05n[ SUR UR SSS9"U5nUR (d [UlX l SUl /Ul [RU5nUR"S0UD6 U$s snf)N__annotations__FT)rreprrrr )rtype__name__typingAnyrr_flexible_repr__repr__ _orig_class_prev_context_stackobject__new____init__)rkwargs orig_classkeyinstances rr#Config.__new__Ks &= "$G&**_$GHC ++   {{)CL$ >>#&#F#!%HsCcU$)zJProcess config value and check whether it is valid. Useful for subclasses.rselfr'values r _on_setattrConfig._on_setattrds rcg)zHCallback for when a config item is being deleted. Useful for subclasses.Nrr,r's r _on_delattrConfig._on_delattrhsrc6URR5$r )__dataclass_fields__keysr,s r__dir__Config.__dir__ls((--//rcUR(aXR;a[SU<35eURX5n[R XU5 SUR lg)NInvalid config name: )rr5AttributeErrorr.r" __setattr__ __class__r r+s rr=Config.__setattr__osS <r r1s rrBConfig.__delattr__vsL <<EcWBO  4%#rc\UR(aXR;$XR;$r )rr5__dict__r1s r __contains__Config.__contains__s(04 C,, , BEBV rcn[UR(aUR5$UR5$r )iterrr5rEr7s r__iter__Config.__iter__s%D--QQ4==QQrcn[UR(aUR5$UR5$r )lenrr5rEr7s r__len__Config.__len__s% 4,,PP$--PPrcn[UR(aUR5$UR5$r )reversedrr5rEr7s r __reversed__Config.__reversed__s%T\\11UUt}}UUrcd[X5$![an[UR6SeSnAff=fr )getattrr<KeyErrorargsr,r'errs r __getitem__Config.__getitem__s3 04% % 0CHH%4 / 0s /*/crURX5 g![an[UR6SeSnAff=fr )r=r<rVrW)r,r'r-rYs r __setitem__Config.__setitem__s6 0   S ( 0CHH%4 / 0 616crURU5 g![an[UR6SeSnAff=fr )rBr<rVrWrXs r __delitem__Config.__delitem__s6 0   S ! 0CHH%4 / 0r_Nc[XU5$r )rU)r,r'defaults rget Config.getst'**rc@[RRU5$r ) collectionsabc ItemsViewr7s ritems Config.itemss((..rc@[RRU5$r )rhriKeysViewr7s rr6 Config.keyss''--rc@[RRU5$r )rhri ValuesViewr7s rvalues Config.valuess))$//rc[U[5(d[$URUR:H=(a! UR 5UR 5:H$r ) isinstancerNotImplementedrrk)r,others r__eq__ Config.__eq__sB%((! !5#4#44V9VVrcHURUR[U544$r ) _deserializerdictr7s r __reduce__Config.__reduce__s"  4#3#3T$Z"@@@rcU"S0UD6$)Nrr)rr%s rr{Config._deserializes}V}rc UR5VVs0sHup#X RX#5_M nnn[U5nUR5Hup#[XU5 M X@RlU$s snnfr )rkr.r|setattrr>r )r,r%r'valprevs r__call__Config.__call__sfBH,,.Q.hc#''11.QDz HC Ds #'# RsA6cURRc [S5eURRR URR5 SURlU$)NaConfig being used as a context manager without config items being set. Set config items via keyword arguments when calling the config object. For example, using config as a context manager should be like: >>> with cfg(breakfast="spam"): ... ... # Do stuff )r>r RuntimeErrorr!appendr7s r __enter__Config.__enter__sY >>   '0  %%,,T^^-A-AB# rcURRR5nUR5HupV[ XU5 M gr )r>r!poprkr)r,exc_type exc_value tracebackrr'rs r__exit__Config.__exit__s6~~,,002 HC Ds #%rr)Tr ) r __module__ __qualname____firstlineno____doc__rr#r.r2r8r=rBrFrJrNrRrZr]ra_ipython_key_completions_rerkr6rrrxr} staticmethodr{rrr__static_attributes__rrrrr s:x2W0$$ RQV0 0 0 !(+/.0W A $rcURRS3SRSURR 555-S-$)N(, c36# UHupUSU<3v M g7f)=Nr).0r'rs r !_flexible_repr..sK5Jse1SG$5Js))r>rjoinrErkr7s rrrsI >> & & 'q) ))KT]]5H5H5JK K L  rcF\rSrSr%Sr\\\S'\\\S'SrSr Sr g) BackendPrioritiesaConfiguration to control automatic conversion to and calling of backends. Priority is given to backends listed earlier. Parameters ---------- algos : list of backend names This controls "algorithms" such as ``nx.pagerank`` that don't return a graph. generators : list of backend names This controls "generators" such as ``nx.from_pandas_edgelist`` that return a graph. kwargs : variadic keyword arguments of function name to list of backend names This allows each function to be configured separately and will override the config in ``algos`` or ``generators`` if present. The dispatchable function name may be gotten from the ``.name`` attribute such as ``nx.pagerank.name`` (it's typically the same as the name of the function). algos generatorscSSKJnJn US;aOX;a[SU<S35e[ U[ 5(a[ SU55(d[U<SU<35eUVs1sH oUU;dM UiM sn=n(a:SR[[[U555n[S U<S U35eU$s snf) N)_registered_algorithms backend_inforrr;zp. Expected 'algos', 'generators', or a name of a dispatchable function (e.g. `.name` attribute of the function).c3B# UHn[U[5v M g7fr rustrrxs rr0BackendPriorities._on_setattr..s/REq 1c0B0BEz- config must be a list of backend names; got rUnknown backend when setting : ) backendsrrr<rulistallrArmaprsorted ValueError)r,r'r-rrrmissings rr.BackendPriorities._on_setattrsB ) )   . 'w/WW 5$''C/RE/R,R,R'FuiP #(A%QL+@q%A A7 AiiD&/ :;G>> nx.config.backend_priority == nx.config["backend_priority"] True Parameters ---------- backend_priority : list of backend names or dict or BackendPriorities Enable automatic conversion of graphs to backend graphs for functions implemented by the backend. Priority is given to backends listed earlier. This is a nested configuration with keys ``algos``, ``generators``, and, optionally, function names. Setting this value to a list of backend names will set ``nx.config.backend_priority.algos``. For more information, see ``help(nx.config.backend_priority)``. Default is empty list. backends : Config mapping of backend names to backend Config The keys of the Config mapping are names of all installed NetworkX backends, and the values are their configurations as Config mappings. cache_converted_graphs : bool If True, then save converted graphs to the cache of the input graph. Graph conversion may occur when automatically using a backend from `backend_priority` or when using the `backend=` keyword argument to a function call. Caching can improve performance by avoiding repeated conversions, but it uses more memory. Care should be taken to not manually mutate a graph that has cached graphs; for example, ``G[u][v][k] = val`` changes the graph, but does not clear the cache. Using methods such as ``G.add_edge(u, v, weight=val)`` will clear the cache to keep it consistent. ``G.__networkx_cache__.clear()`` manually clears the cache. Default is True. fallback_to_nx : bool If True, then "fall back" and run with the default "networkx" implementation for dispatchable functions not implemented by backends of input graphs. When a backend graph is passed to a dispatchable function, the default behavior is to use the implementation from that backend if possible and raise if not. Enabling ``fallback_to_nx`` makes the networkx implementation the fallback to use instead of raising, and will convert the backend graph to a networkx-compatible graph. Default is False. warnings_to_ignore : set of strings Control which warnings from NetworkX are not emitted. Valid elements: - `"cache"`: when a cached value is used from ``G.__networkx_cache__``. Notes ----- Environment variables may be used to control some default configurations: - ``NETWORKX_BACKEND_PRIORITY``: set ``backend_priority.algos`` from comma-separated names. - ``NETWORKX_CACHE_CONVERTED_GRAPHS``: set ``cache_converted_graphs`` to True if nonempty. - ``NETWORKX_FALLBACK_TO_NX``: set ``fallback_to_nx`` to True if nonempty. - ``NETWORKX_WARNINGS_TO_IGNORE``: set `warnings_to_ignore` from comma-separated names. and can be used for finer control of ``backend_priority`` such as: - ``NETWORKX_BACKEND_PRIORITY_ALGOS``: same as ``NETWORKX_BACKEND_PRIORITY`` to set ``backend_priority.algos``. This is a global configuration. Use with caution when using from multiple threads. backend_priorityrcache_converted_graphsfallback_to_nxwarnings_to_ignorecSSKJn US:Xa[U[5(aU[ X5l[ X5nU$[U[ 5(a3Un[//S9nUR5Hup[X!U5 M U$[U[5(d[U<SU<35eU$US:Xa[U[5(a<[SU55(a%[SUR555(d[U<S U<35eUVs1sH ofU;dM UiM sn=n(a:S R[[ [#U555n[%S U<S U35eU$US ;a*[U[&5(d[U<SU<35eU$US:Xa[U[(5(a[SU55(d[U<SU<35eS1nUVs1sH ofU;dM UiM sn=n(aVS R[[ [#U555n[%SU<S US3S R[#U55-5eU$s snfs snf)Nr)rr)rrz6 config must be a dict of lists of backend names; got rc3B# UHn[U[5v M g7fr r)rr's rr-NetworkXConfig._on_setattr..ks> 3,,rc3B# UHn[U[5v M g7fr )rur)rrs rrrlsJ>C 3//>rz1 config must be a Config of backend configs; got rrr>rrz# config must be True or False; got rc3B# UHn[U[5v M g7fr rrs rrrxs2Uu!:a3E3Eurz, config must be a set of warning names; got cachezUnknown warning when setting z. Valid entries: )rrrurrUrr|rrkrrArrrrrrrrrboolset) r,r'r-rr%rrrknown_warningss rr.NetworkXConfig._on_setattrXs}* $ $%&&+0"(*J IE4(()rB & HCE,!/B ? '899gSTYS\]:> 7J 5&))>>>>J5<<>JJJgNuiX',Ee /D1eEEwE))CfWo$>? #@r'!STTF$ @ @eT**3')LUI VWW+ ( (uc**s2Uu2U/U/UgI%S&YN&+Ge/F1eGGwG))CfWo$>? 3C7"WIEVWii~ 678 %FHs I(+I(3 I-I-rN) rrrrrrrrrrrr.rrrrrrs1<|('  C +rr)rhosrwarnings dataclassesr__all__rrriMappingregisterrrrrrrs ! * %tTeLL$L$ML$^  (*Mu*MZpVpr