.PhHdZddlZddlZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl mZddlmZddlmZgdZejejzZejd ezd zZejd Zd Zd ZdPdZdZdQdZ ddddZ!dRdZ"dZ#dZ$dZ%dZ&iddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d6d7d8d9d:d;d<d=d>id?d?d@dAdBdCdDdEdFdGdHdIdJdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^id_d_d`dadbdcdddedddfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d|d}d~iddddddddddddddddddddddddddddddddddiddddddddddddddddddddddddddddddddddiddddddddÓddœddǓddɓdd˓dd͓ddϓddѓddӓddՓddדddٓddۓddݓddddZ'de'(DZ)ejdej*Z+dZ,dZ-ejdej.Z/dZ0dRdZ1dZ2Gdde3Z4iddddddddddddddddddddddddddddddddddid dd dd d d d ddddddddddddddddddddddd d!d"d#d#d#d$d$d%d%d%d&d&d'd'd(d(d) Z5e4e5Z6d*Z7d+e8e7DZ9e:e;e9e9d,dZ<dSd-Z=Gd.d/eZ>d0Z?d1Z@d2ZAd3ZBdTd5ZCejd6ej*ZDd7ZEd8eFfd9ZGdUd;ZHdVd=ZIejd>jJZKdWd?ZLdWd@ZMdXdCZNdYdDZO dZdEZPdXdFZQGdGdHZRdIZSd[dKZTdLeUdMeUdNeUfdOZVdS(\zSo much practical programming involves string manipulation, which Python readily accommodates. Still, there are dozens of basic and common capabilities missing from the standard library, several of them provided by ``strutils``. N)Mapping)GzipFile) HTMLParser)entities)BytesIO) camel2under under2camelslugifysplit_punct_wsunit_len ordinalize cardinalize pluralize singularizeasciifyis_asciiis_uuid html2text strip_ansi bytes2human find_hashtagsa10n gzip_bytes gunzip_bytesiter_splitlinesindentescape_shell_argsargs2cmdargs2shparse_int_listformat_int_listcomplement_int_listint_ranges_from_int_list MultiReplace multi_replace unwrap_text removeprefix[z]+z(((?<=[a-z0-9])[A-Z]|(?!^)[A-Z](?=[a-z]))c\td|S)zConverts a camelcased string to underscores. Useful for turning a class name into a function name. >>> camel2under('BasicParseTest') 'basic_parse_test' z_\1)_camel2under_resublower) camel_strings P/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/boltons/strutils.pyrrDs&   v| 4 4 : : < <<cfdd|dDS)zConverts an underscored string to camelcased. Useful for turning a function name into a class name. >>> under2camel('complex_tokenizer') 'ComplexTokenizer' c3BK|]}|pdVdS)_N) capitalize.0ws r. zunder2camel..Us/JJQ1<<>>(SJJJJJJr/r3)joinsplit) under_strings r.r r Ns3 77JJ,2D2DS2I2IJJJ J JJr/r3TFc|r$|t|p|nd}|rt|}|r|}|S)u A basic function that turns text full of scary characters (i.e., punctuation and whitespace), into a relatively safe lowercased string separated only by the delimiter specified by *delim*, which defaults to ``_``. The *ascii* convenience flag will :func:`asciify` the slug if you require ascii-only slugs. >>> slugify('First post! Hi!!!!~1 ') 'first_post_hi_1' >>> slugify("Kurt Gödel's pretty cool.", ascii=True) == b'kurt_goedel_s_pretty_cool' True r1)r9r rr,)textdelimr,asciirets r.r r XsW$8< C%**^D)) * * 3eC cll iikk Jr/cJdt|DS)aWhile :meth:`str.split` will split on whitespace, :func:`split_punct_ws` will split on punctuation and whitespace. This used internally by :func:`slugify`, above. >>> split_punct_ws('First post! Hi!!!!~1 ') ['First', 'post', 'Hi', '1'] cg|]}||SrCr5s r. z"split_punct_ws..zs 2 2 2! 2A 2 2 2r/) _punct_rer:r=s r.r r rs$ 3 2yt,, 2 2 22r/itemc\t|}t||}|r|d|Sd|S)a;Returns a plain-English description of an iterable's :func:`len()`, conditionally pluralized with :func:`cardinalize`, detailed below. >>> print(unit_len(range(10), 'number')) 10 numbers >>> print(unit_len('aeiou', 'vowel')) 5 vowels >>> print(unit_len([], 'worry')) No worries  zNo )lenr)sized_iterable unit_nouncountunitss r.r r }sH   E  5 ) )E "!!%!!! ==r/stndrd)123c(t|d}}|rw|dtjvrc |ddkrd}n!t|dd}n1#t $r$t|dd}YnwxYw|r|S||zS)aTurns *number* into its cardinal form, i.e., 1st, 2nd, 3rd, 4th, etc. If the last character isn't a digit, it returns the string value unchanged. Args: number (int or str): Number to be cardinalized. ext_only (bool): Whether to return only the suffix. Default ``False``. >>> print(ordinalize(1)) 1st >>> print(ordinalize(3694839230)) 3694839230th >>> print(ordinalize('hi')) hi >>> print(ordinalize(1515)) 1515th r1rRth)strstringdigits _ORDINAL_MAPget IndexError)numberext_onlynumstrexts r.r r s$f++rCF 5&* -- 5bzS  #&&vbz488 5 5 5""6":t44CCC 5 |s0A+BBc0|dkr|St|S)aConditionally pluralizes a singular word *unit_noun* if *count* is not one, preserving case when possible. >>> vowels = 'aeiou' >>> print(len(vowels), cardinalize('vowel', len(vowels))) 5 vowels >>> print(3, cardinalize('Wish', 3)) 3 Wishes )r)rLrMs r.rrs! zz Y  r/c||}}|r |tvr|St|}|r|}n|ds|St |dkr |dd}ne|dr|dddvr|ddd z}n6|d r|ddkr |dd }n |dd}t||S) aSemi-intelligently converts an English plural *word* to its singular form, preserving case pattern. >>> singularize('chances') 'chance' >>> singularize('Activities') 'Activity' >>> singularize('Glasses') 'Glass' >>> singularize('FEET') 'FOOT' sNrViesaeiouyesrW)stripr,_IRR_S2P_IRR_P2Sr]endswithrJ _match_case)word orig_word irr_singularsingulars r.rrsDJJLL..00tI 48##<<%%L  ]]3    Ta9 u  $r"u+W"<"<9s? t  bS99 y( + ++r/c||}}|r |tvr|St|}|r|}n|dr|dddvr|dddz}nX|ddks*|ds|d r|d r|n|d z}n|dz}t ||S) zSemi-intelligently converts an English *word* from singular form to plural, preserving case pattern. >>> pluralize('friend') 'friends' >>> pluralize('enemy') 'enemies' >>> pluralize('Sheep') 'Sheep' rlrWrVrkNrhrfchshrm)rnr,rpror]rqrr)rsrt irr_pluralplurals r.rrsDJJLL..00tI 48##d##J s  RU 7 : :crcU" bSDMM$//4==3F3Ft,,=$+ y& ) ))r/c:|s|S||kr|S||kr|S||kr|S|SN)rnr,uppertitle)masterdisciples r.rrrrs <<>> ||~~~~ 6 ! !~~ 6 ! !~~ Or/addendumaddendaalgaalgaealumnaalumnaealumnusalumnianalysisanalysesantennaantennaeappendix appendicesaxisaxesbacillusbacilli bacteriumbacteriabasisbasesbeaubeauxbisonbureaubureauscactuscacticalfcalveschildchildrencorpscorpuscorporacrisiscrises criterioncriteria curriculum curriculadatumdatadeer diagnosis diagnosesdiedicedwarfdwarvesechoechoeselfelvesellipsisellipsesembargo embargoesemphasisemphaseserratumerratafiremanfiremenfishfocusfocifootfeetformulaformulaeformulasfungusfungigenusgeneragoosegeesehalfhalvesheroheroes hippopotamus hippopotamihoofhooves hypothesis hypothesesindexindicesknifeknivesleafleaveslifelivesloafloaveslouselicemanmenmatrixmatricesmeansmediummedia memorandum memoranda millenniummilenniamoosemosquito mosquitoesmousemicenebulanebulaeneurosisneurosesnucleusnucleioasisoasesoctopusoctopi offspringovumovaoxoxen paralysis paralyses parenthesis parenthesespersonpeople phenomenon phenomenapotatopotatoesradiusradiiscarfscarvesscissorsselfselvessensesensesseriessheepshelfshelvesspeciesstimulusstimulistratumstratasyllabussyllabi symposiumsymposiasynopsissynopses synthesis synthesestableautableauxthatthosethesisthesesthiefthievesthisthesetomatotomatoestoothteethtorpedo torpedoesvertebra vertebraevetovetoesvitavitaewatchwatcheswiveswolveswomen)wifewolfwomanci|]\}}|| SrCrC)r6kvs r. rK7s . . .TQAq . . .r/u(?:^|\s)[＃#]{1}(\w+)c6t|S)a.Finds and returns all hashtags in a string, with the hashmark removed. Supports full-width hashmarks for Asian languages and does not false-positive on URL anchors. >>> find_hashtags('#atag http://asite/#ananchor') ['atag'] ``find_hashtags`` also works with unicode hashtags. ) HASHTAG_REfindallrZs r.rr<s   f % %%r/c~t|dkr|S|dt|dd|dS)aOThat thing where "internationalization" becomes "i18n", what's it called? Abbreviation? Oh wait, no: ``a10n``. (It's actually a form of `numeronym`_.) >>> a10n('abbreviation') 'a10n' >>> a10n('internationalization') 'i18n' >>> a10n('') '' .. _numeronym: http://en.wikipedia.org/wiki/Numeronym rrdrV)rJrOs r.rrMsF 6{{Q Qi 8VAbD\** 8F2J 8 88r/uP \x1B # Sequence starts with ESC, i.e. hex 0x1B (?: [@-Z\\-_] # Second byte: # all 0x40–0x5F range but CSI char, i.e ASCII @A–Z\]^_ | # Or \[ # CSI sequences, starting with [ [0-?]* # Parameter bytes: # range 0x30–0x3F, ASCII 0–9:;<=>? [ -/]* # Intermediate bytes: # range 0x20–0x2F, ASCII space and !"#$%&'()*+,-./ [@-~] # Final byte # range 0x40–0x7E, ASCII @A–Z[\]^_`a–z{|}~ ) cd}t|ttfr$t|}|d}t d|}|r|t|kr ||d}|S)aStrips ANSI escape codes from *text*. Useful for the occasional time when a log or redirected output accidentally captures console color codes and the like. >>> strip_ansi('art') 'art' Supports str, bytes and bytearray content as input. Returns the same type as the input. There's a lot of ANSI art available for testing on `sixteencolors.net`_. This function does not interpret or render ANSI art, but you can do so with `ansi2img`_ or `escapes.js`_. .. _sixteencolors.net: http://sixteencolors.net .. _ansi2img: http://www.bedroomlan.org/projects/ansi2img .. _escapes.js: https://github.com/atdt/escapes.js Nutf-8r1) isinstancebytes bytearraytypedecodeANSI_SEQUENCESr+)r= target_typecleaneds r.rrrs.K$ *++$4jj {{7##  T**G0{d7mm33+gw// Nr/cZ |dS#t$r-|d}|dcYSwxYw#t$rNd}|rd}t jd|t}|d|}|cYSwxYw)uAConverts a unicode or bytestring, *text*, into a bytestring with just ascii characters. Performs basic deaccenting for all you Europhiles out there. Also, a gentle reminder that this is a **utility**, primarily meant for slugification. Whenever possible, make your application work **with** unicode, not against it. Args: text (str): The string to be asciified. ignore (bool): Configures final encoding to ignore remaining unasciified string instead of replacing it. >>> asciify('Beyoncé') == b'Beyonce' True r?rSreplaceignoreNFKD)encodeUnicodeDecodeErrorrXUnicodeEncodeError unicodedata normalize translate DEACCENT_MAP)r=r^modetransdr@s r.rrs"  (;;w'' '! ( ( (;;w''D;;w'' ' ' ' (   D&vt~~l/K/KLLmmGT** s(4A AAAAB*)B*c8t|tr( |dnm#t$rYdSwxYwt|tr( |dn0#t $rYdSwxYwtdt|zdS)uCheck if a string or bytestring, *text*, is composed of ascii characters only. Raises :exc:`ValueError` if argument is not text. Args: text (str): The string to be checked. >>> is_ascii('Beyoncé') False >>> is_ascii('Beyonce') True r?Fzexpected text or bytes, not %rT) rTrYr`rbrUrXra ValueErrorrWrFs r.rrs$ H  KK !   55  D% H  KK !   55 9DJJFGGG 4s- ;;A** A87A8ceZdZdZdZdS)DeaccenterDictz+A small caching dictionary for deaccenting.c||}||S tjt|}|d\}}}t |ddkr||}nt |d}n-#t tf$r|||}YnwxYw|||<|S)NrIi)r]rc decompositionchr rpartitionintr^rj)rkeyrxdep1r3p2s r. __missing__zDeaccenterDict.__missing__s XXc]] >I $*3s8844B c**IB22r{{e##XXc]]R[[J' $ $ $#s##BBB $S  sA4B'B:9B:N)__name__ __module__ __qualname____doc__rwrCr/r.rlrls)11r/rlAEDOEThAeOeUeACEIOUssaedoerXueaceiou'") i i i i ) BKMGTPrZYc"g|] \}}d|z|f S)irC)r6rsyms r.rDrD"s%HHHVQC HHHr/rdct|}tD]\\}}\}}||krnt||z }d|||S)a&Turns an integer value of *nbytes* into a human readable format. Set *ndigits* to control how many digits after the decimal point should be shown (default ``0``). >>> bytes2human(128991) '126K' >>> bytes2human(100001221) '95M' >>> bytes2human(0, 2) '0.00B' z{hnbytes:.{ndigits}f}{symbol})hnbytesndigitssymbol)abs _SIZE_RANGESfloatformat)nbytesr abs_bytessizer next_size next_symbolrs r.rr&syF I4@0v0K  ! ! E "Fmmd"G * 1 1':A9? 2 A AAr/c,eZdZdZdZdZdZdZdS)HTMLTextExtractorcX|d|_d|_g|_dS)NFT)resetstrictconvert_charrefsresultrs r.__init__zHTMLTextExtractor.__init__=s)  $ r/c:|j|dSr})rappend)rrs r. handle_datazHTMLTextExtractor.handle_dataCs 1r/c|ddks |ddkrt|ddd}nt|}|jt|dS)NrxXrdrn)rrrrrp)rr_ codepoints r.handle_charrefz HTMLTextExtractor.handle_charrefFse !9  vayC//F122J++IIF I 3y>>*****r/c tj|}|jt |dS#t $r$|jd|zdzYdSwxYw)N&;)htmlentitydefsname2codepointrrrpKeyError)rnamers r.handle_entityrefz"HTMLTextExtractor.handle_entityrefMs} /&5d;I K  s9~~ . . . . . 1 1 1 K  sTzC/ 0 0 0 0 0 0 1s=*A+*A+c6d|jS)Nr1)r9rrs r.get_textzHTMLTextExtractor.get_textUswwt{###r/N)rxryrzrrrrrrCr/r.rr<s_ +++///$$$$$r/rcpt}|||S)uStrips tags from HTML text, returning markup-free text. Also, does a best effort replacement of entities like " " >>> r = html2text(u'Test &(Δημώ)') >>> r == u'Test &(Δημώ)' True )rfeedr)htmlrfs r.rrYs, AFF4LLL ::<<r/s9Uemptys)Unot_emptyK,I-NȯTnb cFtj|dtjzS)aThe :mod:`gzip` module is great if you have a file or file-like object, but what if you just have bytes. StringIO is one possibility, but it's often faster, easier, and simpler to just use this one-liner. Use this tried-and-true utility function to decompress gzip from bytes. >>> gunzip_bytes(_EMPTY_GZIP_BYTES) == b'' True >>> gunzip_bytes(_NON_EMPTY_GZIP_BYTES).rstrip() == b'bytesahoy!' True rn)zlib decompress MAX_WBITS) bytestrings r.rrks ?:rDN': ; ;;r/ct}t|d|}||||S)aTurn some bytes into some compressed bytes. >>> len(gzip_bytes(b'a' * 10000)) 46 Args: bytestring (bytes): Bytes to be compressed level (int): An integer, 1-9, controlling the speed/compression. 1 is fastest, least compressed, 9 is slowest, but most compressed. Note that all levels of gzip are pretty fast these days, though it's not really a competitor in compression, at any level. wb)fileobjrg compresslevel)StringIOrwriteclosegetvalue)rleveloutfs r.rrzsN **C4u===AGGJGGIII <<>>r/z'(\r\n|\n|\x0b|\f|\r|\x85|\x2028|\x2029)c#Kdt|}}t|D]J}|d|d}}||kr |||V||krdV|}K||d}|r|VdS)aLike :meth:`str.splitlines`, but returns an iterator of lines instead of a list. Also similar to :meth:`file.next`, as that also lazily reads and yields lines from a file. This function works with a variety of line endings, but as always, be careful when mixing line endings within a file. >>> list(iter_splitlines('\nhi\nbye\n')) ['', 'hi', 'bye', ''] >>> list(iter_splitlines('\r\nhi\rbye\r\n')) ['', 'hi', 'bye', ''] >>> list(iter_splitlines('')) [] rrdr1N)rJ_line_ending_refinditerstartend)r=prev_endlen_textmatchr r tails r.rrsCIIhH!))$//[[^^UYYq\\s u  x~& & & & (??HHH  ?D   Fr/ chfdt|D}||S)aThe missing counterpart to the built-in :func:`textwrap.dedent`. Args: text (str): The text to indent. margin (str): The string to prepend to each line. newline (str): The newline used to rejoin the lines (default: ``\n``) key (callable): Called on each line to determine whether to indent it. Default: :class:`bool`, to ensure that empty lines do not get whitespace added. c4g|]}|r|zn|SrCrC)r6linersmargins r.rDzindent..s>999),D ;v}}t999r/)rr9)r=rnewlinersindented_liness ` ` r.rrsK99999"1$"7"7999N << ' ''r/ct|tjs4 tj|}n#ttt f$rYdSwxYw|r|jt|krdSdS)aCheck the argument is either a valid UUID object or string. Args: obj (object): The test target. Strings and UUID objects supported. version (int): The target UUID version, set to 0 to skip version check. >>> is_uuid('e682ccca-5a4c-4ef2-9711-73f9ad1e15ea') True >>> is_uuid('0221f0d9-d4b9-11e5-a478-10ddb1c2feb9') False >>> is_uuid('0221f0d9-d4b9-11e5-a478-10ddb1c2feb9', version=1) True FT)rTuuidUUID TypeErrorrjAttributeErrorversionrr)objrs r.rrsy c49 % % )C..CC:~6   55 3;#g,,..u 4s1A  A rIc|stjdkrdnd}|dkrt||S|dkrt||St d|z)a?Returns an escaped version of each string in *args*, according to *style*. Args: args (list): A list of arguments to escape and join together sep (str): The separator used to join the escaped arguments. style (str): The style of escaping to use. Can be one of ``cmd`` or ``sh``, geared toward Windows and Linux/BSD/etc., respectively. If *style* is ``None``, then it is picked according to the system platform. See :func:`args2cmd` and :func:`args2sh` for details and example output for each style. win32cmdry)sepz+style expected one of 'cmd' or 'sh', not %r)sysplatformrrrj)argsr"styles r.rrsm ;00d }}t%%%% %#&&&& BUJ K KKr/z[^a-zA-Z0-9_@%+=:,./-]cg}|D]n}|s|dt|||?|d|ddzdzod|S)aReturn a shell-escaped string version of *args*, separated by *sep*, based on the rules of sh, bash, and other shells in the Linux/BSD/MacOS ecosystem. >>> print(args2sh(['aa', '[bb]', "cc'cc", 'dd"dd'])) aa '[bb]' 'cc'"'"'cc' 'dd"dd' As you can see, arguments with no special characters are not escaped, arguments with special characters are quoted with single quotes, and single quotes themselves are quoted with double quotes. Double quotes are handled like any other special character. Based on code from the :mod:`pipes`/:mod:`shlex` modules. Also note that :mod:`shlex` and :mod:`argparse` have functions to split and parse strings escaped in this manner. z''Nrz'"'"'rI)r_find_sh_unsafer]r9)r%r"ret_listargs r.rrs$H A A  OOD ! ! !  3   ' OOC  ckk#y999C?@@@@ 88H  r/cj g}d}|D]}g}|r|dd|vpd|vp| }|r|d|D]}|dkr|||dkr@|dt|zdzg}|dd|r||g}|||r|||r*|||dd|S) aReturn a shell-escaped string version of *args*, separated by *sep*, using the same rules as the Microsoft C runtime. >>> print(args2cmd(['aa', '[bb]', "cc'cc", 'dd"dd'])) aa [bb] cc'cc dd\"dd As you can see, escaping is through backslashing and not quoting, and double quotes are the only special character. See the comment in the code for more details. Based on internal code from the :mod:`subprocess` module. FrI r\rgz\"r1)rrJextendr9)r%r"r needquoter*bs_bufrs r.rrsw2FI!!   MM#   CZ>> parse_int_list('1,3,5-8,10-11,15') [1, 3, 5, 6, 7, 8, 10, 11, 15] rd) rnr:listmaprrrangeminmaxrsorted) range_stringr> range_delimoutputr range_limitss r.r r ks"F    ! ! ' ' . . " " !  C)=)= > >??L d5\!2!2C 4E4Ea4GHHII IFF "  MM#a&& ! ! ! ! &>>r/cg}tj}t|D]K}t|dkr||,t|dkr||dz }|dkr||f|dkrpdt ||t|}|||||܌||dz }|dkr|||dkr@|| d||KMt|dkr>|| d|nmt|dkrZdt ||t|}||||r|dz |} n| |} | S)aReturns a sorted range string from a list of positive integers (*int_list*). Contiguous ranges of integers are collapsed to min and max values. Reverse of :func:`parse_int_list`. Args: int_list (list): List of positive integers to be converted into a range string (e.g. [1,2,4,5,6,8]). delim (char): Defaults to ','. Separates integers and contiguous ranges of integers. range_delim (char): Defaults to '-'. Indicates a contiguous range of integers. delim_space (bool): Defaults to ``False``. If ``True``, adds a space after all *delim* characters. >>> format_int_list([1,3,5,6,7,8,10,11,15]) '1,3,5-8,10-11,15' rdrVz {:d}{}{:d}rrrI) collectionsdequer9rJrrr7r8clearpopleftr9) int_listr>r; delim_spacer< contig_rangerdelta range_substr output_strs r.r!r!s&F$&&L H  :!:! |  q    " " " "   " " R((Ezz##A&&&&+223|3D3D6A69,6G6G I I  l+++""$$$##A&&&& Q'Ezz##A&&&& !5!5!7!7;;<<<##A&&&& |   ! ! MM\113377 8 8 8       " "'..s>> complement_int_list('1,3,5-8,10-11,15') '0,2,4,9,12-14' >>> complement_int_list('1,3,5-8,10-11,15', range_start=0) '0,2,4,9,12-14' >>> complement_int_list('1,3,5-8,10-11,15', range_start=1) '2,4,9,12-14' >>> complement_int_list('1,3,5-8,10-11,15', range_start=2) '2,4,9,12-14' >>> complement_int_list('1,3,5-8,10-11,15', range_start=3) '4,9,12-14' >>> complement_int_list('1,3,5-8,10-11,15', range_end=15) '0,2,4,9,12-14' >>> complement_int_list('1,3,5-8,10-11,15', range_end=14) '0,2,4,9,12-13' >>> complement_int_list('1,3,5-8,10-11,15', range_end=13) '0,2,4,9,12' >>> complement_int_list('1,3,5-8,10-11,15', range_end=20) '0,2,4,9,12-14,16-19' >>> complement_int_list('1,3,5-8,10-11,15', range_end=0) '' >>> complement_int_list('1,3,5-8,10-11,15', range_start=-1) '0,2,4,9,12-14' >>> complement_int_list('1,3,5-8,10-11,15', range_end=-1) '' >>> complement_int_list('1,3,5-8', range_start=1, range_end=1) '' >>> complement_int_list('1,3,5-8', range_start=2, range_end=2) '' >>> complement_int_list('1,3,5-8', range_start=2, range_end=3) '2' >>> complement_int_list('1,3,5-8', range_start=-10, range_end=-5) '' >>> complement_int_list('1,3,5-8', range_start=20, range_end=10) '' >>> complement_int_list('') '' Nrd)setr r8r6r!)r: range_start range_endr>r;rCcomplement_valuess r.r"r"sZ>,{CCDDH  $H )II#I i$%'*5+=+='>'>? ,e[ A AAr/c8g}tt|||}|rj|dD]T}d|vr|d\}}n||}}|t |t |fUt |S)a Transform a string of ranges (*range_string*) into a tuple of tuples. Args: range_string (str): String of comma separated positive integers or ranges (e.g. '1,2,4-6,8'). Typical of a custom page range string used in printer dialogs. delim (char): Defaults to ','. Separates integers and contiguous ranges of integers. range_delim (char): Defaults to '-'. Indicates a contiguous range of integers. >>> int_ranges_from_int_list('1,3,5-8,10-11,15') ((1, 1), (3, 3), (5, 8), (10, 11), (15, 15)) >>> int_ranges_from_int_list('1') ((1, 1),) >>> int_ranges_from_int_list('') () r1r2)r!r r:rrrtuple)r:r>r; int_tuplesboundsr r s r.r#r#Bs*J"|UK88::L6"((-- 6 6Ff}}#\\#.. ss#Vs   s5zz3s884 5 5 5 5   r/c$eZdZdZdZdZdZdS)r$a MultiReplace is a tool for doing multiple find/replace actions in one pass. Given a mapping of values to be replaced it allows for all of the matching values to be replaced in a single pass which can save a lot of performance on very large strings. In addition to simple replace, it also allows for replacing based on regular expressions. Keyword Arguments: :type regex: bool :param regex: Treat search keys as regular expressions [Default: False] :type flags: int :param flags: flags to pass to the regex engine during compile Dictionary Usage:: from boltons import strutils s = strutils.MultiReplace({ 'foo': 'zoo', 'cat': 'hat', 'bat': 'kraken' }) new = s.sub('The foo bar cat ate a bat') new == 'The zoo bar hat ate a kraken' Iterable Usage:: from boltons import strutils s = strutils.MultiReplace([ ('foo', 'zoo'), ('cat', 'hat'), ('bat', 'kraken)' ]) new = s.sub('The foo bar cat ate a bat') new == 'The zoo bar hat ate a kraken' The constructor can be passed a dictionary or other mapping as well as an iterable of tuples. If given an iterable, the substitution will be run in the order the replacement values are specified in the iterable. This is also true if it is given an OrderedDict. If given a dictionary then the order will be non-deterministic:: >>> 'foo bar baz'.replace('foo', 'baz').replace('baz', 'bar') 'bar bar bar' >>> m = MultiReplace({'foo': 'baz', 'baz': 'bar'}) >>> m.sub('foo bar baz') 'baz bar bar' This is because the order of replacement can matter if you're inserting something that might be replaced by a later substitution. Pay attention and if you need to rely on order then consider using a list of tuples instead of a dictionary. c :ddd}||i|_g}t|tr|}t |D]\}}d|}t|dt r,|dstj|d}n|d}n |dj }| d|d|d|d |j|<tj d ||d  |_ d S)z6Compile any regular expressions that have been passed.Fr)regexflagsgrouprTz(?P<>)rd|rU)rUN)update group_maprTritems enumeraterYreescapepatternrcompiler9combined_pattern) rsub_mapkwargsoptions regex_valuesidxvals group_nameexps r.rzMultiReplace.__init__s:   v gw ' ' &mmooG"7++ 1 1IC&J$q'3'' &w'")DG,,CCq'CC1go    :z : :C : : : ; ; ;)-aDN: & & " HH\ " "'"! ! ! r/cn|fdDd}|j|S)z,Given a match object find replacement value.c$g|] }| | SrCrC)r6r group_dicts r.rDz+MultiReplace._get_value..s"666Q 1 6q666r/r) groupdictr[)rrrsrms @r. _get_valuezMultiReplace._get_values=__&& 6666*666q9~c""r/cB|j|j|S)z Run substitutions on the input text. Given an input string, run all substitutions given in the constructor. )rbr+ro)rr=s r.r+zMultiReplace.subs$(($???r/N)rxryrzr{rror+rCr/r.r$r$esR66p   @### @@@@@r/r$c Ft|fi|}||S)aE Shortcut function to invoke MultiReplace in a single call. Example Usage:: from boltons.strutils import multi_replace new = multi_replace( 'The foo bar cat ate a bat', {'foo': 'zoo', 'cat': 'hat', 'bat': 'kraken'} ) new == 'The zoo bar hat ate a kraken' )r$r+)r=rcrdms r.r%r%s) W''''A 55;;r/ cjg}g}|D]X}|}|r||.|d|g}Y|r(|d|||S||S)a Unwrap text, the natural complement to :func:`textwrap.wrap`. >>> text = "Short \n lines \nwrapped\nsmall.\n\nAnother\nparagraph." >>> unwrap_text(text) 'Short lines wrapped small.\n\nAnother paragraph.' Args: text: A string to unwrap. ending (str): The string to join all unwrapped paragraphs by. Pass ``None`` to get the list. Defaults to '\n\n' for compatibility with Markdown and RST. rI) splitlinesrnrr9)r=ending all_grafscur_grafrs r.r&r&sIH!!zz||   OOD ! ! ! !   SXXh// 0 0 0HH-(++,,, ~ ;;y ! !!r/r=prefixreturnc^||r|t|dS|S)a Remove `prefix` from start of `text` if present. Backport of `str.removeprefix` for Python versions less than 3.9. Args: text: A string to remove the prefix from. prefix: The string to remove from the beginning of `text`. N) startswithrJ)r=rys r.r'r's2 v"CKKLL!! Kr/)r3TF)rG)F)r)r)r)rIN)rI)r1r2)r1r2F)rNr1r2)rs)Wr{builtinsr^r#rrrZrcr?collections.abcrgzipr html.parserrrrriorr__all__ punctuation whitespace _punct_ws_strrarEr*rr r r r r\r rrrrrror\rpUNICODErMrrVERBOSErYrrrdictrl_BASE_DEACCENT_MAPrf _SIZE_SYMBOLSr] _SIZE_BOUNDSr4ziprrrr_EMPTY_GZIP_BYTES_NON_EMPTY_GZIP_BYTESrrrrboolrrrsearchr(rrr r!r"r#r$r%r&rYr'rCr/r.rsA > ######""""""++++++"""""" ; ; ;"V%66 BJs]*T1 2 2 "*GHH===KKK4333& !!!!H    ,,,D***4   " 0J " 067" 0Hi" 0 x" 0!+Z" 09BJ" 0  " 0&,f" 06@)" 0 " 0&-g" 08>w" 0 W " 0' " 04z3" 04 H5" 04&x5" 042:85" 04FM 7" 06i7" 06*3I7" 06@J 9" 0" 0" 08!(9" 08-7 9" 08DO ;" 0:#J;" 0:1<[;" 0< z=" 0<$*7=" 0<5=h=" 0> Y?" 0>!'?" 0>2::?" 0>HO A" 0@ A" 0@.8A" 0@GM C" 0BgC" 0B(/ C" 0" 0BDKwE" 0" 0" 0L / .X^^-- . . . RZ12: > > &&&"999(Z"###LB6T.0$0#0 $0 $ 0  $ 0  $ 0 $0 #0 #0 #0 #0 #0 #0 #0 #0  #!0" ##00$ #%0& #'0( #)0* #+0, $-0. $/00 #102 $304 $506 $708 $90: $;0< #=0> #?0@ #A0B #C0D #E00F     _000f~011 > HHyy/G/GHHH tCC l122&67788 AAAA,$$$$$ $$$:   kJ < < <."*GZ))   @"&4 ( ( ( ( 0LLLL4"*677>DLLLL^""""JWWWWv04"UBUBUBUBp    Ff@f@f@f@f@f@f@f@R"""""< s C C      r/