Current File : //usr/lib/python2.7/site-packages/kitchen/text/utf8.pyc
�
i�:Oc @ s� d Z d d l Z d d l m Z 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 d � Z d � Z d d � Z d e d
d
d � Z d d
d
d
� Z d � Z d � Z d Z d S( s�
-----
UTF-8
-----
Functions for operating on byte :class:`str` encoded as :term:`UTF-8`
.. note::
In many cases, it is better to convert to :class:`unicode`, operate on the
strings, then convert back to :term:`UTF-8`. :class:`unicode` type can
handle many of these functions itself. For those that it doesn't
(removing control characters from length calculations, for instance) the
code to do so with a :class:`unicode` type is often simpler.
.. warning::
All of the functions in this module are deprecated. Most of them have
been replaced with functions that operate on unicode values in
:mod:`kitchen.text.display`. :func:`kitchen.text.utf8.utf8_valid` has
been replaced with a function in :mod:`kitchen.text.misc`.
i����N( t b_( t
to_unicodet to_bytes( t byte_string_valid_encoding( t _textual_width_let byte_string_textual_width_fillt fillt
textual_widtht textual_width_chopt wrapc C s& t j t d � t d d �t | � S( s� **Deprecated** Detect if a string is valid :term:`utf-8`
Use :func:`kitchen.text.misc.byte_string_valid_encoding` instead.
sj kitchen.text.utf8.utf8_valid is deprecated. Use kitchen.text.misc.byte_string_valid_encoding(msg) insteadt
stackleveli ( t warningst warnR t DeprecationWarningR ( t msg( ( s5 /usr/lib/python2.7/site-packages/kitchen/text/utf8.pyt
utf8_valid@ s
c C s& t j t d � t d d �t | � S( s� **Deprecated** Get the :term:`textual width` of a :term:`utf-8` string
Use :func:`kitchen.text.display.textual_width` instead.
s` kitchen.text.utf8.utf8_width is deprecated. Use kitchen.text.display.textual_width(msg) insteadR
i ( R R R R
R ( R ( ( s5 /usr/lib/python2.7/site-packages/kitchen/text/utf8.pyt
utf8_widthJ s
c C s| t j t d � t d d �| d k r8 t | � | f St | t � } t | | � } | rl t | � } n t | � | f S( sA **Deprecated** Return a string chopped to a given :term:`textual width`
Use :func:`~kitchen.text.display.textual_width_chop` and
:func:`~kitchen.text.display.textual_width` instead::
>>> msg = 'く ku ら ra と to み mi'
>>> # Old way:
>>> utf8_width_chop(msg, 5)
(5, 'く ku')
>>> # New way
>>> from kitchen.text.converters import to_bytes
>>> from kitchen.text.display import textual_width, textual_width_chop
>>> (textual_width(msg), to_bytes(textual_width_chop(msg, 5)))
(5, 'く ku')
se kitchen.text.utf8.utf8_width_chop is deprecated. Use kitchen.text.display.textual_width_chop insteadR
i N(
R R R R
t NoneR t
isinstancet unicodeR R ( R t chopt as_bytest chopped_msg( ( s5 /usr/lib/python2.7/site-packages/kitchen/text/utf8.pyt utf8_width_chopU s t c C sA t j t d � t d d �t | | d | d | d | d | �S( s� **Deprecated** Pad a :term:`utf-8` string to fill a specified width
Use :func:`~kitchen.text.display.byte_string_textual_width_fill` instead
sq kitchen.text.utf8.utf8_width_fill is deprecated. Use kitchen.text.display.byte_string_textual_width_fill insteadR
i R t leftt prefixt suffix( R R R R
R ( R R R R R R ( ( s5 /usr/lib/python2.7/site-packages/kitchen/text/utf8.pyt utf8_width_fills s
iF c C s� t j t d � t d d �t | t � } t | � } t | d | d | d | �} | r~ g | D] } t | � ^ qc } n | S( s� **Deprecated** Similar to :func:`textwrap.wrap` but understands
:term:`utf-8` data and doesn't screw up lists/blocks/etc
Use :func:`kitchen.text.display.wrap` instead
sV kitchen.text.utf8.utf8_text_wrap is deprecated. Use kitchen.text.display.wrap insteadR
i t widtht initial_indentt subsequent_indent( R R R R
R R R R R ( t textR R R R t linest m( ( s5 /usr/lib/python2.7/site-packages/kitchen/text/utf8.pyt utf8_text_wrap s
"c O s, t j t d � t d d �t | | | � S( s� **Deprecated** Similar to :func:`textwrap.fill` but understands
:term:`utf-8` strings and doesn't screw up lists/blocks/etc.
Use :func:`kitchen.text.display.fill` instead.
sV kitchen.text.utf8.utf8_text_fill is deprecated. Use kitchen.text.display.fill insteadR
i ( R R R R
R ( R t argst kwargs( ( s5 /usr/lib/python2.7/site-packages/kitchen/text/utf8.pyt utf8_text_fill� s
c G s8 t j t d � t d d �t | t d j | � � � S( sx **Deprecated** Convert the arguments to unicode and use
:func:`kitchen.text.display._textual_width_le` instead.
sc kitchen.text.utf8._utf8_width_le is deprecated. Use kitchen.text.display._textual_width_le insteadR
i R ( R R R R
R R t join( R R$ ( ( s5 /usr/lib/python2.7/site-packages/kitchen/text/utf8.pyt _utf8_width_le� s
R& R# R R R R ( s utf8_text_fills utf8_text_wraps
utf8_valids
utf8_widths utf8_width_chops utf8_width_fill( t __doc__R t kitchenR t kitchen.text.convertersR R t kitchen.text.miscR t kitchen.text.displayR R R R R R R R R R t TrueR R# R& R( t __all__( ( ( s5 /usr/lib/python2.7/site-packages/kitchen/text/utf8.pyt <module>2 s .
Mini Shell