python (3.11.7)
e% r d dl mZ ddgZdZdZ G d d Z G d de Z G d d Zd
S ) ) GenericAliasTopologicalSorter
CycleErrorc e Zd ZdZd ZdS ) _NodeInfonode
npredecessors
successorsc 0 || _ d| _ g | _ d S Nr r
)selfr s </BuggyBox/python/3.11.7/bootstrap/lib/python3.11/graphlib.py__init__z_NodeInfo.__init__ s
N)__name__
__module__ __qualname__ __slots__r r r r r s( 5I r r c e Zd ZdZdS )r aC Subclass of ValueError raised by TopologicalSorter.prepare if cycles
exist in the working graph.
If multiple cycles exist, only one undefined choice among them will be reported
and included in the exception. The detected cycle can be accessed via the second
element in the *args* attribute of the exception instance and consists in a list
of nodes, such that each node is, in the graph, an immediate predecessor of the
next node in the list. In the reported list, the first and the last node will be
the same, to make it clear that it is cyclic.
N)r r r __doc__r r r r r s Dr c f e Zd ZdZd
dZd Zd Zd Zd Zd Z d Z
d
Z d Z d Z
ee ZdS )r zFProvides functionality to topologically sort a graph of hashable nodesNc i | _ d | _ d| _ d| _ |(| D ]\ }} | j |g|R d S d S r )
_node2info _ready_nodes _npassedout
_nfinisheditemsadd)r graphr predecessorss r r zTopologicalSorter.__init__, sq &+kkmm
.
."l- -----
.
.r c p | j | x}t | x| j |< }|S N)r getr )r r results r
_get_nodeinfoz TopologicalSorter._get_nodeinfo6 s9 o))$// /F 8-6t__ <DOD !F
r c | j t d | | }|xj t | z
c_ |D ]1}| | }|j | 2dS )a Add a new node and its predecessors to the graph.
Both the *node* and all elements in *predecessors* must be hashable.
If called multiple times with the same node argument, the set of dependencies
will be the union of all dependencies passed in.
It is possible to add a node with no dependencies (*predecessors* is not provided)
as well as provide a dependency twice. If a node that has not been provided before
is included among *predecessors* it will be automatically added to the graph with
no predecessors of its own.
Raises ValueError if called after "prepare".
Nz/Nodes cannot be added after a call to prepare())r
ValueErrorr) r lenr
append)r r r$ nodeinfopred pred_infos r r" zTopologicalSorter.add; s ( NOO O %%d++ #l"3"33 ! . .D **400I ' ' - - - - . .r c | j t d d | j D | _ | }|rt d| dS )ax Mark the graph as finished and check for cycles in the graph.
If any cycle is detected, "CycleError" will be raised, but "get_ready" can
still be used to obtain as many nodes as possible until cycles block more
progress. After a call to this function, the graph cannot be modified and
therefore no more nodes can be added using "add".
Nz cannot prepare() more than oncec 2 g | ]}|j d k
|j S )r )r r ).0is r
<listcomp>z-TopologicalSorter.prepare.<locals>.<listcomp>a s-
18L8LAF8L8L8Lr znodes are in a cycle)r r+ r values _find_cycler )r cycles r preparezTopologicalSorter.prepareV s ( >?? ?
O 2 2 4 4
"" = 4e<< < = =r c | j t d t | j }| j }|D ]}t || _ | j | xj t | z
c_ |S )a Return a tuple of all the nodes that are ready.
Initially it returns all nodes with no predecessors; once those are marked
as processed by calling "done", further calls will return all new nodes that
have all their predecessors already processed. Once no more progress can be made,
empty tuples are returned.
Raises ValueError if called without calling "prepare" previously.
N prepare() must be called first) r r+ tupler _NODE_OUTr clearr r, )r r( n2ir s r get_readyzTopologicalSorter.get_readyl s $ =>> > t())o 0 0D&/CI # #
!!! CKK'
r c v | j t d | j | j k pt | j S )a Return ``True`` if more progress can be made and ``False`` otherwise.
Progress can be made if cycles do not block the resolution and either there
are still nodes ready that haven't yet been returned by "get_ready" or the
number of nodes marked "done" is less than the number that have been returned
by "get_ready".
Raises ValueError if called without calling "prepare" previously.
Nr; )r r+ r r boolr s r is_activezTopologicalSorter.is_active s< $ =>> >!11LT$:K5L5LLr c * | S r& )rD rC s r __bool__zTopologicalSorter.__bool__ s ~~ r c | j t d | j }|D ]}| | x}t d|d |j }|t
k rG|dk rt d|d |t k rt d|d J d|d | t |_ |j D ]?}|| }|xj d
z c_ |j dk r| j | @| xj d
z
c_ dS ) a Marks a set of nodes returned by "get_ready" as processed.
This method unblocks any successor of each node in *nodes* for being returned
in the future by a call to "get_ready".
Raises :exec:`ValueError` if any node in *nodes* has already been marked as
processed by a previous call to this method, if a node was not added to the
graph by using "add" or if called without calling "prepare" previously or if
node has not yet been returned by "get_ready".
Nr; znode z was not added using add()r z% was not passed out (still not ready)z was already marked doneFz: unknown status )
r r+ r r' r r=
_NODE_DONEr
r- r )r nodesr? r r. stat successorsuccessor_infos r donezTopologicalSorter.done sd $ =>> >o ! !D GGDMM)2 !K!K!K!KLLL )Dy 199$MMMM Z''$%MT%M%M%MNNNI"I$"I"I4"I"IIII &0H " & 0
8
8 !$Y ,,1,,!/144%,,Y777 OOq OOO9 ! !r c | j }g }g }t }i }|D ]}||v r ||v r||v r||| d |gz c S nn| | | t || j j t | ||< | | |rM |d }n<# t $ r, || = | Y nw xY w|Mnތd S )NTr )
r setr" r- iterr
__next__r,
StopIterationpop)r r? stackitstackseen node2stackir s r r7 z TopologicalSorter._find_cycle sQ ouu Dt||
4<< {** $[%6%8%8 9TF BBBB + HHTNNNNN4D (<#=#=#FGGG(+E
K%LL&&& & *wr{}} ( & & & ' 4
& /
. ts 6C3C=<C=c # K | | r<| }|E d{V | j | | :dS dS )aQ Returns an iterable of nodes in a topological order.
The particular order that is returned may depend on the specific
order in which the items were inserted in the graph.
Using this method does not require to call "prepare" or "done". If any
cycle is detected, :exc:`CycleError` will be raised.
N)r9 rD r@ rN )r
node_groups r static_orderz TopologicalSorter.static_order s
nn # ))J! ! ! ! ! ! ! ! DIz " " nn # # # # #r r& )r r r r r r) r" r9 r@ rD rF rN r7 r[ classmethodr __class_getitem__r r r r r ) s PP. . . .
. . .6= = =, 4 M M M -! -! -!^# # #J
#
#
# $ L11r N) typesr __all__r= rI r r+ r r r r r <module>r` s
-
" Q2 Q2 Q2 Q2 Q2 Q2 Q2 Q2 Q2 Q2r 
Browse
Usage
Versions