k jdZddlZddlmZddlmZmZmZmZee dfZ GddeZ Gddej Z Gd d eZGd d e ZdeededefdZdeee deedefdZdeeefdefdZGdde Zede_ ede_ ede_ ede_dS)aN This module contains anything related to separators. Currently, it contains an implementation of "row sep policies", e.g. components that decide if and how to add an extra separator/spacing between the rows of a definition list (only for tabular layout). In the future, it may be expanded with something analogous for help sections. N) zip_longest)OptionalProtocolSequenceUnion SepGeneratorc"eZdZdZdedefdZdS)raGenerate a separator given a width. When used as ``row_sep``, this ``width`` corresponds to ``HelpFormatter.available_width``, i.e. the line width excluding the current indentation width. Note: the length of the returned separator may differ from ``width``. widthreturncdSN)selfr s O/home/agentuser/manim-venv/lib/python3.11/site-packages/cloup/formatting/sep.py__call__zSepGenerator.__call__s N)__name__ __module__ __qualname____doc__intstrrrrrrrs@ c c      rc teZdZdZejdeeedeedede efdZ dS) RowSepPolicyaA callable that can be passed as ``row_sep`` to :class:`HelpFormatter` in order to decide *if* a definition list should get a row separator (in addition to ``\n``) and *which* separator. In practice, the row separator should be the same for all definition lists that satisfy a given condition. That's why :class:`RowSepIf` exists, you probably want to use that. Nonetheless, this protocol exists mainly for one reason: it leaves open the door to policies that can decide a row separator for each individual row (feature I'm personally against to for now), without breaking changes. This would make possible to implement the old Click 7.2 behavior, which inserted an empty line only after options with a long help. Adding this feature would be possible without breaking changes, by extending the return type to ``Union[None, str, Sequence[str]]``. rows col_widths col_spacingr cdS)zYDecide which row separator to use (eventually none) in the given definition list.Nrrrrrs rrzRowSepPolicy.__call__-rN) rrrrabcabstractmethodrrrrrrrrrrsw" Xc]+SM # rr) metaclasscNeZdZdZdeeedeededefdZdS)RowSepConditionz=Determines when a definition list should use a row separator.rrrr cdS)zrReturn ``True`` if the input definition list should use a row separator (in addition to the usual ``\n``).Nrrs rrzRowSepCondition.__call__;r rN) rrrrrrrboolrrrrr%r%7s_GG9Xc]+9SM99  999999rr%c ~eZdZdZ d dedeeeffdZde e ede e de d e efd Z d S) RowSepIfa Inserts a row separator between the rows of a definition list only if a condition is satisfied. This class implements the ``RowSepPolicy`` protocol and does two things: - enforces the use of a single row separator for all rows of a definition lists and for all definition lists; note that ``RowSepPolicy`` doesn't for implementation reasons but it's probably what you want; - allows you to implement different conditions (see type :data:`RowSepCondition`) without worrying about the generation part, which is always the same. :param condition: a :class:`RowSepCondition` that determines when to add the (extra) row separator. :param sep: either a string or a ``SepGenerator``, i.e. a function ``(width: int) -> str`` (e.g. :class:`Hline`). The empty string corresponds to an empty line separator. conditionsepct|tr$|drtd||_||_dS)N z_sep must not end with '\n'. The formatter writes a '\n' after it; no other newline is allowed.) isinstancerendswith ValueErrorr+r,)rr+r,s r__init__zRowSepIf.__init__[sR c3   0CLL$6$6 0/00 0#rrrrr c||||r@t|jr%t||}||S|jSdSr )r+callabler,get_total_width)rrrr total_widths rrzRowSepIf.__call__ds[ >>$ K 8 8 !! --j+FF xx ,,,8OtrN)r*) rrrrr%rrrr2rrrrrrrr)r)Ds.24/C-.Xc]+9A#UX #rr)rrr cLt||t|dz zzS)zyReturn the total width of a definition list (or, more generally, a table). Useful when implementing a RowSepStrategy.)sumlen)rrs rr5r5rs% z??[C OOa,?@ @@rrc:tfd|DS)Nc3fK|]+}tdt|DV,dS)c3BK|]\}}t||kVdSr )r:).0col_text col_widths r z1count_multiline_rows...}sM E E#) MMI % E E E E E ErN)anyr)r>rowrs rrAz'count_multiline_rows..|sp   E E'23 'C'C E E E E Er)r9)rrs `rcount_multiline_rowsrDxs?   rcount_or_percentagec|dkrtdt|trF|dtttdttdtdt ffd }nt|t r_|dkrtd d dtttdttdtdt ffd }ntd |S) a  Return a ``RowSepStrategy`` that returns a row separator between all rows of a definition list, only if the number of rows taking multiple lines is greater than or equal to a certain threshold. :param count_or_percentage: a threshold for multiline rows above which the returned strategy will insert a row separator. It can be either an absolute count (`int`) or a percentage relative to the total number of rows expressed as a `float` between 0 and 1 (0 and 1 excluded). rz!count_or_percentage should be > 0rrrr c0t||}|kSr )rD)rrr num_multilinecount_thresholds rr+z.multiline_rows_are_at_least..conditions 1zBBM O3 3rg?zlcount_or_percentage must be either an integer or a float in the interval ]0, 1[. You passed a float >= 1.0 (z).cTt||}|t|z }|kSr )rDr:)rrrrHpercent_multilinepercent_thresholds rr+z.multiline_rows_are_at_least..conditions1 1zBBM -D 9 $(99 9rz-count_or_percentage must be an int or a float)r1r/rrrr'float TypeError)rEr+rIrLs @@rmultiline_rows_are_at_leastrOsOa<===%s++I- 48C=) 4   4 4  4 4 4 4 4 4 4 ' / /I/ s " "U?PUUUVV V :8C=) :   : :  : : : : : : :GHHH rcXeZdZUdZded<ded<ded<ded<defdZded efd Zd S) HlineaeReturns a function that generates an horizontal line of a given length. This class has different static members for different line styles like ``Hline.solid``, ``Hline.dashed``, ``Hline.densely_dashed`` and ``Hline.dotted``. :param pattern: a string (usually a single character) that is repeated to generate the line. soliddasheddensely_dasheddottedpatternc||_dSr )rV)rrVs rr2zHline.__init__s  rr r c|j}t|dkr||zS|t|z|t|z}}||z|d|zS)Nr8)rVr:)rr rVrepsrests rrzHline.__call__sZ, w<<1  U? "c'll*ECLL,@d~..rN) rrrr__annotations__rr2rrrrrrQrQs   NNN OOO OOO/c/c//////rrQu─-u╌u┄)rr! itertoolsrtypingrrrrrSepTyperABCMetarr%r)rr5rDrMrOrQrRrSrTrUrrrras  !!!!!!666666666666 ^# $      8    S[8 9 9 9 9 9h 9 9 9(((((|(((\A ACACAAAA x 6HSMVY.sEz*.....b/////L///:eEll 6uSzz &uU||6uU|| 66r