a ]Df%@sdZddlmZddlZeeZddlZddlm Z m Z m Z ddl m Z dZd(d d d d d d d Zddddd d d dddZd)d d d dddZdd ddddZe dddddd d!Ze d ddd dd"d!Zdddddd#d!Zd*d d$d d%d&d'ZdS)+z9 Functions useful for string manipulations or encoding. ) annotationsN)AnyIterableoverload 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).0linepaddingr_/nfs/NAS7/SABIOD/METHODE/ermites/ermites_venv/lib/python3.9/site-packages/bokeh/util/strings.py <zindent..)joinsplit)rrrrrrr -sr z, or)sep conjunctionz Iterable[str])seqr"r#rcCsVdd|D}t|dks"|dur,||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 conjunction 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 Qrznice_join..Nr)lenr)r$r"r#rrrr ?s r _)namer"rcCs4tdd|d|}tdd|d|}|S)z" Convert CamelCase to snake_case. z([A-Z]+)([A-Z][a-z])z\1z\2z([a-z\d])([A-Z]))resublower)r+r"rrrr Ysr z str | None) docstringextrarcCs|dur 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)r/r0rrrr_srNoner)r/argskwargsrcOsdSrrr/r2r3rrrr psr cOsdSrrr4rrrr rscOs|dur dS|j|i|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)formatr4rrrr uszdict[str, str] | None)url argumentsrcCs0|dur,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)rkeyvaluerrrrrz-format_url_query_arguments..?&)itemsr)r6r7r=rrrformat_url_query_argumentss r>)r r)r*)N)__doc__ __future__rlogging getLogger__name__logr,typingrrr urllib.parser__all__r r r rr r>rrrrs"