ó mÜJ]c@`sªdZddlmZmZmZmZddlZejeƒZ ddl Z dZ d „Z d „Z dd„Zddd„Zddd„Zdd„Zd„ZdS(u9 Functions useful for string manipulations or encoding. i(tabsolute_importtdivisiontprint_functiontunicode_literalsNu decode_utf8u encode_utf8uescapeuformat_docstringuindentu nice_joinusnakifycC`s5ddl}|jddkr1|jdƒ}n|S(u‚ Encode a UTF-8 string to a sequence of bytes. Args: u (str) : the string to encode Returns: bytes iNiuutf-8(tsyst version_infotencode(tuR((s0lib/python2.7/site-packages/bokeh/util/string.pyt encode_utf80s cC`s5ddl}|jddkr1|jdƒ}n|S(u‡ Decode a sequence of bytes to a UTF-8 string Args: u (str) : the bytes to decode Returns: UTF-8 string iNiuutf-8(RRtdecode(RR((s0lib/python2.7/site-packages/bokeh/util/string.pyt decode_utf8?s u'u"cC`s…|jddƒ}|jddƒ}|jddƒ}|rd|kr]|jddƒ}nd |kr|jd d ƒ}qn|S( uO Perform HTML-safe escaping. Replaces special characters "&", "<" and ">" to HTML-safe sequences, and optionally translates quote characters. Args: s (str): a string to escape quote (seq[str], optional) : which quote characters to replace (default: ("'", '"')) Returns: str u&u&uu>u"u"u'u'(treplace(tstquote((s0lib/python2.7/site-packages/bokeh/util/string.pytescapeOs  iu c`s0||‰dj‡fd†|jdƒDƒƒS(uH Indent all the lines in a given block of text by a specified amount. Args: text (str) : The text to indent n (int, optional) : The amount to indent each line by (default: 2) ch (char, optional) : What character to fill the indentation with (default: " ") u c3`s|]}ˆ|VqdS(N((t.0tline(tpadding(s0lib/python2.7/site-packages/bokeh/util/string.pys xs(tjointsplit(ttexttntch((Rs0lib/python2.7/site-packages/bokeh/util/string.pytindentis u, uorcC`spg|D]}t|ƒ^q}t|ƒdks=|dkrJ|j|ƒSd|j|d ƒ||dfSdS(u Join together sequences of strings into English-friendly phrases using the conjunction ``or`` when appropriate. Args: seq (seq[str]) : a sequence of strings to nicely join sep (str, optional) : a sequence delimiter to use (default: ", ") conjunction (str or None, optional) : a conjuction to use for the last two items, or None to reproduce basic join behaviour (default: "or") Returns: a joined string Examples: >>> nice_join(["a", "b", "c"]) 'a, b or c' iu%s %s %siÿÿÿÿN(tstrtlentNoneR(tseqtsept conjuctiontx((s0lib/python2.7/site-packages/bokeh/util/string.pyt nice_joinzs u_cC`s<tjdd||ƒ}tjdd||ƒ}|jƒS(u" Convert CamelCase to snake_case. u([A-Z]+)([A-Z][a-z])u\1%s\2u([a-z\d])([A-Z])(tretsubtlower(tnameR((s0lib/python2.7/site-packages/bokeh/util/string.pytsnakify“scO`s |dkrdS|j||ŽS(uæ Safely format docstrings. When Python is executed with the ``-OO`` option, doc strings are removed and replaced the value ``None``. This function guards against applying the string formatting options in that case. Args: docstring (str or None) : The docstring to format, or ``None`` args (tuple) : string formatting arguments for the docsring kwargs (dict) : string formatting arguments for the docsring Returns: str or None N(Rtformat(t docstringtargstkwargs((s0lib/python2.7/site-packages/bokeh/util/string.pytformat_docstring™s(u decode_utf8u encode_utf8uescapeuformat_docstringuindentu nice_joinusnakify(u'u"(t__doc__t __future__RRRRtloggingt getLoggert__name__tlogR t__all__RR RRRR$R)(((s0lib/python2.7/site-packages/bokeh/util/string.pyt s$"