R`i6 d dl mZmZ d dlmZ d dlmZ d dlmZ d dl m
Z
m Z m Z m
Z
mZmZmZmZmZ ddlmZ ddlmZ dd lmZmZmZmZ dd
l m Z dd l m Z dd l m!Z! dd
l"m#Z# ddl$m%Z%m&Z& ddl'm(Z( ddl)m*Z* e
rd dl+m,Z, G d de Z-e de#f Z.e de-f Z/ G d de0 Z1 G d de1 Z2 G d d Z3 G d d e Z4 G d d e4 Z5 G d d e4 Z6e& G d! d Z7e8d"k( rd d#l9mZ e Z e7 Z:e:jw e7d$d%& e7dd'( e7d)d*+ e:d' jy e7d,- e7d.d/0 e:d. jy e7d1d/0 e7d2- e:d2 jw e7d3- e7d4- e7d5- e:d, jw e7e:jz d6- e7d7- e:d1 j} d8 ej e: y9y9): )ABCabstractmethod)islice)
itemgetter)RLock)
TYPE_CHECKINGDictIterableList
NamedTupleOptionalSequenceTupleUnion )
ratio_resolve)Align)ConsoleConsoleOptionsRenderableType RenderResult)ReprHighlighter)Panel)Pretty)Region)Result rich_repr)Segment) StyleTypeTreec 2 e Zd ZU dZeed< eee ed< y) LayoutRenderz An individual layout render.regionrenderN)__name__
__module__ __qualname____doc__r __annotations__r r /builddir/build/BUILDROOT/alt-python312-pip-23.3.1-3.el8.x86_64/opt/alt/python312/lib/python3.12/site-packages/pip/_vendor/rich/layout.pyr# r# s & N g r, r# Layoutc e Zd ZdZy) LayoutErrorzLayout related error.Nr& r' r( r) r+ r, r- r0 r0 + s r, r0 c e Zd ZdZy)
NoSplitterz"Requested splitter does not exist.Nr1 r+ r, r- r3 r3 / s ,r, r3 c H e Zd ZdZ e Zd dddeddfdZded e de
fd
Z y) _Placeholderz4An internal renderable used as a Layout placeholder.layoutr. stylereturnNc || _ || _ y N)r6 r7 )selfr6 r7 s r- __init__z_Placeholder.__init__8 s
r, consoleoptionsc # j K |j }|j xs |j j }| j }|j r|j d| d| dnd| d| d}t t
j t | d | j | j | d| y w) Nz (z x )(middle)verticalblue)r7 title border_styleheight) max_widthrG sizer6 namer r centerr r7 highlighter)r; r= r> widthrG r6 rE s r- __rich_console__z _Placeholder.__rich_console__< s !! 67<<#6#6 {{ {{oRwc& 3UG3vha(
LL ( ;**""5)
s B1B3) ) r& r' r( r) r rL r r< r r r rN r+ r, r- r5 r5 3 sD >!#Kx 4
)7
r, r5 c
j e Zd ZU dZdZeed< edefd Zede d de
de e de
f fd Z
y
) SplitterzBase class for a splitter.rO rJ r8 c y)z(Get the icon (emoji) used in layout.treeNr+ r; s r-
get_tree_iconzSplitter.get_tree_iconU r, childrenr. r$ c y)zDivide a region amongst several child layouts.
Args:
children (Sequence(Layout)): A number of child layouts.
region (Region): A rectangular region to divide.
Nr+ )r; rV r$ s r- dividezSplitter.divideY rU r, N)r& r' r( r) rJ strr* r rT r r r
r rX r+ r, r- rQ rQ P sg $D#N7s 7 7 * 4: %&() * r, rQ c J e Zd ZdZdZdefdZded dede e
def fdZ y )
RowSplitterz!Split a layout region in to rows.rowr8 c y)Nu [layout.tree.row]⬌r+ rS s r- rT zRowSplitter.get_tree_iconj s %r, rV r. r$ c # K |\ }}}}t || }d}t } t || D ] \ }
} |
| ||z || | f || z
} y wNr r r zip) r; rV r$ xyrM rG
render_widthsoffset_Regionchild child_widths r- rX zRowSplitter.dividem sf %1eV%eX6
"%h
"> E;VQ VDD D k !F #? AA
N r& r' r( r) rJ rY rT r r r
r rX r+ r, r- r[ r[ e sG + D&s & " * "4: " %&() * "r, r[ c J e Zd ZdZdZdefdZded dede e
def fdZ y )
ColumnSplitterz$Split a layout region in to columns.columnr8 c y)Nu [layout.tree.column]⬍r+ rS s r- rT z ColumnSplitter.get_tree_icon~ s (r, rV r. r$ c # K |\ }}}}t || }d}t } t || D ] \ }
} |
| |||z || f || z
} y wr_ r` ) r; rV r$ rb rc rM rG render_heightsre rf rg child_heights r- rX zColumnSplitter.divide sg %1eV&vx8#&x #@ E<AJ|DD D l "F $Ari Nrj r+ r, r- rl rl y sG . D)s ) # * #4: # %&() * #r, rl c e Zd ZdZeedZ d*dddddddee dee d ee
d
e
d e
d e d
dfdZ d
e
fdZed
efd Zed
ed fd Zed
efd Zde d
ed fdZde d
d fdZed+d Zddded ef deee f d
dfdZded ef d
dfdZded ef d
dfd Z ded ef d
dfd Z d,d Z ded
dfd Z d d!d"e d
dfd#Z d$e
d%e
d
e!fd&Z"d e#d'e$d
efd(Z%d e#d'e$d
e&fd)Z'y)-r. aB A renderable to divide a fixed height in to rows or columns.
Args:
renderable (RenderableType, optional): Renderable content, or None for placeholder. Defaults to None.
name (str, optional): Optional identifier for Layout. Defaults to None.
size (int, optional): Optional fixed size of layout. Defaults to None.
minimum_size (int, optional): Minimum size of layout. Defaults to 1.
ratio (int, optional): Optional ratio for flexible layout. Defaults to 1.
visible (bool, optional): Visibility of layout. Defaults to True.
)r\ rm Nr T)rJ rI minimum_sizeratiovisible
renderablerJ rI rs rt ru r8 c |xs t | | _ || _ || _ || _ || _ || _ | j d | _ g | _ i | _
t | _ y )Nrm )
r5 _renderablerI rs rt rJ ru splitterssplitter _children _render_mapr _lock)r; rv rJ rI rs rt ru s r- r< zLayout.__init__ sg &; d); (
":$..":"<
')&(W
r, c # K d| j d f d| j d f d| j df d| j df y w)NrJ rI rs r rt )rJ rI rs rt rS s r-
__rich_repr__zLayout.__rich_repr__ sL dii%%dii%% d / /22tzz1$$s AAc 6 | j r| S | j S )zLayout renderable.)r{ rx rS s r- rv zLayout.renderable s ~~t;4+;+;;r, c Z | j D cg c] }|j s| c}S c c}w )z Gets (visible) layout children.)r{ ru )r; rg s r- rV zLayout.children s& $(>>C>%U]]>CCCs ((c | j S )z Get a map of the last render.)r| rS s r- mapz
Layout.map s r, c v | j |k( r| S | j D ] }|j | }||c S y)zGet a named layout, or None if it doesn't exist.
Args:
name (str): Name of layout.
Returns:
Optional[Layout]: Layout instance or None if no layout was found.
N)rJ r{ get)r; rJ rg named_layouts r- r z
Layout.get sA 99 K $yy +'' ( r, c H | j | }|t d| |S )NzNo layout with name )r KeyError)r; rJ r6 s r- __getitem__zLayout.__getitem__ s, $ > 1$:; ;
r, c ddl m ddlm ddlm} dddffd | } | | d |j j d
}d
fd || |S )z/Get a tree renderable to show layout structure.r )Styled)Tabler r6 r. r8 c | j j }j d }| j r t | n t | d }|j || |}|S )N)r r r r )paddingdim)rz rT gridru r add_row)r6 icontabletext_summaryr r s r- summaryz Layout.tree..summary s` ??002DJJ|J4E #)..vfVF^U6S
MM$ % HOr, layout.tree.T) guide_style highlightc |j D ]9 } | j | d|j j | ; y )Nr )r )r{ addrz rJ )treer6 rg recurser s r- r z Layout.tree..recurse sM ))HH &25>>3F3F2G$H *r, )r r! r6 r. r8 N)pip._vendor.rich.styledr pip._vendor.rich.tabler pip._vendor.rich.treer! rz rJ )r; r! r6 r r r r r s @@@@r- r z Layout.tree sg 30. H FO&v';';&<=
d r, rm )rz layoutsrz c |D cg c] }t |t r|n
t | ! }} t |t r|n | j | | _ || j dd yc c}w # t
$ r t
d| w xY w)zSplit the layout in to multiple sub-layouts.
Args:
*layouts (Layout): Positional arguments should be (sub) Layout instances.
splitter (Union[Splitter, str]): Splitter instance or name of splitter.
zNo splitter called N)
isinstancer. rQ ry rz r r3 r{ )r; rz r r6 _layoutss r- splitz Layout.split s "
! !0FfVn D!
A h1 -T^^H-/
M %q
A 28, ?@ @ As $A'+A, ,Bc L d |D }| j j | y)zAdd a new layout(s) to existing split.
Args:
*layouts (Union[Layout, RenderableType]): Positional arguments should be renderables or (sub) Layout instances.
c 3 V K | ]! }t |t r|n
t | # y wr: )r r. ).0r6 s r- z#Layout.add_split..& s*
! !0FfVn D!s ')N)r{ extend)r; r r s r- add_splitzLayout.add_split s%
!
h'r, c ( | j |ddi y)zSplit the layout in to a row (layouts side by side).
Args:
*layouts (Layout): Positional arguments should be (sub) Layout instances.
rz r\ Nr r; r s r- split_rowzLayout.split_row, s
G,e,r, c ( | j |ddi y)zSplit the layout in to a column (layouts stacked on top of each other).
Args:
*layouts (Layout): Positional arguments should be (sub) Layout instances.
rz rm Nr r s r- split_columnzLayout.split_column4 s
G/h/r, c " | j dd= y)z Reset splits to initial state.N)r{ rS s r- unsplitzLayout.unsplit< s NN1 r, c T | j 5 || _ ddd y# 1 sw Y yxY w)zjUpdate renderable.
Args:
renderable (RenderableType): New renderable object.
N)r} rx )r; rv s r- updatez
Layout.update@ s ZZ )D ZZs 'r= r layout_namec 2 | j 5 | | }| j | \ }}|\ }}}} |j ||j j || }
t ||
| j |< |j
|
|| ddd y# 1 sw Y yxY w)zRefresh a sub-layout.
Args:
console (Console): Console instance where Layout is to be rendered.
layout_name (str): Name of layout.
N)r} r| render_linesr> update_dimensionsr# update_screen_lines) r; r= r r6 r$ _linesrb rc rM rG liness r- refresh_screenzLayout.refresh_screenI s ZZ+&F ! - -f 5NFF$* !Q5&((99%HE (4FE'BD V $ ' 'q! 4 ZZs A7B
BrM rG c t | t dd|| fg}|j }|j }g }|j }|rO | | |d \ }} |j }
|
r)|j j |
| D ]
} || |rOt
|t d D ci c] \ }} ||
} }} | S c c} }w )z,Create a dict that maps layout on to Region.r r )key)r appendpoprV rz rX sortedr )
r; rM rG stackpushr layout_regionsappend_layout_regionr6 r$ rV child_and_region
region_maps
r- _make_region_mapzLayout._make_region_mapZ s /3VAq%5P.Q-R||ii68 - 4 4 ' +B /NFF H(.(>(>x(P$)* )Q #) Z]"K
"K
FN"K
s "
B4r> c |j }|j xs |j }| j || }|j D cg c] \ }}|j s||f }}}i } |j
}
|j } |D ]B \ }} |
|j | |j |j } t || | |< D | S c c}}w )zRender the sub_layouts.
Args:
console (Console): Console instance.
options (ConsoleOptions): Console options.
Returns:
RenderMap: A dict that maps Layout on to a tuple of Region, lines
)
rH rG r itemsrV r r rv rM r# )
r; r= r> render_width
render_heightr r6 r$ r
render_mapr r r s
r- r% z
Layout.rendero s (( 8'..
**< G
#-"2"2"4
"4?? V "4
68
++ # 5 5 ,NFF !!#4V\\6==#QE ".fe! t j }|D ] }|E d { | d d d y c c}w 7 # 1 sw Y y xY wwr: )r} rH rM rG r% r r| ranger valuesra r r line)r; r= r> rM rG r _ layout_lines_islicer$ r _xrc
_layout_width
layout_heightr\ r new_line
layout_rows r- rN zLayout.__rich_console__ s ZZ%%6 E ^^5w~~F Wg.G.Gv.VWJ )D =B6]0K]]L0K G#-#4#4#66<3A}m!$L!Q ->?"IC JJt$" $7 ||~H *
%%% + Z
1L &! Zs<
D A+D: D
A5D8D9
D D
DD D r: )r8 r! )r8 N)(r& r' r( r) r[ rl ry r
r rY intboolr< r r propertyrv r rV RenderMapr r r r r rQ r r r r r r r RegionMapr r r r% r rN r+ r, r- r. r. s; $~>I 04 # " ^, sm
sm
*%v % r s #
" J J ( # * :
6! " <' ( ) - -
: s *"( "(#X #( R R R j z0iG
XF
H1%QV$BX& 6N V 0&fA2NO
6N V! OP
4L EF 16x3H 6N v{{ A6wCWX
9 U# MM&1 r,