fdZddlmZddlmZmZmZmZmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZddlmZmZmZmZmZmZddlmZmZm Z m!Z!m"Z"m#Z#m$Z$ddl%m&Z&m'Z'm(Z(ddl)m*Z*m+Z+m,Z,m-Z-m.Z.dd l/m0Z0m1Z1dd l2m3Z3gd Z4y ) a Command line layout definitions ------------------------------- The layout of a command line interface is defined by a Container instance. There are two main groups of classes here. Containers and controls: - A container can contain other containers or controls, it can have multiple children and it decides about the dimensions. - A control is responsible for rendering the actual content to a screen. A control can propose some dimensions, but it's the container who decides about the dimensions -- or when the control consumes more space -- which part of the control will be visible. Container classes:: - Container (Abstract base class) |- HSplit (Horizontal split) |- VSplit (Vertical split) |- FloatContainer (Container which can also contain menus and other floats) `- Window (Container which contains one actual control Control classes:: - UIControl (Abstract base class) |- FormattedTextControl (Renders formatted text, or a simple list of text fragments) `- BufferControl (Renders an input buffer.) Usually, you end up wrapping every control inside a `Window` object, because that's the only way to render it in a layout. There are some prepared toolbars which are ready to use:: - SystemToolbar (Shows the 'system' input buffer, for entering system commands.) - ArgToolbar (Shows the input 'arg', for repetition of input commands.) - SearchToolbar (Shows the 'search' input buffer, for incremental search.) - CompletionsToolbar (Shows the completions of the current buffer.) - ValidationToolbar (Shows validation errors of the current buffer.) And one prepared menu: - CompletionsMenu ) annotations) AnyContainer ColorColumnConditionalContainer ContainerDynamicContainerFloatFloatContainerHorizontalAlignHSplit ScrollOffsets VerticalAlignVSplitWindow WindowAlignWindowRenderInfo is_container to_container to_window) BufferControl DummyControlFormattedTextControlSearchBufferControl UIContent UIControl) AnyDimensionD Dimension is_dimensionmax_layout_dimensionssum_layout_dimensions to_dimension)InvalidLayoutErrorLayoutwalk)ConditionalMarginMarginNumberedMargin PromptMarginScrollbarMargin)CompletionsMenuMultiColumnCompletionsMenu)ScrollablePane)*r%r$r&rrrr"r!r#r rrr rr rr r rrrrrrrrrr r.rrrrrrr(r)r+r'r*r,r-N)5__doc__ __future__r containersrrrrr r r r r rrrrrrrrrcontrolsrrrrrr dimensionrrrr r!r"r#layoutr$r%r&marginsr'r(r)r*r+menusr,r-scrollable_paner.__all__Y/var/www/cvtools/html/venv/lib/python3.12/site-packages/prompt_toolkit/layout/__init__.pyr<sc-^#(54?+1 r: