-e2dZddlmZddlZejeZddlZddlm Z m Z m Z ddl m Z dZd*d+dZdddd,dZd-d.dZd/dZe d0d#Ze d1d$Zd2d%Zd3d4d)ZdS)5z9 Functions useful for string manipulations or encoding. ) annotationsN)AnyIterableoverload quote_plus)append_docstringformat_docstringindent nice_joinsnakify textstrnintchreturncv||zdfd|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: " ")  c3"K|] }|zV dSN).0linepaddings 2lib/python3.11/site-packages/bokeh/util/strings.py zindent..<s'AAWt^AAAAAA)joinsplit)rrrrs @rr r -sA1fG 99AAAA 40@0@AAA A AAr z, or)sep conjunctionseq Iterable[str]r$r%cd|D}t|dks|||S||ddd|d|dS)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' c,g|]}t|Sr)r)rxs r znice_join..Qs   a3q66   r Nr)lenr!)r&r$r%s rr r ?so$ 3   C 3xx1}} +xx}}((3ss8$$>>{>>SW>>>r _namectjdd|d|}tjdd|d|}|S)z" Convert CamelCase to snake_case. z([A-Z]+)([A-Z][a-z])z\1z\2z([a-z\d])([A-Z]))resublower)r0r$s rr r YsH 6(---- > >D 6%}S}}}d ; ;D ::<<r docstring str | Noneextrac|dn||zS)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)r5r7s rr r _s$44)e*;;r NoneargsrkwargscdSrrr5r:r;s rr r psJM#r cdSrrr=s rr r rsHKr c$|dn |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)formatr=s rr r us& $44*:)*:D*KF*K*KKr url argumentsdict[str, str] | Nonec||9d|D}|dd|zz }|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 Nc3^K|](\}}t|dt|V)dS)=Nr)rkeyvalues rrz-format_url_query_arguments..sB^^jc5JsOO99j&7&799^^^^^^r ?&)itemsr!)rArBrKs rformat_url_query_argumentsrLsE^^IOOL]L]^^^ sSXXe__$$ Jr )rr)rrrrrrrr)r&r'r$rr%rrr)r/)r0rr$rrr)r5r6r7rrr6)r5r9r:rr;rrr9)r5rr:rr;rrr)r5r6r:rr;rrr6r)rArrBrCrr)__doc__ __future__rlogging getLogger__name__logr2typingrrr urllib.parser__all__r r r r r rLrr rrVsY#"""""g!! **********######  BBBBB$15??????4 <<<<" MMM M KKK KLLLL&r