a oe<@slddlZddlZddlZddlZzddlmZWneyNddlmZYn0ddlm Z m Z ddl m Z ddZ ddZGd d d eZe eZejd d Zd dZddZddZddZGdddeZd2ddZGdddeZejZddZ GdddeZ!Gd d!d!Z"d"d#Z#d$d%Z$d&d'Z%d(d)Z&ej'd*d+Z(e()ed,d-Z*d.d/Z+d0d1Z,dS)3N)files)compose method_cache) ExceptionTrapcsfddS)zH Return a function that will perform a substitution on a string cs |SNreplacesnewoldHC:\Program Files\Certbot\pkgs\setuptools\_vendor\jaraco\text\__init__.pyzsubstitution..r)r r rr r substitutionsrcGs tt|}tt|}t|S)z Take a sequence of pairs specifying substitutions, and create a function that performs those substitutions. >>> multi_substitution(('foo', 'bar'), ('bar', 'baz'))('foo') 'baz' ) itertoolsstarmaprreversedtupler)Z substitutionsrrrmulti_substitutions  rcsreZdZdZddZddZddZdd Zd d Zfd d Z ddZ e fddZ ddZ dddZZS) FoldedCasea A case insensitive string class; behaves just like str except compares equal when the only variation is case. >>> s = FoldedCase('hello world') >>> s == 'Hello World' True >>> 'Hello World' == s True >>> s != 'Hello World' False >>> s.index('O') 4 >>> s.split('O') ['hell', ' w', 'rld'] >>> sorted(map(FoldedCase, ['GAMMA', 'alpha', 'Beta'])) ['alpha', 'Beta', 'GAMMA'] Sequence membership is straightforward. >>> "Hello World" in [s] True >>> s in ["Hello World"] True You may test for set inclusion, but candidate and elements must both be folded. >>> FoldedCase("Hello World") in {s} True >>> s in {FoldedCase("Hello World")} True String inclusion works as long as the FoldedCase object is on the right. >>> "hello" in FoldedCase("Hello World") True But not if the FoldedCase object is on the left: >>> FoldedCase('hello') in 'Hello World' False In that case, use ``in_``: >>> FoldedCase('hello').in_('Hello World') True >>> FoldedCase('hello') > FoldedCase('Hello') False cCs||kSrlowerselfotherrrr__lt__aszFoldedCase.__lt__cCs||kSrrrrrr__gt__dszFoldedCase.__gt__cCs||kSrrrrrr__eq__gszFoldedCase.__eq__cCs||kSrrrrrr__ne__jszFoldedCase.__ne__cCs t|Sr)hashrrrrr__hash__mszFoldedCase.__hash__cst|Sr)superr __contains__r __class__rrr&pszFoldedCase.__contains__cCs |t|vS)zDoes self appear in other?)rrrrrin_sszFoldedCase.in_cs tSr)r%rr#r'rrrxszFoldedCase.lowercCs||Sr)rindex)rsubrrrr*|szFoldedCase.index rcCs tt|tj}|||Sr)recompileescapeIsplit)rZsplittermaxsplitpatternrrrr1szFoldedCase.split)r,r)__name__ __module__ __qualname____doc__rrr r!r$r&r)rrr*r1 __classcell__rrr'rr%s; rcCs |dS)z Return True if the supplied value is decodable (using the default encoding). >>> is_decodable(b'\xff') False >>> is_decodable(b'\x32') True N)decodevaluerrr is_decodables r<cCst|tot| S)z Return True if the value appears to be binary (that is, it's a byte string and isn't decodable). >>> is_binary(b'\xff') True >>> is_binary('\xff') False ) isinstancebytesr<r:rrr is_binarys r?cCst|S)z Trim something like a docstring to remove the whitespace that is common due to indentation and formatting. >>> trim("\n\tfoo = bar\n\t\tbar = baz\n") 'foo = bar\n\tbar = baz' )textwrapdedentstripr rrrtrimsrCcCs |}dd|D}d|S)a  Wrap lines of text, retaining existing newlines as paragraph markers. >>> print(wrap(lorem_ipsum)) Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst. css|]}dt|VqdS) N)joinr@wrap.0Zpararrr rzwrap..z ) splitlinesrE)r paragraphswrappedrrrrFsrFcCs$td|}dd|D}d|S)ad Given a multi-line string, return an unwrapped version. >>> wrapped = wrap(lorem_ipsum) >>> wrapped.count('\n') 20 >>> unwrapped = unwrap(wrapped) >>> unwrapped.count('\n') 1 >>> print(unwrapped) Lorem ipsum dolor sit amet, consectetur adipiscing ... Curabitur pretium tincidunt lacus. Nulla gravida orci ... z\n\n+css|]}|ddVqdS)rDr,NrrGrrrrIrzunwrap..rD)r-r1rE)r rKZcleanedrrrunwraps rMc@s eZdZdZddZddZdS)Splitterzobject that will split a string with the given arguments for each call >>> s = Splitter(',') >>> s('hello, world, this is your, master calling') ['hello', ' world', ' this is your', ' master calling'] cGs ||_dSr)args)rrOrrr__init__szSplitter.__init__cCs |j|jSr)r1rO)rr rrr__call__szSplitter.__call__N)r4r5r6r7rPrQrrrrrNsrN cCs||S)z) >>> indent('foo') ' foo' r)stringprefixrrrindentsrUcseZdZdZedZddZddZddZ d d Z d d Z d dZ ddZ ddZddZddZfddZeddZeddZZS)WordSeta Given an identifier, return the words that identifier represents, whether in camel case, underscore-separated, etc. >>> WordSet.parse("camelCase") ('camel', 'Case') >>> WordSet.parse("under_sep") ('under', 'sep') Acronyms should be retained >>> WordSet.parse("firstSNL") ('first', 'SNL') >>> WordSet.parse("you_and_I") ('you', 'and', 'I') >>> WordSet.parse("A simple test") ('A', 'simple', 'test') Multiple caps should not interfere with the first cap of another word. >>> WordSet.parse("myABCClass") ('my', 'ABC', 'Class') The result is a WordSet, so you can get the form you need. >>> WordSet.parse("myABCClass").underscore_separated() 'my_ABC_Class' >>> WordSet.parse('a-command').camel_case() 'ACommand' >>> WordSet.parse('someIdentifier').lowered().space_separated() 'some identifier' Slices of the result should return another WordSet. >>> WordSet.parse('taken-out-of-context')[1:].underscore_separated() 'out_of_context' >>> WordSet.from_class_name(WordSet()).lowered().space_separated() 'word set' >>> example = WordSet.parse('figured it out') >>> example.headless_camel_case() 'figuredItOut' >>> example.dash_separated() 'figured-it-out' z ([A-Z]?[a-z]+)|([A-Z]+(?![a-z]))cCstdd|DS)Ncss|]}|VqdSr) capitalizerHZwordrrrrI5rz&WordSet.capitalized..rVr#rrr capitalized4szWordSet.capitalizedcCstdd|DS)Ncss|]}|VqdSrrrXrrrrI8rz"WordSet.lowered..rYr#rrrlowered7szWordSet.loweredcCsd|SN)rErZr#rrr camel_case:szWordSet.camel_casecCs4t|}t|}t|ft|}d|Sr\)iternextrrchainrVr^rE)rwordsfirstZ new_wordsrrrheadless_camel_case=s zWordSet.headless_camel_casecCs d|S)N_rEr#rrrunderscore_separatedCszWordSet.underscore_separatedcCs d|S)N-rfr#rrrdash_separatedFszWordSet.dash_separatedcCs d|S)Nr,rfr#rrrspace_separatedIszWordSet.space_separatedcCs |r|d|kr|ddS|S)a  Remove the item from the end of the set. >>> WordSet.parse('foo bar').trim_right('foo') ('foo', 'bar') >>> WordSet.parse('foo bar').trim_right('bar') ('foo',) >>> WordSet.parse('').trim_right('bar') () Nrritemrrr trim_rightLs zWordSet.trim_rightcCs |r|d|kr|ddS|S)a Remove the item from the beginning of the set. >>> WordSet.parse('foo bar').trim_left('foo') ('bar',) >>> WordSet.parse('foo bar').trim_left('bar') ('foo', 'bar') >>> WordSet.parse('').trim_left('bar') () rNrrlrrr trim_leftYs zWordSet.trim_leftcCs|||S)zK >>> WordSet.parse('foo bar').trim('foo') ('bar',) )rprnrlrrrrCfsz WordSet.trimcs&tt||}t|tr"t|}|Sr)r%rV __getitem__r=slice)rrmresultr'rrrqms zWordSet.__getitem__cCs|j|}tdd|DS)Ncss|]}|dVqdS)rNgrouprHmatchrrrrIvrz WordSet.parse..)_patternfinditerrV)clsZ identifiermatchesrrrparsess z WordSet.parsecCs||jjSr)r|r(r4)rzZsubjectrrrfrom_class_namexszWordSet.from_class_name)r4r5r6r7r-r.rxrZr[r^rdrgrirjrnrprCrq classmethodr|r}r8rrr'rrVs"5     rVcCs,tdtj}dd||D}d|S)a Remove HTML from the string `s`. >>> str(simple_html_strip('')) '' >>> print(simple_html_strip('A stormy day in paradise')) A stormy day in paradise >>> print(simple_html_strip('Somebody tell the truth.')) Somebody tell the truth. >>> print(simple_html_strip('What about
\nmultiple lines?')) What about multiple lines? z()|(<[^>]*>)|([^<]+)css|]}|dpdVqdS)r]NrtrvrrrrIrz$simple_html_strip..r])r-r.DOTALLryrE)r Z html_stripperZtextsrrrsimple_html_stripsrc@seZdZdZdZddZdS)SeparatedValuesa A string separated by a separator. Overrides __iter__ for getting the values. >>> list(SeparatedValues('a,b,c')) ['a', 'b', 'c'] Whitespace is stripped and empty values are discarded. >>> list(SeparatedValues(' a, b , c, ')) ['a', 'b', 'c'] ,cCs ||j}tddd|DS)Ncss|]}|VqdSr)rB)rHpartrrrrIrz+SeparatedValues.__iter__..)r1 separatorfilter)rpartsrrr__iter__s zSeparatedValues.__iter__N)r4r5r6r7rrrrrrrs rc@s8eZdZdZddZeddZddZedd Z d S) Strippera& Given a series of lines, find the common prefix and strip it from them. >>> lines = [ ... 'abcdefg\n', ... 'abc\n', ... 'abcde\n', ... ] >>> res = Stripper.strip_prefix(lines) >>> res.prefix 'abc' >>> list(res.lines) ['defg\n', '\n', 'de\n'] If no prefix is common, nothing should be stripped. >>> lines = [ ... 'abcd\n', ... '1234\n', ... ] >>> res = Stripper.strip_prefix(lines) >>> res.prefix = '' >>> list(res.lines) ['abcd\n', '1234\n'] cCs||_t|||_dSr)rTmaplines)rrTrrrrrPszStripper.__init__cCs&t|\}}t|j|}|||Sr)rtee functoolsreduce common_prefix)rzrZ prefix_linesrTrrr strip_prefixszStripper.strip_prefixcCs |js |S||j\}}}|Sr)rT partition)rlinenullrTrestrrrrQszStripper.__call__cCs@tt|t|}|d||d|kr4|d8}q|d|S)z8 Return the common prefix of two lines. Nro)minlen)s1s2r*rrrrs zStripper.common_prefixN) r4r5r6r7rPr~rrQ staticmethodrrrrrrs rcCs||\}}}|S)z Remove the prefix from the text if it exists. >>> remove_prefix('underwhelming performance', 'underwhelming ') 'performance' >>> remove_prefix('something special', 'sample') 'something special' ) rpartition)textrTrrrrr remove_prefixs rcCs||\}}}|S)z Remove the suffix from the text if it exists. >>> remove_suffix('name.git', '.git') 'name' >>> remove_suffix('something special', 'sample') 'something special' r)rsuffixrrrrr remove_suffixs rcCs gd}d|}t|d|S)a  Replace alternate newlines with the canonical newline. >>> normalize_newlines('Lorem Ipsum\u2029') 'Lorem Ipsum\n' >>> normalize_newlines('Lorem Ipsum\r\n') 'Lorem Ipsum\n' >>> normalize_newlines('Lorem Ipsum\x85') 'Lorem Ipsum\n' )z  rD…u
u
|rD)rEr-r+)rnewlinesr3rrrnormalize_newliness  rcCs|o|d S)N#) startswith)strrrr _nonblanksrcCstjtt|S)a Yield valid lines of a string or iterable. >>> list(yield_lines('')) [] >>> list(yield_lines(['foo', 'bar'])) ['foo', 'bar'] >>> list(yield_lines('foo\nbar')) ['foo', 'bar'] >>> list(yield_lines('\nfoo\n#bar\nbaz #comment')) ['foo', 'baz #comment'] >>> list(yield_lines(['foo\nbar', 'baz', 'bing\n\n\n'])) ['foo', 'bar', 'baz', 'bing'] )rra from_iterabler yield_lines)iterablerrrrsrcCsttttj|Sr)rrrrrBrJ)rrrrre%srecCs|ddS)z Drop comments. >>> drop_comment('foo # bar') 'foo' A hash without a space may be in a URL. >>> drop_comment('http://example.com/foo#bar') 'http://example.com/foo#bar' z #rr)rrrr drop_comment*s rc cs\t|}|D]J}|drPz|ddt|}WqtyLYdS0q|Vq dS)a_ Join lines continued by a trailing backslash. >>> list(join_continuation(['foo \\', 'bar', 'baz'])) ['foobar', 'baz'] >>> list(join_continuation(['foo \\', 'bar', 'baz'])) ['foobar', 'baz'] >>> list(join_continuation(['foo \\', 'bar \\', 'baz'])) ['foobarbaz'] Not sure why, but... The character preceeding the backslash is also elided. >>> list(join_continuation(['goo\\', 'dly'])) ['godly'] A terrible idea, but... If no line is available to continue, suppress the lines. >>> list(join_continuation(['foo', 'bar\\', 'baz\\'])) ['foo'] \N)r_endswithrBr` StopIteration)rrmrrrjoin_continuation9s   r)rR)-r-rr@rZimportlib.resourcesr ImportErrorZ%setuptools.extern.importlib_resourcesZ"setuptools.extern.jaraco.functoolsrrZ setuptools.extern.jaraco.contextrrrrrUnicodeDecodeErrorZ _unicode_trapZpassesr<r?rCrFrMobjectrNrUrrVr|rbrrrrrrrsingledispatchrregisterrerrrrrrsJ  `   ! 6