Current File : //snap/core/17212/usr/lib/python3/dist-packages/urwid/__pycache__/container.cpython-35.pyc
9$�V L � @ sf d d l m Z m Z d d l m Z d d l m Z m Z m Z m Z m
Z
m Z m Z m
Z
m Z m Z m Z m Z m Z m Z m Z m Z d d l m Z m Z m Z m Z m Z m Z m Z m Z m Z m Z m! Z! m" Z" d d l# m$ Z$ m% Z% d d l& m' Z' m( Z( m) Z) m* Z* m+ Z+ Gd d � d e, � Z- Gd d
� d
e, � Z. Gd d � d e/ � Z0 Gd
d � d e e- e. � Z1 Gd d � d e/ � Z2 Gd d � d e e- e. � Z3 Gd d � d e/ � Z4 Gd d � d e e- � Z5 Gd d � d e/ � Z6 Gd d � d e e- e. � Z7 Gd d � d e/ � Z8 Gd d � d e e- e. � Z9 d d � Z: e; d! k rbe: � d" S)#� )�chain�repeat)�is_mouse_press)�Widget�Divider�FLOW�FIXED�PACK�BOX�
WidgetWrap�GIVEN�WEIGHT�LEFT�RIGHT�RELATIVE�TOP�BOTTOM�CLIP� RELATIVE_100) �Padding�Filler� calculate_left_right_padding�calculate_top_bottom_filler�normalize_align�normalize_width�normalize_valign�normalize_height�simplify_align�simplify_width�simplify_valign�simplify_height)�
MonitoredList�MonitoredFocusList)�CompositeCanvas�
CanvasOverlay�
CanvasCombine� SolidCanvas�
CanvasJoinc @ sF e Z d Z d Z d d � Z d d � Z d d � Z d d � Z d
S) �WidgetContainerMixinzQ
Mixin class for widget containers implementing common container methods
c C s | j | d j S)aG
Container short-cut for self.contents[position][0].base_widget
which means "give me the child widget at position without any
widget decorations".
This allows for concise traversal of nested container widgets
such as:
my_widget[position0][position1][position2] ...
r )�contents� base_widget)�self�position� r- �1/usr/lib/python3/dist-packages/urwid/container.py� __getitem__( s z WidgetContainerMixin.__getitem__c C sV g } | } xC y
| j } Wn t k
r4 | SYn X| j | � | j j } q Wd S)z�
Return the .focus_position values starting from this container
and proceeding along each child widget until reaching a leaf
(non-container) widget.
N)�focus_position�
IndexError�append�focusr* )r+ �out�w�pr- r- r. �get_focus_path5 s
z#WidgetContainerMixin.get_focus_pathc C s? | } x2 | D]* } | | j k r+ | | _ | j j } q
Wd S)a�
Set the .focus_position property starting from this container
widget and proceeding along newly focused child widgets. Any
failed assignment due do incompatible position types or invalid
positions will raise an IndexError.
This method may be used to restore a particular widget to the
focus by passing in the value returned from an earlier call to
get_focus_path().
positions -- sequence of positions
N)r0 r3 r* )r+ Z positionsr5 r6 r- r- r. �set_focus_pathE s
z#WidgetContainerMixin.set_focus_pathc C s@ g } | } x- | j j } | d k r+ | S| j | � q Wd S)aV
Return the .focus values starting from this container
and proceeding along each child widget until reaching a leaf
(non-container) widget.
Note that the list does not contain the topmost container widget
(i.e, on which this method is called), but does include the
lowest leaf widget.
N)r* r3 r2 )r+ r4 r5 r- r- r. �get_focus_widgetsX s
z&WidgetContainerMixin.get_focus_widgetsN)�__name__�
__module__� __qualname__�__doc__r/ r7 r8 r9 r- r- r- r. r( $ s
r( c @ s. e Z d Z d Z d d � Z d d � Z d S)� WidgetContainerListContentsMixinzs
Mixin class for widget containers whose positions are indexes into
a list available as self.contents.
c C s t t | j � � S)z`
Return an iterable of positions for this container from first
to last.
)�range�lenr) )r+ r- r- r. �__iter__o s z)WidgetContainerListContentsMixin.__iter__c C s t t | j � d d d � S)z`
Return an iterable of positions for this container from last
to first.
� ���rC )r? r@ r) )r+ r- r- r. � __reversed__v s z-WidgetContainerListContentsMixin.__reversed__N)r: r; r< r= rA rD r- r- r- r. r> j s r> c @ s e Z d Z d S)�
GridFlowErrorN)r: r; r< r- r- r- r. rE ~ s rE c @ s� e Z d Z d Z d d � Z d d � Z d d � Z d d � Z d
d � Z d d
� Z e
e e d d �Z d d � Z d d � Z
e
e e
d d �Z d d � Z d d � Z e
e e d d �Z e d d d � Z d d � Z d d � Z e
e d d! �Z d" d# � Z e
e e d d$ �Z d% d& � Z d' d( � Z e
e e d d) �Z d* d+ � Z d, d- � Z d. d/ � Z d0 d1 � Z d2 d3 d4 � Z d2 d5 d6 � Z! d7 d8 � Z" d9 d: � Z# d; d< � Z$ d= d> � Z% d S)?�GridFlowz�
The GridFlow widget is a flow widget that renders all the widgets it
contains the same width and it arranges them from left to right and top to
bottom.
c C s
t t g � S)N)� frozensetr )r+ r- r- r. �sizing� s zGridFlow.sizingc s� t � f d d � | D� � � _ � j j � j � � j j � f d d � � � j j � j � � � _ | � _ | � _ | � _
d � _ � j j
d � � j | � t | � f � d S)a�
:param cells: list of flow widgets to display
:param cell_width: column width for each cell
:param h_sep: blank columns between each cell horizontally
:param v_sep: blank rows between cells vertically
(if more than one row is required to display all the cells)
:param align: horizontal alignment of cells, one of\:
'left', 'center', 'right', ('relative', percentage 0=left 100=right)
c s" g | ] } | t � f f � q Sr- )r )�.0r5 )�
cell_widthr- r. �
<listcomp>� s z%GridFlow.__init__.<locals>.<listcomp>c s
� j � S)N)� _invalidate)�f)r+ r- r. �<lambda>� s z#GridFlow.__init__.<locals>.<lambda>N)r" � _contents�set_modified_callbackrL �set_focus_changed_callback� set_validate_contents_modified�_contents_modified� _cell_width�h_sep�v_sep�align�
_cache_maxcol�_GridFlow__super�__init__�get_display_widgetr@ )r+ �cellsrJ rU rV rW r- )rJ r+ r. rZ � s
zGridFlow.__init__c C s d | _ | j j � d S)N)rX rY rL )r+ r- r- r. rL � s zGridFlow._invalidatec
C sk xd | D]\ } y( | \ } \ } } | t k r4 t � Wq t t f k
rb t d | f � � Yq Xq Wd S)Nzadded content invalid %r)r �
ValueError� TypeErrorrE )r+ �slc� new_items�itemr5 �t�nr- r- r. rS � s
zGridFlow._contents_modifiedc sB t d d � � j D� � � � � f d d � } � j | � � S)Nc s s | ] \ } } | Vq d S)Nr- )rI r5 rb r- r- r. � <genexpr>� s z&GridFlow._get_cells.<locals>.<genexpr>c s � j � � d S)N)�
_set_cellsr- )�mlr+ r- r. �
user_modified� s z*GridFlow._get_cells.<locals>.user_modified)r! r) rP )r+ rg r- )rf r+ r. �
_get_cells� s
zGridFlow._get_cellsc sD � j } � f d d � | D� � _ | t | � k r@ | � _ d S)Nc s% g | ] } | t � j f f � q Sr- )r rT )rI �new)r+ r- r. rK � s z'GridFlow._set_cells.<locals>.<listcomp>)r0 r) r@ )r+ �widgetsr0 r- )r+ r. re � s zGridFlow._set_cells�docz�
A list of the widgets in this GridFlow
.. note:: only for backwards compatibility. You should use the new
use the new standard container property :attr:`contents` to modify
GridFlow contents.
c C s | j S)N)rT )r+ r- r- r. �_get_cell_width� s zGridFlow._get_cell_widthc s> | j } � f d d � | j D� | _ | | _ � | _ d S)Nc s( g | ] \ } } | t � f f � q Sr- )r )rI r5 �options)�widthr- r. rK � s z,GridFlow._set_cell_width.<locals>.<listcomp>)r0 r) rT )r+ rn r0 r- )rn r. �_set_cell_width� s zGridFlow._set_cell_widthzg
The width of each cell in the GridFlow. Setting this value affects
all cells.
c C s | j S)N)rO )r+ r- r- r. �
_get_contents� s zGridFlow._get_contentsc C s | | j d d � <d S)N)rO )r+ �cr- r- r. �
_set_contents� s zGridFlow._set_contentsa�
The contents of this GridFlow as a list of (widget, options)
tuples.
options is currently a tuple in the form `('fixed', number)`.
number is the number of screen columns to allocate to this cell.
'fixed' is the only type accepted at this time.
This list may be modified like a normal list and the GridFlow
widget will update automatically.
.. seealso:: Create new options tuples with the :meth:`options` method.
Nc C s> | t k r t d | f � � | d k r4 | j } | | f S)z�
Return a new options tuple for use in a GridFlow's .contents list.
width_type -- 'given' is the only value accepted
width_amount -- None to use the default cell_width for this GridFlow
zinvalid width_type: %rN)r rE rT )r+ �
width_type� width_amountr- r- r. rm � s
zGridFlow.optionsc C s) t | t � r | j | � S| j | � S)a7
Set the cell in focus, for backwards compatibility.
.. note:: only for backwards compatibility. You may also use the new
standard container property :attr:`focus_position` to get the focus.
:param cell: contained element to focus
:type cell: Widget or int
)�
isinstance�int�_set_focus_position�_set_focus_cell)r+ �cellr- r- r. � set_focus� s
zGridFlow.set_focusc C s | j s
d S| j | j d S)z�
Return the widget in focus, for backwards compatibility.
.. note:: only for backwards compatibility. You may also use the new
standard container property :attr:`focus` to get the focus.
Nr )r) r0 )r+ r- r- r. � get_focus� s zGridFlow.get_focusz8the child widget in focus or None when GridFlow is emptyc C sV x< t | j � D]+ \ } \ } } | | k r | | _ d Sq Wt d | f � � d S)Nz)Widget not found in GridFlow contents: %r)� enumerater) r0 r] )r+ ry �ir5 rm r- r- r. rx
s
" zGridFlow._set_focus_cellaF
The widget in focus, for backwards compatibility.
.. note:: only for backwards compatibility. You should use the new
use the new standard container property :attr:`focus` to get the
widget in focus and :attr:`focus_position` to get/set the cell in
focus by index.
c C s | j s t d � � | j j S)zd
Return the index of the widget in focus or None if this GridFlow is
empty.
z$No focus_position, GridFlow is empty)r) r1 r3 )r+ r- r- r. �_get_focus_position s z GridFlow._get_focus_positionc C si y+ | d k s$ | t | j � k r* t � Wn+ t t f k
rX t d | f � � Yn X| | j _ d S)zf
Set the widget in focus.
position -- index of child widget to be made focus
r z'No GridFlow child widget at position %sN)r@ r) r1 r^ r3 )r+ r, r- r- r. rw ! s !
z GridFlow._set_focus_positionz�
index of child widget in focus. Raises :exc:`IndexError` if read when
GridFlow is empty, or when set to an invalid index.
c C sA | \ } | j | k r | j S| | _ | j | � | _ | j S)z�
Arrange the cells into columns (and possibly a pile) for
display, input or to calculate rows, and update the display
widget.
)rX �_w�generate_display_widget)r+ �size�maxcolr- r- r. r[ 2 s zGridFlow.get_display_widgetc
C s | \ } t � } | j s | S| j d k r> | j d | _ d } t g � } d } x�t | j � D]�\ } \ } \ } }
| d k s� | | |
k r| j r� | j j | | j � f � t g | j � } d } t
| | j � } | | _ | j j | | j � f � | j j | | j t
|
� f � | | j k sR| rn| j � rnt | j � d | _ d } | | j k r�t | j � d | _ t d d � | j D� � | j t | j � } |
| k r�| | _ | | j | _ qf W| j r| j d d � =| S)zC
Actually generate display widget (ignoring cache)
rB Nr FTc s s | ] } | d d Vq d S)rB Nr- )rI �xr- r- r. rd f s z3GridFlow.generate_display_widget.<locals>.<genexpr>)r r) rV �top�Piler| r2 rm �ColumnsrU r rW �first_positionr r0 �
selectabler@ �sumZoriginal_widgetrn )
r+ r� r� Zdividerrq r6 Z
used_spacer} r5 rs rt Zcolumn_focusedZpadr- r- r. r� B sB ( " z GridFlow.generate_display_widgetc C sN | j j } | s d S| j } | j r4 | j } n d } | j | | _ d S)zK
Set the focus to the item in focus in the display widget.
Nr )r r3 r* r0 r� )r+ Z
pile_focusrq Zcol_focus_positionr- r- r. � _set_focus_from_display_widgetu s
z'GridFlow._set_focus_from_display_widgetc C s< | j | � | j j | | � } | d k r8 | j � | S)z_
Pass keypress to display widget for handling.
Captures focus changes.
N)r[ rY �keypressr� )r+ r� �keyr- r- r. r� � s
zGridFlow.keypressFc C s# | j | � | j j | d | �S)Nr3 )r[ rY �rows)r+ r� r3 r- r- r. r� � s
z
GridFlow.rowsc C s | j | � | j j | | � S)N)r[ rY �render)r+ r� r3 r- r- r. r� � s
zGridFlow.renderc C s | j | � | j j | � S)z Get cursor from display widget.)r[ rY �get_cursor_coords)r+ r� r- r- r. r� � s
zGridFlow.get_cursor_coordsc C s3 | j | � | j j | | | � } | j � | S)z/Set the widget in focus based on the col + row.)r[ rY �move_cursor_to_coordsr� )r+ r� �col�row�rvalr- r- r. r� � s
z GridFlow.move_cursor_to_coordsc C s: | j | � | j j | | | | | | � | j � d S)NT)r[ rY � mouse_eventr� )r+ r� �event�buttonr� r� r3 r- r- r. r� � s
zGridFlow.mouse_eventc C s | j | � | j j | � S)z$Return pref col from display widget.)r[ rY � get_pref_col)r+ r� r- r- r. r� � s
zGridFlow.get_pref_col)&r: r; r< r= rH rZ rL rS rh re �propertyr\ rl ro rJ rp rr r) r rm rz r{ r3 rx Z
focus_cellr~ rw r0 r[ r� r� r� r� r� r� r� r� r� r- r- r- r. rF � sN
3 rF c @ s e Z d Z d S)� OverlayErrorN)r: r; r< r- r- r- r. r� � s r� c @ s� e Z d Z d Z d Z e e g � Z e d e d d d d e
d e d d d d f Z d d d d d d d d � Z d d d d d d d d � Z
d d d d d d d
d � Z d d
� Z d d � Z d d � Z e e d d �Z d d � Z d d � Z e e e d d �Z d d � Z d d � Z d d � Z e e d d �Z d d! � Z d" d# � Z d$ d% � Z d& d' d( � Z d) d* � Z d S)+�OverlayzN
Overlay contains two box widgets and renders one on top of the other
TN�d r c
C sK | j j � | | _ | | _ | j | | | | | | | |
| | �
d S)a�
:param top_w: a flow, box or fixed widget to overlay "on top"
:type top_w: Widget
:param bottom_w: a box widget to appear "below" previous widget
:type bottom_w: Widget
:param align: alignment, one of ``'left'``, ``'center'``, ``'right'`` or
(``'relative'``, *percentage* 0=left 100=right)
:type align: str
:param width: width type, one of:
``'pack'``
if *top_w* is a fixed widget
*given width*
integer number of columns wide
(``'relative'``, *percentage of total width*)
make *top_w* width related to container width
:param valign: alignment mode, one of ``'top'``, ``'middle'``, ``'bottom'`` or
(``'relative'``, *percentage* 0=top 100=bottom)
:param height: one of:
``'pack'``
if *top_w* is a flow or fixed widget
*given height*
integer number of rows high
(``'relative'``, *percentage of total height*)
make *top_w* height related to container height
:param min_width: the minimum number of columns for *top_w* when width
is not fixed
:type min_width: int
:param min_height: minimum number of rows for *top_w* when height
is not fixed
:type min_height: int
:param left: a fixed number of columns to add on the left
:type left: int
:param right: a fixed number of columns to add on the right
:type right: int
:param top: a fixed number of rows to add on the top
:type top: int
:param bottom: a fixed number of rows to add on the bottom
:type bottom: int
Overlay widgets behave similarly to :class:`Padding` and :class:`Filler`
widgets when determining the size and position of *top_w*. *bottom_w* is
always rendered the full size available "below" *top_w*.
N)Z_Overlay__superrZ �top_w�bottom_w�set_overlay_parameters)
r+ r� r� rW rn �valign�height� min_width�
min_height�left�rightr� �bottomr- r- r. rZ � s
0
zOverlay.__init__c C s. | | | | | | | | | | | |
|
| f S)an
Return a new options tuple for use in this Overlay's .contents mapping.
This is the common container API to create options for replacing the
top widget of this Overlay. It is provided for completeness
but is not necessarily the easiest way to change the overlay parameters.
See also :meth:`.set_overlay_parameters`
r- )r+ �
align_type� align_amountrs rt � valign_type�
valign_amount� height_type�
height_amountr� r� r� r� r� r� r- r- r. rm s zOverlay.optionsc C s" t | t � rR | d d k r2 | d } t } n | d d k rR | d } t } t | t � r� | d d k r� | d } t } n | d d k r� | d } t } t | t � r� | d d k r� | d } t } n | d d k r� | d }
t } t | t � rH| d d k r(| d }
t } n | d d k rH| d } t } | d k rZt } | d k rlt } t | t � \ } } t
| t � \ }
} t | t � \ } } t | t � \ } } | t
t f k r�d } | j | j | | |
| | | | | | | | | | |
� f | j d <d S)z�
Adjust the overlay size and position parameters.
See :class:`__init__() <Overlay>` for a description of the parameters.
r z
fixed leftrB z fixed rightz fixed topz fixed bottomN)ru �tupler r r r r r r r� r r r r r� rm r) )r+ rW rn r� r� r� r� r� r� r� r� r� r� rs rt r� r� r� r� r- r- r. r� sT
z Overlay.set_overlay_parametersc C s
| j j � S)z Return selectable from top_w.)r� r� )r+ r- r- r. r� I s zOverlay.selectablec C s+ | j j | j | | j | d � � | � S)zPass keypress to top_w.T)r� r� �
top_w_size�calculate_padding_filler)r+ r� r� r- r- r. r� M s zOverlay.keypressc C s | j S)zH
Currently self.top_w is always the focus of an Overlay
)r� )r+ r- r- r. �
_get_focusR s zOverlay._get_focusrk z1the top widget in this overlay is always in focusc C s d S)zF
Return the top widget position (currently always 1).
rB r- )r+ r- r- r. r~ Z s zOverlay._get_focus_positionc C s# | d k r t d | f � � d S)z�
Set the widget in focus. Currently only position 0 is accepted.
position -- index of child widget to be made focus
rB zGOverlay widget focus_position currently must always be set to 1, not %sN)r1 )r+ r, r- r- r. rw _ s zOverlay._set_focus_positionz2index of child widget in focus, currently always 1c s# G� f d d � d t � } | � S)Nc s. e Z d Z d d � Z � j Z � j Z d S)z*Overlay._contents.<locals>.OverlayContentsc S s d S)N� r- )�
inner_selfr- r- r. �__len__m s z2Overlay._contents.<locals>.OverlayContents.__len__N)r: r; r< r� �_contents__getitem__r/ �_contents__setitem__� __setitem__r- )r+ r- r. �OverlayContentsl s r� )�object)r+ r� r- )r+ r. rO k s zOverlay._contentsc C s� | d k r | j | j f S| d k r� | j | j | j | j | j | j | j | j | j
| j | j | j
| j | j | j f f St d | f � � d S)Nr rB z#Overlay.contents has no position %r)r� �_DEFAULT_BOTTOM_OPTIONSr� r� r� rs rt r� r� r� r� r� r� r� r� r� r� r1 )r+ �indexr- r- r. r� r s z Overlay._contents__getitem__c C s y | \ } } Wn+ t t f k
r= t d | f � � Yn X| d k r{ | | j k ro t d | j f � � | | _ nz| d k r�y4 | \ } } } } } }
} } }
} } } } } Wn+ t t f k
r� t d | f � � Yn Xt t | | � t � \ } } t t | | � t � \ } } t t
| |
� t � \ } } t t | | � t � \ } } | | _
| | _ | | _ | | _ | | _ |
| _ | | _ | | _ |
| _ | | _ | | _ | | _ | | _ | | _ n t d | f � � | j � d S)Nzadded content invalid: %rr z bottom_options must be set to %rrB ztop_options is invalid: %rz#Overlay.contents has no position %r) r] r^ r� r� r� r r r r r r r r r� r� rs rt r� r� r� r� r� r� r� r� r� r� r1 rL )r+ r� �value�value_w�
value_optionsr� r� rs rt r� r� r� r� r� r� r� r� r� r� Z valign_amounr- r- r. r� sP 4
z Overlay._contents__setitem__a-
a list-like object similar to::
[(bottom_w, bottom_options)),
(top_w, top_options)]
This object may be used to read or update top and bottom widgets and
top widgets's options, but no widgets may be added or removed.
`top_options` takes the form
`(align_type, align_amount, width_type, width_amount, min_width, left,
right, valign_type, valign_amount, height_type, height_amount,
min_height, top, bottom)`
bottom_options is always
`('left', None, 'relative', 100, None, 0, 0,
'top', None, 'relative', 100, None, 0, 0)`
which means that bottom widget always covers the full area of the Overlay.
writing a different value for `bottom_options` raises an
:exc:`OverlayError`.
c
C s� t | j d � s d S| \ } } | j | d � \ } } } } | j j | | | | | | f � \ } } | | k r� | d } | | | | f S)z(Return cursor coords from top_w, if any.r� NTrB )�hasattrr� r� r� )
r+ r� r� �maxrowr� r� r� r� r� �yr- r- r. r� � s %
zOverlay.get_cursor_coordsc C s� | \ } } d } | j t k r� | j j f d | �\ } } | sQ t d � � t | | j | j t | d | j | j
� \ } } n< t | | j | j | j | j | j | j | j
� \ } } | r!t
| | j | j t | d | j | j � \ } }
| | |
| k r�| | | }
n� | j t k r�| j j | f d | �} t
| | j | j t | d | j | j � \ } }
| | k r�| | }
n< t
| | j | j | j | j | j | j | j � \ } }
| | | |
f S)z1Return (padding left, right, filler top, bottom).Nr3 z fixed widget must have a height)rs r r� �packr� r r� r� r r� r� rt r� r r� r� r r� r� r� r� r� r� ) r+ r� r3 r� r� r� rn r� r� r� r� r- r- r. r� � s> ! !
z Overlay.calculate_padding_fillerc C sf | j t k r f S| \ } } | j t k rL | j t k rL | | | f S| | | | | | f S)z!Return the size to pass to top_w.)rs r r� )r+ r� r� r� r� r� r� r� r- r- r. r� � s zOverlay.top_w_sizeFc C s | j | | � \ } } } } | j j | � } | j � sJ | j � rT t | � S| j j | j | | | | | � | � } t | � } | d k s� | d k r� | j t d | � t d | � � | d k s� | d k r� | j
t d | � t d | � � t | | | | � S)z#Render top_w overlayed on bottom_w.r ) r� r� r� �colsr� r# r� r� �pad_trim_left_right�min�pad_trim_top_bottomr$ ) r+ r� r3 r� r� r� r� Zbottom_cZtop_cr- r- r. r� s
! ""zOverlay.renderc
C s� t | j d � s d S| j | | � \ } } } }
| \ } } | | k sx | | | k sx | | k sx | | |
k r| d S| j j | j | | | | |
� | | | | | | | � S)z0Pass event to top_w, ignore if outside of top_w.r� F)r� r� r� r� r� )
r+ r� r� r� r� r� r3 r� r� r� r� r� r� r- r- r. r� s zOverlay.mouse_event) r: r; r< r= � _selectablerG r
�_sizingr r r r� rZ rm r� r� r� r� r� r3 r~ rw r0 rO r� r� r) r� r� r� r� r� r- r- r- r. r� � s6 9 8
.
' r� c @ s e Z d Z d S)�
FrameErrorN)r: r; r< r- r- r- r. r� ' s r� c @ s� e Z d Z d Z d Z e e g � Z d d d d d � Z d d � Z d d
� Z
e e e
� Z d d � Z
d
d � Z e e
e � Z d d � Z d d � Z e e e � Z d d � Z d d � Z d d � Z e e d d �Z e e e d d �Z d d � Z d d � Z d d! � Z d" d# � Z d$ d% � Z e e d d& �Z d' d( � Z d) d* � Z d+ d, d- � Z d. d/ � Z! d0 d1 � Z" d2 d3 � Z# d4 d5 � Z$ d S)6�Framea�
Frame widget is a box widget with optional header and footer
flow widgets placed above and below the box widget.
.. note:: The main difference between a Frame and a :class:`Pile` widget
defined as: `Pile([('pack', header), body, ('pack', footer)])` is that
the Frame will not automatically change focus up and down in response to
keystrokes.
TN�bodyc C s5 | j j � | | _ | | _ | | _ | | _ d S)au
:param body: a box widget for the body of the frame
:type body: Widget
:param header: a flow widget for above the body (or None)
:type header: Widget
:param footer: a flow widget for below the body (or None)
:type footer: Widget
:param focus_part: 'header', 'footer' or 'body'
:type focus_part: str
N)Z
_Frame__superrZ �_header�_body�_footer�
focus_part)r+ r� �header�footerr� r- r- r. rZ 8 s
zFrame.__init__c C s | j S)N)r� )r+ r- r- r. �
get_headerJ s zFrame.get_headerc C s; | | _ | d k r- | j d k r- d | _ | j � d S)Nr� r� )r� r� rL )r+ r� r- r- r. �
set_headerL s zFrame.set_headerc C s | j S)N)r� )r+ r- r- r. �get_bodyS s zFrame.get_bodyc C s | | _ | j � d S)N)r� rL )r+ r� r- r- r. �set_bodyU s zFrame.set_bodyc C s | j S)N)r� )r+ r- r- r. �
get_footerZ s zFrame.get_footerc C s; | | _ | d k r- | j d k r- d | _ | j � d S)Nr� r� )r� r� rL )r+ r� r- r- r. �
set_footer\ s zFrame.set_footerc C s | d k r t d | f � � | d k r: | j d k sU | d k rh | j d k rh t d | f � � | | _ | j � d S)a(
Determine which part of the frame is in focus.
.. note:: included for backwards compatibility. You should rather use
the container property :attr:`.focus_position` to set this value.
:param part: 'header', 'footer' or 'body'
:type part: str
r� r� r� z Invalid position for Frame: %sNzThis Frame has no %s)zheaderzfooterzbody)r1 r� r� r� rL )r+ �partr- r- r. rz c s
zFrame.set_focusc C s | j S)a2
Return an indicator which part of the frame is in focus
.. note:: included for backwards compatibility. You should rather use
the container property :attr:`.focus_position` to get this value.
:returns: one of 'header', 'footer' or 'body'.
:rtype: str
)r� )r+ r- r- r. r{ u s
zFrame.get_focusc C s& d | j d | j d | j i | j S)Nr� r� r� )r� r� r� r� )r+ r- r- r. r� � s zFrame._get_focusrk zq
child :class:`Widget` in focus: the body, header or footer widget.
This is a read-only property.z�
writeable property containing an indicator which part of the frame
that is in focus: `'body', 'header'` or `'footer'`.
c s# G� f d d � d t � } | � S)Nc sg e Z d Z d d � Z d d � Z d d � Z d d d � Z � j Z � j Z
� j Z � j
Z d S)
z&Frame._contents.<locals>.FrameContentsc S s t t | j � � � S)N)r@ �list�keys)r� r- r- r. r� � s z.Frame._contents.<locals>.FrameContents.__len__c s# � f d d � t � j � � D� S)Nc s g | ] } | � | f � q Sr- r- )rI �k)r� r- r. rK � s z@Frame._contents.<locals>.FrameContents.items.<locals>.<listcomp>)r� r� )r� r- )r� r. �items� s z,Frame._contents.<locals>.FrameContents.itemsc s# � f d d � t � j � � D� S)Nc s g | ] } � | � q Sr- r- )rI r� )r� r- r. rK � s zAFrame._contents.<locals>.FrameContents.values.<locals>.<listcomp>)r� r� )r� r- )r� r. �values� s z-Frame._contents.<locals>.FrameContents.valuesNc [ s� | ra t | d d � } | r@ x@ | D] } | | | | <q% Wn! x | D] \ } } | | | <qG Wx | D] } | | | | <qh Wd S)Nr� )�getattr)r� �E�Fr� r� �vr- r- r. �update� s
z-Frame._contents.<locals>.FrameContents.update)r: r; r< r� r� r� r� �_contents_keysr� r� r/ r� r� �_contents__delitem__� __delitem__r- )r+ r- r. �
FrameContents� s r� )r� )r+ r� r- )r+ r. rO � s zFrame._contentsc C s9 d g } | j r | j d � | j r5 | j d � | S)Nr� r� r� )r� r2 r� )r+ r� r- r- r. r� � s
zFrame._contents_keysc C st | d k r | j d f S| d k r; | j r; | j d f S| d k r] | j r] | j d f St d | f � � d S)Nr� r� r� z Frame.contents has no key: %r)r� r� r� �KeyError)r+ r� r- r- r. r� � s
zFrame._contents__getitem__c C s� | d k r t d | f � � y" | \ } } | d k r@ t � Wn+ t t f k
rn t d | f � � Yn X| d k r� | | _ n! | d k r� | | _ n | | _ d S)Nr� r� r� z Frame.contents has no key: %rzadded content invalid: %r)zbodyzheaderzfooter)r� r] r^ r� r� r� r� )r+ r� r� r� r� r- r- r. r� � s
zFrame._contents__setitem__c C s� | d k r t d | f � � | d k r: | j d k sU | d k rh | j d k rh t d | f � � | d k r� d | _ n d | _ d S)Nr� r� z#Frame.contents can't remove key: %rz Frame.contents has no key: %r)zheaderzfooter)r� r� r� r� r� )r+ r� r- r- r. r� � s zFrame._contents__delitem__a#
a dict-like object similar to::
{
'body': (body_widget, None),
'header': (header_widget, None), # if frame has a header
'footer': (footer_widget, None) # if frame has a footer
}
This object may be used to read or update the contents of the Frame.
The values are similar to the list-like .contents objects used
in other containers with (:class:`Widget`, options) tuples, but are
constrained to keys for each of the three usual parts of a Frame.
When other keys are used a :exc:`KeyError` will be raised.
Currently all options are `None`, but using the :meth:`options` method
to create the options value is recommended for forwards
compatibility.
c C s d S)z~
There are currently no options for Frame contents.
Return None as a placeholder for future options.
Nr- )r+ r- r- r. rm � s z
Frame.optionsc C s� | \ } } d } } | j rF | j j | f | j d k o@ | � } | j rv | j j | f | j d k op | � } | } | j d k r� | | k r� d | f | | f f S| | 8} | | k r�| | f | | f f Sn� | j d k r<| | k r
| d f | | f f S| | 8} | | k r�| | f | | f f Sn| | | | k r�t d | d � } | | d k r�d | f | | f f S| | 8} t d | d � } | | f | | f f S| | f | | f f S)a�
Calculate the number of rows for the header and footer.
:param size: See :meth:`Widget.render` for details
:type size: widget size
:param focus: ``True`` if this widget is in focus
:type focus: bool
:returns: `(head rows, foot rows),(orig head, orig foot)`
orig head/foot are from rows() calls.
:rtype: (int, int), (int, int)
r r� r� rB )r� r� r� r� �max) r+ r� r3 r� r� �frows�hrows� remainingZrless1r- r- r. �frame_top_bottom� s:
zFrame.frame_top_bottomFc C sY | \ } } | j | | f | � \ \ } } \ } } g } g }
d } | r� | | k r� t | j d � j | | f | o� | j d k � } nK | r� | j j | f | o� | j d k � } | j � | k s� t d � � | r| j | d | j d k f � |
j | j � | | | k r�| j j | | | | f | oL| j d k � } | j | d | j d k f � |
j | j � d }
| r�| | k r�t | j d � j | | f | o�| j d k � }
nK | r| j j | f | o�| j d k � }
|
j � | k st d � � |
rO| j |
d | j d k f � |
j | j � t
| � S)Nr� r� zrows, render mismatchr� r� r� ) r� r r� r� r� r� �AssertionErrorr2 r� r� r% )r+ r� r3 r� r� �htrim�ftrimr� r� � combinelistZ
depends_on�headr� Zfootr- r- r. r� # sL $ z Frame.renderc C s? | \ } } | j d k rS | j d k rS | j j � s= | S| j j | f | � S| j d k r� | j d k r� | j j � s� | S| j j | f | � S| j d k r� | S| } | j d k r� | | j j | f � 8} | j d k r| | j j | f � 8} | d k r| S| j j � s&| S| j j | | f | � S)z!Pass keypress to widget in focus.r� Nr� r� r )r� r� r� r� r� r� r� )r+ r� r� r� r� r� r- r- r. r� Q s* zFrame.keypressc
C s� | \ } } | j | | f | � \ \ } }
\ } } | | k r� | oT | j d k } t | � r� | d k r� | j j � r� | j d � t | j d � s� d S| j j | f | | | | | � S| | |
k r\| o� | j d k } t | � r | d k r | j j � r | j d � t | j d � s2d S| j j | f | | | | | | | � S| on| j d k } t | � r�| d k r�| j j � r�| j d � t | j d � s�d S| j j | | | |
f | | | | | | � S)zp
Pass mouse event to appropriate part of frame.
Focus may be changed on button 1 press.
r� rB r� Fr� r� )
r� r� r r� r� rz r� r� r� r� )
r+ r� r� r� r� r� r3 r� r� r� r� r� r� r- r- r. r� k s: $
zFrame.mouse_eventc c s% | j r d Vd V| j r! d Vd S)zT
Return an iterator over the positions in this Frame top to bottom.
r� r� r� N)r� r� )r+ r- r- r. rA � s
zFrame.__iter__c c s% | j r d Vd V| j r! d Vd S)zT
Return an iterator over the positions in this Frame bottom to top.
r� r� r� N)r� r� )r+ r- r- r. rD � s
zFrame.__reversed__)%r: r; r< r= r� rG r
r� rZ r� r� r� r� r� r� r� r� r� r� rz r{ r� r3 r0 rO r� r� r� r� r) rm r� r� r� r� rA rD r- r- r- r. r� * sD
6. (
r� c @ s e Z d Z d S)� PileErrorN)r: r; r< r- r- r- r. r� � s r� c @ s� e Z d Z d Z e e e g � Z d d d � Z d d � Z d d � Z
d d
� Z e e
e d d �Z
d
d � Z d d � Z e e e d d �Z d d � Z d d � Z e e e d d �Z e d d d � Z d d � Z d d � Z d d � Z e e d d �Z e e e d d! �Z d" d# � Z d$ d% � Z e e e d d& �Z d' d( � Z d d) d* � Z d+ d, � Z d- d. d/ � Z! d0 d1 � Z" d- d2 d3 � Z# d4 d5 � Z$ d6 d7 � Z% d8 d9 � Z& d: d; � Z' d S)<r� zA
A pile of widgets stacked vertically from top to bottom
Nc s � j j � t � � _ � j j � j � � j j � f d d � � � j j � j � | } xyt | � D]k\ } } | } t
| t � s� � j j
| t d f f � n
| d t t f k r� | \ } } � j j
| t d f f � n� t | � d k r,| \ } } � j j
| t | f f � n� | d t k rj| \ } } } � j j
| t | f f � nQ | d t k r�| \ } } } � j j
| | | f f � n t d | f � � | d k rn | j � rn | } qn W� j r�| d k r�� j | � d � _ d S)aX
:param widget_list: child widgets
:type widget_list: iterable
:param focus_item: child widget that gets the focus initially.
Chooses the first selectable widget if unset.
:type focus_item: Widget or int
*widget_list* may also contain tuples such as:
(*given_height*, *widget*)
always treat *widget* as a box widget and give it *given_height* rows,
where given_height is an int
(``'pack'``, *widget*)
allow *widget* to calculate its own height by calling its :meth:`rows`
method, ie. treat it as a flow widget.
(``'weight'``, *weight*, *widget*)
if the pile is treated as a box widget then treat widget as a box
widget with a height based on its relative weight value, otherwise
treat the same as (``'pack'``, *widget*).
Widgets not in a tuple are the same as (``'weight'``, ``1``, *widget*)`
.. note:: If the Pile is treated as a box widget there must be at least
one ``'weight'`` tuple in :attr:`widget_list`.
c s
� j � S)N)rL )rM )r+ r- r. rN � s z Pile.__init__.<locals>.<lambda>rB r Nr� z#initial widget list item invalid %r)Z _Pile__superrZ r" rO rP rL rQ rR rS r| ru r� r) r2 r
r r r@ r r r� r� rz �pref_col) r+ � widget_list�
focus_itemr} �originalr5 rM r� Z_ignorer- )r+ r. rZ � s:
z
Pile.__init__c
C st xm | D]e } y1 | \ } \ } } | t t t f k r= t � Wq t t f k
rk t d | f � � Yq Xq Wd S)Nzadded content invalid: %r)r r r
r] r^ r� )r+ r_ r` ra r5 rb rc r- r- r. rS � s
zPile._contents_modifiedc sB t d d � � j D� � � � � f d d � } � j | � � S)Nc s s | ] \ } } | Vq d S)Nr- )rI r5 rb r- r- r. rd � s z(Pile._get_widget_list.<locals>.<genexpr>c s � j � � d S)N)�_set_widget_listr- )rf r+ r- r. rg � s z,Pile._get_widget_list.<locals>.user_modified)r! r) rP )r+ rg r- )rf r+ r. �_get_widget_list� s
zPile._get_widget_listc C se | j } d d � t | t | j t d t d f f � � � D� | _ | t | � k ra | | _ d S)Nc S s( g | ] \ } \ } } | | f � q Sr- r- )rI ri r5 rm r- r- r. rK � s z)Pile._set_widget_list.<locals>.<listcomp>rB )r0 �zipr r) r r
r@ )r+ rj r0 r- r- r. r� � s
.zPile._set_widget_listrk z�
A list of the widgets in this Pile
.. note:: only for backwards compatibility. You should use the new
standard container property :attr:`contents`.
c sB t d d � � j D� � � � � f d d � } � j | � � S)Nc s s? | ]5 \ } \ } } t t t t i j | | � | f Vq d S)N)r r r r �get)rI r5 rM r� r- r- r. rd s z'Pile._get_item_types.<locals>.<genexpr>c s � j � � d S)N)�_set_item_typesr- )rf r+ r- r. rg s z+Pile._get_item_types.<locals>.user_modified)r! r) rP )r+ rg r- )rf r+ r. �_get_item_types s
zPile._get_item_typesc C sJ | j } d d � t | | j � D� | _ | t | � k rF | | _ d S)Nc S sL g | ]B \ \ } } \ } } | t t t t i j | | � | f f � q Sr- )r r r r r� )rI �new_tZ
new_heightr5 rm r- r- r. rK s z(Pile._set_item_types.<locals>.<listcomp>)r0 r� r) r@ )r+ �
item_typesr0 r- r- r. r� s
zPile._set_item_typesz�
A list of the options values for widgets in this Pile.
.. note:: only for backwards compatibility. You should use the new
standard container property :attr:`contents`.
c C s | j S)N)rO )r+ r- r- r. rp # s zPile._get_contentsc C s | | j d d � <d S)N)rO )r+ rq r- r- r. rr % s zPile._set_contentsa�
The contents of this Pile as a list of (widget, options) tuples.
options currently may be one of
(``'pack'``, ``None``)
allow widget to calculate its own height by calling its
:meth:`rows <Widget.rows>` method, i.e. treat it as a flow widget.
(``'given'``, *n*)
Always treat widget as a box widget with a given height of *n* rows.
(``'weight'``, *w*)
If the Pile itself is treated as a box widget then
the value *w* will be used as a relative weight for assigning rows
to this box widget. If the Pile is being treated as a flow
widget then this is the same as (``'pack'``, ``None``) and the *w*
value is ignored.
If the Pile itself is treated as a box widget then at least one
widget must have a (``'weight'``, *w*) options value, or the Pile will
not be able to grow to fill the required number of rows.
This list may be modified like a normal list and the Pile widget
will updated automatically.
.. seealso:: Create new options tuples with the :meth:`options` method
rB c C sE | t k r t d f S| t t f k r; t d | f � � | | f S)a,
Return a new options tuple for use in a Pile's :attr:`contents` list.
:param height_type: ``'pack'``, ``'given'`` or ``'weight'``
:param height_amount: ``None`` for ``'pack'``, a number of rows for
``'fixed'`` or a weight value (number) for ``'weight'``
Nzinvalid height_type: %r)r r r
r� )r+ r� r� r- r- r. rm B s
z Pile.optionsc C s | j } | d k o | j � S)z,Return True if the focus item is selectable.N)r3 r� )r+ r5 r- r- r. r� Q s zPile.selectablec C sr t | t � r | j | � Sx< t | j � D]+ \ } \ } } | | k r, | | _ d Sq, Wt d | f � � d S)aT
Set the item in focus, for backwards compatibility.
.. note:: only for backwards compatibility. You should use the new
standard container property :attr:`focus_position`.
to set the position by integer index instead.
:param item: element to focus
:type item: Widget or int
Nz%Widget not found in Pile contents: %r)ru rv rw r| r) r0 r] )r+ ra r} r5 rm r- r- r. rz V s
" zPile.set_focusc C s | j s
d S| j | j d S)z�
Return the widget in focus, for backwards compatibility. You may
also use the new standard container property .focus to get the
child widget in focus.
Nr )r) r0 )r+ r- r- r. r{ i s zPile.get_focusz4the child widget in focus or None when Pile is emptyaL
A property for reading and setting the widget in focus.
.. note::
only for backwards compatibility. You should use the new
standard container properties :attr:`focus` and
:attr:`focus_position` to get the child widget in focus or modify the
focus position.
c C s | j s t d � � | j j S)z`
Return the index of the widget in focus or None if this Pile is
empty.
z No focus_position, Pile is empty)r) r1 r3 )r+ r- r- r. r~ � s zPile._get_focus_positionc C si y+ | d k s$ | t | j � k r* t � Wn+ t t f k
rX t d | f � � Yn X| | j _ d S)zf
Set the widget in focus.
position -- index of child widget to be made focus
r z#No Pile child widget at position %sN)r@ r) r1 r^ r3 )r+ r, r- r- r. rw � s !
zPile._set_focus_positionz�
index of child widget in focus. Raises :exc:`IndexError` if read when
Pile is empty, or when set to an invalid index.
c C s$ | j � s d S| j | � | j S)z4Return the preferred column for the cursor, or None.N)r� �_update_pref_col_from_focusr� )r+ r� r- r- r. r� � s
zPile.get_pref_colc C s� | d } | j | \ } \ } } | t k r9 | | f S| t k r} t | � d k r} | so | j | | � } | | | f S| f Sd S)zU
Return a size appropriate for passing to self.contents[i][0].render
r r� N)r) r r
r@ �
get_item_rows) r+ r� r} r3 � item_rowsr� r5 rM r� r- r- r. �
get_item_size� s
zPile.get_item_sizec
C s d } | d } t | � d k r, | d } g } | d k r� xg | j D]\ \ } \ } } | t k rv | j | � qH | j | j | f d | o� | j | k �� qH W| Sd } x� | j D]� \ } \ } } | t k r| j | f d | o� | j | k �}
| j |
� | |
8} q� | t k rA| j | � | | 8} q� | ra| j d � | | 7} q� | j d � q� W| d k r�t d � � | d k r�d } x{ t | j � D]j \ } \ } \ } } | | } | d k r�t t
| � | | d � }
|
| | <| |
8} | | 8} q�W| S)zb
Return a list of the number of rows used by each widget
in self.contents
Nr r� rB r3 z:No weighted widgets found for Pile treated as a box widgetg �?) r@ r) r r2 r� r� r r� r| rv �float)
r+ r� r3 r� r� �lr5 rM r� �wtotalr� r} Zlir- r- r. r� � sJ
'
(
zPile.get_item_rowsFc C s� | d } d } g } x t | j � D]
\ } \ } \ } } | j | k }
d } | t k r� | j | | f d | oz |
�} n� | t k s� t | � d k r� | j | f d | o� |
�} nU | d k r� | j | | � } | | } | d k r| j | | f d | o|
�} | r& | j | | |
f � q& W| sct d | d | d d � d d � St
| � }
t | � d k r�| d |
j � k r�t |
� }
|
j
d | d |
j � � |
S)Nr r3 rB � r� )r )r| r) r� r r� r r@ r� r2 r& r% r� r# r� )r+ r� r3 r� r� r� r} r5 rM r� Z
item_focus�canvr� r4 r- r- r. r� � s0
( $ !
!& ( z Pile.renderc
C sj | j � s d St | j d � s& d S| j } | j | \ } \ } } d } | d } | t k s� | t k r� t | � d k r� | t k r� | } n+ | d k r� | j | d d �} | | } | j j | | f � } n | j j | f � } | d k rd S| \ }
} | d k r`| d k r;| j | d d �} x" | d | � D] } | | 7} qLW|
| f S)z2Return the cursor coordinates of the focus widget.Nr� r r� r3 T)
r� r� r� r0 r) r r
r@ r� r� )
r+ r� r} r5 rM r� r� r� r� �coordsr� r� �rr- r- r. r� s2
*
zPile.get_cursor_coordsc C s t | j | | � � S)N)r� r� )r+ r� r3 r- r- r. r� # s z Pile.rowsc C s� | j s
| Sd } t | � d k r: | j | d d �} | j } | j � r� | j | | d | � } | j j | | � } | j | d
k r� | S| j | d k r� t t
| d d d � � } n" t t
| d t | j � � � } | s| j | d d �} x� | D]� } | j | d j � s)q | j | � | | _ t | j d � sUd S| | } | j | d k r�t t
| d d
d � � } n t t
| � � } xB | D]: }
| j | | d | � } | j
j | | j |
� r�Pq�Wd SW| S)zjPass the keypress to the widget in focus.
Unhandled 'up' and 'down' keys may cause a focus change.Nr� r3 T� cursor up� cursor downrB r r� )r r rC rC rC rC )r) r@ r� r0 r� r r3 r� � _command_mapr� r? r� r� r� r� r� ) r+ r� r� r� r} �tsize�
candidates�jr� Zrowlistr� r- r- r. r� & sD "
z
Pile.keypressc C s_ t | j d � s d S| j } | j | | d � } | j j | � } | d k r[ | | _ d S)z+Update self.pref_col from the focus widget.r� NT)r� r3 r0 r r� r� )r+ r� r} r r� r- r- r. r� W s z Pile._update_pref_col_from_focusc C s� | | _ d } d } | j | | � } xX t t | d d � | j D� � � D]- \ } \ } } | | | k rp P| | 7} qM Wd S| j � s� d St | d � r� | j | | | | � }
| j |
| | | � } | d k r� d S| | _ d S)z#Capture pref col and set new focus.Tr c s s | ] \ } } | Vq d S)Nr- )rI r5 rm r- r- r. rd k s z-Pile.move_cursor_to_coords.<locals>.<genexpr>Fr� )
r� r� r| r� r) r� r� r r� r0 ) r+ r� r� r� r3 �wrowr� r} r r5 r r� r- r- r. r� b s& , zPile.move_cursor_to_coordsc
C s d } | j | | � } xX t t | d d � | j D� � � D]- \ } \ }
} | |
| k ra P| |
7} q> Wd S| o� | j | k } t | � r� | d k r� | j � r� | | _ t | d � s� d S| j | | | | � } | j
| | | | | | | � S)ze
Pass the event to the contained widget.
May change focus on button 1 press.
r c s s | ] \ } } | Vq d S)Nr- )rI r5 rm r- r- r. rd � s z#Pile.mouse_event.<locals>.<genexpr>FrB r� ) r� r| r� r) r� r r� r0 r� r r� )
r+ r� r� r� r� r� r3 r r� r} r r5 r r- r- r. r� ~ s" , zPile.mouse_event)(r: r; r< r= rG r r
r� rZ rS r� r� r� r� r� r� r� rp rr r) r
rm r� rz r{ r3 r� r~ rw r0 r� r r� r� r� r� r� r� r� r� r- r- r- r. r� � sL < 6 1 r� c @ s e Z d Z d S)� ColumnsErrorN)r: r; r< r- r- r- r. r � s r c @ sG e Z d Z d Z e e e g � Z d d d d d d � Z d d � Z d d
� Z
d d � Z e e
e d
d �Z
d d � Z d d � Z e e e d
d �Z d d � Z d d � Z e e e d
d �Z d d � Z d d � Z e e e d
d �Z d d � Z d d! � Z e e e d
d" �Z e d d# d$ d% � Z d& d' � Z d( d) � Z d* d+ � Z d, d- � Z d. d/ � Z e e d
d0 �Z! d1 d2 � Z" d3 d4 � Z# e e" e# d
d5 �Z$ e e" e# d
d6 �Z% d# d7 d8 � Z& d# d9 d: � Z' d; d< � Z( d= d> � Z) d? d@ � Z* dA dB � Z+ d# dC dD � Z, dE dF � Z- dG dH � Z. d S)Ir� zE
Widgets arranged horizontally in columns from left to right
r NrB c s� � j j � t � � _ � j j � j � � j j � f d d � � � j j � j � t | pg f � } x�t
| � D]�\ } } | } t | t � s� � j
j | t d | | k f f � n=| d t t f k rt } | \ }
} � j
j | | d | | k f f � n� t | � d k rY| \ } } � j
j | t | | | k f f � n� | d t k r�t } | \ }
} } � j
j | t | | | k f f � nZ | d t k r�| \ } } } � j
j | | | | | k f f � n t d | f � � | d k rz | j � rz | } qz W| � _ � j
rI| d k rI| � _ | d k r[d } | � _ d � _ | � _ d � _ d S)aY
:param widget_list: iterable of flow or box widgets
:param dividechars: number of blank characters between columns
:param focus_column: index into widget_list of column in focus,
if ``None`` the first selectable widget will be chosen.
:param min_width: minimum width for each column which is not
calling widget.pack() in *widget_list*.
:param box_columns: a list of column indexes containing box widgets
whose height is set to the maximum of the rows
required by columns not listed in *box_columns*.
*widget_list* may also contain tuples such as:
(*given_width*, *widget*)
make this column *given_width* screen columns wide, where *given_width*
is an int
(``'pack'``, *widget*)
call :meth:`pack() <Widget.pack>` to calculate the width of this column
(``'weight'``, *weight*, *widget*)`
give this column a relative *weight* (number) to calculate its width from the
screen columns remaining
Widgets not in a tuple are the same as (``'weight'``, ``1``, *widget*)
If the Columns widget is treated as a box widget then all children
are treated as box widgets, and *box_columns* is ignored.
If the Columns widget is treated as a flow widget then the rows
are calculated as the largest rows() returned from all columns
except the ones listed in *box_columns*. The box widgets in
*box_columns* will be displayed with this calculated number of rows,
filling the full height.
c s
� j � S)N)rL )rM )r+ r- r. rN � s z"Columns.__init__.<locals>.<lambda>rB r Nr� z$initial widget list item invalid: %r) �_Columns__superrZ r" rO rP rL rQ rR rS �setr| ru r� r) r2 r
r r r@ r r r r� � dividecharsr0 r� r� rX ) r+ r� r Z focus_columnr� � box_columnsr} r� r5 rM Z_ignoredrn r- )r+ r. rZ � sJ #
( ( (((
zColumns.__init__c
C sw xp | D]h } y4 | \ } \ } } } | t t t f k r@ t � Wq t t f k
rn t d | f � � Yq Xq Wd S)Nzadded content invalid %r)r r r
r] r^ r )r+ r_ r` ra r5 rb rc �br- r- r. rS � s
zColumns._contents_modifiedc sB t d d � � j D� � � � � f d d � } � j | � � S)Nc s s | ] \ } } | Vq d S)Nr- )rI r5 rb r- r- r. rd � s z+Columns._get_widget_list.<locals>.<genexpr>c s � j � � d S)N)r� r- )rf r+ r- r. rg � s z/Columns._get_widget_list.<locals>.user_modified)r! r) rP )r+ rg r- )rf r+ r. r� � s
zColumns._get_widget_listc
C sh | j } d d � t | t | j t d t d d f f � � � D� | _ | t | � k rd | | _ d S)Nc S s( g | ] \ } \ } } | | f � q Sr- r- )rI ri r5 rm r- r- r. rK s z,Columns._set_widget_list.<locals>.<listcomp>rB F)r0 r� r r) r r
r@ )r+ rj r0 r- r- r. r� s
1zColumns._set_widget_listrk z�
A list of the widgets in this Columns
.. note:: only for backwards compatibility. You should use the new
standard container property :attr:`contents`.
c sB t d d � � j D� � � � � f d d � } � j | � � S)Nc s sB | ]8 \ } \ } } } t t t t i j | | � | f Vq d S)N)r r r r r� )rI r5 rb rc r r- r- r. rd s z,Columns._get_column_types.<locals>.<genexpr>c s � j � � d S)N)�_set_column_typesr- )rf r+ r- r. rg s z0Columns._get_column_types.<locals>.user_modified)r! r) rP )r+ rg r- )rf r+ r. �_get_column_types s
zColumns._get_column_typesc C sJ | j } d d � t | | j � D� | _ | t | � k rF | | _ d S)Nc S sX g | ]N \ \ } } \ } \ } } } | t t t t i j | | � | | f f � q Sr- )r r r r r� )rI r� Znew_nr5 rb rc r r- r- r. rK s z-Columns._set_column_types.<locals>.<listcomp>)r0 r� r) r@ )r+ � column_typesr0 r- r- r. r s
zColumns._set_column_typesz�
A list of the old partial options values for widgets in this Pile,
for backwards compatibility only. You should use the new standard
container property .contents to modify Pile contents.
c sH t d d � t � j � D� � � � � f d d � } � j | � � S)Nc s s0 | ]& \ } \ } \ } } } | r | Vq d S)Nr- )rI r} r5 rb rc r r- r- r. rd * s z+Columns._get_box_columns.<locals>.<genexpr>c s � j � � d S)N)�_set_box_columnsr- )rf r+ r- r. rg + s z/Columns._get_box_columns.<locals>.user_modified)r! r| r) rP )r+ rg r- )rf r+ r. �_get_box_columns( s
zColumns._get_box_columnsc s5 t � � � � f d d � t | j � D� | _ d S)Nc s@ g | ]6 \ } \ } \ } } } | | | | � k f f � q Sr- r- )rI r} r5 rb rc r )r r- r. rK 2 s z,Columns._set_box_columns.<locals>.<listcomp>)r r| r) )r+ r r- )r r. r / s zColumns._set_box_columnsa
A list of the indexes of the columns that are to be treated as
box widgets when the Columns is treated as a flow widget.
.. note:: only for backwards compatibility. You should use the new
standard container property :attr:`contents`.
c C s) d d l } | j d t � t | j k S)Nr zA.has_flow_type is deprecated, read values from .contents instead.)�warnings�warn�DeprecationWarningr r )r+ r r- r- r. �_get_has_pack_type< s zColumns._get_has_pack_typec C s d d l } | j d t � d S)Nr zA.has_flow_type is deprecated, read values from .contents instead.)r r r )r+ r� r r- r- r. �_set_has_pack_typeA s zColumns._set_has_pack_typezP
.. deprecated:: 1.0 Read values from :attr:`contents` instead.
c C s | j S)N)rO )r+ r- r- r. rp I s zColumns._get_contentsc C s | | j d d � <d S)N)rO )r+ rq r- r- r. rr K s zColumns._set_contentsa
The contents of this Columns as a list of `(widget, options)` tuples.
This list may be modified like a normal list and the Columns
widget will update automatically.
.. seealso:: Create new options tuples with the :meth:`options` method
Fc C sG | t k r d } | t t t f k r: t d | f � � | | | f S)a�
Return a new options tuple for use in a Pile's .contents list.
This sets an entry's width type: one of the following:
``'pack'``
Call the widget's :meth:`Widget.pack` method to determine how wide
this column should be. *width_amount* is ignored.
``'given'``
Make column exactly width_amount screen-columns wide.
``'weight'``
Allocate the remaining space to this column by using
*width_amount* as a weight value.
:param width_type: ``'pack'``, ``'given'`` or ``'weight'``
:param width_amount: ``None`` for ``'pack'``, a number of screen columns
for ``'given'`` or a weight value (number) for ``'weight'``
:param box_widget: set to `True` if this widget is to be treated as a box
widget when the Columns widget itself is treated as a flow widget.
:type box_widget: bool
Nzinvalid width_type: %r)r r r
r )r+ rs rt Z
box_widgetr- r- r. rm U s
zColumns.optionsc C s d | _ | j j � d S)N)rX r rL )r+ r- r- r. rL q s zColumns._invalidatec C s | j | � d S)a4
Set the column in focus by its index in :attr:`widget_list`.
:param num: index of focus-to-be entry
:type num: int
.. note:: only for backwards compatibility. You may also use the new
standard container property :attr:`focus_position` to set the focus.
N)rw )r+ Znumr- r- r. �set_focus_columnu s
zColumns.set_focus_columnc C s | j S)z�
Return the focus column index.
.. note:: only for backwards compatibility. You may also use the new
standard container property :attr:`focus_position` to get the focus.
)r0 )r+ r- r- r. �get_focus_column� s zColumns.get_focus_columnc C sr t | t � r | j | � Sx< t | j � D]+ \ } \ } } | | k r, | | _ d Sq, Wt d | f � � d S)z�
Set the item in focus
.. note:: only for backwards compatibility. You may also use the new
standard container property :attr:`focus_position` to get the focus.
:param item: widget or integer indexNz(Widget not found in Columns contents: %r)ru rv rw r| r) r0 r] )r+ ra r} r5 rm r- r- r. rz � s
" zColumns.set_focusc C s | j s
d S| j | j d S)z�
Return the widget in focus, for backwards compatibility. You may
also use the new standard container property .focus to get the
child widget in focus.
Nr )r) r0 )r+ r- r- r. r{ � s zColumns.get_focusz7the child widget in focus or None when Columns is emptyc C s | j s t d � � | j j S)zc
Return the index of the widget in focus or None if this Columns is
empty.
z#No focus_position, Columns is empty)r� r1 r) r3 )r+ r- r- r. r~ � s zColumns._get_focus_positionc C si y+ | d k s$ | t | j � k r* t � Wn+ t t f k
rX t d | f � � Yn X| | j _ d S)zf
Set the widget in focus.
position -- index of child widget to be made focus
r z&No Columns child widget at position %sN)r@ r) r1 r^ r3 )r+ r, r- r- r. rw � s !
zColumns._set_focus_positionz�
index of child widget in focus. Raises :exc:`IndexError` if read when
Columns is empty, or when set to an invalid index.
z�
A property for reading and setting the index of the column in
focus.
.. note:: only for backwards compatibility. You may also use the new
standard container property :attr:`focus_position` to get the focus.
c C sV | d } | | j k r= t d d � | j D� � r= | j Sg } g } | | j } x� t | j � D]� \ } \ } \ } }
} | t k r� |
} n1 | t k r� | j | f | � d } n | j } | | | j k r� | | j
k r� P| j | � | | | j 8} | t t f k rf | j |
| f � qf Wxg t | � D]Y \ } } | d k rWP| | | | j 7} d | | <| r>| d d | k r>| d =q>W| r@| j � t
d d � | D� � }
| t | � | j } xb | D]Z \ } } t t | � | |
d � }
t | j |
� }
|
| | <| |
8} |
| 8}
q�W| | _ | | _ | S)zy
Return a list of column widths.
0 values in the list mean hide corresponding column completely
r c s s* | ] \ } \ } } } | t k Vq d S)N)r )rI r5 rb rc r r- r- r. rd � s z(Columns.column_widths.<locals>.<genexpr>rB c s s | ] \ } } | Vq d S)Nr- )rI �weightr} r- r- r. rd � s g �?)rX �anyr) Z_cache_column_widthsr r| r r r� r� r0 r2 �sortr� r@ rv r r� )r+ r� r3 r� �widthsZweightedZsharedr} r5 rb rn r Zstatic_wr Zgrowr! r- r- r. �
column_widths� sN
+ "
zColumns.column_widthsc C s | j | | � } d } t | � d k r� d } xz t t | | j � � D]` \ } \ } \ } \ } } }
|
rs qI | j | f d | o� | j | k �} t | | � } qI Wg } x� t t | | j � � D]� \ } \ } \ } \ } } }
| d k r� q� | r|
r| | f }
n | f | d d � }
| j |
d | oL| j | k �} | t | � d k ru| | j 7} | j
| | | j | k | f � q� W| s�t d | d | d d � d d � St | � } | j
� | d k r| j d | d | j
� � | S)z�
Render columns and return canvas.
:param size: see :meth:`Widget.render` for details
:param focus: ``True`` if this widget is in focus
:type focus: bool
NrB r3 r r )rB )r% r@ r| r� r) r� r0 r� r� r r2 r& r' r� r� )r+ r� r3 r$ Z
box_maxrowr} �mcr5 rb rc r r� r Zsub_sizer r- r- r. r� s8 ::
&& zColumns.renderc s& � j � j \ } \ } } } | j � s/ d St | d � sB d S� j | � } t | � � j k rj d S| � j } t | � d k r� | r� | j | � j | � f � } n | j | f | d d � � } | d k r� d S| \ } }
| t � f d d � | d � j � D� � 7} | |
f S)z4Return the cursor coordinates from the focus widget.Nr� rB c s) g | ] } | d k r � j | � q S)r )r )rI Zwc)r+ r- r. rK H s z-Columns.get_cursor_coords.<locals>.<listcomp>) r) r0 r� r� r% r@ r� r� r� ) r+ r� r5 rb rc r r$ Zcolwr r� r� r- )r+ r. r� 3 s$
! zColumns.get_cursor_coordsc C s$ | j | � } d } d } x� t t | | j � � D]� \ } \ } \ } }
| | } | j � r| t k r� | t k s� | | k r� | d k r� | | | | |
f } P| t k r� | | k r� | | d | | k r� P| | | | |
f } | t k r| | k rP| | j } q4 W| d k r(d S| \ } } } } \ } }
} t | d � rt | t
� r�t t d | | � | | d � } n | } t
| � d k r�| r�| j | | | j | � f | | � } n* | j | | f | d d � | | � } | d k rd S| | _ | | _ d S)z�
Choose a selectable column to focus based on the coords.
see :meth:`Widget.move_cursor_coords` for details
Nr r� Fr� rB T)r% r| r� r) r� r r r r� ru rv r� r� r@ r� r� r0 r� )r+ r� r� r� r$ Zbestr� r} rn r5 rm �endrb rc r Zmove_xr� r- r- r. r� L s@ 1
00 ' z Columns.move_cursor_to_coordsc C sl | j | � } d } xPt t | | j � � D]6\ } \ }
\ } \ } }
} | | k r_ d S| j | } | |
} | | k r� | | j } q. | o� | j | k } t | � r� | d k r� | j � r� | | _ t
| d � s� d St | � d k r2| r2| j | | | j
| � f | | | | | | � S| j | | f | d d � | | | | | | � SWd S)z_
Send event to appropriate column.
May change focus on button 1 press.
r FrB r� N)r% r| r� r) r� r � focus_colr r� r0 r� r@ r� r� )r+ r� r� r� r� r� r3 r$ r� r} rn r5 rb rc r r' r- r- r. r� { s, :
"$zColumns.mouse_eventc C sn | j | � } | j | j \ } \ } } } t | � | j k rG d Sd } | | j } t | d � rt | � d k r� | r� | j | | j | � f � } n | j | f | d d � � } t | t � r| | j | j
7} | t | d | j � � 7} | d k r| j } | d k rj| j
� rj| d } | | j | j
7} | t | d | j � � 7} | S)z-Return the pref col from the column in focus.r Nr� rB r� )r% r) r0 r@ r� r� r� ru rv r( r r� r� r� ) r+ r� r$ r5 rb rc r r� Zcwidthr- r- r. r� � s(
!
zColumns.get_pref_colc C s� | j | | � } d } xt t t | | j � � D]Z \ } \ } \ } \ } } }
|
r[ q1 t | | j | f d | o� | j | k �� } q1 W| S)z�
Return the number of rows required by the columns.
This only makes sense if :attr:`widget_list` contains flow widgets.
see :meth:`Widget.rows` for details
rB r3 )r% r| r� r) r� r� r0 ) r+ r� r3 r$ r� r} r& r5 rb rc r r- r- r. r� � s :.z Columns.rowsc C s� | j d k r | S| j | � } | j t | � k r; | S| j } | | } | j | \ } \ } } } | j | d k r� d | _ t | � d k r� | r� | j | | j | d � f | � } n# | j | f | d d � | � } | j | d k r� | S| j | d k r1t t | d d
d � � }
n" t t | d t | j � � � }
x2 |
D]* } | j | d
j
� szqZ| | _ d SW| S)z�
Pass keypress to the focus column.
:param size: `(maxcol,)` if :attr:`widget_list` contains flow widgets or
`(maxcol, maxrow)` if it contains box widgets.
:type size: int, int
N� cursor up� cursor down�cursor page up�cursor page downrB T� cursor left� cursor rightr )r) r* r+ r, )r- r. rC rC ) r0 r% r@ r) r
r� r� r� r� r? r� ) r+ r� r� r$ r} r& r5 rb rc r r r
r- r- r. r� � s2
'# "
zColumns.keypressc C s | j } | d k o | j � S)z0Return the selectable value of the focus column.N)r3 r� )r+ r5 r- r- r. r� � s zColumns.selectable)/r: r; r< r= rG r r
r� rZ rS r� r� r� r� r r r r r r r r Z
has_flow_typerp rr r) r
rm rL r r rz r{ r3 r~ rw r0 r( r% r� r� r� r� r� r� r� r� r- r- r- r. r� � s` M =/ / ! *r� c C s d d l } | j � d S)Nr )�doctestZtestmod)r/ r- r- r. �_test� s r0 �__main__N)<� itertoolsr r Z
urwid.utilr Z urwid.widgetr r r r r r
r r r
r r r r r r r Zurwid.decorationr r r r r r r r r r r r Zurwid.monitored_listr! r" Z urwid.canvasr# r$ r% r& r' r� r( r> � ExceptionrE rF r� r� r� r� r� r� r r� r0 r: r- r- r- r. �<module> s4 jR(F � : � k� � � � � ]
Mini Shell