U
|
ß=®dê% ã @ sô U d dl Zd dlmZ d dlmZ ddlmZ ddlm Z dZ
|
ej e e d< ejejeef eje df d d
|
d Zejejeef e ejejedf d d dZdee eeeedddZG dd dZeje ejeef dddZdS )é N)Úcontextmanager)Úgettexté )Úterm_len)Ú split_optÚ FORCED_WIDTH.)ÚrowsÚreturnc C sT i }| D ]0}t |D ]"\}}t| |d¡t|||< qqtdd t| ¡ D S )Nr c s s | ]\}}|V qd S )N© )Ú.0ÚxÚyr
|
r
|
úGd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\click/formatting.pyÚ <genexpr> s z measure_table.<locals>.<genexpr>)Ú enumerateÚmaxÚgetr ÚtupleÚsortedÚitems)r ÚwidthsÚrowÚidxÚcolr
|
r
|
r Ú measure_table s
|
r )r Ú col_countr c c s$ | D ]}|d|t | V qd S )N)Ú )Úlen)r r r r
|
r
|
r Ú iter_rows s r éN r F)ÚtextÚwidthÚinitial_indentÚsubsequent_indentÚpreserve_paragraphsr c
|
s ddl m} | ¡ } ||||dd}|s2| | ¡S g g ddd fdd }| ¡ D ]B}|sp| dq\dkrt|} | ¡ }| t| |¡ q\| g }
|
D ]J\} } | d ¡, | rÞ|
|
| | ¡¡ n|
|
| | ¡¡ W 5 Q R X q®d
|
|
|
|
¡S ) a² A helper function that intelligently wraps text. By default, it
|
assumes that it operates on a single paragraph of text but if the
|
`preserve_paragraphs` parameter is provided it will intelligently
|
handle paragraphs (defined by two empty lines).
|
|
If paragraphs are handled, a paragraph can be prefixed with an empty
|
line containing the ``\b`` character (``\x08``) to indicate that
|
no rewrapping should happen in that block.
|
|
:param text: the text that should be rewrapped.
|
:param width: the maximum width for the text.
|
:param initial_indent: the initial indent that should be placed on the
|
first line as a string.
|
:param subsequent_indent: the indent string that should be placed on
|
each consecutive line.
|
:param preserve_paragraphs: if this flag is set then the wrapping will
|
intelligently handle paragraphs.
|
r )Ú TextWrapperF)r" r# Úreplace_whitespaceN©r c sd sd S d ¡ dkr< p"ddd dd
¡f¡ n pFddd ¡f¡ d d
= d S )Nr úTÚ
|
r Fú )ÚstripÚappendÚjoinr
|
©ÚbufÚindentÚpr
|
r Ú
|
_flush_parF s $z wrap_text.<locals>._flush_parr* z
|
|
) Z _textwrapr% Ú
|
expandtabsÚfillÚ
|
splitlinesr Úlstripr, Z extra_indentZ indent_onlyr- ) r r! r" r# r$ r% Úwrapperr2 ÚlineZorig_lenÚrvÚrawr
|
r. r Ú wrap_text s> ü
|
r; c @ s e Zd ZdZd&eeje eje ddddZedddd Z dd
|
d d Z
|
dd
|
d dZ d'eeeje ddddZ eddddZ dd
|
ddZeddddZd(ejejeef eedd d d Zeeejd d d d!Zeejd d
|
d"d#Zed
|
d$d%ZdS ))Ú HelpFormattera¾ This class helps with formatting text-based help pages. It's
|
usually just needed for very special internal cases, but it's also
|
exposed so that developers can write their own fancy outputs.
|
|
At present, it always writes into memory.
|
|
:param indent_increment: the additional increment for each level.
|
:param width: the width for the text. This defaults to the terminal
|
width clamped to a maximum of 78.
|
é N)Úindent_incrementr! Ú max_widthr c C s^ dd l }|| _|d krd}|d krHt}|d krHtt| ¡ j|d d}|| _d| _g | _ d S )Nr éP r= é2 )
|
Úshutilr> r r ÚminÚget_terminal_sizeÚcolumnsr! Úcurrent_indentÚbuffer)Úselfr> r! r? rB r
|
r
|
r Ú__init__r s zHelpFormatter.__init__)Ústringr c C s | j |¡ dS )z1Writes a unicode string into the internal buffer.N)rG r, )rH rJ r
|
r
|
r Úwrite
s zHelpFormatter.writer' c C s | j | j7 _ dS )zIncreases the indentation.N©rF r> ©rH r
|
r
|
r r0 s zHelpFormatter.indentc C s | j | j8 _ dS )zDecreases the indentation.NrL rM r
|
r
|
r Údedent s zHelpFormatter.dedentr )ÚprogÚargsÚprefixr c C s¾ |dkrt d d}|d| j | d}| j| j }|t|d krndt| }| t||||d¡ nB| |¡ | d¡ dt| jt|d }| t||||d¡ | d¡ dS ) zïWrites a usage line into the buffer.
|
|
:param prog: the program name.
|
:param args: whitespace separated list of arguments.
|
:param prefix: The prefix for the first line. Defaults to
|
``"Usage: "``.
|
NzUsage:r* ú>é )r" r# r) é )Ú_rF r! r rK r; r )rH rO rP rQ Z usage_prefixÚ
|
text_widthr0 r
|
r
|
r Ú write_usage s4
|
üÿ
|
|
|
ÿÿzHelpFormatter.write_usage)Úheadingr c C s" | dd| j | d¡ dS )z!Writes a heading into the buffer.r rR z:
|
N)rK rF )rH rX r
|
r
|
r Ú write_heading¹ s zHelpFormatter.write_headingc C s | j r| d¡ dS )z#Writes a paragraph into the buffer.r) N)rG rK rM r
|
r
|
r Úwrite_paragraph½ s z HelpFormatter.write_paragraph)r r c C s2 d| j }| t|| j||dd¡ | d¡ dS )zaWrites re-indented text into the buffer. This rewraps and
|
preserves paragraphs.
|
r* T)r" r# r$ r) N)rF rK r; r! )rH r r0 r
|
r
|
r Ú
|
write_text s
|
ûÿ zHelpFormatter.write_texté )r Úcol_maxÚ col_spacingr c C sL t |}t|}t|dkr$tdt|d || }t|t|D ] \}}| dd| j | ¡ |sz| d¡ qDt||| kr¢| d|t| ¡ n | d¡ | d|| j ¡ t | j
|
| d d}t ||d d
|
} | ¡ }
|
|
|
r<| |
|
d d¡ |
|
d d
D ](} | dd|| j | d¡ qqD| d¡ qDd S ) an Writes a definition list into the buffer. This is how options
|
and commands are usually formatted.
|
|
:param rows: a list of two item tuples for the terms and values.
|
:param col_max: the maximum width of the first column.
|
:param col_spacing: the number of spaces between the first and
|
second column.
|
r= z(Expected two columns for definition listr r rR r) r* é
|
T)r$ r N) Úlistr r Ú TypeErrorrC r rK rF r r r! r; r5 ) rH r r] r^ r Z first_colÚfirstÚsecondrV Z wrapped_textÚlinesr8 r
|
r
|
r Úwrite_dlÒ s,
|
|
(zHelpFormatter.write_dl)Únamer c c s4 | ¡ | |¡ | ¡ z
|
dV W 5 | ¡ X dS )z Helpful context manager that writes a paragraph, a heading,
|
and the indents.
|
|
:param name: the section name that is written as heading.
|
N)rZ rY r0 rN )rH rf r
|
r
|
r Úsectionþ s
|
|
zHelpFormatter.sectionc c s" | ¡ z
|
dV W 5 | ¡ X dS )z1A context manager that increases the indentation.N)r0 rN rM r
|
r
|
r Ú indentation s
|
zHelpFormatter.indentationc C s d | j¡S )z Returns the buffer contents.r )r- rG rM r
|
r
|
r Úgetvalue s zHelpFormatter.getvalue)r= NN)r N)r\ r= )Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__ÚintÚtÚOptionalrI ÚstrrK r0 rN rW rY rZ r[ ÚSequenceÚTuplere r ÚIteratorrg rh ri r
|
r
|
r
|
r r< f sJ üû ÿ þ ( üû ,r< )Úoptionsr c C sd g }d}| D ].}t |d }|dkr(d}| t||f¡ q |jdd d d d d
|
|D ¡|fS ) a Given a list of option strings this joins them in the most appropriate
|
way and returns them in the form ``(formatted_string,
|
any_prefix_is_slash)`` where the second item in the tuple is a flag that
|
indicates if any of the option prefixes was a slash.
|
Fr ú/Tc S s | d S )Nr r
|
)r r
|
r
|
r Ú<lambda>, ó z join_options.<locals>.<lambda>)Úkeyz, c s s | ]}|d V qdS )r Nr
|
)r r r
|
r
|
r r - s z join_options.<locals>.<genexpr>)r r, r Úsortr- )ru r9 Zany_prefix_is_slashÚoptrQ r
|
r
|
r Ú join_options s r| )r r r F)Útypingro Ú
|
contextlibr r rU Ú_compatr Úparserr r rp rn Ú__annotations__ÚIterablers rq r rt r Úboolr; r< rr r| r
|
r
|
r
|
r Ú<module> s4 * þ ûú I 6
|
