B ‹æ@\dã@s~dZddlmZmZmZmZddlZe e¡Z ddl Z dZ dd„Z dd„Z dd d „Zddd„Zddd„Zddd„Zdd„ZdS)z9 Functions useful for string manipulations or encoding. é)Úabsolute_importÚdivisionÚprint_functionÚunicode_literalsN)Ú decode_utf8Ú encode_utf8ÚescapeÚformat_docstringÚindentÚ nice_joinÚsnakifycCs$ddl}|jddkr | d¡}|S)z‚ Encode a UTF-8 string to a sequence of bytes. Args: u (str) : the string to encode Returns: bytes rNézutf-8)ÚsysÚ version_infoÚencode)Úur©rú0lib/python3.7/site-packages/bokeh/util/string.pyr0s  rcCs$ddl}|jddkr | d¡}|S)z‡ Decode a sequence of bytes to a UTF-8 string Args: u (str) : the bytes to decode Returns: UTF-8 string rNr zutf-8)rrÚdecode)rrrrrr?s  r©ú'ú"cCsT| dd¡}| dd¡}| dd¡}|rPd|kr<| dd¡}d |krP| d d ¡}|S) aO 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 ú&z&úz>rz"rz')Úreplace)ÚsZquoterrrrOs     rr ú cs&||‰d ‡fdd„| d¡Dƒ¡S)aH 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: " ") Ú c3s|]}ˆ|VqdS)Nr)Ú.0Úline)Úpaddingrrú xszindent..)ÚjoinÚsplit)ÚtextÚnZchr)r!rr isr ú, ÚorcCsPdd„|Dƒ}t|ƒdks"|dkr,| |¡Sd| |dd…¡||dfSdS)a 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' cSsg|] }t|ƒ‘qSr)Ústr)rÚxrrrú Œsznice_join..éNz%s %s %séÿÿÿÿ)Úlenr#)ÚseqÚsepZ conjuctionrrrr zs r Ú_cCs,t dd||¡}t dd||¡}| ¡S)z" Convert CamelCase to snake_case. z([A-Z]+)([A-Z][a-z])z\1%s\2z([a-z\d])([A-Z]))ÚreÚsubÚlower)Únamer0rrrr “sr cOs|dkr dS|j||ŽS)aæ 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)Úformat)Z docstringÚargsÚkwargsrrrr ™sr )r)r r)r'r()r1)Ú__doc__Z __future__rrrrZloggingZ getLoggerÚ__name__Úlogr2Ú__all__rrrr r r r rrrrÚ s