-=[ Mr. Bumblebee ]=-
_Indonesia_
ó
ī:ļNc @@ s d Z d d l m Z d d l m Z m Z m Z d d d d g Z d Z
d e f d YZ d e d
Z d e f d YZ d S(
s Topological sorting routines.i ( t absolute_import( t errorst grapht revisiont topo_sortt
TopoSortert
merge_sortt MergeSorterc C@ s t j t | } | j S( s Topological sort a graph.
graph -- sequence of pairs of node->parents_list.
The result is a list of node names, such that all parents come before their
children.
node identifiers can be any hashable object, and are typically strings.
This function has the same purpose as the TopoSorter class, but uses a
different algorithm to sort the graph. That means that while both return a
list with parents before their child nodes, the exact ordering can be
different.
topo_sort is faster when the whole list is needed, while when iterating
over a part of the list, TopoSorter.iter_topo_order should be used.
( t
_mod_grapht
KnownGrapht dictR ( R t kg( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/tsort.pyR s c B@ s# e Z d Z d Z d Z RS( c C@ s t | | _ d S( s Topological sorting of a graph.
:param graph: sequence of pairs of node_name->parent_names_list.
i.e. [('C', ['B']), ('B', ['A']), ('A', [])]
For this input the output from the sort or
iter_topo_order routines will be:
'A', 'B', 'C'
node identifiers can be any hashable object, and are typically strings.
If you have a graph like [('a', ['b']), ('a', ['c'])] this will only use
one of the two values for 'a'.
The graph is sorted lazily: until you iterate or sort the input is
not processed other than to create an internal representation.
iteration or sorting may raise GraphCycleError if a cycle is present
in the graph.
N( R
t _graph( t selfR ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/tsort.pyt __init__8 s c C@ s t | j S( s| Sort the graph and return as a list.
After calling this the sorter is empty and you must create a new one.
( t listt iter_topo_order( R
( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/tsort.pyt sortedO s c c@ s; | j } t | } g } g } t } x
| r6| j \ } } | j | | j t | xĖ | r2| d } | s© | j } | j | j | | Vqh | j }
|
| k rĒ qh n |
| k rŁ qh n y | j |
} Wn t k
rt j | n X| j |
| j t | qh Wq- Wd S( s Yield the nodes of the graph in a topological order.
After finishing iteration the sorter is empty and you cannot continue
iteration.
i’’’’N(
R t sett popitemt appendR t popt addt KeyErrorR t GraphCycleError( R
R t visitablet pending_node_stackt pending_parents_stackt completed_node_namest node_namet parentst parents_to_visitt popped_nodet next_node_name( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/tsort.pyR ` s6
( t __name__t
__module__R R R ( ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/tsort.pyR 6 s c C@ s t | | | | j S( s§ Topological sort a graph which groups merges.
:param graph: sequence of pairs of node->parents_list.
:param branch_tip: the tip of the branch to graph. Revisions not
reachable from branch_tip are not included in the
output.
:param mainline_revisions: If not None this forces a mainline to be
used rather than synthesised from the graph.
This must be a valid path through some part
of the graph. If the mainline does not cover all
the revisions, output stops at the start of the
old revision listed in the mainline revisions
list.
The order for this parameter is oldest-first.
:param generate_revno: Optional parameter controlling the generation of
revision number sequences in the output. See the output description of
the MergeSorter docstring for details.
:result: See the MergeSorter docstring for details.
Node identifiers can be any hashable object, and are typically strings.
( R R ( R t
branch_tipt mainline_revisionst generate_revno( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/tsort.pyR ¢ s c B@ sk e Z d d d d d d d d d d d
d d d
g Z d e d Z d Z d Z d Z d Z RS( t _node_name_stackt _node_merge_depth_stackt _pending_parents_stackt _first_child_stackt _left_subtree_pushed_stackt _generate_revnoR t _mainline_revisionst _stop_revisiont _original_grapht _revnost _revno_to_branch_countt _completed_node_namest _scheduled_nodesc
C@ sĶ | | _ t | | _ | d k r9 g | _ d | _ n t | | _ | j d | _ x t | j d D]
\ } } | j | } | d k r ql n | j | } | s° ql n | d | k rĘ ql n | j | j | | j | j d | ql Wt | j j
| _ t d | j D | _ i | _
g | _ g | _ g | _ g | _ t | _ g | _ g | _ | d k rÉ| t j k rÉ| t j f k rÉ| j j | } | j | d | n d S( sN Merge-aware topological sorting of a graph.
:param graph: sequence of pairs of node_name->parent_names_list.
i.e. [('C', ['B']), ('B', ['A']), ('A', [])]
For this input the output from the sort or
iter_topo_order routines will be:
'A', 'B', 'C'
:param branch_tip: the tip of the branch to graph. Revisions not
reachable from branch_tip are not included in the
output.
:param mainline_revisions: If not None this forces a mainline to be
used rather than synthesised from the graph.
This must be a valid path through some part
of the graph. If the mainline does not cover all
the revisions, output stops at the start of the
old revision listed in the mainline revisions
list.
The order for this parameter is oldest-first.
:param generate_revno: Optional parameter controlling the generation of
revision number sequences in the output. See the output description
for more details.
The result is a list sorted so that all parents come before
their children. Each element of the list is a tuple containing:
(sequence_number, node_name, merge_depth, end_of_merge)
* sequence_number: The sequence of this row in the output. Useful for
GUIs.
* node_name: The node name: opaque text to the merge routine.
* merge_depth: How many levels of merging deep this node has been
found.
* revno_sequence: When requested this field provides a sequence of
revision numbers for all revisions. The format is:
(REVNO, BRANCHNUM, BRANCHREVNO). BRANCHNUM is the number of the
branch that the revno is on. From left to right the REVNO numbers
are the sequence numbers within that branch of the revision.
For instance, the graph {A:[], B:['A'], C:['A', 'B']} will get
the following revno_sequences assigned: A:(1,), B:(1,1,1), C:(2,).
This should be read as 'A is the first commit in the trunk',
'B is the first commit on the first branch made from A', 'C is the
second commit in the trunk'.
* end_of_merge: When True the next node is part of a different merge.
node identifiers can be any hashable object, and are typically strings.
If you have a graph like [('a', ['b']), ('a', ['c'])] this will only use
one of the two values for 'a'.
The graph is sorted lazily: until you iterate or sort the input is
not processed other than to create an internal representation.
iteration or sorting may raise GraphCycleError if a cycle is present
in the graph.
Background information on the design:
-------------------------------------
definition: the end of any cluster or 'merge' occurs when:
1 - the next revision has a lower merge depth than we do.
i.e.
A 0
B 1
C 2
D 1
E 0
C, D are the ends of clusters, E might be but we need more data.
2 - or the next revision at our merge depth is not our left most
ancestor.
This is required to handle multiple-merges in one commit.
i.e.
A 0 [F, B, E]
B 1 [D, C]
C 2 [D]
D 1 [F]
E 1 [F]
F 0
C is the end of a cluster due to rule 1.
D is not the end of a cluster from rule 1, but is from rule 2: E
is not its left most ancestor
E is the end of a cluster due to rule 1
F might be but we need more data.
we show connecting lines to a parent when:
- The parent is the start of a merge within this cluster.
That is, the merge was not done to the mainline before this cluster
was merged to the mainline.
This can be detected thus:
* The parent has a higher merge depth and is the next revision in
the list.
The next revision in the list constraint is needed for this case:
A 0 [D, B]
B 1 [C, F] # we do not want to show a line to F which is depth 2
but not a merge
C 1 [H] # note that this is a long line to show back to the
ancestor - see the end of merge rules.
D 0 [G, E]
E 1 [G, F]
F 2 [G]
G 1 [H]
H 0
- Part of this merges 'branch':
The parent has the same merge depth and is our left most parent and we
are not the end of the cluster.
A 0 [C, B] lines: [B, C]
B 1 [E, C] lines: [C]
C 0 [D] lines: [D]
D 0 [F, E] lines: [E, F]
E 1 [F] lines: [F]
F 0
- The end of this merge/cluster:
we can ONLY have multiple parents at the end of a cluster if this
branch was previously merged into the 'mainline'.
- if we have one and only one parent, show it
Note that this may be to a greater merge depth - for instance if
this branch continued from a deeply nested branch to add something
to it.
- if we have more than one parent - show the second oldest (older ==
further down the list) parent with
an equal or lower merge depth
XXXX revisit when awake. ddaa asks about the relevance of each one
- maybe more than one parent is relevant
i i c s@ s! | ] } | d t g f Vq d S( N( t Nonet True( t .0R ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/tsort.pys <genexpr>v s N( R, R
R R4 R- R. R t enumeratet removet insertt itemsR/ R0 R1 R' R( R) R* R R2 R3 R+ t
_mod_revisiont
NULL_REVISIONR t
_push_node(
R
R R$ R% R& t indexR t parentt graph_parent_idsR ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/tsort.pyR Ī sD |
c C@ s t | j S( s| Sort the graph and return as a list.
After calling this the sorter is empty and you must create a new one.
( R R ( R
( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/tsort.pyR £ s c c@ sĖ | j } | j } | j } | j } | j } | j } | j j } | j | j | j | j | j j | j
d } | j | j | j j | j | j | j | j
| j j | j | j
d
} x| rĪ| d }
|
są | qĄ xč | d rŹ| d s | d j d } t } t | d <n | d j } t } | | k rEqć n y | | }
Wn5 t k
r| | j k rć t j | qqć n Xd } | r¢d } n d } | d | } | | | |
Pqć WqĄ Wd } | j } | j } | j } xŌ | rĘ| j \ } } } | | k r d St | s3t } nX | d d | k rPt } n; | d d | k r
| d d | | k r
t } n t } | rØ| | | | | f Vn | | | | f V| d 7} qóWd S( s Yield the nodes of the graph in a topological order.
After finishing iteration the sorter is empty and you cannot continue
iteration.
c S@ s | | | | | t | t | d } | rc y | | d } Wqc t k
r_ qc Xn | d k r | d }
t | d <n d }
| |
d S( s Add node_name to the pending node stack.
Names in this stack will get emitted into the output as they are popped
off the stack.
This inlines a lot of self._variable.append functions as local
variables.
i i N( t FalseR R4 R ( R t merge_depthR t node_name_stack_appendt node_merge_depth_stack_appendt left_subtree_pushed_stack_appendt pending_parents_stack_appendt first_child_stack_appendt revnost parent_infot first_child( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/tsort.pyt push_node» s
c
S@ sS | }
| } | } | | | |
}
d } |
rl y | |
d d } Wql t k
rh ql Xn | d k rą | sÄ | d } | j | d } | d 7} | | | <| d | d f } q$| d | d d f } nD | j d d } | d 7} | rd | d f } n d } | | d <| | |
d <| |
| |
| | f |
S( sc Pop the top node off the stack
The node is appended to the sorted output.
i i i’’’’N( i ( R4 R t get( t node_name_stack_popt node_merge_depth_stack_popt first_child_stack_popt left_subtree_pushed_stack_popt pending_parents_stack_popt original_graphRH t completed_node_names_addt scheduled_nodes_appendt revno_to_branch_countR RB RJ R t parent_revnot
base_revnot branch_countt revnot
root_count( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/tsort.pyt pop_nodeį s<
i’’’’i i N( R' R( R) R+ R2 R3 R R R R* R0 R/ R R1 R5 RA R R R R. R, t len( R
t node_name_stackt node_merge_depth_stackR t left_subtree_pushed_stackR t scheduled_nodest graph_popRK R[ R R! t is_left_subtreeR t next_merge_deptht sequence_numbert
stop_revisionR& RR R RB RY t end_of_merge( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/tsort.pyR Ŗ s 6
c C@ s» | j j | | j j | | j j t | j j t | d } | r~ y | j | d } Wq~ t k
rz q~ Xn | d k r” | d } t | d <n d } | j
j | d S( s Add node_name to the pending node stack.
Names in this stack will get emitted into the output as they are popped
off the stack.
i i N( R' R R( R+ RA R) R R4 R0 R R* ( R
R RB R RI RJ ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/tsort.pyR= z s
c
C@ s² | j j } | j j } | j j } | j j | j j | j | } d } | r y | j | d d } Wq t k
r q Xn | d k r
| sī | d } | j
j | d } | d 7} | | j
| <| d | d f } qi| d | d d f } n_ | j
j d d } | j
j d d } | d 7} | rVd | d f } n d } | | j
d <| | j | d <| j j
| | j j | | | j | d f | S( s[ Pop the top node off the stack
The node is appended to the sorted output.
i i i’’’’N( i ( R' R R( R* R+ R) R/ R4 R0 R R1 RL R2 R R3 R (
R
R RB RJ R RV RW RX RY RZ ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/tsort.pyt _pop_node s>
$N(
R" R# t __slots__R4 RA R R R R= Rg ( ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/tsort.pyR ¼ s( Ō Š N( t __doc__t
__future__R t bzrlibR R R R R; t __all__R t objectR R4 RA R R ( ( ( s0 /usr/lib/python2.7/dist-packages/bzrlib/tsort.pyt <module> s l
Copyright © 2017 || Recoded By Mr.Bumblebee