łň Je|Mc@sLdZddkZddkZddkZddklZyddklZWnej o dZnXddddd d d d d ddddddgZ dde d„Z ddd„Z e d„Ze d„Zd„Zd„Zd„Zdd„Zd e d!„Zd"„Zd#„Zd$„Zd%„Zd&d'„Zd&d(„ZdS()seFunctions that output text (not HTML). Helpers for filtering, formatting, and transforming strings. i˙˙˙˙N(t strip_tags(t unidecodetchop_attcollapsetconvert_accented_entitiestconvert_misc_entitiestexcerpttlchoptpluraltrchoptremove_formattingtreplace_whitespacetserieststrip_leading_whitespacettruncateturlifytwrap_paragraphsis...cCsĺ|pdSnt|ƒ|jo|Sn|t|ƒ}|p|| |Sn|}x.|djo ||iƒ o|d8}qZWx-|djo||iƒo|d8}q‹W|djo|| |Sn||d |S(syTruncate ``text`` with replacement characters. ``length`` The maximum length of ``text`` before replacement ``indicator`` If ``text`` exceeds the ``length``, this string will replace the end of the string ``whole_word`` If true, shorten the string further to avoid breaking a word in the middle. A word is defined as any string not containing whitespace. If the entire text before the break is a single word, it will have to be broken. Example:: >>> truncate('Once upon a time in a world far far away', 14) 'Once upon a...' tii(tlentisspace(ttexttlengtht indicatort whole_wordt short_lengthti((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/text.pyR%s" idcCsä| p| o|Sntid|ti|ƒ|ftiƒ}|i|ƒ}|pdSn|idƒ}|idƒdjo||}n|idƒt|ƒjo||}nt |dƒot t ƒSn|SdS(soExtract an excerpt from the ``text``, or '' if the phrase isn't found. ``phrase`` Phrase to excerpt from ``text`` ``radius`` How many surrounding characters to include ``excerpt_string`` Characters surrounding entire excerpt Example:: >>> excerpt("hello my world", "my", 3) '...lo my wo...' s(.{0,%s}%s.{0,%s})Rs\1iit__html__N( tretcompiletescapetItsearchtexpandtstarttendRthasattrtliteraltexcertp(Rtphrasetradiustexcerpt_stringtpattmatchR((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/text.pyRNscCs>|djo |}n|}|od||fSn|SdS(sKReturn the singular or plural form of a word, according to the number. If ``with_number`` is true (default), the return value will be the number followed by the word. Otherwise the word alone will be returned. Usage: >>> plural(2, "ox", "oxen") '2 oxen' >>> plural(2, "ox", "oxen", False) 'oxen' is%s %sN((tntsingularRt with_numbertform((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/text.pyRrs  cCsI|i|ƒ}|djo|Sn|o||t|ƒ Sn|| S(sTruncate string ``s`` at the first occurence of ``sub``. If ``inclusive`` is true, truncate just after ``sub`` rather than at it. >>> chop_at("plutocratic brats", "rat") 'plutoc' >>> chop_at("plutocratic brats", "rat", True) 'plutocrat' i˙˙˙˙(tfindR(tstsubt inclusivetpos((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/text.pyRˆs  cCs(|i|ƒo|t|ƒ}n|S(sRChop ``sub`` off the front of ``s`` if present. >>> lchop("##This is a comment.##", "##") 'This is a comment.##' The difference between ``lchop`` and ``s.lstrip`` is that ``lchop`` strips only the exact prefix, while ``s.lstrip`` treats the argument as a set of leading characters to delete regardless of order. (t startswithR(R0R1((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/text.pyR™s cCs)|i|ƒo|t|ƒ }n|S(sUChop ``sub`` off the end of ``s`` if present. >>> rchop("##This is a comment.##", "##") '##This is a comment.' The difference between ``rchop`` and ``s.rstrip`` is that ``rchop`` strips only the exact suffix, while ``s.rstrip`` treats the argument as a set of trailing characters to delete regardless of order. (tendswithR(R0R1((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/text.pyR §s cCs=g}|itƒD]}||iƒq~}di|ƒS(s˛Strip the leading whitespace in all lines in ``s``. This deletes *all* leading whitespace. ``textwrap.dedent`` deletes only the whitespace common to all lines. R(t splitlinestTruetlstriptjoin(R0t_[1]txtret((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/text.pyR ľs0iHc Cs4t|tiƒo |}ntid|ƒ}g}|itƒ}t|ƒ}d}d}xČ||joşt||ƒ|jo"|i||ƒ|d7}q_n|d}x.||jo ||iƒ o|d7}q˛Wdi |||!ƒ}|i |ƒd}|i|ƒ|}d}q_Wdi |ƒS(sWrap all paragraphs in a text string to the specified width. ``width`` may be an int or a ``textwrap.TextWrapper`` instance. The latter allows you to set other options besides the width, and is more efficient when wrapping many texts. twidthiiRs N( t isinstancettextwrapt TextWrapperR6R7RtNonetappendRR9tfill( RR=twrappertresulttlinest lines_lenR!R"t paragraph((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/text.pyRžs0       tandcCs˘t|ƒ}t|ƒ}|djodSn|djo |dSn|djo t}ndi|d ƒ}|d}|odpd}d||||fS( sgJoin strings using commas and a conjunction such as "and" or "or". Examples: >>> series(["A", "B", "C"]) 'A, B, and C' >>> series(["A", "B", "C"], "or") 'A, B, or C' >>> series(["A", "B", "C"], strict_commas=False) 'A, B and C' >>> series(["A", "B"]) 'A and B' >>> series(["A"]) 'A' >>> series([]) '' iRiis, i˙˙˙˙t,s %s%s %s %s(tlistRtFalseR9(titemst conjunctiont strict_commasRtnonlasttlasttcomma((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/text.pyR ŕs        cCs=t|ƒiƒ}t|dƒ}t|dƒ}ti|ƒS(s^Create a URI-friendly representation of the string Can be called manually in order to generate an URI-friendly version of any string. If the ``unidecode`` package is installed, it will also transliterate non-ASCII Unicode characters to their nearest pronounciation equivalent in ASCII. Examples:: >>> urlify("Mighty Mighty Bosstones") 'mighty-mighty-bosstones' Based on Ruby's stringex package (http://github.com/rsl/stringex/tree/master) Changed in WebHelpers 1.2: urlecode the result in case it contains special characters like "?". t-(R tlowerR Rturllibtquote(tstringR0((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/text.pyR˙scCsEt|ƒ}t|ƒ}t|ƒ}tot|ƒ}nt|ƒS(sJSimplify HTML text by removing tags and several kinds of formatting. If the ``unidecode`` package is installed, it will also transliterate non-ASCII Unicode characters to their nearest pronounciation equivalent in ASCII. Based on Ruby's stringex package (http://github.com/rsl/stringex/tree/master) (RRRRR(RWR0((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/text.pyR s   cCstidd|ƒS(s˜Converts HTML entities into the respective non-accented letters. Examples:: >>> convert_accented_entities("á") 'a' >>> convert_accented_entities("ç") 'c' >>> convert_accented_entities("è") 'e' >>> convert_accented_entities("î") 'i' >>> convert_accented_entities("ø") 'o' >>> convert_accented_entities("ü") 'u' Note: This does not do any conversion of Unicode/ASCII accented-characters. For that functionality please use unidecode. Based on Ruby's stringex package (http://github.com/rsl/stringex/tree/master) s:\&([A-Za-z])(grave|acute|circ|tilde|uml|ring|cedil|slash);s\1(RR1(RW((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/text.pyR,s cCsúhdd<dd<dd<dd<d d <d d <d d<dd<dd<dd<dd<dd<dd<dd<dd<dd <d!d"<d#d$<d%d&<}x3|iƒD]%\}}tid'|||ƒ}qžWtid(d)|ƒS(*s@Converts HTML entities (taken from common Textile formattings) into plain text formats Note: This isn't an attempt at complete conversion of HTML entities, just those most likely to be generated by Textile. Based on Ruby's stringex package (http://github.com/rsl/stringex/tree/master) s"s#822[01]t's#821[67]s...s#8230RSs#8211s--s#8212R;s#215t>tgtt>> replace_whitespace("Foo bar") 'Foo bar' >>> replace_whitespace("Foo bar", "-") 'Foo-bar' Based on Ruby's stringex package (http://github.com/rsl/stringex/tree/master) s\s+(RR1(RWtreplace((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/text.pyR ŹscCs/tid|ƒ}ti|||i|ƒƒS(sçRemoves specified character from the beginning and/or end of the string and then condenses runs of the character within the string. Based on Ruby's stringex package (http://github.com/rsl/stringex/tree/master) s(%s){2,}(RRR1tstrip(RWt charactertreg((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/text.pyRźs(t__doc__RR?RUtwebhelpers.html.toolsRRt ImportErrorRAt__all__RLRRR7RRRR R RR RR RRR R(((s_/afs/athena.mit.edu/user/x/a/xavid/Public/bazki/lib/WebHelpers-1.2-py2.5.egg/webhelpers/text.pyssL     )$     "    d