o tBh@sTdZddlZddlZddlZddlZddlZddlmZmZm Z m Z ddl Z ddl mZdZGdddZd d d d d ddZiddddddddddddddddddddddddddd d!d"d#d$d%d&d'id(d'd)d'd*d'd+d,d-d,d.d,d/d,d0d1d2d1d3d1d4d1d5d6d7d6d8d6d9d6d:d;dd?d@d?dAd?dBd?dCd?dDd?dEdFdGdFdHdFdIdFdJdFdKdFdLdMdNdMdOdMdPdMdQdRdRdRdRdSdTdTdUdVdWdXdYdZdZd[ Zd\Zd]Zd^Zd_Zd`ZdaZdbZdcZeeeeeZddZdeZdfZdgZdhZ diZ!djZ"dkZ#eee e!Z$dlZ%dme$dnZ&dmednZ'doZ(dmednZ)dmednZ*dpee$e(eee"dnZ+dqZ,dre'dse,dtZ-dpednZ.duZ/dvZ0dme"dnZ1dwZ2dre*dse+dtZ3dre1dse+dtZ4dre%dxZ5dre%dyZ6e-dzZ7dme#d{Z8dre2dre.dse/dse0dte8e7d| Z9d}Z:d~Z;e8e7e9Zd?gde1dze*de5de&dse1de4de6de&dse1e3de1dze3de5dse1de6dse;dse:dse(de=dZ@eeZAee@ZBeeZCeDe>ZEeDe%ZFeDdZGddZHdddZIddZJddZKddZLddZMddZNddZOddZPdddZQddZRddZSddZTddZUddZVddZWddZXd ddZ?ddZYddZZddZ[ddZ\d!ddZ]d"ddZ^d"ddZ_d"ddZ`dddZadd„Zbd#ddńZcd$ddȄZdddʄZedd̄Zfd%ddτZgd&ddфZh ͐d'ddӄZid(ddՄZjd(ddׄZkddلZld)dd݄Zmd*dd߄Znd+ddZoddZpefddZqddZrd&ddZsddZtddZuddZvddZwddZxddZyddZzddZ{ddZ|ddZ}ddZ~dddZdddZdddZd,dd Zd d Zd d ZddZd$ddZddZdddZddZddZddZddZdS(-z, String functions. .. versionadded:: 1.1.0 N) parse_qsl urlencodeurlsplit urlunsplit)UNSET)B camel_case capitalizechop chop_rightcharsclean count_substrdeburr decapitalize ends_withensure_ends_withensure_starts_withescapeescape_reg_exp has_substr human_case insert_substrjoin kebab_caselines lower_case lower_first number_formatpadpad_end pad_start pascal_case predecessorprunequotereg_exp_js_matchreg_exp_js_replacereg_exp_replacerepeatreplace replace_end replace_startseparator_case series_phraseseries_phrase_serialslugify snake_casesplit start_case starts_with strip_tags substr_leftsubstr_left_end substr_rightsubstr_right_end successorsurround swap_case title_caseto_lowerto_uppertrimtrim_end trim_starttruncateunescapeunquote upper_case upper_firsturlwordsc@s(eZdZdZddZddZddZdS) JSRegExpz Javascript-style regular expression pattern. Converts a Javascript-style regular expression to the equivalent Python version. cCsP|dddd\}}d|v|_d|v|_|jrtjnd}tj||d|_dS)Nr/girflags)rsplit_global _ignore_casereIcompilepattern)selfreg_exprVoptionsrOrZe/var/www/html/riverr-enterprise-integrations-main/venv/lib/python3.10/site-packages/pydash/strings.py__init__`s   zJSRegExp.__init__cCs<|jr |j|}|S|j|}|r|g}|Sg}|S)z*Return list of regular expression matches.)rQrVfindallsearchgroup)rWtextresultsresrZrZr[findis   z JSRegExp.findcCs |jrdnd}|jj|||dS)z8Replace parts of text that match the regular expression.rrcount)rQrVsub)rWr`replrerZrZr[r*uszJSRegExp.replaceN)__name__ __module__ __qualname____doc__r\rcr*rZrZrZr[rJYs  rJz&z<z>z"z'z`)&<>"'`ÀAÁÂÃÄÅàaáâãäåÇCçcÐDðdÈEÉÊËèeéêëÌrTÍÎÏìrMíîïÑNñnÒOÓÔÕÖØòoóôõöøÙUÚÛÜùuYyAeaeThthss ) úûüÝýÿÆæÞþß×÷z/[^-/:-@[-`{-]+/gu /[À-ÿ]/gz \ud800-\udfffz \u0300-\u036fz \ufe20-\ufe2fz \u20d0-\u20ffz \u1ab0-\u1affz \u1dc0-\u1dffz \u2700-\u27bfza-z\xdf-\xf6\xf8-\xffz\xac\xb1\xd7\xf7z$\x00-\x2f\x3a-\x40\x5b-\x60\x7b-\xbfz \u2000-\u206fz \t\x0b\f\xa0\ufeff\n\r\u2028\u2029\u1680\u180e\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u202f\u205f\u3000zA-Z\xc0-\xd6\xd8-\xdez \ufe0e\ufe0fu['’][]z\dz[^z\ud83c[\udffb-\udfff]z(?:|)z(?:\ud83c[\udde6-\uddff]){2}z[\ud800-\udbff][\udc00-\udfff]z\u200dz(?:d|ll|m|re|s|t|ve))?z(?:D|LL|M|RE|S|T|VE))??z]?z)*z-\d*(?:1st|2nd|3rd|(?![123])\dth)(?=\b|[A-Z_])z-\d*(?:1ST|2ND|3RD|(?![123])\dTH)(?=\b|[a-z_])zB[a-z][A-Z]|[A-Z]{2}[a-z]|[0-9][a-zA-Z]|[a-zA-Z][0-9]|[^a-zA-Z0-9 ]rK+z(?=z|$)|z+|z/gz <\/?[^>]+>cCs4dddt|D}|dd|ddS)aA Converts `text` to camel case. Args: text (str): String to convert. Returns: str: String converted to camel case. Example: >>> camel_case('FOO BAR_bAz') 'fooBarBAz' .. versionadded:: 1.1.0 .. versionchanged:: 5.0.0 Improved unicode word support. rcs|]}|VqdSN)title.0wordrZrZr[ 0zcamel_case..Nrr compounderlowerr`rZrZr[rsrTcCs2t|}|r |S|dd|ddS)a Capitalizes the first character of `text`. Args: text (str): String to capitalize. strict (bool, optional): Whether to cast rest of string to lower case. Defaults to ``True``. Returns: str: Capitalized string. Example: >>> capitalize('once upon a TIME') 'Once upon a time' >>> capitalize('once upon a TIME', False) 'Once upon a TIME' .. versionadded:: 1.1.0 .. versionchanged:: 3.0.0 Added `strict` option. Nr)pyd to_stringr upperr`strictrZrZr[r 4s (r cCstt|S)a Split `text` into a list of single characters. Args: text (str): String to split up. Returns: list: List of individual characters. Example: >>> chars('onetwo') ['o', 'n', 'e', 't', 'w', 'o'] .. versionadded:: 3.0.0 )listrrrrZrZr[r Osr csLdurgStdkrg}|SfddtdtD}|S)ad Break up `text` into intervals of length `step`. Args: text (str): String to chop. step (int): Interval to chop `text`. Returns: list: List of chopped characters. If `text` is `None` an empty list is returned. Example: >>> chop('abcdefg', 3) ['abc', 'def', 'g'] .. versionadded:: 3.0.0 Nrcsg|] }||qSrZrZrrMstepr`rZr[ }szchop..)rrrangelenr`rchoppedrZrr[r cs  r cs\durgStdkrg}|StfddtdDddd}|S)aA Like :func:`chop` except `text` is chopped from right. Args: text (str): String to chop. step (int): Interval to chop `text`. Returns: list: List of chopped characters. Example: >>> chop_right('abcdefg', 3) ['a', 'bcd', 'efg'] .. versionadded:: 3.0.0 Nrcs"g|] }| |qSrZrZrrr`text_lenrZr[rs"zchop_right..)rrrrrrZrr[r s (r cCst|}dt|S)z Trim and replace multiple spaces with a single space. Args: text (str): String to clean. Returns: str: Cleaned string. Example: >>> clean('a b c d') 'a b c d' .. versionadded:: 3.0.0 r)rrrcompactr2rrZrZr[r s r cCs2|dus|dur dSt|}t|}||S)aM Count the occurrences of `subtext` in `text`. Args: text (str): Source string to count from. subtext (str): String to count. Returns: int: Number of occurrences of `subtext` in `text`. Example: >>> count_substr('aabbccddaabbccdd', 'bc') 2 .. versionadded:: 3.0.0 Nr)rrrer`subtextrZrZr[rs    rcCst|}t|ddS)u: Deburrs `text` by converting latin-1 supplementary letters to basic latin letters. Args: text (str): String to deburr. Returns: str: Deburred string. Example: >>> deburr('déjà vu') '... >>> 'deja vu' 'deja vu' .. versionadded:: 2.0.0 cSst||Sr)DEBURRED_LETTERSgetr_)matchrZrZr[szdeburr..)rr JS_RE_LATIN1r*rrZrZr[rs rcCs&t|}|dd|ddS)a Decaptitalizes the first character of `text`. Args: text (str): String to decapitalize. Returns: str: Decapitalized string. Example: >>> decapitalize('FOO BAR') 'fOO BAR' .. versionadded:: 3.0.0 NrrrrrrZrZr[rs rcCs6t|}t|}|durt|}|d||S)a Checks if `text` ends with a given target string. Args: text (str): String to check. target (str): String to check for. position (int, optional): Position to search from. Defaults to end of `text`. Returns: bool: Whether `text` ends with `target`. Example: >>> ends_with('abc def', 'def') True >>> ends_with('abc def', 4) False .. versionadded:: 1.1.0 N)rrrendswithr`targetpositionrZrZr[rs  rcCs.t|}t|}||r|S||S)a Append a given suffix to a string, but only if the source string does not end with that suffix. Args: text (str): Source string to append `suffix` to. suffix (str): String to append to the source string if the source string does not end with `suffix`. Returns: str: source string possibly extended by `suffix`. Example: >>> ensure_ends_with('foo bar', '!') 'foo bar!' >>> ensure_ends_with('foo bar!', '!') 'foo bar!' .. versionadded:: 2.4.0 )rrr)r`suffixrZrZr[rs    rcCs.t|}t|}||r|S||S)aG Prepend a given prefix to a string, but only if the source string does not start with that prefix. Args: text (str): Source string to prepend `prefix` to. prefix (str): String to prepend to the source string if the source string does not start with `prefix`. Returns: str: source string possibly prefixed by `prefix` Example: >>> ensure_starts_with('foo bar', 'Oh my! ') 'Oh my! foo bar' >>> ensure_starts_with('Oh my! foo bar', 'Oh my! ') 'Oh my! foo bar' .. versionadded:: 2.4.0 rr startswith)r`prefixrZrZr[r:s    rcCst|}ddd|DS)a Converts the characters ``&``, ``<``, ``>``, ``"``, ``'``, and ``\``` in `text` to their corresponding HTML entities. Args: text (str): String to escape. Returns: str: HTML escaped string. Example: >>> escape('"1 > 2 && 3 < 4"') '"1 > 2 && 3 < 4"' .. versionadded:: 1.0.0 .. versionchanged:: 1.1.0 Moved function to :mod:`pydash.strings`. rcss|] }t||VqdSr) HTML_ESCAPESr)rcharrZrZr[rozescape..)rrrrrZrZr[rWs rcCt|}t|S)aF Escapes the RegExp special characters in `text`. Args: text (str): String to escape. Returns: str: RegExp escaped string. Example: >>> escape_reg_exp('[()]') '\\[\\(\\)\\]' .. versionadded:: 1.1.0 .. versionchanged:: 4.0.0 Removed alias ``escape_re`` )rrrSrrrZrZr[rrs  rcCs"t|}t|}||dkS)ao Returns whether `subtext` is included in `text`. Args: text (str): String to search. subtext (str): String to search for. Returns: bool: Whether `subtext` is found in `text`. Example: >>> has_substr('abcdef', 'bc') True >>> has_substr('abcdef', 'bb') False .. versionadded:: 3.0.0 r)rrrcrrZrZr[rs  rcCs&t|ddddS)a Converts `text` to human case which has only the first letter capitalized and each word separated by a space. Args: text (str): String to convert. Returns: str: String converted to human case. Example: >>> human_case('abc-def_hij lmn') 'Abc def hij lmn' >>> human_case('user_id') 'User' .. versionadded:: 3.0.0 .. versionchanged:: 5.0.0 Improved unicode word support. z_id$r_r)rchainr1r(r*r valuerrZrZr[rsrcCs0t|}t|}|d||||dS)ap Insert `subtext` in `text` starting at position `index`. Args: text (str): String to add substring to. index (int): String index to insert into. subtext (str): String to insert. Returns: str: Modified string. Example: >>> insert_substr('abcdef', 3, '--') 'abc--def' .. versionadded:: 3.0.0 Nrr)r`indexrrZrZr[rs  rcCst|t|p dtjS)a/ Joins an iterable into a string using `separator` between each element. Args: array (iterable): Iterable to implode. separator (str, optional): Separator to using when joining. Defaults to ``''``. Returns: str: Joined string. Example: >>> join(['a', 'b', 'c']) == 'abc' True >>> join([1, 2, 3, 4], '&') == '1&2&3&4' True >>> join('abcdef', '-') == 'a-b-c-d-e-f' True .. versionadded:: 2.0.0 .. versionchanged:: 4.0.0 Removed alias ``implode``. rZ)rrrmap_)array separatorrZrZr[rsrcCdddt|DS)aX Converts `text` to kebab case (a.k.a. spinal case). Args: text (str): String to convert. Returns: str: String converted to kebab case. Example: >>> kebab_case('a b c_d-e!f') 'a-b-c-d-e-f' .. versionadded:: 1.1.0 .. versionchanged:: 5.0.0 Improved unicode word support. -cs|] }|r|VqdSrrrrZrZr[r rzkebab_case..rrrrZrZr[rrcCt|}|S)z Split lines in `text` into an array. Args: text (str): String to split. Returns: list: String split by lines. Example: >>> lines('a\nb\r\nc') ['a', 'b', 'c'] .. versionadded:: 3.0.0 )rr splitlinesrrZrZr[r rcCdt|S)a Converts string to lower case as space separated words. Args: text (str): String to convert. Returns: str: String converted to lower case as space separated words. Example: >>> lower_case('fooBar') 'foo bar' >>> lower_case('--foo-Bar--') 'foo bar' >>> lower_case('/?*Foo10/;"B*Ar') 'foo 10 b ar' .. versionadded:: 4.0.0 .. versionchanged:: 5.0.0 Improved unicode word support. rrrrZrZr[r$rcC|dd|ddS)a Converts the first character of string to lower case. Args: text (str): String passed in by the user. Returns: str: String in which the first character is converted to lower case. Example: >>> lower_first('FRED') 'fRED' >>> lower_first('Foo Bar') 'foo Bar' >>> lower_first('1foobar') '1foobar' >>> lower_first(';foobar') ';foobar' .. versionadded:: 4.0.0 Nrr rrZrZr[r?r.,c Csd|dd}z ||d}Wn tyd}Y|Sw|d}|dgd}|t|ddd d ddd }|t||g}|S) ac Format a number to scale with custom decimal and order separators. Args: number (int|float): Number to format. scale (int, optional): Number of decimals to include. Defaults to ``0``. decimal_separator (str, optional): Decimal separator to use. Defaults to ``'.'``. order_separator (str, optional): Order separator to use. Defaults to ``','``. Returns: str: Formatted number as string. Example: >>> number_format(1234.5678) '1,235' >>> number_format(1234.5678, 2, ',', '.') '1.234,57' .. versionadded:: 3.0.0 z{0:.rzf}rrrrNr)formatr2 ValueErrorrr rr) numberscaledecimal_separatororder_separatorfmt num_partsr`int_partdec_partrZrZr[rYs  $rcCsft|}t|}||kr|S||d}tt|}tt|}td||}|d|||S)a Pads `text` on the left and right sides if it is shorter than the given padding length. The `chars` string may be truncated if the number of padding characters can't be evenly divided by the padding length. Args: text (str): String to pad. length (int): Amount to pad. chars (str, optional): Characters to pad with. Defaults to ``" "``. Returns: str: Padded string. Example: >>> pad('abc', 5) ' abc ' >>> pad('abc', 6, 'x') 'xabcxx' >>> pad('abc', 5, '...') '.abc.' .. versionadded:: 1.1.0 .. versionchanged:: 3.0.0 Fix handling of multiple `chars` so that padded string isn't over padded. g@rN)rrrintmathfloorceilr )r`lengthr rmidleft_len right_lenrZrZr[rs   rcCs0t|}t|t|f}|t||d|S)a~ Pads `text` on the right side if it is shorter than the given padding length. The `chars` string may be truncated if the number of padding characters can't be evenly divided by the padding length. Args: text (str): String to pad. length (int): Amount to pad. chars (str, optional): Characters to pad with. Defaults to ``" "``. Returns: str: Padded string. Example: >>> pad_end('abc', 5) 'abc ' >>> pad_end('abc', 5, '.') 'abc..' .. versionadded:: 1.1.0 .. versionchanged:: 4.0.0 Renamed from ``pad_right`` to ``pad_end``. Nrrmaxrr)r`r'r rZrZr[r s r cCs0t|}t|t|}t|||| dS)a Pads `text` on the left side if it is shorter than the given padding length. The `chars` string may be truncated if the number of padding characters can't be evenly divided by the padding length. Args: text (str): String to pad. length (int): Amount to pad. chars (str, optional): Characters to pad with. Defaults to ``" "``. Returns: str: Padded string. Example: >>> pad_start('abc', 5) ' abc' >>> pad_start('abc', 5, '.') '..abc' .. versionadded:: 1.1.0 .. versionchanged:: 4.0.0 Renamed from ``pad_left`` to ``pad_start``. Nr+r-rZrZr[r!s r!cCs&t|}|r |}tt|ddS)a  Like :func:`camel_case` except the first letter is capitalized. Args: text (str): String to convert. strict (bool, optional): Whether to cast rest of string to lower case. Defaults to ``True``. Returns: str: String converted to class case. Example: >>> pascal_case('FOO BAR_bAz') 'FooBarBaz' >>> pascal_case('FOO BAR_bAz', False) 'FooBarBAz' .. versionadded:: 3.0.0 .. versionchanged:: 5.0.0 Improved unicode word support. Fr)rrrr rrrZrZr[r"s r"cCst|}tt|dS)aS Return the predecessor character of `char`. Args: char (str): Character to find the predecessor of. Returns: str: Predecessor character. Example: >>> predecessor('c') 'b' >>> predecessor('C') 'B' >>> predecessor('3') '2' .. versionadded:: 3.0.0 rrrchrordrrZrZr[r#  r#...cCst|}t|}t|}||kr|Sdd}t|d|dd|}td|ddr4t|dd }n|dd }t|}|||krN|d||}|S) aI Like :func:`truncate` except it ensures that the pruned string doesn't exceed the original length, i.e., it avoids half-chopped words when truncating. If the pruned text + `omission` text is longer than the original text, then the original text is returned. Args: text (str): String to prune. length (int, optional): Target prune length. Defaults to ``0``. omission (str, optional): Omission text to append to the end of the pruned string. Defaults to ``'...'``. Returns: str: Pruned string. Example: >>> prune('Fe fi fo fum', 5) 'Fe fi...' >>> prune('Fe fi fo fum', 6) 'Fe fi...' >>> prune('Fe fi fo fum', 7) 'Fe fi...' >>> prune('Fe fi fo fum', 8, ',,,') 'Fe fi fo,,,' .. versionadded:: 3.0.0 cSs"|d}||krdS|S)Nrr)r_rr)rrrZrZr[rgJs zprune..replNrz .(?=\W*\w*$)z\w\wz\s*\S+$rr)rrrr(rSrrstrip)r`r'omissionr omission_lenrgr subtext_lenrZrZr[r$&s  r$rocCs t||S)a Quote a string with another string. Args: text (str): String to be quoted. quote_char (str, optional): the quote character. Defaults to ``"``. Returns: str: the quoted string. Example: >>> quote('To be or not to be') '"To be or not to be"' >>> quote('To be or not to be', "'") "'To be or not to be'" .. versionadded:: 2.4.0 )r;)r` quote_charrZrZr[r%cs r%cCst|}t||S)a Return list of matches using Javascript style regular expression. Args: text (str): String to evaluate. reg_exp (str): Javascript style regular expression. Returns: list: List of matches. Example: >>> reg_exp_js_match('aaBBcc', '/bb/') [] >>> reg_exp_js_match('aaBBcc', '/bb/i') ['BB'] >>> reg_exp_js_match('aaBBccbb', '/bb/i') ['BB'] >>> reg_exp_js_match('aaBBccbb', '/bb/gi') ['BB', 'bb'] .. versionadded:: 2.0.0 .. versionchanged:: 3.0.0 Reordered arguments to make `text` first. .. versionchanged:: 4.0.0 Renamed from ``js_match`` to ``reg_exp_js_match``. )rrrJrc)r`rXrZrZr[r&zs r&cCs.t|}t|st|}t|||S)a6 Replace `text` with `repl` using Javascript style regular expression to find matches. Args: text (str): String to evaluate. reg_exp (str): Javascript style regular expression. repl (str|callable): Replacement string or callable. Returns: str: Modified string. Example: >>> reg_exp_js_replace('aaBBcc', '/bb/', 'X') 'aaBBcc' >>> reg_exp_js_replace('aaBBcc', '/bb/i', 'X') 'aaXcc' >>> reg_exp_js_replace('aaBBccbb', '/bb/i', 'X') 'aaXccbb' >>> reg_exp_js_replace('aaBBccbb', '/bb/gi', 'X') 'aaXccX' .. versionadded:: 2.0.0 .. versionchanged:: 3.0.0 Reordered arguments to make `text` first. .. versionchanged:: 4.0.0 Renamed from ``js_replace`` to ``reg_exp_js_replace``. )rr is_functionrJr*)r`rXrgrZrZr[r's   r'FcCs&|dur t|St|||||ddS)a Replace occurrences of regex `pattern` with `repl` in `text`. Optionally, ignore case when replacing. Optionally, set `count` to limit number of replacements. Args: text (str): String to replace. pattern (str|typing.Pattern): Pattern to find and replace. repl (str): String to substitute `pattern` with. ignore_case (bool, optional): Whether to ignore case when replacing. Defaults to ``False``. count (int, optional): Maximum number of occurrences to replace. Defaults to ``0`` which replaces all. Returns: str: Replaced string. Example: >>> reg_exp_replace('aabbcc', 'b', 'X') 'aaXXcc' >>> reg_exp_replace('aabbcc', 'B', 'X', ignore_case=True) 'aaXXcc' >>> reg_exp_replace('aabbcc', 'b', 'X', count=1) 'aaXbcc' >>> reg_exp_replace('aabbcc', '[ab]', 'X') 'XXXXcc' .. versionadded:: 3.0.0 .. versionchanged:: 4.0.0 Renamed from ``re_replace`` to ``reg_exp_replace``. NF) ignore_caserer)rrr*)r`rVrgr<rerZrZr[r(s r(cCst|t|S)a" Repeats the given string `n` times. Args: text (str): String to repeat. n (int, optional): Number of times to repeat the string. Returns: str: Repeated string. Example: >>> repeat('.', 5) '.....' .. versionadded:: 1.1.0 )rrr#)r`rrZrZr[r)sr)c Cst|}|dur |St|st|}|rtjnd}t|tjr%|} n)t|}|r1t|}|r<| ds>> replace('aabbcc', 'b', 'X') 'aaXXcc' >>> replace('aabbcc', 'B', 'X', ignore_case=True) 'aaXXcc' >>> replace('aabbcc', 'b', 'X', count=1) 'aaXbcc' >>> replace('aabbcc', '[ab]', 'X') 'aabbcc' >>> replace('aabbcc', '[ab]', 'X', escape=False) 'XXXXcc' .. versionadded:: 3.0.0 .. versionchanged:: 4.1.0 Added ``from_start`` and ``from_end`` arguments. .. versionchanged:: 5.0.0 Added support for ``pattern`` as ``typing.Pattern`` object. Nr^$rNrd) rrr;rS IGNORECASE isinstancetypingPatternrrrrUrf) r`rVrgr<rer from_startfrom_endrOpatrZrZr[r*s" ,     r*cCt|||||ddS)aI Like :func:`replace` except it only replaces `text` with `repl` if `pattern` mathces the end of `text`. Args: text (str): String to replace. pattern (str|typing.Pattern): Pattern to find and replace. repl (str): String to substitute `pattern` with. ignore_case (bool, optional): Whether to ignore case when replacing. Defaults to ``False``. escape (bool, optional): Whether to escape `pattern` when searching. This is needed if a literal replacement is desired when `pattern` may contain special regular expression characters. Defaults to ``True``. Returns: str: Replaced string. Example: >>> replace_end('aabbcc', 'b', 'X') 'aabbcc' >>> replace_end('aabbcc', 'c', 'X') 'aabbcX' .. versionadded:: 4.1.0 T)r<rrDr*r`rVrgr<rrZrZr[r+Er+cCrF)aO Like :func:`replace` except it only replaces `text` with `repl` if `pattern` mathces the start of `text`. Args: text (str): String to replace. pattern (str|typing.Pattern): Pattern to find and replace. repl (str): String to substitute `pattern` with. ignore_case (bool, optional): Whether to ignore case when replacing. Defaults to ``False``. escape (bool, optional): Whether to escape `pattern` when searching. This is needed if a literal replacement is desired when `pattern` may contain special regular expression characters. Defaults to ``True``. Returns: str: Replaced string. Example: >>> replace_start('aabbcc', 'b', 'X') 'aabbcc' >>> replace_start('aabbcc', 'a', 'X') 'Xabbcc' .. versionadded:: 4.1.0 T)r<rrCrGrHrZrZr[r,brIr,cCs|ddt|DS)a Splits `text` on words and joins with `separator`. Args: text (str): String to convert. separator (str): Separator to join words with. Returns: str: Converted string. Example: >>> separator_case('a!!b___c.d', '-') 'a-b-c-d' .. versionadded:: 3.0.0 .. versionchanged:: 5.0.0 Improved unicode word support. csr rr rrZrZr[rrz!separator_case..)rrI)r`rrZrZr[r-sr-,  and cCst|tj}t|}t|}t|}|dkr'|r'||}|dkr;|dd||ddg}||S)az Join items into a grammatical series phrase, e.g., ``"item1, item2, item3 and item4"``. Args: items (list): List of string items to join. separator (str, optional): Item separator. Defaults to ``', '``. last_separator (str, optional): Last item separator. Defaults to ``' and '``. serial (bool, optional): Whether to include `separator` with `last_separator` when number of items is greater than 2. Defaults to ``False``. Returns: str: Joined string. Example: >>> series_phrase(['apples', 'bananas', 'peaches']) 'apples, bananas and peaches' >>> series_phrase(['apples', 'bananas', 'peaches'], serial=True) 'apples, bananas, and peaches' >>> series_phrase(['apples', 'bananas', 'peaches'], '; ', ', or ') 'apples; bananas, or peaches' .. versionadded:: 3.0.0 Nr5) rrmaprrrrr6r)itemsrlast_separatorserial item_countrZrZr[r.s      r.cCst|||ddS)a Join items into a grammatical series phrase using a serial separator, e.g., ``"item1, item2, item3, and item4"``. Args: items (list): List of string items to join. separator (str, optional): Item separator. Defaults to ``', '``. last_separator (str, optional): Last item separator. Defaults to ``' and '``. Returns: str: Joined string. Example: >>> series_phrase_serial(['apples', 'bananas', 'peaches']) 'apples, bananas, and peaches' .. versionadded:: 3.0.0 T)rP)r.)rNrrOrZrZr[r/sr/r cCs*tdt|ddd}t||S)up Convert `text` into an ASCII slug which can be used safely in URLs. Incoming `text` is converted to unicode and noramlzied using the ``NFKD`` form. This results in some accented characters being converted to their ASCII "equivalent" (e.g. ``é`` is converted to ``e``). Leading and trailing whitespace is trimmed and any remaining whitespace or other special characters without an ASCII equivalent are replaced with ``-``. Args: text (str): String to slugify. separator (str, optional): Separator to use. Defaults to ``'-'``. Returns: str: Slugified string. Example: >>> slugify('This is a slug.') == 'this-is-a-slug' True >>> slugify('This is a slug.', '+') == 'this+is+a+slug' True .. versionadded:: 3.0.0 .. versionchanged:: 5.0.0 Improved unicode word support. NFKDasciiignoreutf8) unicodedata normalizerrencodedecoder-)r`r normalizedrZrZr[r0s r0cCr )a Converts `text` to snake case. Args: text (str): String to convert. Returns: str: String converted to snake case. Example: >>> snake_case('This is Snake Case!') 'this_is_snake_case' .. versionadded:: 1.1.0 .. versionchanged:: 4.0.0 Removed alias ``underscore_case``. .. versionchanged:: 5.0.0 Improved unicode word support. rcsr rr rrZrZr[rrzsnake_case..r rrZrZr[r1sr1cCs<t|}|tur|}|S|r||}|St|}|S)ay Splits `text` on `separator`. If `separator` not provided, then `text` is split on whitespace. If `separator` is falsey, then `text` is split on every character. Args: text (str): String to explode. separator (str, optional): Separator string to split on. Defaults to ``NoValue``. Returns: list: Split string. Example: >>> split('one potato, two potatoes, three potatoes, four!') ['one', 'potato,', 'two', 'potatoes,', 'three', 'potatoes,', 'four!'] >>> split('one potato, two potatoes, three potatoes, four!', ',') ['one potato', ' two potatoes', ' three potatoes', ' four!'] .. versionadded:: 2.0.0 .. versionchanged:: 3.0.0 Changed `separator` default to ``NoValue`` and supported splitting on whitespace by default. .. versionchanged:: 4.0.0 Removed alias ``explode``. )rrrr2r )r`rretrZrZr[r2s  r2cCr )a9 Convert `text` to start case. Args: text (str): String to convert. Returns: str: String converted to start case. Example: >>> start_case("fooBar") 'Foo Bar' .. versionadded:: 3.1.0 .. versionchanged:: 5.0.0 Improved unicode word support. rcss|] }t|ddVqdS)Fr.Nr rrZrZr[rNrzstart_case..r rrZrZr[r3:rr3cCs&t|}t|}||d|S)a Checks if `text` starts with a given target string. Args: text (str): String to check. target (str): String to check for. position (int, optional): Position to search from. Defaults to beginning of `text`. Returns: bool: Whether `text` starts with `target`. Example: >>> starts_with('abcdef', 'a') True >>> starts_with('abcdef', 'b') False >>> starts_with('abcdef', 'a', 1) False .. versionadded:: 1.1.0 NrrrZrZr[r4Qs  r4cCstdt|S)a Removes all HTML tags from `text`. Args: text (str): String to strip. Returns: str: String without HTML tags. Example: >>> strip_tags('Some link') 'Some link' .. versionadded:: 3.0.0 r) RE_HTML_TAGSrfrrrrZrZr[r5msr5cC t|}|r||dS|S)a Searches `text` from left-to-right for `subtext` and returns a substring consisting of the characters in `text` that are to the left of `subtext` or all string if no match found. Args: text (str): String to partition. subtext (str): String to search for. Returns: str: Substring to left of `subtext`. Example: >>> substr_left('abcdefcdg', 'cd') 'ab' .. versionadded:: 3.0.0 rrr partitionrrZrZr[r6 r6cC$t|}|r||dp|S|S)a Searches `text` from right-to-left for `subtext` and returns a substring consisting of the characters in `text` that are to the left of `subtext` or all string if no match found. Args: text (str): String to partition. subtext (str): String to search for. Returns: str: Substring to left of `subtext`. Example: >>> substr_left_end('abcdefcdg', 'cd') 'abcdef' .. versionadded:: 3.0.0 rrr rpartitionrrZrZr[r7 r7cCrb)a Searches `text` from right-to-left for `subtext` and returns a substring consisting of the characters in `text` that are to the right of `subtext` or all string if no match found. Args: text (str): String to partition. subtext (str): String to search for. Returns: str: Substring to right of `subtext`. Example: >>> substr_right('abcdefcdg', 'cd') 'efcdg' .. versionadded:: 3.0.0 rLr_rrZrZr[r8rer8cCr^)a Searches `text` from left-to-right for `subtext` and returns a substring consisting of the characters in `text` that are to the right of `subtext` or all string if no match found. Args: text (str): String to partition. subtext (str): String to search for. Returns: str: Substring to right of `subtext`. Example: >>> substr_right_end('abcdefcdg', 'cd') 'g' .. versionadded:: 3.0.0 rLrcrrZrZr[r9rar9cCst|}tt|dS)aG Return the successor character of `char`. Args: char (str): Character to find the successor of. Returns: str: Successor character. Example: >>> successor('b') 'c' >>> successor('B') 'C' >>> successor('2') '3' .. versionadded:: 3.0.0 rr/r2rZrZr[r:r3r:cCs$t|}t|}|||S)aq Surround a string with another string. Args: text (str): String to surround with `wrapper`. wrapper (str): String by which `text` is to be surrounded. Returns: str: Surrounded string. Example: >>> surround('abc', '"') '"abc"' >>> surround('abc', '!') '!abc!' .. versionadded:: 2.4.0 r)r`wrapperrZrZr[r;s  r;cCr)z Swap case of `text` characters. Args: text (str): String to swap case. Returns: str: String with swapped case. Example: >>> swap_case('aBcDeF') 'AbCdEf' .. versionadded:: 3.0.0 )rrswapcaserrZrZr[r<rr<cCs&t|}dddtd|DS)z Convert `text` to title case. Args: text (str): String to convert. Returns: str: String converted to title case. Example: >>> title_case("bob's shop") "Bob's Shop" .. versionadded:: 3.0.0 rcsrrr\rrZrZr[r7rztitle_case..)rrrrSr2rrZrZr[r=$s r=cCt|S)au Converts the given :attr:`text` to lower text. Args: text (str): String to convert. Returns: str: String converted to lower case. Example: >>> to_lower('--Foo-Bar--') '--foo-bar--' >>> to_lower('fooBar') 'foobar' >>> to_lower('__FOO_BAR__') '__foo_bar__' .. versionadded:: 4.0.0 rrrZrZr[r>:r>cCrh)au Converts the given :attr:`text` to upper text. Args: text (str): String to convert. Returns: str: String converted to upper case. Example: >>> to_upper('--Foo-Bar--') '--FOO-BAR--' >>> to_upper('fooBar') 'FOOBAR' >>> to_upper('__FOO_BAR__') '__FOO_BAR__' .. versionadded:: 4.0.0 )rrrrrZrZr[r?Rrir?cCt|}||S)aO Removes leading and trailing whitespace or specified characters from `text`. Args: text (str): String to trim. chars (str, optional): Specific characters to remove. Returns: str: Trimmed string. Example: >>> trim(' abc efg\r\n ') 'abc efg' .. versionadded:: 1.1.0 )rrstripr`r rZrZr[r@js  r@cCrj)a Removes trailing whitespace or specified characters from `text`. Args: text (str): String to trim. chars (str, optional): Specific characters to remove. Returns: str: Trimmed string. Example: >>> trim_end(' abc efg\r\n ') ' abc efg' .. versionadded:: 1.1.0 .. versionchanged:: 4.0.0 Renamed from ``trim_right`` to ``trim_end``. )rrr6rlrZrZr[rA  rAcCrj)a Removes leading whitespace or specified characters from `text`. Args: text (str): String to trim. chars (str, optional): Specific characters to remove. Returns: str: Trimmed string. Example: >>> trim_start(' abc efg\r\n ') 'abc efg\r\n ' .. versionadded:: 1.1.0 .. versionchanged:: 4.0.0 Renamed from ``trim_left`` to ``trim_start``. )rrlstriprlrZrZr[rBrmrBc Cst|}t||kr |St|}||}|d|}t|}t|r*||}nt|rCd}||D]}|}q6|durC|}|d||S)a` Truncates `text` if it is longer than the given maximum string length. The last characters of the truncated string are replaced with the omission string which defaults to ``...``. Args: text (str): String to truncate. length (int, optional): Maximum string length. Defaults to ``30``. omission (str, optional): String to indicate text is omitted. separator (mixed, optional): Separator pattern to truncate to. Returns: str: Truncated string. Example: >>> truncate('hello world', 5) 'he...' >>> truncate('hello world', 5, '..') 'hel..' >>> truncate('hello world', 10) 'hello w...' >>> truncate('hello world', 10, separator=' ') 'hello...' .. versionadded:: 1.1.0 .. versionchanged:: 4.0.0 Removed alias ``trunc``. N)rrr is_stringrfind is_reg_expfinditerstart) r`r'r7rr8r trunc_lenlastrrZrZr[rCs      rCcCr)a The inverse of :func:`escape`. This method converts the HTML entities ``&``, ``<``, ``>``, ``"``, ``'``, and ````` in `text` to their corresponding characters. Args: text (str): String to unescape. Returns: str: HTML unescaped string. Example: >>> results = unescape('"1 > 2 && 3 < 4"') >>> results == '"1 > 2 && 3 < 4"' True .. versionadded:: 1.0.0 .. versionchanged:: 1.1.0 Moved to :mod:`pydash.strings`. )rrhtmlrDrrZrZr[rDs  rDcCr)a Converts string to upper case, as space separated words. Args: text (str): String to be converted to uppercase. Returns: str: String converted to uppercase, as space separated words. Example: >>> upper_case('--foo-bar--') 'FOO BAR' >>> upper_case('fooBar') 'FOO BAR' >>> upper_case('/?*Foo10/;"B*Ar') 'FOO 10 B AR' .. versionadded:: 4.0.0 .. versionchanged:: 5.0.0 Improved unicode word support. r)rrrrrZrZr[rFrrFcCr)a Converts the first character of string to upper case. Args: text (str): String passed in by the user. Returns: str: String in which the first character is converted to upper case. Example: >>> upper_first('fred') 'Fred' >>> upper_first('foo bar') 'Foo bar' >>> upper_first('1foobar') '1foobar' >>> upper_first(';foobar') ';foobar' .. versionadded:: 4.0.0 Nr)rrrZrZr[rGrrGcCs2t|}|dd}||||kr|}|S)a Unquote `text` by removing `quote_char` if `text` begins and ends with it. Args: text (str): String to unquote. quote_char (str, optional): Quote character to remove. Defaults to `"`. Returns: str: Unquoted string. Example: >>> unquote('"abc"') 'abc' >>> unquote('"abc"', '#') '"abc"' >>> unquote('#abc', '#') '#abc' >>> unquote('#abc#', '#') 'abc' .. versionadded:: 3.0.0 rrr)r`r:innerrZrZr[rE8s  rEc Ost|tj}g}t|}|D]}t|\}}}}}t|}||7}| t |||d|fqt dg|R}t|\}}}}}t |}t |||||fS)a- Combines a series of URL paths into a single URL. Optionally, pass in keyword arguments to append query parameters. Args: paths (str): URL paths to combine. Keyword Args: params (str, optional): Query parameters. Returns: str: URL string. Example: >>> link = url('a', 'b', ['c', 'd'], '/', q='X', y='Z') >>> path, params = link.split('?') >>> path == 'a/b/c/d/' True >>> set(params.split('&')) == set(['q=X', 'y=Z']) True .. versionadded:: 2.2.0 rrK) rr flatten_deeprMrrflatten_url_paramsrrappendrdelimitedpathjoinr) pathsparams paths_list params_listpathschemenetlocqueryfragmentrZrZr[rHYsrHcCs8t|}|durt|rt}nt}nt|}||S)a Return list of words contained in `text`. References: https://github.com/lodash/lodash/blob/master/words.js#L30 Args: text (str): String to split. pattern (str, optional): Custom pattern to split words on. Defaults to ``None``. Returns: list: List of words. Example: >>> words('a b, c; d-e') ['a', 'b', 'c', 'd', 'e'] >>> words('fred, barney, & pebbles', '/[^, ]+/g') ['fred', 'barney', '&', 'pebbles'] .. versionadded:: 2.0.0 .. versionchanged:: 3.2.0 Added `pattern` argument. .. versionchanged:: 3.2.0 Improved matching for one character words. .. versionchanged:: 5.0.0 Improved unicode word support. N)rrhas_unicode_wordJS_RE_UNICODE_WORDSJS_RE_ASCII_WORDSrJrc)r`rVrXrZrZr[rIs  rIcCstttdt|S)a Remove single quote before passing into words() to match Lodash-style outputs. Required by certain functions such as kebab_case, camel_case, start_case etc. References: https://github.com/lodash/lodash/blob/4.17.15/lodash.js#L4968 r)rIrRE_APOSrfrrrrZrZr[rs rcCst|}t|S)z Check if the text contains unicode or requires more complex regex to handle. References: https://github.com/lodash/lodash/blob/master/words.js#L3 )RE_HAS_UNICODE_WORDr^bool)r`resultrZrZr[rs rcsddt|D}t|dkr|d}|S|r!|dr!nd}|r.|dr.nd}fdd|D}d|||g}|S)a Join delimited path using specified delimiter. >>> assert delimitedpathjoin('.', '') == '' >>> assert delimitedpathjoin('.', '.') == '.' >>> assert delimitedpathjoin('.', ['', '.a']) == '.a' >>> assert delimitedpathjoin('.', ['a', '.']) == 'a.' >>> assert delimitedpathjoin('.', ['', '.a', '', '', 'b']) == '.a.b' >>> ret = '.a.b.c.d.e.' >>> assert delimitedpathjoin('.', ['.a.', 'b.', '.c', 'd', 'e.']) == ret >>> assert delimitedpathjoin('.', ['a', 'b', 'c']) == 'a.b.c' >>> ret = 'a.b.c.d.e.f' >>> assert delimitedpathjoin('.', ['a.b', '.c.d.', '.e.f']) == ret >>> ret = '.a.b.c.1.' >>> assert delimitedpathjoin('.', '.', 'a', 'b', 'c', 1, '.') == ret >>> assert delimitedpathjoin('.', []) == '' cSsg|] }|rt|qSrZrrrrZrZr[rsz%delimitedpathjoin..rrrrcs g|] }|r|qSrZ)rkr delimiterrZr[rs )rryrrrr)rr}rleadingtrailingmiddlerZrr[r|s r|cCsbt|tr t|}g}|D]\}}t|ttfr'|t|gt||7}q|||fq|S)ah Flatten URL params into list of tuples. If any param value is a list or tuple, then map each value to the param key. >>> params = [('a', 1), ('a', [2, 3])] >>> assert flatten_url_params(params) == [('a', 1), ('a', 2), ('a', 3)] >>> params = {'a': [1, 2, 3]} >>> assert flatten_url_params(params) == [('a', 1), ('a', 2), ('a', 3)] )r@dictrrNtupleziprr{)r~ flattenedparamrrZrZr[rzs  rz)Tr)r)rrr)r)rr4)ro)Fr)r)FrTFF)FT)rJrKF)rJrK)r )ror4N)rkrwr$rSrArV urllib.parserrrrpydashrhelpersr__all__rJrrRS_ASCII_WORDS RS_LATIN1RS_ASTRAL_RANGERS_COMBO_MARKS_RANGERE_COMBO_HALF_MARKS_RANGERS_COMBO_SYMBOLS_RANGERS_COMBO_MARKS_EXTENDED_RANGERS_COMBO_MARKS_SUPPLEMENT_RANGERS_COMBO_RANGERS_DINGBAT_RANGERS_LOWER_RANGERS_MATH_OP_RANGERS_NON_CHAR_RANGERS_PUNCTUATION_RANGERS_SPACE_RANGERS_UPPER_RANGE RS_VAR_RANGERS_BREAK_RANGERS_APOSRS_BREAKRS_COMBORS_DIGIT RS_DINGBATRS_LOWERRS_MISCRS_FITZ RS_MODIFIER RS_NON_ASTRAL RS_REGIONAL RS_SURR_PAIRRS_UPPERRS_ZWJ RS_MISC_LOWER RS_MISC_UPPERRS_OPT_CONTR_LOWERRS_OPT_CONTR_UPPER RE_OPT_MOD RS_OPT_VAR RS_OPT_JOIN RS_ORD_LOWER RS_ORD_UPPERRS_SEQRS_EMOJIRS_HAS_UNICODE_WORDrRS_UNICODE_WORDSrrrrUrrr]rr r r r r rrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8r9r:r;r<r=r>r?r@rArBrCrDrFrGrErHrIrrr|rzrZrZrZr[sh F"      !"#$%&'()*+,-./01234G          &         !   * +   =" % & I   ) " '   6   !* 0 !