U /eJ@sdZddlmZddlZeeZddlZddlm Z m Z m Z m Z ddl mZdZd'd d d d d d d Zd(dd d d dddZd)d d d dddZdd ddddZe ddddddd Ze d ddd dd!d Zdddddd"d Zd*d d#d d$d%d&ZdS)+z9 Functions useful for string manipulations or encoding. ) annotationsN)AnyDictIterableoverload quote_plus)append_docstringformat_docstringindent nice_joinsnakify strint)textnchreturncs&||dfdd|dDS)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|]}|VqdSN).0linepaddingr5/tmp/pip-unpacked-wheel-f5fndrjf/bokeh/util/string.py Aszindent..)joinsplit)rrrrrrr 2sr , orz Iterable[str])seqsep conjuctionrcCsVdd|D}t|dks"|dkr,||S||ddd|d|dSdS)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)r)rxrrr Vsznice_join..Nr)lenr)r#r$r%rrrr Ds r _)namer$rcCs,tdd||}tdd||}|S)z" Convert CamelCase to snake_case. z([A-Z]+)([A-Z][a-z])z\1%s\2z([a-z\d])([A-Z]))resublower)r,r$rrrr ^sr z str | None) docstringextrarcCs|dkr dS||S)a Safely append to docstrings. When Python is executed with the ``-OO`` option, doc strings are removed and replaced the value ``None``. This function guards against appending the extra content in that case. Args: docstring (str or None) : The docstring to format, or None extra (str): the content to append if docstring is not None Returns: str or None Nr)r0r1rrrr dsr Noner)r0argskwargsrcOsdSrrr0r3r4rrrr usr cOsdSrrr5rrrr wscOs|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)formatr5rrrr zszDict[str, str] | None)url argumentsrcCs0|dk r,dd|D}|dd|7}|S)a! Format a base URL with optional query arguments Args: url (str) : An base URL to append query arguments to arguments (dict or None, optional) : A mapping of key/value URL query arguments, or None (default: None) Returns: str Ncss(|] \}}t|dt|VqdS)=Nr)rkeyvaluerrrrsz-format_url_query_arguments..?&)itemsr)r7r8r>rrrformat_url_query_argumentss r?)rr)r!r")r+)N)__doc__ __future__rlogging getLogger__name__logr-typingrrrr urllib.parser__all__r r r r r r?rrrrs"