\MhQuNddlZddlZddlZddlZddlZddlZddlmZddlm Z ddl Z ddl m Z mZmZddlmZdgZejeZdZd d d Zed ZiZiZiZd ZdZdZdZdZ GddZ!dZ"dZ#ddddZ$dddZ%GddZ&ej'(drje!Z)ddZ!e)j*j+e!_+ej,e)j*Z-e-.de-j/0De!_1dSdS) N)partial) entry_points)BackendPrioritiesConfigNetworkXConfig)argmap _dispatchableFAILED_TO_CONVERTF load_and_callct|}i}|D]}|j|vr%tjd|jtd0|rd |||j<X#t $r1}tjd|jd|tdYd}~d}~wwxYw|||j<|dd|S) a Retrieve NetworkX ``backends`` and ``backend_info`` from the entry points. Parameters ----------- group : str The entry_point to be retrieved. load_and_call : bool, optional If True, load and call the backend. Defaults to False. Returns -------- dict A dictionary mapping backend names to their respective backend objects. Notes ------ If a backend is defined more than once, a warning is issued. The "nx_loopback" backend is removed if it exists, as it is only available during testing. A warning is displayed if an error occurs while loading a backend. )groupz)networkx backend defined more than once: ) stacklevelz0Error encountered when loading info for backend z: N nx_loopback)rnamewarningswarnRuntimeWarningload Exceptionpop)rr itemsrvepexcs W/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/networkx/utils/backends.py _get_backendsr-s#, u % % %E B 7b== MEBGEE        'bggiikk27     WrwWWRUWW"  BrwKKFF=$ Is$A-- B(7'B##B(znetworkx.backendscjfd|dDS)Nc@g|]}|xS)strip).0xx_strips r z&_comma_sep_to_list..ks+ Q Q Qaggii;O7 QG Q Q Q,)r#split)stringr&s @r_comma_sep_to_listr,js3 Q Q Q QV\\^^11#66 Q Q QQr(cnttddtdttz Di}tD]F\}}d|vrt }n)|d}t|t s t di|}|||<Gt di|}dt|_ tgg}t||ttjddttjd d t!t#tjd d  }itd<dtjD}|j}d|vr"t#|dnJt#tjdtjdd |_t#|dd |_t-|D]}t#||||<|S)aInitialize ``config.backend_priority``, load backend_info and config. This gets default values from environment variables (see ``nx.config`` for details). This function is run at the very end of importing networkx. It is run at this time to avoid loading backend_info before the rest of networkx is imported in case a backend uses networkx for its backend_info (e.g. subclassing the Config class.) znetworkx.backend_infoTr c3K|]}|ifV dSNr")r$backends r z0_set_configs_from_environment..xs7!" r(default_configz2All installed NetworkX backends and their configs.)algos generatorsNETWORKX_CACHE_CONVERTED_GRAPHSNETWORKX_FALLBACK_TO_NXFNETWORKX_WARNINGS_TO_IGNORE)backend_prioritybackendscache_converted_graphsfallback_to_nxwarnings_to_ignorenetworkxcxi|]7\}}|d|dd|8S)NETWORKX_BACKEND_PRIORITY_N) startswithlowerr$keyvals r z1_set_configs_from_environment..sS C >>6 7 7 BCC#r(r3NETWORKX_BACKEND_PRIORITYNETWORKX_AUTOMATIC_BACKENDSr4r") backend_infoupdaterr:keysrr isinstancetype__doc__rrboolosenvirongetsetr,r9rr3r4sorted)backend_configr0infocfgr9config prioritiesrEs r_set_configs_from_environmentr[ns &=TRRRSSS%-]]__|7H7H7J7J%J N%++--&&  4 ' '((CC'(Cc6** $mmsmm"%w--n--N$XD (rbAAA )# JNN>'22333  JNN+ t|tt6zs!t dt9|dd|>t|tt6zs!t dt9|ddtjt:tzt6zs&t dt9jd dtjt:tzt6zs&t d t9jd dtjt:t<zs&t d t9jd dtjt:t6zs&t d t9jddtjt:s&t dt9jddt|tr|di}n\|nYt|t6s!t dt9|ddt?|dkrtAddt=_!t=_"|i_#n' fd|$D_#d_%fdtL$D_'| rj'(dtRvrtAddtUtVtR<S)aA decorator function that is used to redirect the execution of ``func`` function to its backend implementation. This decorator allows the function to dispatch to different backend implementations based on the input graph types, and also manages the extra keywords ``backend`` and ``**backend_kwargs``. Usage can be any of the following decorator forms: - ``@_dispatchable`` - ``@_dispatchable()`` - ``@_dispatchable(name="override_name")`` - ``@_dispatchable(graphs="graph_var_name")`` - ``@_dispatchable(edge_attrs="weight")`` - ``@_dispatchable(graphs={"G": 0, "H": 1}, edge_attrs={"weight": "default"})`` with 0 and 1 giving the position in the signature function for graph objects. When ``edge_attrs`` is a dict, keys are keyword names and values are defaults. Parameters ---------- func : callable, optional (default: None) The function to be decorated. If None, ``_dispatchable`` returns a partial object that can be used to decorate a function later. If ``func`` is a callable, returns a new callable object that dispatches to a backend function based on input graph types. name : str, optional (default: name of `func`) The name for the function as used for dispatching. If not provided, the name of ``func`` will be used. ``name`` is useful to avoid name conflicts, as all dispatched functions live in a single namespace. For example, ``nx.tournament.is_strongly_connected`` had a name conflict with the standard ``nx.is_strongly_connected``, so we used ``@_dispatchable(name="tournament_is_strongly_connected")``. graphs : str or dict or None, optional (default: "G") If a string, the parameter name of the graph, which must be the first argument of the wrapped function. If more than one graph is required for the function (or if the graph is not the first argument), provide a dict keyed by graph parameter name to the value parameter position. A question mark in the name indicates an optional argument. For example, ``@_dispatchable(graphs={"G": 0, "auxiliary?": 4})`` indicates the 0th parameter ``G`` of the function is a required graph, and the 4th parameter ``auxiliary?`` is an optional graph. To indicate that an argument is a list of graphs, do ``"[graphs]"``. Use ``graphs=None``, if *no* arguments are NetworkX graphs such as for graph generators, readers, and conversion functions. edge_attrs : str or dict, optional (default: None) ``edge_attrs`` holds information about edge attribute arguments and default values for those edge attributes. If a string, ``edge_attrs`` holds the function argument name that indicates a single edge attribute to include in the converted graph. The default value for this attribute is 1. To indicate that an argument is a list of attributes (all with default value 1), use e.g. ``"[attrs]"``. If a dict, ``edge_attrs`` holds a dict keyed by argument names, with values that are either the default value or, if a string, the argument name that indicates the default value. If None, function does not use edge attributes. node_attrs : str or dict, optional Like ``edge_attrs``, but for node attributes. preserve_edge_attrs : bool or str or dict, optional (default: False) If bool, whether to preserve all edge attributes. If a string, the parameter name that may indicate (with ``True`` or a callable argument) whether all edge attributes should be preserved when converting graphs to a backend graph type. If a dict of form ``{graph_name: {attr: default}}``, indicate pre-determined edge attributes (and defaults) to preserve for the indicated input graph. preserve_node_attrs : bool or str or dict, optional (default: False) Like ``preserve_edge_attrs``, but for node attributes. preserve_graph_attrs : bool or set, optional (default: False) If bool, whether to preserve all graph attributes. If set, which input graph arguments to preserve graph attributes. preserve_all_attrs : bool, optional (default: False) Whether to preserve all edge, node and graph attributes. If True, this overrides all the other preserve_*_attrs. mutates_input : bool or dict, optional (default: False) If bool, whether the function mutates an input graph argument. If dict of ``{arg_name: arg_pos}``, name and position of bool arguments that indicate whether an input graph will be mutated, and ``arg_name`` may begin with ``"not "`` to negate the logic (for example, ``"not copy"`` means we mutate the input graph when the ``copy`` argument is False). By default, dispatching doesn't convert input graphs to a different backend for functions that mutate input graphs. returns_graph : bool, optional (default: False) Whether the function can return or yield a graph object. By default, dispatching doesn't convert input graphs to a different backend for functions that return graphs. implemented_by_nx : bool, optional (default: True) Whether the function is implemented by NetworkX. If it is not, then the function is included in NetworkX only as an API to dispatch to backends. Default is True. Nrnz-'name' and 'graphs' must be passed by keywordr0zBad type for edge_attrs: z. Expected str or dict.zBad type for node_attrs: z"Bad type for preserve_edge_attrs: z. Expected bool, str, or dict.z"Bad type for preserve_node_attrs: z#Bad type for preserve_graph_attrs: z. Expected bool or set.zBad type for mutates_input: z. Expected bool or dict.zBad type for returns_graph: z. Expected bool.rzBad type for graphs: z0'graphs' must contain at least one variable nameci|]h\}}|dxdkr&j|ddxpn-dkr&j|ddxpn||iS)?N]r)optional_graphsadd list_graphs)r$kvlastselfrFs rrGz)_dispatchable.__new__..s Aq bEMDc))$((#2#77>33;;%))1R4.#99@S r(c6h|]\}}d|v |dv|S) functionsr")r$r0rWrs r z(_dispatchable.__new__..sA   d""ttK/@'@'@ '@'@'@r(r>z/Algorithm already exists in dispatch registry: ),rr rMstr TypeError__name__object__new__ __defaults____kwdefaults__ __module__ __qualname____dict__rK __wrapped__rO _orig_doc _cached_doc orig_funcrrprqrrrsrtrv_returns_graphdictrNrPrTlenKeyErrorr~rror_sigrJr:r_registered_algorithmsr r])clsfuncrrorprqrrrsrtrurvrwrxrrrFs ` @@@rrz_dispatchable.__new__sGj <%%$7$7%9#5++"3     dC  WKLLRV V <=D~~c""   -   4"JT%8"J)T"J"JD  #,d"3D / - T]+++ $$#6#L:L #6#L:L $8$NDKK #LLNN DK     !-!3!3!5!5     * M  j ) ) ) ) ) )H$HH #vk""4(('+t$ r(cN|j}||x}|_|S)zIf the cached documentation exists, it is returned. Otherwise, the documentation is generated using _make_doc() method, cached, and then returned.)r _make_doc)rrs rrOz_dispatchable.__doc__s-   :$(NN$4$4 4B! r(c"||_d|_dS)z_Sets the original documentation to the given value and resets the cached documentation.N)rr)rrFs rrOz_dispatchable.__doc__s r(cl|j&tj|j}t d|jDsz|g|jtjdtjj dtjdtjj }n\|j^}}|g|tjdtjj d|}||_|jS)zzReturn the signature of the original function, with the addition of the `backend` and `backend_kwargs` parameters.Nc3JK|]}|jtjjkVdSr/)kindinspect Parameter VAR_KEYWORD)r$ps rr1z._dispatchable.__signature__..s@<='+77r(r0)defaultbackend_kwargs parameters) rr signatureranyrvaluesreplacer KEYWORD_ONLYr)rsigr var_keywords r __signature__z_dispatchable.__signature__s] 9 #DN33CADAVAVAXAX kk ..00 )%w'8'Et   ),g.?.K  "  ,/>+@+@+B+B([kk # )%w'8'Et  $  "DIyr()r0c||dkrtd|dd|jvrtd|jd|j|i|S)zDReturns the result of the original function (no backends installed).Nr>rcrdzz' is not implemented by 'networkx' backend. This function is included in NetworkX as an API to dispatch to other backends.)rhr:NotImplementedErrorrr)rr0r_r`s r_call_if_no_backends_installedz,_dispatchable._call_if_no_backends_installed s|  7j#8#8E'EEEFF F T] * *%"DI"""  t~t.v...r(c|}||tvrtd|di}jD]\}}|t |kr&||vrt jd|||}n0||vr ||}n#|jvrt jd|n|$|jvrt jd|d|||<jrt|}j| zD]6}t||} | ||<||vr| ||<&| |j|<7fd|D} j| zD]'}| d ||D(nd | D} tjjjjrtjjjntjjj} tjjod jv} jr#| r!|| d ||| S| d|d|d} d|djd| }| r| |hkrj|||r||||S|rd}nd}t9djd|d|d| || rʉ|||ry||r$t> dj|g}nd}!|| ||||}|r|D]\}}|"|d|S|rd}nd}t9djd|d|d| t | dkr#d}dtGtI| d} nd}t djd|d| d|d|d | ||rd!}d"}t | dkr-| \}d#|d$jd%|} |||r||||d&zS | rOtKd'| Dr$t> d(|j|n|rd&}nd}t9||z#t8$rZ}tKd)| Dr$t> d*|j||nYd}~nud}~wwxYw| rNtKd+| Dr#t> d,j| |ntMdjd-| d.|j'|i|S| s| sd g}ng}tQ}g}g}| D]K}||vr|)||| vr|*|6|*|Lg}g}|D]K}||vr|)||| vr|*|6|*|L| |z } t | dkr#t> d/j| d0} ttWj,||| ||}!t |!dkr$t> d1j| pd2|!g}"t[|!D]=\}#}|#rt> d3| | r| |hkr1|||r|||cSn|| r|||rx.|||rL!|| ||}jr)| r'|| vr#t> d4j| |||cS|"*|#t8$r-}t> d5|j|Yd}~7d}~wwxYw|"D]}t> d6| !|| ||}jr)| r'|| vr#t> d4j| |||cS#t8$r,}t> d5|j|Yd}~d}~wwxYwt | |z x}$dkr!t d7| d8jd9|!d:|$d; d jvrd<}nd}t9djd=|!d>|)?zReturns the result of the original function, or the backend function if the backend is specified and that backend implements `func`.Nrcrdz() got multiple values for z$() missing required graph argument: z() required graph argument z is None; must be a graphcJh|]\}}|jvt|dd S__networkx_backend__N)rgetattr)r$gnamegrs rrz@_dispatchable._call_if_any_backends_installed..MsB###E1 0001488000r(c38K|]}t|ddVdSrrr$rs rr1z@_dispatchable._call_if_any_backends_installed..SsC++A5t<<++++++r(c0h|]}t|ddSrrrs rrz@_dispatchable._call_if_any_backends_installed..Xs5###1488###r(r>rr<zZNo other backends will be attempted, because the backend was specified with the `backend='z'` keyword argument.z3' backend raised NotImplementedError when calling 'z'.  extra_messagez for the given argumentsr8z' is not implemented by 'z ' backendz. z'%s' will mutate an input graph. This prevents automatic conversion to, and use of, backends listed in `nx.config.backend_priority`. Using backend specified by the `backend='%s'` keyword argument. This may change behavior by not mutating inputs.r mutationsrsz)' is unable to convert graph from backend z to 'z2' backend, which was specified with the `backend='z'` keyword argument. zconversions between backends (if configured) will not be attempted because the original input graph would not be mutated. Using the backend keyword e.g. `backend='some_backend'` will force conversions and not mutate the original input graph.zThis call will mutate inputs, so fall back to 'networkx' backend (without converting) since all input graphs are instances of nx.Graph and are hopefully compatible.z Backend 'z' does not implement 'z2'%s. This call will mutate an input, so automatic z with these argumentsc3JK|]}t|tjVdSr/rMnxGraphrs rr1z@_dispatchable._call_if_any_backends_installed..sD..#1bh//......r(zBackend '%s' can't run '%s'. %sc3JK|]}t|tjVdSr/rrs rr1z@_dispatchable._call_if_any_backends_installed..s.UUq:a22UUUUUUr(z-Backend '%s' raised when calling '%s': %s. %sc3JK|]}t|tjVdSr/rrs rr1z@_dispatchable._call_if_any_backends_installed..sD((1bh''((((((r(z:'%s' was called with inputs from multiple backends: %s. %szN' will mutate an input, but it was called with inputs from multiple backends: z . Automatic zCall to '%s' has inputs from multiple backends, %s, that have no priority set in `nx.config.backend_priority`, so automatic conversions to these backends will not be attempted.r"zaCall to '%s' has inputs from %s backends, and will try to use backends in the following order: %snozTrying next backend: '%s'zCall to '%s' is returning a graph from a different backend! It has inputs from %s backends, but ran with '%s' backend and is returning graph from '%s' backend)Backend '%s' raised when calling '%s': %sz2Trying backend: '%s' (ignoring `should_run=False`)zUnable to convert inputs from z backends and run 'z6'. NetworkX is configured to automatically convert to zB backends. To remedy this, you may enable automatic conversion to z backends by adding them to `nx.config.backend_priority`, or you may specify a backend to use with the `backend=` keyword argument.zO This function is included in NetworkX as an API to dispatch to other backends.z' is not implemented by z backends. To remedy this, you may enable automatic conversion to more backends (including 'networkx') by adding them to `nx.config.backend_priority`, or you may specify a backend to use with the `backend=` keyword argument.)/rJrhrorrrrr~rlistrLrKrrrYr9rSrr4r3r<r: _is_testing_convert_and_call_for_testsdiscard_can_backend_run_call_with_backend_does_backend_haver _can_convert_will_call_mutate_input_loggerdebug_convert_and_callrnextiterall RuntimeErrorrrTrappend itertoolschain enumerate_should_backend_run)%rr0r_r`rjgraphs_resolvedrposgraphlist_of_graphsgraph_backend_namesr9r<backend_kwarg_msgrextrarrcacherEmaybe_s mutate_msg fallback_msg msg_templaterbackend_fallbackseengroup1group2rgroup4group5group3 try_orderbackends_to_try_again is_not_firstunspecified_backendss%` r_call_if_any_backends_installedz-_dispatchable._call_if_any_backends_installeds   # L(H(HJ,JJJKK K+++-- / /JE3SYYF??#ty$V$VU$V$VWWWS &u d222yMMeMM} 444#9ccccc5 */&&   ::D)O,@,@,B,BB > >!%oe&  C(()//11 (((%%  PI' #. ..6I..!+.."4>42622 2  "!4 "!+|  ! xuu$ $ $Dt|| HHTNNN*** d#### d####$ $ $Dt|| HHTNNN*** d#### d####$t+ v;;??" MM8     FPPQQ y>>A   MM6 #+t    !#*3I*>*>, ,  &L, I 9<HHH) *!?.Al^.S.S,,\4HHS#66|T6RRRRRS&& "5?++L$GG?// dFKK"!33(*=tV!/ 3!-4G G G$MM!X!% 3 , , " )00>>>&    ? I  2  L MMDl    ++ "5tV' + %,???MMP +$$ &    ? I   ':T'AA# B BQ F FU1DUU UUUU"6UUU  T] * *" E E! 7  7 79 7 705  7 7   sW2T66 VAVV6bBb)b b7 "b22b7A d&& e0"ee__call__ct|jx}tr|Stt fd|DS)Nc3K|]n\}}|ds%|kr|n|dun,|kr|n|ddd VodS)znot NT)rBrS)r$arg_namearg_posr_r`ns rr1z8_dispatchable._will_call_mutate_input..s  "'&&v.. Xa'kkT']]vzz(/C/CD P P()7{{d7mm 8ABBz2Unable to convert from %s backends to '%s' backend)issubsetrr)rrjrrs rrz_dispatchable._can_convert#s^Z ' +>+G+G  &, ,   MMD#     r(ch|dkr d|jvSt|}t||jS)z/Does the specified backend have this algorithm?r>)r:rkrir)rrjr0s rrz _dispatchable._does_backend_have1s9 : % %. . --w ***r(c |dkr d|jvSt|}t||js#td||jdS||j||}t|ts|sPt|trd|nd}td||jt||||dSdS)zBCan the specified backend run this algorithm with these arguments?r>z$Backend '%s' does not implement '%s'F , because: r8z0Backend '%s' can't run `%s` with arguments: %s%sT) r:rkrirrrrerMr _LazyArgsRepr)rrjr_r`r0rereasons rrz_dispatchable._can_backend_run9s : % %. . --w **  MM6 di   5//$)T6:: gs # # 7 0:7C0H0HP,7,,,bF MMB dD&11    5tr(c :|dkrdSt|}||j||}t|ts|sPt|trd|nd}t d||jt||||dSdS)zShould the specified backend run this algorithm with these arguments? Note that this does not check ``backend.can_run``. r>Tr r8z4Backend '%s' shouldn't run `%s` with arguments: %s%sF)rkrfrrMrrrr )rrjr_r`r0rfr s rrz!_dispatchable._should_backend_runRs : % %4 --'' 4@@ j# & & j 3=j#3N3NV/:///TVF MMF dD&11    5tr(c V  jj|i| js j}|d= j|fSdkrdxxn#jjjj j durndurdnttrx j dust j rddnJ j dur9ttrksttr vrddndnttr̉ddkr/t j dd dnt j rddn j  j dinvjd krGt% j d d r,t j d jdn$dn! fd Ddurndurdnttrx j dust j rddnJ j dur9ttrksttr vrddndnttryddkr.t j dd n`t j rddnA j  j din$dn! fdDjD]'jvr+f d j D j <7 j }|%jvrPt/ddjdttrd}} n}} ttrd} } n} } tt2rv} n} t5|ddkr'|| | || |  j <) j}|d= j|fS)z~Convert graph arguments to the specified backend. Returns ------- args tuple and kwargs dict r0r>TFNr[rr{to_numpy_arraydtypenamesci|]G\}}j|xt|trj|dn|HS)Nr argumentsrMrrS)r$rErFbound edge_attrs rrGz4_dispatchable._convert_arguments..sbC!&!55IB*S#:N:NW5?..sA666TWBBBr(ci|]F\}}j|xt|trj|n|GSr/r)r$rErFr node_attrs rrGz4_dispatchable._convert_arguments..s`C!&!55IBz#s7K7KT5?..s333QTBBBr(c| g|]8}t|ddkr |   n|9S)rr>rprqrrrsrt graph_name use_cacher)r_convert_graph) r$rrjrprrrqrrrtrsrrs rr'z4_dispatchable._convert_arguments..s***q"8*EEUU''$#-#-,?,?-A#("+"+(   ***r(z!Missing required graph argument `z` in z functionrr)rbindapply_defaultsror`r_rrrsrtrprqrMrrcallablerfromkeysrrirrrr~rrSrTrr)rrjr_r`rr bound_kwargsrpreserve_edgesedgespreserve_nodesnodespreserve_graphrrrprrrqrrrtrss`` `` @@@@@@@@@r_convert_argumentsz _dispatchable._convert_argumentsjs=("'888 { , >:s++?"555j$//6':55 ',#! ',#     C ( ( !}##"]]5?:ad;K+LaPP %/*566 "&*#! ,8#oj91= ...7('44."]]5?7+C+I1MM "  * 0 0 2 2J % ' '  D ( (JJ +S 1 1 ,23t;;x 34@@; '+#! !45>>:s++?"555j$//6':55 ',#! ',#     C ( ( !}##"]]5?:ad;K+LMM %/*566 "&*#! ,8#oj94@ "  * 0 0 2 2J[7 7 E(((*************#_U3***&&$.= 444 #\E\\ \\\1488'%*N/33E:FFEE%8N&E1488'%*N/33E:FFEE%8N&E2C88:%*.B%BNN%9N5"8*EEUU-1-@-@$#(#(,:,:-;#("+"+.A . .EOE*|  #z<''r(c V| rt|ddnd} | | di|i} t|||||} t| | | \}}|dtjjvr tjd|d|j d|tkrtd |d |j d t d t|d d||j ||S|dkrt|d s$t d|j |||St|j} ||}n#t$$r| t'| | twxYwt|} |||||||p| du|j |}n'#t$$r| t'| | twxYw| Ct'| | |t dt|d d||j ||S)N__networkx_cache__r:rprqrrrsrt)rrzNote: conversions to backend graphs are saved to cache (`G.__networkx_cache__` on the original graph) by default. This warning means the cached graph is being used for the z backend in the call to a. For the cache to be consistent (i.e., correct), the input graph must not have been manually mutated since the cached graph was created. Examples of manually mutating the graph data structures resulting in an inconsistent cache include: >>> G[u][v][key] = val and >>> for u, v, d in G.edges(data=True): ... d[key] = val Using methods such as `G.add_edge(u, v, weight=val)` will correctly clear the cache to keep it consistent. You may also use `G.__networkx_cache__.clear()` to manually clear the cache, or set `G.__networkx_cache__` to None to disable caching for G. Enable or disable caching globally via `nx.config.cache_converted_graphs` config. To disable this warning: >>> nx.config.warnings_to_ignore.add("cache") z6Graph conversion aborted: unable to convert graph to 'z' backend in call to `z1', because this conversion has previously failed.zZUsing cached converted graph (from '%s' to '%s' backend) in call to '%s' for '%s' argumentrr>zUnable to convert input to 'networkx' backend in call to '%s' for '%s argument, because it is not from a backend (i.e., it does not have `G.__networkx_backend__` attribute). Using the original object: %s)rprqrrrsrtrrzUCaching converted graph (from '%s' to '%s' backend) in call to '%s' for '%s' argument)r setdefault_get_cache_key_get_from_cacherrYr=rrrr rrrrirkr convert_to_nxr _set_to_cacheconvert_from_nx)rrjrrprqrrrsrtrrrnx_cacherrE compat_keyrr0s rrz_dispatchable._convert_graph7s BKT75"6===PT  '' B77BB>>MN$0NN$(9 NNN.*** .I(II@D III  8E#94@@ I  : % %5"899  !I #E$>??G **511   '!%.?@@@  $L11G ,,))(;(;*>)UQUAU)-     '!%.?@@@    %b ) ) ) MM45t<<      s E$F&F==$G!rc n|dkr |j|i|St|}td||jt ||| t ||j|i|S#t$r:}|2td||j|t||d}~wwxYw)zICall this dispatchable function with a backend without converting inputs.r>6Using backend '%s' for call to '%s' with arguments: %sNr)rrkrrrr rr)rrjr_r`rr0rs rrz _dispatchable._call_with_backends : % %!4>42622 2 -- D  I $f - -    .77DI..??? ?"   ( ? I  *-88cA  sA00 B4:5B//B4rc H|dkr|j}n$t|}t||j}||hz } tdt | dkr| ndtt| dt | dkrdnd||j | |||tj j |\} } nK#t$r>} t jd|dnd z|||jg|d n| fR|t|| d } ~ wwxYw|dkr1td ||jt|| |  || i| S#t$r:} |2td ||j| t|| d } ~ wwxYw)aCall this dispatchable function with a backend after converting inputs. Parameters ---------- backend_name : str input_backend_names : set[str] args : arguments tuple kwargs : keywords dict extra_message : str, optional Additional message to log if NotImplementedError is raised by backend. mutations : list, optional Used to clear objects gotten from cache if inputs will be mutated. r>zJConverting input graphs from %s backend%s to '%s' backend for call to '%s'rrcrr8rrzAFailed to convert graphs from %s to '%s' backend for call to '%s'Nz: %sr"r5r)rrkrrrrrrrr(rrYr;rr ) rrjinput_backend_namesr_r`rrrr0other_backend_namesconverted_argsconverted_kwargsrs rrz_dispatchable._convert_and_calls8. : % %>DD#L11G7DI..D1\NB X&''!++ 7T$23344777*++a//CCR  I    /3/F/F):# 0G00 ,N,,#    MS&.22F<#   &-""C6     ()-88cA   : % % MMH dN4DEE     4<+;<< <"   ( ? I  *-88cA  s0%,C D9DDE F!'5FF!rc<  !"#$%&'()*+,-t|}|||s|sjs@|r1td|jt ||j|i|Sddl}djd|}t|jr|dz }| |ddl m m !m"ddlm(m)dd lmmm%m&dd lm,dd lm#ddl*dd lmm$dd lm+j odj!vojdv}dj!vo"||} |r|s| s|x} } n"tG!#$%&(),f d|D\} } |r|s| s|x} } nStG!#$%&(),-f d|$D\} } tK| } tK| } &|| | dd\}}n#tN$r}|r3td|jj| i| cYd}~Sddl}| |j(r |j(dnjdtS|j*Yd}~nd}~wwxYw| rj+j,|i|}|-j+j,| i| }|-jD]@}|j.|}|j.||cxurn$||j.|<A|j(} |j/} | 0ddtd|jt || tc|j|i|}n#tN$r}|r4td|j|j| i| cYd}~Sddl}| |j(r |j(dnjdtS|j*Yd}~nd}~wwxYwj te|tfj4pEt|dp5te|tjtlzotod|Dkrdjdvrtod|DsBjdvrtod|Ds jdvrtqd jd* !"'*+fd! ''fd"}jd#vrnqte|!r ||}nU '|n=#tp$r0}tqjd$|d%tS|d&|d}~wwxYw'|d+d(}| rXj| i| }jD]C}|j.|}|j.|}||#|9|}|||d)D|9|}|r:te|tfj4r | r|}n j| i| }||||S|S),zECall this dispatchable function with a backend; for use with testing.zZFalling back to use 'networkx' instead of '%s' backend for call to '%s' with arguments: %srNrcz' not implemented by z with the given arguments)IterableIteratorMapping)copydeepcopy)BufferedReaderBytesIOStringIO TextIOWrapper)tee)Random) Generator RandomState)sparrayr>>read_gml read_gexf from_pydot read_pajek read_graph6 read_adjlist read_graphml read_sparse6 read_edgelistpydot_read_dotquotient_graphagraph_read_dotread_multiline_adjlistbipartite_read_edgelistc3 K|]y}t|r | |fnWt|zzzr | |fn1t|rt| zs  |n||fVzdSr/rM) r$argrBrCrHr>rGrIrDrEr@rArFs rr1z<_dispatchable._convert_and_call_for_tests..bs  "#{33$S((3--(("#w'9F'BY'NOO$#ttCyy))"#x00$&sN],JKK$Ss      r(c3H K|]\}}t|r||f| |ffnst| zzzr||f| |ffnIt|r2t| zs| |xdf|dffn||f||ffVdS)rrNrZ)r$rrrBrCrHr>rGrIrDrEr@rArFteeds rr1z<_dispatchable._convert_and_call_for_tests..rs   1"![11*aVa!-.."!Wx%7&%@9%LMM*1a&1dd1gg,//"!X..*&q.=*HII*1ss1vv~tq12QQLAAa&1a&)      r(Fr7z`Graph conversion failed; falling back to use 'networkx' instead of '%s' backend for call to '%s'z raised r0r5zRBackend '%s' raised when calling '%s': %s; falling back to use 'networkx' instead.rc3jK|].}t|tjpt|dV/dSr)rMrrrir$r%s rr1z<_dispatchable._convert_and_call_for_tests..sRq"(++Qwq:P/Q/Qr(>check_planaritycheck_planarity_recursivec3K|]}|duV dSr/r"r_s rr1z<_dispatchable._convert_and_call_for_tests..s&22aT 222222r(>held_karp_ascentc3@K|]}t|tVdSr/)rMrr_s rr1z<_dispatchable._convert_and_call_for_tests..s,<< 1d++<<<<< all_triadsnonisomorphic_treesgeneral_k_edge_subgraphsz!`returns_graph` is incorrect for c `t|jr-tjd|dt |d|dt|j zrdSt|t jr,|j|dz|j |dzdSt|rtt|r*t|ts|D]}||dzt|r'| D]}||dzdSdS)N returned a numpy scalar  (z, depth=)r)depth) rMnumberrrrNndarrayrr_node_adjrrr) rFrlr%r=r>r? check_resultnprrJs rrqz?_dispatchable._convert_and_call_for_tests..check_results#ry)) "y]]3]]$s))]]UZ]]]#rzG344 #rx((  SYeai8888 SXUQY7777#x(( *))#x(( 5C1E1E 555A L%!)44444#w'' 555A L%!)44444 5 555r(c 3K|D]P} |n=#t$r0}tjd|dt|d|d}~wwxYw|VQdS)Nrirjrk)rrrN)itrFrrqrs rcheck_iteratorzA_dispatchable._convert_and_call_for_tests..check_iterators   L%%%%#&9RRsRRd3iiRRR   s  A+A  A> from_edgelistrirjrkTcn||ksJ||ksJ||usJ||usJ|r8|j|jksJ|j|jksJ|j|jksJdSt|t|ksJt|jt|jksJdSr/) number_of_nodesnumber_of_edges is_directed is_multigraphrrorprTr$)G1G2stricts rassert_graphs_equalzF_dispatchable._convert_and_call_for_tests..assert_graphs_equal s3%%''2+=+=+?+?????%%''2+=+=+?+?????>>##r~~'7'77777##%%)9)9););;;;; 6x28++++x28++++w"'))))))2ww#b''))))28}}BH 555555r()r~)rT):rkrrorrrr rpytestrixfailcollections.abcr=r>r?r@rAiorBrCrDrErrFrandomrGnumpy numpy.randomrHrI scipy.sparserJrr:rziprrr(rr_rNrrrrrr`rrrMrrtuplerrrr/).rrjr_r`r<r0rmsgcompare_result_to_nxcompare_inputs_to_nxargs_to_convertargs_nxkwargs_to_convert kwargs_nxr:r;r bound_backendbound_nxrgraph_nxresultrur result_nxG0r|converted_resultrmrBrCrHr=r>r?rGrIrDrErqr@rArrrJrFr]s.` @@@@@@@@@@@@@@@@@rrz)_dispatchable._convert_and_call_for_testss  --$$\4@@  7T[ 7!MM>$ %dD&99 &t~t6v666 MMMDdiDDlDDCw ** 322 LL   ??????????''''''''GGGGGGGGGGGG!!!!!!!!!!!!77777777((((((   dm+   4 $- ' VD,H,Hv,V,V   / 8L (, ,Ogg'*               $    ( $OW (1 (:N (,2 2  +.               !'     , ( y!%%6 7 7 YI /3/F/F! 0G00 ,N,,#    = 7 I  &t~w<)<<<<<<<< MMM LL"xW  -W-W499CU-W-W          +3D.3^XGWXXM  ( ( * * *.t).E9EEH  # # % % % @ @#-e4 *51XIIIIIIII08 H&u-mG I MM)T * * * D  I $0@ A A     0WWdi00.UDTUUFF"    = > I &t~w<)<<<<<<<< MMM LL"xW  -W-W499CU-W-W         (  628,,6#9::fedl33#   MMM22622222N  111<&=9==I > >",U3'.>R^ ..r22B''Bu===="0088  J/?$J$J $ :"DNG9y99  #3 4 4 4HsbG I2*/I-I2A I--I2!M== P0P 7P=A P  P T%% U/+UUcl|jdhkr|jSddg}t|jdhz D]}t|}d|vr!||d|dn||d|vs|j|dvr|ds|d|j}|dp|d x}r5|d |d Dd }nd }|dp|dx}r|r|d|dt|D]Q}|d|||x} r|d| |dRn|d|dx} r.|d| d|d|jpd} | s d|jd} |jrB| d |} | d| } d|jvr| d }d} ||  s| dz } ||  | t|krL||  r2| dz } | t|kr||  2t|j}t|dkrd}nt|dkr d|dd}n`t|dkrd|dd|dd}n7d d! d"|d#d$Dzd%|d$dz}d&|d'} || | d |} | S)(zGenerate the backends section at the end for functions having an alternate backend implementation(s) using the `backend_info` entry-point.r>Backendsz-------- short_summaryz : rr8additional_docsextra_docstringc3(K|] }|rd|n|VdS)z Nr")r$lines rr1z*_dispatchable._make_doc..MsB6:41KKKKTr( TFextra_parametersadditional_parametersz Additional parameters:z z urlz [`Source `_]zThe original docstring for z was empty.z z rrz such as ""rz or "z such as , c3"K|] }d|dV dS)rNr"r_s rr1z*_dispatchable._make_doc..s*@@QA@@@@@@r(Nr{z, or "z .. attention:: This function does not have a default NetworkX implementation. It may only be run with an installable :doc:`backend ` that supports itz. Hint: use ``backend=...`` keyword argument to specify a backend or add backends to ``nx.config.backend_priority``.)r:rrUrJrrrSextendr*rstriprjoinr#rinsert)rlinesr0rW func_info func_docsadd_gaprparamdescfunc_urlnew_docto_addindexr:examples rrz_dispatchable._make_doc2s =ZL ( (> !   dmzl:;;) !) !G(D$&& CCD,ACCDDDD W%%%$&&$)4 ;L*L*L R   [)$)4I /00TIMMBS4T4Ty  >Good>S>S 011:==!899 !%LL$$$ 7888#$455%%ELL000/66t6 _d__555LL$$$$ %  R   $==///x ! 8(888999 R   .&B~~ KJDIJJJG = < IIKKK]]5))F ));;6;;G T] * *MM$''EEEl((**  El((** #e**$$u););)=)=$ #e**$$u););)=)=$dm,,H8}}!!X!##5x{555X!##Gx{GG!GGG ii@@(3B3-@@@@@A.x|.../ F&-FFF  LL ' ' 'ii&&Gr(c t|jffS)zAllow this object to be serialized with pickle. This uses the global registry `_registered_algorithms` to deserialize. )_restore_dispatchabler)rs r __reduce__z_dispatchable.__reduce__s %tyl22r(r/)rrrrrpropertyrOsetterrrrr:rtypingCallable__annotations__rrrrrr(rrrrrrr"r(rr r s*K@!!" @@@@@DX ^  ^ ""X"J@D / / / / /AEi i i i i Z,4W''9W fo   2   +++20K(K(K(Z{{{zOS>NNNNNb=BT T T T T l]]]~33333r(c&t|jSr/)rr)rs rrrs !$ ' 33r(c|!t|n||!t|n|fS)zLReturn key used by networkx caching given arguments for ``convert_from_nx``.) frozensetrr+s rr-r-sX  ! *""$$%%%  ! *""$$%%%  r()rjrcJ|*|di|i}|sdS|\}}tj|dur|dfnd|dur|dfndD]I}||x}0|tks||kr||||f||fcSJt |D]\\}} } | tkrY|dus|durn|dus|dus||s:| dus|durn| dus|dus| |sat||<n'|dus|durn|dus|dus||s|dus| durn|dus| dus|| s||||| ff|| f| fcSdS)aSearch the networkx cache for a graph that is compatible with ``key``. Parameters ---------- cache : dict If ``backend_name`` is given, then this is treated as ``G.__networkx_cache__``, but if ``backend_name`` is None, then this is treated as the resolved inner cache such as ``G.__networkx_cache__["backends"][backend_name]``. key : tuple Cache key from ``_get_cache_key``. backend_name : str, optional Name of the backend to control how ``cache`` is interpreted. mutations : list, optional Used internally to clear objects gotten from cache if inputs will be mutated. Returns ------- tuple or None The key of the compatible graph found in the cache. graph or "FAILED_TO_CONVERT" or None A compatible graph if possible. "FAILED_TO_CONVERT" indicates that a previous conversion attempt failed for this cache key. Nr:)NNTrF)rSrproductr rrrr) rrErjredge_keynode_keyr3rekeynkeyrs rr.r.si0 *b))--lB?? z Hh'$D004g$D004g " " ))J'' 'B 4 # # #sj'8'8$  %!4555r> ! ! ! $EKKMM22## te % % %u}}D 0 0U!2!2$--:Q:Q!2u}}D 0 0U!2!2$--:Q:Q!2*E#JJ   $$,,    h6G6G6M6M  u      h6G6G6M6M      edD\2 3 3 3d|U"""" :r()rjc|*|di|i}i}|\}}|||<|tkr|St|D]y}||kr |\}} |dus|durn|dus|dus||s5| dus|durn| dus|dus| |s\||dx}|||<z|S)aSet a backend graph to the cache, and remove unnecessary cached items. Parameters ---------- cache : dict If ``backend_name`` is given, then this is treated as ``G.__networkx_cache__``, but if ``backend_name`` is None, then this is treated as the resolved inner cache such as ``G.__networkx_cache__["backends"][backend_name]``. key : tuple Cache key from ``_get_cache_key``. graph : graph or "FAILED_TO_CONVERT" Setting value to "FAILED_TO_CONVERT" prevents this conversion from being attempted in future calls. backend_name : str, optional Name of the backend to control how ``cache`` is interpreted. Returns ------- dict The items that were removed from the cache. Nr:FT)r,r rrr) rrErrjremovedrrcur_keyrrs rr0r0s',  R00;;L"MM GHhE#J !!!;;%% c>>  d 5==H,,  T\\X..dmmH6M6M.  5==H,,  T\\X..dmmH6M6M. YYw-- -E :$GG  Nr(ceZdZdZdZdZdS)r zOSimple wrapper to display arguments of dispatchable functions in logging calls.c>||_||_||_d|_dSr/)rr_r`value)rrr_r`s r__init__z_LazyArgsRepr.__init__>s"    r(c|jb|jjj|ji|j}dd|jD}d|d|_|jS)Nrc3*K|]\}}|d|VdS)=Nr"rDs rr1z)_LazyArgsRepr.__repr__..Gs4WW83..s..WWWWWWr((rk) rrr bind_partialr_r`rrr)rrinners r__repr__z_LazyArgsRepr.__repr__Dso : 8DI+8$)St{SSEIIWWu?T?T?V?VWWWWWE%UDJzr(N)rrrrOrrr"r(rr r ;s8YY r(r _NETWORKX_BUILDING_DOCS_c `|ttfi|St|fi|}|j|_|Sr/)rr _orig_dispatchablerO)rr`dispatched_funcs rr r TsA <=33F33 3,T<rconfigsrrr decoratorsr __all__ getLoggerrrr rr:rJrgrr,r[r]rarkr rr-r.r0r rRrSrrrOrrrrrrr"r(rrs2 ++++++>>>>>>>>>>   ' H % %'+0+++++b =, - - RRRCCCL   G3G3G3G3G3G3G3G3T6444.15QQQQQh6:00000f":>>,-- '/6>M 7 /7 8 8D"&,,HH$/"7"7"9"9HHH#/##M#r(