| Disable Functions: Path : /lib/python2.7/site-packages/kitchen/text/ |
| Current File : //lib/python2.7/site-packages/kitchen/text/display.pyc |
�
i�:Oc � @ s d Z d d l Z d d l Z d d l m Z d d l m Z m Z d d l m Z d � Z
d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d|d}d~dd�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�f� Z d%� Z d&� Z
d'd(� Z d'd)d*d+� Z d)d*d,� Z d e d-d-d.� Z d/� Z d0d1d1d)d*d2� Z d3� Z d e d-d-d)d*d4� Z d�Z d S(� s
-----------------------
Format Text for Display
-----------------------
Functions related to displaying unicode text. Unicode characters don't all
have the same width so we need helper functions for displaying them.
.. versionadded:: 0.2 kitchen.display API 1.0.0
i����N( t b_( t
to_unicodet to_bytes( t ControlCharErrorc C s� d } t | � d } | | | d k s> | | | d k rB t Sxd | | k r� | | d } | | | d k r� | d } qE | | | d k r� | d } qE t SqE Wt S( s� Binary search in an interval table.
:arg value: numeric value to search for
:arg table: Ordered list of intervals. This is a list of two-tuples. The
elements of the two-tuple define an interval's start and end points.
:returns: If :attr:`value` is found within an interval in the :attr:`table`
return :data:`True`. Otherwise, :data:`False`
This function checks whether a numeric value is present within a table
of intervals. It checks using a binary search algorithm, dividing the
list of values in half and checking against the values until it determines
whether the value is in the table.
i i i ( t lent Falset True( t valuet tablet minimumt maximumt mid( ( s8 /usr/lib/python2.7/site-packages/kitchen/text/display.pyt _interval_bisearchT s (
i io i� i� i� i� i� i� i� i� i� i� i i i i iK i^ ip i� i� i� i� i� i� i i i0 iJ i� i� i� i� i i i i# i% i' i) i- i i i< iA iH iM iQ iT ib ic i� i� i� i� i� i� i� i
i
i<
iA
iB
iG
iH
iK
iM
ip
iq
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i i< i? iA iC iM iV i� i� i� i> i@ iF iH iJ iM iU iV i� i� i� i� i� i� i� iA
iC
iM
i�
i�
i�
i�
i1 i4 i: iG iN i� i� i� i� i� i� i� i i i5 i7 i9 iq i~ i� i� i� i� i� i� i� i� i� i- i0 i2 i6 i7 i9 i: iX iY i� i` i� i_ i i i2 i4 iR iS ir is i� i� i� i� i� i� i� i� i i
i� i i" i' i( i2 i9 i; i i i` iu i| i i i i4 i6 i: i< iB iD ik is i� i7 i� i� i� i� i� i� i� i� i� i� i� i i i* i. i` ic ij io i� i� i�, i�, i�- i�- i*0 i/0 i�0 i�0 io� i|� i}� i� i� i� i � i%� i&� iĨ i� i� i+� i-� iS� i�� i�� i�� i�� i�� i�� i�� i�� i�� i�� i� i � i � i� i � i&� i�� i�� i�� i� i
i
i
i
i
i
i8
i:
i?
i� i� ie� ii� im� i�� i�� i�� i�� i�� iB� iD� i i i i i� c � C s� d� d� d� d� d� d� d� d� d� d� d� d� d� d� d� d� d� d ddddddddd d
d d d
ddddddddddddddd d d d d d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d|f� } g } t } g } x� t d� d}� D]r } t | | � s�t j t | � � r| sD| g } t } qDq�| r�t } | j | d� � | j | � q�q�W| rk| j | � | j | � n t t j
t | � � S(~ se Combine Markus Kuhn's data with :mod:`unicodedata` to make combining
char list
:rtype: :class:`tuple` of tuples
:returns: :class:`tuple` of intervals of :term:`code points` that are
combining character. Each interval is a 2-:class:`tuple` of the
starting :term:`code point` and the ending :term:`code point` for the
combining characters.
In normal use, this function serves to tell how we're generating the
combining char list. For speed reasons, we use this to generate a static
list and just use that later.
Markus Kuhn's list of combining characters is more complete than what's in
the python :mod:`unicodedata` library but the python :mod:`unicodedata` is
synced against later versions of the unicode database
This is used to generate the :data:`~kitchen.text.display._COMBINING`
table.
i io i� i� i� i� i� i� i� i� i� i� i� i� i i i i iK i^ ip i� i� i� i� i� i� i i i0 iJ i� i� i� i� i i i< iA iH iM iQ iT ib ic i� i� i� i� i� i� i� i
i
i<
iA
iB
iG
iH
iK
iM
ip
iq
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i i< i? iA iC iM iV i� i� i� i> i@ iF iH iJ iM iU iV i� i� i� i� i� i� i� iA
iC
iM
i�
i�
i�
i�
i1 i4 i: iG iN i� i� i� i� i� i� i� i i i5 i7 i9 iq i~ i� i� i� i� i� i� i� i� i� i- i0 i2 i6 i7 i9 iX iY i` i� i_ i i i2 i4 iR iS ir is i� i� i� i� i� i� i� i� i i
i� i i" i' i( i2 i9 i; i i i i i4 i6 i: i< iB ik is i� i� i� i� i i i* i. i` ic ij io i� i� i*0 i/0 i�0 i�0 i� i � i%� i&� i � i � i� i � i#� i�� i�� i�� i
i
i
i
i
i
i8
i:
i?
ig� ii� is� i�� i�� i�� i�� i�� iB� iD� i i i i i� i i�� i ( i io ( i� i� ( i� i� ( i� i� ( i� i� ( i� i� ( i� i� ( i� i� ( i i ( i i ( iK i^ ( ip ip ( i� i� ( i� i� ( i� i� ( i i ( i i ( i0 iJ ( i� i� ( i� i� ( i i ( i< i< ( iA iH ( iM iM ( iQ iT ( ib ic ( i� i� ( i� i� ( i� i� ( i� i� ( i� i� ( i
i
( i<
i<
( iA
iB
( iG
iH
( iK
iM
( ip
iq
( i�
i�
( i�
i�
( i�
i�
( i�
i�
( i�
i�
( i�
i�
( i i ( i< i< ( i? i? ( iA iC ( iM iM ( iV iV ( i� i� ( i� i� ( i� i� ( i> i@ ( iF iH ( iJ iM ( iU iV ( i� i� ( i� i� ( i� i� ( i� i� ( i� i� ( iA
iC
( iM
iM
( i�
i�
( i�
i�
( i�
i�
( i1 i1 ( i4 i: ( iG iN ( i� i� ( i� i� ( i� i� ( i� i� ( i i ( i5 i5 ( i7 i7 ( i9 i9 ( iq i~ ( i� i� ( i� i� ( i� i� ( i� i� ( i� i� ( i- i0 ( i2 i2 ( i6 i7 ( i9 i9 ( iX iY ( i` i� ( i_ i_ ( i i ( i2 i4 ( iR iS ( ir is ( i� i� ( i� i� ( i� i� ( i� i� ( i� i� ( i i
( i� i� ( i i" ( i' i( ( i2 i2 ( i9 i; ( i i ( i i ( i4 i4 ( i6 i: ( i< i< ( iB iB ( ik is ( i� i� ( i� i� ( i i ( i* i. ( i` ic ( ij io ( i� i� ( i*0 i/0 ( i�0 i�0 ( i� i� ( i � i � ( i%� i&� ( i � i � ( i � i� ( i � i#� ( i�� i�� ( i�� i�� ( i
i
( i
i
( i
i
( i8
i:
( i?
i?
( ig� ii� ( is� i�� ( i�� i�� ( i�� i�� ( iB� iD� ( i i ( i i ( i i� i ( R t xrangeR t unicodedatat combiningt unichrR t appendt tuplet itertoolst imap( t markus_kuhn_combining_5_0R t in_intervalt intervalt codepoint( ( s8 /usr/lib/python2.7/site-packages/kitchen/text/display.pyt _generate_combining_table� s�
c C so t � } d } d GHxO | D]G } | d k r7 d } Hn | d k rJ d Gn | d 7} d | } | Gq Wd GHd S( s; Print out a new :data:`_COMBINING` table
This will print a new :data:`_COMBINING` table in the format used in
:file:`kitchen/text/display.py`. It's useful for updating the
:data:`_COMBINING` table with updated data from a new python as the format
won't change from what's already in the file.
i s _COMBINING = (i s i s
(0x%x, 0x%x),t )N( R ( R t entriest pairt entry( ( s8 /usr/lib/python2.7/site-packages/kitchen/text/display.pyt _print_combining_table$ s
t guessc C s� | d k s$ | d k ri | d k ri | d k rE t t d � � � n | d# k rU d S| d k re d Sd
St | t � r| d
Sd | d k o�| d
k p�| d k p�| d k p�| d k r� | d k r� | d k p�| d k r� | d k p�| d k r| d k p�| d k r| d k p�| d k r3| d k p�| d k rK| d k p�| d k rc| d k p�| d k r{| d k p�| d! k o�| d" k S($ s Get the :term:`textual width` of a ucs character
:arg ucs: integer representing a single unicode :term:`code point`
:kwarg control_chars: specify how to deal with :term:`control characters`.
Possible values are:
:guess: (default) will take a guess for :term:`control character`
widths. Most codes will return zero width. ``backspace``,
``delete``, and ``clear delete`` return -1. ``escape`` currently
returns -1 as well but this is not guaranteed as it's not always
correct
:strict: will raise :exc:`~kitchen.text.exceptions.ControlCharError`
if a :term:`control character` is encountered
:raises ControlCharError: if the :term:`code point` is a unicode
:term:`control character` and :attr:`control_chars` is set to 'strict'
:returns: :term:`textual width` of the character.
.. note::
It's important to remember this is :term:`textual width` and not the
number of characters or bytes.
i i� i t strictsQ _ucp_width does not understand how to assign a width value to control characters.i i� i����i i i i i_ i)# i*# i�. iϤ i?0 i � i�� i � i�� i� i� i0� io� i � i`� i� i� i i�� i i�� ( i i i� ( R R R t
_COMBINING( t ucst
control_chars( ( s8 /usr/lib/python2.7/site-packages/kitchen/text/display.pyt
_ucp_width< s0 $ s utf-8t replacec C sO t | d | d | �} t t j t t j t j t | � t j | � � � � S( s� Get the :term:`textual width` of a string
:arg msg: :class:`unicode` string or byte :class:`str` to get the width of
:kwarg control_chars: specify how to deal with :term:`control characters`.
Possible values are:
:guess: (default) will take a guess for :term:`control character`
widths. Most codes will return zero width. ``backspace``,
``delete``, and ``clear delete`` return -1. ``escape`` currently
returns -1 as well but this is not guaranteed as it's not always
correct
:strict: will raise :exc:`kitchen.text.exceptions.ControlCharError`
if a :term:`control character` is encountered
:kwarg encoding: If we are given a byte :class:`str` this is used to
decode it into :class:`unicode` string. Any characters that are not
decodable in this encoding will get a value dependent on the
:attr:`errors` parameter.
:kwarg errors: How to treat errors encoding the byte :class:`str` to
:class:`unicode` string. Legal values are the same as for
:func:`kitchen.text.converters.to_unicode`. The default value of
``replace`` will cause undecodable byte sequences to have a width of
one. ``ignore`` will have a width of zero.
:raises ControlCharError: if :attr:`msg` contains a :term:`control
character` and :attr:`control_chars` is ``strict``.
:returns: :term:`Textual width` of the :attr:`msg`. This is the amount of
space that the string will consume on a monospace display. It's
measured in the number of cell positions or columns it will take up on
a monospace display. This is **not** the number of glyphs that are in
the string.
.. note::
This function can be wrong sometimes because Unicode does not specify
a strict width value for all of the :term:`code points`. In
particular, we've found that some Tamil characters take up to four
character cells but we return a lesser amount.
t encodingt errors( R t sumR t starmapR$ t izipR t ordt repeat( t msgR# R& R' ( ( s8 /usr/lib/python2.7/site-packages/kitchen/text/display.pyt
textual_width~ s G c
C s t | d | d | �} t | � } | | k r4 | St | � } | | d k r] | d } n d } | } | | k r~ | } n t | | � } x�t r| | k rB| | | d } | | k r� Pn | | | | k r x8 | | k r| t t | | d � � } | d 8} q� W| | S| t | | | !� } | } | } q� | | k r| | | d } | | k rpPn | | | | k r�x: | | k r�t t | | � � } | | } | d 7} q�W| | S| t | | | !� } | } | } | | k r
| } Pq
q� | | Sq� W| | S( sy Given a string, return it chopped to a given :term:`textual width`
:arg msg: :class:`unicode` string or byte :class:`str` to chop
:arg chop: Chop :attr:`msg` if it exceeds this :term:`textual width`
:kwarg encoding: If we are given a byte :class:`str`, this is used to
decode it into a :class:`unicode` string. Any characters that are not
decodable in this encoding will be assigned a width of one.
:kwarg errors: How to treat errors encoding the byte :class:`str` to
:class:`unicode`. Legal values are the same as for
:func:`kitchen.text.converters.to_unicode`
:rtype: :class:`unicode` string
:returns: :class:`unicode` string of the :attr:`msg` chopped at the given
:term:`textual width`
This is what you want to use instead of ``%.*s``, as it does the "right"
thing with regard to :term:`UTF-8` sequences, :term:`control characters`,
and characters that take more than one cell position. Eg::
>>> # Wrong: only displays 8 characters because it is operating on bytes
>>> print "%.*s" % (10, 'café ñunru!')
café ñun
>>> # Properly operates on graphemes
>>> '%s' % (textual_width_chop('café ñunru!', 10))
café ñunru
>>> # takes too many columns because the kanji need two cell positions
>>> print '1234567890\n%.*s' % (10, u'一二三四五六七八九十')
1234567890
一二三四五六七八九十
>>> # Properly chops at 10 columns
>>> print '1234567890\n%s' % (textual_width_chop(u'一二三四五六七八九十', 10))
1234567890
一二三四五
R& R' i i i ( R R. R R R$ R+ (
R- t chopR& R' t widthR
R t eosR t new_width( ( s8 /usr/lib/python2.7/site-packages/kitchen/text/display.pyt textual_width_chop� sV $
t c C s� t | � } | d k r* t | | � } n t | � } | | k rl | sN | r� d j | | | g � } q� nM d | | } | r� d j | | | | g � } n d j | | | | g � } | S( s
Expand a :class:`unicode` string to a specified :term:`textual width`
or chop to same
:arg msg: :class:`unicode` string to format
:arg fill: pad string until the :term:`textual width` of the string is
this length
:kwarg chop: before doing anything else, chop the string to this length.
Default: Don't chop the string at all
:kwarg left: If :data:`True` (default) left justify the string and put the
padding on the right. If :data:`False`, pad on the left side.
:kwarg prefix: Attach this string before the field we're filling
:kwarg suffix: Append this string to the end of the field we're filling
:rtype: :class:`unicode` string
:returns: :attr:`msg` formatted to fill the specified width. If no
:attr:`chop` is specified, the string could exceed the fill length
when completed. If :attr:`prefix` or :attr:`suffix` are printable
characters, the string could be longer than the fill width.
.. note::
:attr:`prefix` and :attr:`suffix` should be used for "invisible"
characters like highlighting, color changing escape codes, etc. The
fill characters are appended outside of any :attr:`prefix` or
:attr:`suffix` elements. This allows you to only highlight
:attr:`msg` inside of the field you're filling.
.. warning::
:attr:`msg`, :attr:`prefix`, and :attr:`suffix` should all be
representable as unicode characters. In particular, any escape
sequences in :attr:`prefix` and :attr:`suffix` need to be convertible
to :class:`unicode`. If you need to use byte sequences here rather
than unicode characters, use
:func:`~kitchen.text.display.byte_string_textual_width_fill` instead.
This function expands a string to fill a field of a particular
:term:`textual width`. Use it instead of ``%*.*s``, as it does the
"right" thing with regard to :term:`UTF-8` sequences, :term:`control
characters`, and characters that take more than one cell position in
a display. Example usage::
>>> msg = u'一二三四五六七八九十'
>>> # Wrong: This uses 10 characters instead of 10 cells:
>>> u":%-*.*s:" % (10, 10, msg[:9])
:一二三四五六七八九 :
>>> # This uses 10 cells like we really want:
>>> u":%s:" % (textual_width_fill(msg[:9], 10, 10))
:一二三四五:
>>> # Wrong: Right aligned in the field, but too many cells
>>> u"%20.10s" % (msg)
一二三四五六七八九十
>>> # Correct: Right aligned with proper number of cells
>>> u"%s" % (textual_width_fill(msg, 20, 10, left=False))
一二三四五
>>> # Wrong: Adding some escape characters to highlight the line but too many cells
>>> u"%s%20.10s%s" % (prefix, msg, suffix)
u'[7m 一二三四五六七八九十[0m'
>>> # Correct highlight of the line
>>> u"%s%s%s" % (prefix, display.textual_width_fill(msg, 20, 10, left=False), suffix)
u'[7m 一二三四五[0m'
>>> # Correct way to not highlight the fill
>>> u"%s" % (display.textual_width_fill(msg, 20, 10, left=False, prefix=prefix, suffix=suffix))
u' [7m一二三四五[0m'
u u N( R t NoneR3 R. t join( R- t fillR/ t leftt prefixt suffixR0 t extra( ( s8 /usr/lib/python2.7/site-packages/kitchen/text/display.pyt textual_width_fill4 s D c G s� d j | � } t j d | � } t | � | k r7 t St | � d | k rQ t St t | � � | k rm t St | � } | | k S( st Optimize the common case when deciding which :term:`textual width` is
larger
:arg width: :term:`textual width` to compare against.
:arg \*args: :class:`unicode` strings to check the total :term:`textual
width` of
:returns: :data:`True` if the total length of :attr:`args` are less than
or equal to :attr:`width`. Otherwise :data:`False`.
We often want to know "does X fit in Y". It takes a while to use
:func:`textual_width` to calculate this. However, we know that the number
of canonically composed :class:`unicode` characters is always going to
have 1 or 2 for the :term:`textual width` per character. With this we can
take the following shortcuts:
1) If the number of canonically composed characters is more than width,
the true :term:`textual width` cannot be less than width.
2) If the number of canonically composed characters * 2 is less than the
width then the :term:`textual width` must be ok.
:term:`textual width` of a canonically composed :class:`unicode` string
will always be greater than or equal to the the number of :class:`unicode`
characters. So we can first check if the number of composed
:class:`unicode` characters is less than the asked for width. If it is we
can return :data:`True` immediately. If not, then we must do a full
:term:`textual width` lookup.
R4 t NFCi ( R6 R t normalizeR R R R R. ( R0 t argst stringt
true_width( ( s8 /usr/lib/python2.7/site-packages/kitchen/text/display.pyt _textual_width_le� s iF u c s� � f d � � t | d | d | �} t | d | d | �} t | � } t | d | d | �j d � } | j � j d � } g } | } t }
d } d } x| D]�}
|
j d � }
| | } } � |
� \ } } t } |
r� | r� t } n |
r| t |
� k rt } n |
rG| rG| d k rG| | k rGt } qGn | rr| j | j d � � | } t }
n | t |
� k r�d }
n |
r�|
j d � }
| } n t
| | |
� r�t }
| j | |
� | } q� n t }
|
j d � } | }
| } | r | d k r | } n xn | D]f } t
| |
| � rvt |
� | k rv| j |
j d � � | d | }
n |
| 7}
|
d 7}
q$W|
j d � d } q� W|
r�| j | j d � � n | S( s Works like we want :func:`textwrap.wrap` to work,
:arg text: :class:`unicode` string or byte :class:`str` to wrap
:kwarg width: :term:`textual width` at which to wrap. Default: 70
:kwarg initial_indent: string to use to indent the first line. Default:
do not indent.
:kwarg subsequent_indent: string to use to wrap subsequent lines.
Default: do not indent
:kwarg encoding: Encoding to use if :attr:`text` is a byte :class:`str`
:kwarg errors: error handler to use if :attr:`text` is a byte :class:`str`
and contains some undecodable characters.
:rtype: :class:`list` of :class:`unicode` strings
:returns: list of lines that have been text wrapped and indented.
:func:`textwrap.wrap` from the |stdlib|_ has two drawbacks that this
attempts to fix:
1. It does not handle :term:`textual width`. It only operates on bytes or
characters which are both inadequate (due to multi-byte and double
width characters).
2. It malforms lists and blocks.
c s� y | j � d } Wn t k
r( d SX| j | � } | d k rN | d f S� | | d � } | d ps | d } | r� | | d | f S| d f S( sf Return the indent to use for this and (possibly) subsequent lines
:arg line: :class:`unicode` line of text to process
:rtype: tuple
:returns: tuple of count of whitespace before getting to the start of
this line followed by a count to the following indent if this
block of text is an entry in a list.
i u
-*.o•‣∘i ( i i ( t stript
IndexErrort find( t linet chart countt nxt( t _indent_at_beg( s8 /usr/lib/python2.7/site-packages/kitchen/text/display.pyRJ � s
R& R' u
i u i u ( R R. t rstript
expandtabst splitR R R R t lstripRB ( t textR0 t initial_indentt subsequent_indentR& R' t subsequent_indent_widtht linest rett indentt wrap_lastt cur_sabt cur_spc_indentRF t last_sabt last_spc_indentt force_nlt wordst spcst word( ( RJ s8 /usr/lib/python2.7/site-packages/kitchen/text/display.pyt wrap� sp & !
c O s d j t | | | � � S( s Works like we want :func:`textwrap.fill` to work
:arg text: :class:`unicode` string or byte :class:`str` to process
:returns: :class:`unicode` string with each line separated by a newline
.. seealso::
:func:`kitchen.text.display.wrap`
for other parameters that you can give this command.
This function is a light wrapper around :func:`kitchen.text.display.wrap`.
Where that function returns a :class:`list` of lines, this function
returns one string with each line separated by a newline.
u
( R6 R_ ( RO R? t kwargs( ( s8 /usr/lib/python2.7/site-packages/kitchen/text/display.pyR7 3 s c
C s� t | d | d | �} t | d | d | �} | d k rZ t | | d | d | �} n t | � } t | � } | | k r� | s� | r� d j | | | g � } q� nM d | | } | r� d j | | | | g � } n d j | | | | g � } | S( s% Expand a byte :class:`str` to a specified :term:`textual width` or chop
to same
:arg msg: byte :class:`str` encoded in :term:`UTF-8` that we want formatted
:arg fill: pad :attr:`msg` until the :term:`textual width` is this long
:kwarg chop: before doing anything else, chop the string to this length.
Default: Don't chop the string at all
:kwarg left: If :data:`True` (default) left justify the string and put the
padding on the right. If :data:`False`, pad on the left side.
:kwarg prefix: Attach this byte :class:`str` before the field we're
filling
:kwarg suffix: Append this byte :class:`str` to the end of the field we're
filling
:rtype: byte :class:`str`
:returns: :attr:`msg` formatted to fill the specified :term:`textual
width`. If no :attr:`chop` is specified, the string could exceed the
fill length when completed. If :attr:`prefix` or :attr:`suffix` are
printable characters, the string could be longer than fill width.
.. note::
:attr:`prefix` and :attr:`suffix` should be used for "invisible"
characters like highlighting, color changing escape codes, etc. The
fill characters are appended outside of any :attr:`prefix` or
:attr:`suffix` elements. This allows you to only highlight
:attr:`msg` inside of the field you're filling.
.. seealso::
:func:`~kitchen.text.display.textual_width_fill`
For example usage. This function has only two differences.
1. it takes byte :class:`str` for :attr:`prefix` and
:attr:`suffix` so you can pass in arbitrary sequences of
bytes, not just unicode characters.
2. it returns a byte :class:`str` instead of a :class:`unicode`
string.
R& R' R4 t N( R R5 R3 R. R6 (
R- R7 R/ R8 R9 R: R& R' R0 R; ( ( s8 /usr/lib/python2.7/site-packages/kitchen/text/display.pyt byte_string_textual_width_fillH s ( Rb R7 R. R3 R< R_ ( i io ( i� i� ( i� i� ( i� i� ( i� i� ( i� i� ( i� i� ( i i ( i i ( iK i^ ( ip ip ( i� i� ( i� i� ( i� i� ( i i ( i i ( i0 iJ ( i� i� ( i� i� ( i i ( i i# ( i% i' ( i) i- ( i i ( i< i< ( iA iH ( iM iM ( iQ iT ( ib ic ( i� i� ( i� i� ( i� i� ( i� i� ( i� i� ( i
i
( i<
i<
( iA
iB
( iG
iH
( iK
iM
( ip
iq
( i�
i�
( i�
i�
( i�
i�
( i�
i�
( i�
i�
( i�
i�
( i i ( i< i< ( i? i? ( iA iC ( iM iM ( iV iV ( i� i� ( i� i� ( i� i� ( i> i@ ( iF iH ( iJ iM ( iU iV ( i� i� ( i� i� ( i� i� ( i� i� ( i� i� ( iA
iC
( iM
iM
( i�
i�
( i�
i�
( i�
i�
( i1 i1 ( i4 i: ( iG iN ( i� i� ( i� i� ( i� i� ( i� i� ( i i ( i5 i5 ( i7 i7 ( i9 i9 ( iq i~ ( i� i� ( i� i� ( i� i� ( i� i� ( i� i� ( i- i0 ( i2 i2 ( i6 i7 ( i9 i: ( iX iY ( i� i� ( i` i� ( i_ i_ ( i i ( i2 i4 ( iR iS ( ir is ( i� i� ( i� i� ( i� i� ( i� i� ( i� i� ( i i
( i� i� ( i i" ( i' i( ( i2 i2 ( i9 i; ( i i ( i` i` ( iu i| ( i i ( i i ( i4 i4 ( i6 i: ( i< i< ( iB iB ( iD iD ( ik is ( i� i� ( i7 i7 ( i� i� ( i� i� ( i� i� ( i� i� ( i� i� ( i� i� ( i i ( i* i. ( i` ic ( ij io ( i� i� ( i�, i�, ( i�- i�- ( i*0 i/0 ( i�0 i�0 ( io� io� ( i|� i}� ( i� i� ( i� i� ( i � i � ( i%� i&� ( iĨ iĨ ( i� i� ( i+� i-� ( iS� iS� ( i�� i�� ( i�� i�� ( i�� i�� ( i�� i�� ( i�� i�� ( i�� i�� ( i�� i�� ( i� i� ( i � i � ( i � i� ( i � i&� ( i�� i�� ( i�� i�� ( i� i� ( i
i
( i
i
( i
i
( i8
i:
( i?
i?
( i� i� ( ie� ii� ( im� i�� ( i�� i�� ( i�� i�� ( iB� iD� ( i i ( i i ( i i� ( s byte_string_textual_width_fills fills
textual_widths textual_width_chops textual_width_fills wrap( t __doc__R R t kitchenR t kitchen.text.convertersR R t kitchen.text.exceptionsR R R! R R R$ R. R3 R5 R R< RB R_ R7 Rb t __all__( ( ( s8 /usr/lib/python2.7/site-packages/kitchen/text/display.pyt <module>& s� ( d B SbS + � ;