o h#@sddlZddlZddlZddlmZddgZeddddddGdddZd d Zejj eGd d d eZ e gee ej d ddZdS)N) dataclassConfigconfigFT)initeqslotskw_only match_argsc@seZdZdZd,ddZddZddZd d Zd d Zd dZ ddZ ddZ ddZ ddZ ddZddZddZeZd-ddZd d!Zd"d#Zd$d%Zd&d'Zd(d)Zed*d+ZdS).raThe base class for NetworkX configuration. There are two ways to use this to create configurations. The first is to simply pass the initial configuration as keyword arguments to ``Config``: >>> cfg = Config(eggs=1, spam=5) >>> cfg Config(eggs=1, spam=5) The second--and preferred--way is to subclass ``Config`` with docs and annotations. >>> class MyConfig(Config): ... '''Breakfast!''' ... ... eggs: int ... spam: int ... ... def _check_config(self, key, value): ... assert isinstance(value, int) and value >= 0 >>> cfg = MyConfig(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 Subclasses may also define ``_check_config`` (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') TcCs ||_dSN)_strict)clsstrictrQ/var/www/html/env_mimamsha/lib/python3.10/site-packages/networkx/utils/configs.py__init_subclass__= zConfig.__init_subclass__cKst|}|turt|j|fddd|Di}td|j|jddd|}|js(t|_||_t |}|j di||S)N__annotations__cSsi|]}|tjqSr)typingAny.0keyrrr Gsz"Config.__new__..FT)rreprrrr r) rtype__name__rr _flexible_repr__repr__ _orig_classobject__new____init__)r kwargs orig_classinstancerrrr @s, zConfig.__new__cCsdS)zCCheck whether config value is valid. This is useful for subclasses.Nrselfrvaluerrr _check_configWszConfig._check_configcCs |jSr )__dataclass_fields__keysr&rrr__dir__[rzConfig.__dir__cCs<|jr||jvrtd||||t|||dS)NzInvalid config name: )r r)AttributeErrorr(r __setattr__r%rrrr.^s zConfig.__setattr__cCs&|jr td|dt||dS)Nz3Configuration items can't be deleted (can't delete z).)r TypeErrorr __delattr__r&rrrrr0ds  zConfig.__delattr__cCs|jr||jvS||jvSr )r r)__dict__r1rrr __contains__lszConfig.__contains__cCt|jr|jS|jSr )iterr r)r2r+rrr__iter__qzConfig.__iter__cCr4r )lenr r)r2r+rrr__len__tr7zConfig.__len__cCr4r )reversedr r)r2r+rrr __reversed__wr7zConfig.__reversed__c Cs2zt||WSty}zt|jdd}~wwr )getattrr-KeyErrorargsr&rerrrrr __getitem__{s   zConfig.__getitem__c Cs8z |||WdSty}zt|jdd}~wwr )r.r-r=r>)r&rr'r@rrr __setitem__s  zConfig.__setitem__c Cs6z||WdSty}zt|jdd}~wwr )r0r-r=r>r?rrr __delitem__s  zConfig.__delitem__NcCs t|||Sr )r<)r&rdefaultrrrget z Config.getcC tj|Sr ) collectionsabc ItemsViewr+rrritemsrFz Config.itemscCrGr )rHrIKeysViewr+rrrr*rFz Config.keyscCrGr )rHrI ValuesViewr+rrrvaluesrFz Config.valuescCs*t|tstS|j|jko||kSr ) isinstancerNotImplementedrrK)r&otherrrr__eq__s z Config.__eq__cCs|j|jt|ffSr ) _deserializerdictr+rrr __reduce__szConfig.__reduce__cCs|di|S)Nrr)r r"rrrrSszConfig._deserialize)Tr )r __module__ __qualname____doc__rr r(r,r.r0r3r6r9r;rArBrC_ipython_key_completions_rErKr*rNrRrU staticmethodrSrrrrr s0 2 cCs,|jjdddd|jDdS)N(, css"|] \}}|d|VqdS)=Nr)rrvalrrr s z!_flexible_repr..)) __class__rWjoinr2rKr+rrrrs rc@s6eZdZUdZeeed<eed<eed<ddZ dS)NetworkXConfiga?Configuration for NetworkX that controls behaviors such as how to use backends. Attribute and bracket notation are supported for getting and setting configurations: >>> nx.config.backend_priority == nx.config["backend_priority"] True Parameters ---------- backend_priority : list of backend names Enable automatic conversion of graphs to backend graphs for algorithms implemented by the backend. Priority is given to backends listed earlier. 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 False. Notes ----- Environment variables may be used to control some default configurations: - NETWORKX_BACKEND_PRIORITY: set `backend_priority` from comma-separated names. - NETWORKX_CACHE_CONVERTED_GRAPHS: set `cache_converted_graphs` to True if nonempty. This is a global configuration. Use with caution when using from multiple threads. backend_prioritybackendscache_converted_graphscs>ddlm|dkrBt|trtdd|Ds!t|d|fdd|D}r@d ttt|}t d |d |dS|d krt|t r_td d|Dr_tdd| Dsht|d|fdd|D}rd ttt|}t d |d |dS|dkrt|t st|d|dSdS)Nrerdcs|]}t|tVqdSr rOstrrxrrrr_z/NetworkXConfig._check_config..z- config must be a list of backend names; got ch|]}|vr|qSrrrlrhrr z/NetworkXConfig._check_config..r\zUnknown backend when setting z: recsrir rjrrrrr_rncsrir )rOr)rr^rrrr_rnz1 config must be a Config of backend configs; got crorrrlrhrrrprqrfz# config must be True or False; got ) rerOlistallr/rbmaprsorted ValueErrorrrNbool)r&rr'missingrrhrr(s:    zNetworkXConfig._check_configN) rrVrWrXrrrkrrrwr(rrrrrcs  ' rcNETWORKX_CACHE_CONVERTED_GRAPHS)rdrerf)rHosr dataclassesr__all__rrrIMappingregisterrcrwenvironrErrrrrs  " I