O=ddZddlZddlZddlZddlZddlZddlmZmZm Z m Z ddl Z ddl mZdZGddZd 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`ZdaZdbZdcZeezezezezZddZdeZdfZdgZdhZ diZ!djZ"dkZ#eeze ze!zZ$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;e8e7ze9zZd?gde1dze*de5de&dse1de4de6de&dse1e3de1dze3de5dse1de6dse;dse:dse(de=dZ@eeZAee@ZBeeZCejDe>ZEejDe%ZFejDdZGdZHddZIdZJdZKdZLdZMdZNdZOdZPddZQdZRdZSdZTdZUdZVdZWdZXddZ?dZYdZZdZ[dZ\ddZ]ddZ^ddZ_ddZ`ddZadZbddZcddZddZedZfddZgddZh ddZiddZjddZkdZlddZmddZnddZodZpefdZqdZrddZsdZtdZudZvdZwd„ZxdÄZydĄZzdńZ{dƄZ|dDŽZ}dȄZ~ddɄZddʄZdd˄Zdd̈́Zd΄ZdτZdЄZddфZd҄ZddӄZdԄZdՄZdքZdׄZdS)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$eZdZdZdZdZdZdS)JSRegExpz Javascript-style regular expression pattern. Converts a Javascript-style regular expression to the equivalent Python version. c|dddd\}}d|v|_d|v|_|jr tjnd}tj|||_dS)Nr/girflags)rsplit_global _ignore_casereIcompilepattern)selfreg_exprYoptionsrRs 8D:\Sites\api_v1\venv\Lib\site-packages\pydash/strings.py__init__zJSRegExp.__init__`sh"122;--c155g~ 7N)0qz'777 c|jr|j|}n4|j|}|r|g}ng}|S)z*Return list of regular expression matches.)rTrYfindallsearchgroup)rZtextresultsress r]findz JSRegExp.findis[ < l**400GG,%%d++C 99;;-r_cR|jrdnd}|j|||S)z8Replace parts of text that match the regular expression.rrcount)rTrYsub)rZrdreplrjs r]r+zJSRegExp.replaceus/\(q|d%888r_N)__name__ __module__ __qualname____doc__r^rgr+r_r]rLrLYsK 888   99999r_rLz&z<z>z"z'z`)&<>"'`ÀAÁÂÃÄÅàaáâãäåÇCçcÐDðdÈEÉÊËèeéêëÌrWÍÎÏìrPíîïÑ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 ]rN+z(?=z|$)|z+|z/gz <\/?[^>]+>cddt|D}|dd|ddzS)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. rc3>K|]}|VdSN)title.0words r] zcamel_case..0s*==D4::<<======r_Nrr compounderlowerrds r]r r sQ( 77==Jt,<,<=== = =D 8>>  d122h &&r_Tctj|}|r|n&|dd|ddzS)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 upperrdstricts r]r r 4sL. =  D & G4??   D!HNN,<,>> chars('onetwo') ['o', 'n', 'e', 't', 'w', 'o'] .. versionadded:: 3.0.0 )listrrrs r]r r Os"  d## $ $$r_cgStjdkrg}n+fdtdtD}|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 Nrc*g|]}||zSrqrq)rrPsteprds r] zchop..}s&III!4AH %IIIr_)rrrangelen)rdrchoppeds`` r]r r csd$ | =  D qyy&IIIIIuQD 4/H/HIII Nr_cgStjdkrg}n7tfdtdDddd}|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 Nrc2g|]}|z |z Srqrq)rrPrrdtext_lens r]rzchop_right..s-VVV4!d( hl23VVVr_)rrrr)rdrrrs`` @r]r r s}$ | =  D qyy&t99VVVVVVU1hPT=U=UVVVW[W[Y[W[\ Nr_ctj|}dtj|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)rrrcompactr3rs r]rrs7" =  D 88CK -- . ..r_c||dStj|}tj|}||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)rrrjrdsubtexts r]rrsB$ |wq =  DmG$$G ::g  r_cbtj|}t|dS)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 ct||Sr)DEBURRED_LETTERSgetrc)matchs r]zdeburr..s',00 NNr_)rr JS_RE_LATIN1r+rs r]rrs4& =  D    NN  r_cxtj|}|dd|ddzS)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 Nrrrrrs r]rrs8" =  D 8>>  d122h &&r_ctj|}tj|}|t|}|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)rrrendswithrdtargetpositions r]rrsO*]6 " "F =  Dt99   ? # #F + ++r_ctj|}tj|}||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)rdsuffixs r]rrsL* =  D ]6 " "F }}V  F  r_ctj|}tj|}||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)rdprefixs r]rr:sL, =  D ]6 " "F v  d  r_chtj|}dd|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`. rc3LK|]}t||V dSr) HTML_ESCAPESr)rchars r]rzescape..os2AAD<##D$//AAAAAAr_)rrrrs r]rrWs6* =  D 77AADAAA A AAr_cRtj|}tj|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`` )rrrVrrs r]rrrs!( =  D 9T??r_ctj|}tj|}||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)rrrgrs r]rrs9( =  DmG$$G 99W   ""r_ctj|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)rchainr2r)r+r valuers r]rrsM0 $   $ $ c     r_ctj|}tj|}|d||z||dzS)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)rdindexrs r]rrsB& =  DmG$$G <' !DL 00r_ctj|tj|pdtjS)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``. rq)rrrmap_)array separators r]rrs42 = # # ( (%+2s})M)M N NNr_cZddt|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. -c3BK|]}||VdSrrrs r]rzkebab_case.. /FFTFDJJLLFFFFFFr_rrrs r]rrs-( 88FFZ-=-=FFF F FFr_cRtj|}|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 splitlinesrs r]rrs#" =  D ??  r_cjdt|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. rrrs r]rr$*0 88Jt$$ % % + + - --r_cP|dd|ddzS)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!rs r]rr?). 8>>  d122h &&r_.,cpd|dd} ||d}|d}|dgzd}|t|ddd d ddd }|t j||g}n#t $rd}YnwxYw|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}r*rrrNr)formatr3rr rr ValueError) numberscaledecimal_separatororder_separatorfmt num_partsint_partdec_partrds r]rrYs. %    C IJJv&&,,S11 Q<$a(#''Xddd^Q(?(?@@2F %%ck8X2F&G&GHH  Ks(B$$ B32B3c.tj|}t|}||kr|S||z dz }tt j|}tt j|}td||}|d||z|zS)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!)rdlengthr rmidleft_len right_lens r]r r s: =  D4yyH6 H  #C4:c??##HDIcNN##I B 5 ) )E ( d "U **r_ctj|}t|t|f}|t ||zd|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*rdr=r s r]r!r!sI6 =  D &#d))$ % %F 6%(( ('6' 22r_ctj|}t|t|}t |||z| 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``. NrBrDs r]r"r"sH6 =  D T # #F 5& ! !D (6'(( 33r_ctj|}|r|}tt |dS)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 r rs r]r#r#sC. =  D zz|| j&&u 5 5 55r_chtj|}tt|dz S)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 rrrchrordrs r]r$r$ +* =  D s4yy1}  r_...ctj|}t|}t|}||kr|Sd}t|d|dzd|}t jd|ddrt|dd}n|dd }t|}||z|kr |d||z}|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 c|d}||krdn|S)Nrr)rcrr)rrs r]rlzprune..replJs5{{1~~jjlldjjll22ss>> 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<)rd quote_chars r]r&r&cs( D* % %%r_cntj|}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``. )rrrLrg)rdr[s r]r'r'zs/< =  D G   ! !$ ' ''r_ctj|}tj|stj|}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_functionrLr+)rdr[rls r]r(r(sR> =  D ?4 #}T"" G   $ $T4 0 00r_FcX|tj|St|||||dS)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_caserjr)rrr+)rdrYrlr\rjs r]r)r)s6@}T""" 4$KuUZ [ [ [[r_cJtj|t|zS)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 )rrr9)rdrs r]r*r*s$ =  Q ''r_ctj|}||Stj|stj|}|r tjnd}t |t jr|} nxtj|}|rtj|}|r| dsd|z}|r| ds|dz }tj ||} | |||S)a* Replace occurrences of `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. 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``. from_start (bool, optional): Whether to limit replacement to start of string. from_end (bool, optional): Whether to limit replacement to end of string. Returns: str: Replaced string. Example: >>> 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^$rQri) rrrZrV IGNORECASE isinstancetypingPatternrr rrXrk) rdrYrlr\rjr from_startfrom_endrRpats r]r+r+sX =  D ?4 #}T""( /BMMaE'6>**/-((  )i((G  $g0055 $GmG  G,,S11  sNGj... 774U7 + ++r_c,t|||||dS)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\rrfr+rdrYrlr\rs r]r,r,Es 4 4$KY] ^ ^ ^^r_c,t|||||dS)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\rrerirjs r]r-r-bs 4 4$K[_ ` ` ``r_cZ|dt|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. c3BK|]}||VdSrr!rs r]rz!separator_case..s/GG4$G$**,,GGGGGGr_)rrJ)rdrs r]r.r.s+* >>GG5;;GGG G GGr_,  and ctj|tj}t |}tj|}tj|}|dkr|r||z}|dkr)|dd||ddgz}||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 NrQ) rrmaprrrrrRr)itemsrlast_separatorserial item_counts r]r/r/s4 Ie    / / 7 7 9 9 ? ? A AEUJ i((I]>22NA~~&~"))++n<Qcrc n11%*==>> >>%  r_c(t|||dS)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)ru)r/)rsrrts r]r0r0s(  >$ G G GGr_rctjdtj|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.)rdr normalizeds r]r1r1sT8 fcmD&9&9::AA'8TT[[\bcc *i 0 00r_cZddt|DS)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. rc3BK|]}||VdSrr!rs r]rzsnake_case..r"r_r#rs r]r2r2s-. 88FFZ-=-=FFF F FFr_ctj|}|tur|}n'|r||}nt |}|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``. )rrrr3r )rdrrets r]r3r3sX6 =  DEjjll jj##Dkk Jr_cZddt|DS)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. rc38K|]}t|dVdS)FrGNr rs r]rzstart_case..Ns/PPtJtE222PPPPPPr_r#rs r]r4r4:s-( 88PPz$?O?OPPP P PPr_ctj|}tj|}||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 Nr rs r]r5r5Qs>. =  D ]6 " "F  ? % %f - --r_c\tdtj|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_TAGSrkrrrs r]r6r6ms$"   B d 3 3 4 44r_chtj|}|r||dn|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 partitionrs r]r7r7s4& =  D)0 :4>>' " "1 % %d:r_cltj|}|r||dp|n|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 rpartitionrs r]r8r8s7& =  D29 C4??7 # #A & .$tCr_cltj|}|r||dp|n|S)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 rqrrs r]r9r9s7& =  D18 B4>>' " "1 % -dBr_chtj|}|r||dn|S)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 rqrrs r]r:r:s4& =  D*1 ;4??7 # #A & &t;r_chtj|}tt|dzS)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 rrIrLs r]r;r;rMr_cbtj|}tj|}|||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)rdwrappers r]r<r<s8( =  DmG$$G &t &W & &&r_cRtj|}|S)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 )rrswapcasers r]r=r=s!" =  D ==??r_ctj|}ddtjd|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 rc3>K|]}|VdSrrrs r]rztitle_case..7s,FF$DOO%%FFFFFFr_)rrrrVr3rs r]r>r>$s@" =  D 88FF"(32E2EFFF F FFr_cNtj|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 rrs r]r?r?: * =   $ $ & &&r_cNtj|S)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 )rrrrs r]r@r@Rrr_cTtj|}||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 )rrstriprdr s r]rArAjs%& =  D ::e  r_cTtj|}||S)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``. )rrrRrs r]rBrB%* =  D ;;u  r_cTtj|}||S)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``. )rrlstriprs r]rCrCrr_ctj|}t||kr|St|}||z }|d|}t|}tj|r||}nFtj|r2d}||D]}|}||}|d||zS)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) rdr=rSrrTr trunc_lenlastrs r]rDrDs< =  D 4yyF x==L $H   ?DD I }Y%JJy))  " "%''--  EDD   I   h &&r_cRtj|}tj|S)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`. )rrhtmlrErs r]rErEs#, =  D =  r_cjdt|S)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)rrrrs r]rGrGr'r_cP|dd|ddzS)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)rrs r]rHrHr)r_c^tj|}|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)rdrWinners r]rFrF8sE0 =  D 2JE *1e1Z1111 Kr_c tj|tj}g}t |}|D]R}t|\}}}}}t|}||z }| t|||d|fStdg|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 rrN) rr flatten_deeprrrrflatten_url_paramsrrappendrdelimitedpathjoinr) pathsparams paths_list params_listpathschemenetlocqueryfragments r]rIrIYs2 Ie   ) ) + + / / > > D D F FEJ$V,,KLL08-eX%  u *ffdB%IJJKKKK S .: . . .D,4TNN)FFD% k " "E vvtUH= > >>r_ctj|}|t|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. )rrhas_unicode_wordJS_RE_UNICODE_WORDSJS_RE_ASCII_WORDSrLrg)rdrYr[s r]rJrJsV@ =  D D ! ! ()GG'GG7## <<  r_c tttdt j|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)rJrRE_APOSrkrrrs r]rrs2  B d(;(;<<== > >>r_cTt|}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_WORDrbbool)rdresults r]rrs#! ' ' - -F <<r_crdtj|D}t|dkr |d}n{|r|drnd}|r|drnd}fd|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('.', []) == '' c:g|]}|tj|Srqr)rrs r]rz%delimitedpathjoin..s' M M MT MS]4 M M Mr_rrrrcdg|],}||-Srq)r)rr delimiters r]rz%delimitedpathjoin..s7 b b b4DJJW`LaLa bI!6!6 b b br_)rrrr rr)rrrleadingtrailingmiddles` r]rrs$ N MS-=e-D-D M M ME 5zzQQx$Oq)<)>> 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)] )rbdictrrstupleziprr)r flattenedparamrs r]rrs&$&fllnn%%I-- u edE] + + - eWs5zz1599 9II   eU^ , , , , r_)Tr)r)rr*r+)r)rrN)ru)Fr)r)FrTFF)FT)rnroF)rnro)r)rrNN)rprr:rVrcr} urllib.parserrrrpydashrhelpersr__all__rLrrRS_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_WORDSrrrrXrrrr 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@rArBrCrDrErGrHrFrIrJrrrrrqr_r]r s   CCCCCCCCCCCCC L99999999D6XGZabb A CA CA CA C A  C A  C A CA CA CA CA CA CA CA CA CA  C!A" C#AA$ C%A& C'A( C)A* C+A, C-A. C/A0 C1A2 C3A4 C5A6 C7A8 C9A: C;A< C=A> C?A@ CAAB CCAD CEAAAF CGAH CIAJ CKAL CMAN COAP CQAR CSAT CUAV CWAX CYAZ C[A\ C]A^ C_A` CaAb CcAd CeAf CgAAh             AAAAN?  $(-* 1"3 $$& &%,)B(6 - !$558LL~]  ~  ~   $! $ $ $ ~ ;;.;(;;';)7;;; %)H))w))) '_''' / 3 ~  ,h+++++ +h+++++ :7::::7:::    ! ! ! ! \&\\]\\[\\<\\*\j\\\ B A j ; . C C Ck C CL C C6 C CZ                 /     4<     ?G          *     /7     :B   DQ           !     $6           &                             H^,,h/00x ""  bj!455 "*W  rz-(( '''0HHHH6%%%(>@///*62'''*,,,,<8:BBB60###2B1110OOOO8GGG.*...6'''4''''T(+(+(+(+V3333@4444@6666>2::::z&&&&.(((D"1"1"1J#\#\#\#\L((((,^cF,F,F,F,R____:aaaa:HHH0&!&!&!&!RHHHH.1111DGGG4 $$$$NQQQ.....8555(;;;.DDD.CCC.<<<.2'''2*GGG,'''0'''0.223'3'3'3'l4...6'''4B'?'?'?T((((` ? ? ?Br_