/h= SrSSKrSSKJr SSKrSSKJr SrSrSr Sr \\S S S S S S\ S4 r \ S\ /\ SSQ7r \R"S5r\R"\\R\R -\R"-5r\R"S5r\R"S5rSSjrSSjr"SS\5rSrSrSSjrg)a Twitter-aware tokenizer, designed to be flexible and easy to adapt to new domains and tasks. The basic logic is this: 1. The tuple REGEXPS defines a list of regular expression strings. 2. The REGEXPS strings are put, in order, into a compiled regular expression object called WORD_RE, under the TweetTokenizer class. 3. The tokenization is done by WORD_RE.findall(s), where s is the user-supplied string, inside the tokenize() method of the class TweetTokenizer. 4. When instantiating Tokenizer objects, there are several options: * preserve_case. By default, it is set to True. If it is set to False, then the tokenizer will downcase everything except for emoticons. * reduce_len. By default, it is set to False. It specifies whether to replace repeated character sequences of length 3 or greater with sequences of length 3. * strip_handles. By default, it is set to False. It specifies whether to remove Twitter handles of text used in the `tokenize` method. * match_phone_numbers. By default, it is set to True. It indicates whether the `tokenize` method should look for phone numbers. N)List) TokenizerIac (?: [<>]? [:;=8] # eyes [\-o\*\']? # optional nose [\)\]\(\[dDpP/\:\}\{@\|\\] # mouth | [\)\]\(\[dDpP/\:\}\{@\|\\] # mouth [\-o\*\']? # optional nose [:;=8] # eyes [<>]? | {}\[\]]+ # Run of non-space, non-()<>{}[] | # or \([^\s()]*?\([^\s()]+\)[^\s()]*?\) # balanced parens, one level deep: (...(...)...) | \([^\s]+?\) # balanced parens, non-recursive: (...) )+ (?: # End with: \([^\s()]*?\([^\s()]+\)[^\s()]*?\) # balanced parens, one level deep: (...(...)...) | \([^\s]+?\) # balanced parens, non-recursive: (...) | # or [^\s`!()\[\]{};:'".,<>?«»“”‘’] # not a space or one of these punct chars ) | # OR, the following to match naked domains: (?: (?\s]+>z [\-]+>|<[\-]+z (?:@[\w_]+)z(?:\#+[\w_]+[\w\'_\-]*[\w_]+)z#[\w.+-]+@[\w-]+\.(?:[\w-]\.?)+[\w-]uR.(?: [🏻-🏿]?(?:‍.[🏻-🏿]?)+ | [🏻-🏿] )a (?:[^\W\d_](?:[^\W\d_]|['\-_])+[^\W\d_]) # Words with apostrophes or dashes. | (?:[+\-]?\d+[,/.:-]\d+[+\-]?) # Numbers, including fractions, decimals. | (?:[\w_]+) # Words without apostrophes or dashes. | (?:\.(?:\s*\.){1,}) # Ellipsis dots. | (?:\S) # Everything else that isn't whitespace. z([^a-zA-Z0-9])\1{3,}z&(#?(x?))([^&;\s]+);zZ(?>> from nltk.tokenize.casual import _replace_html_entities >>> _replace_html_entities(b'Price: £100') 'Price: \xa3100' >>> print(_replace_html_entities(b'Price: £100')) Price: £100 >>> c,>URS5nURS5(a\URS5(a [US5nO [US5nSUs=::aS::aO O\[U45RS5$O@UT;aURS 5$[ R RRU5nUb [U5$T(aS $URS 5$![a SnN7f=f![[4a N>f=f) Nr cp1252r) groupintr r ValueErrorhtmlentitiesname2codepointgetchr OverflowError)match entity_bodynumberkeepremove_illegals r_convert_entity/_replace_html_entities.._convert_entityskk!n ;;q>> ;;q>> b1F b1F 6)T) &+228<<* d"{{1~%]]1155kBF   6{"$r7Q7   .  s)>C.)C. D. C=<C=DD)ENT_REsubr)r r'r(r r)s `` r_replace_html_entitiesr-s 888 ::ot'F GGrcr\rSrSrSrSrSrS SjrS\S\ \4Sjr \ S Sj5r \ S S j5r S rg) TweetTokenizeri2a Tokenizer for tweets. >>> from nltk.tokenize import TweetTokenizer >>> tknzr = TweetTokenizer() >>> s0 = "This is a cooool #dummysmiley: :-) :-P <3 and some arrows < > -> <--" >>> tknzr.tokenize(s0) # doctest: +NORMALIZE_WHITESPACE ['This', 'is', 'a', 'cooool', '#dummysmiley', ':', ':-)', ':-P', '<3', 'and', 'some', 'arrows', '<', '>', '->', '<--'] Examples using `strip_handles` and `reduce_len parameters`: >>> tknzr = TweetTokenizer(strip_handles=True, reduce_len=True) >>> s1 = '@remy: This is waaaaayyyy too much for you!!!!!!' >>> tknzr.tokenize(s1) [':', 'This', 'is', 'waaayyy', 'too', 'much', 'for', 'you', '!', '!', '!'] Nc4XlX lX0lX@lg)a Create a `TweetTokenizer` instance with settings for use in the `tokenize` method. :param preserve_case: Flag indicating whether to preserve the casing (capitalisation) of text used in the `tokenize` method. Defaults to True. :type preserve_case: bool :param reduce_len: Flag indicating whether to replace repeated character sequences of length 3 or greater with sequences of length 3. Defaults to False. :type reduce_len: bool :param strip_handles: Flag indicating whether to remove Twitter handles of text used in the `tokenize` method. Defaults to False. :type strip_handles: bool :param match_phone_numbers: Flag indicating whether the `tokenize` method should look for phone numbers. Defaults to True. :type match_phone_numbers: bool N preserve_case reduce_len strip_handlesmatch_phone_numbers)selfr2r3r4r5s r__init__TweetTokenizer.__init__Ls.+$*#6 rr returnc[U5nUR(a [U5nUR(a [ U5n[ R SU5nUR(aURRU5nOURRU5nUR(d[[SU55nU$)zTokenize the input text. :param text: str :rtype: list(str) :return: a tokenized list of strings; joining this list returns the original string if `preserve_case=False`. \1\1\1cZ[RU5(aU$UR5$)N) EMOTICON_REsearchlower)xs r)TweetTokenizer.tokenize..s"K$6$6q$9$9qHqwwyHr)r-r4remove_handlesr3reduce_lengtheningHANG_REr,r5 PHONE_WORD_REfindallWORD_REr2listmap)r6r safe_textwordss rtokenizeTweetTokenizer.tokenizehs&d+   !$'D ??%d+DKK 40  # #&&..y9ELL((3E!!H5QE rc8[U5R(dl[R"SSR [ 5S3[R [R-[R-5[U5l[U5R$)zCore TweetTokenizer regex(|)) type_WORD_REregexcompilejoinREGEXPSVERBOSEIUNICODEr6s rrHTweetTokenizer.WORD_REsgDz"""'--CHHW%&a( '%--7#DJ Dz"""rc8[U5R(dl[R"SSR [ 5S3[R [R-[R-5[U5l[U5R$)z#Secondary core TweetTokenizer regexrPrQrR) rS_PHONE_WORD_RErUrVrW REGEXPS_PHONErYrZr[r\s rrFTweetTokenizer.PHONE_WORD_REsgDz(((- CHH]+,A. '%--7)DJ %Dz(((r)r5r2r3r4TFFT)r9z regex.Pattern)__name__ __module__ __qualname____firstlineno____doc__rTr_r7strrrMpropertyrHrF__static_attributes__rrr/r/2se(HN  78ST#Y<##))rr/cR[R"S5nURSU5$)zY Replace repeated character sequences of length 3 or greater with sequences of length 3. z (.)\1{2,}r;)rUrVr,)r patterns rrDrDs# mmL)G ;;y$ ''rc.[RSU5$)z, Remove Twitter username handles from text.  ) HANDLES_REr,)r s rrCrCs >>#t $$rc8[UUUUS9RU5$)z2 Convenience function for wrapping the tokenizer. r1)r/rM)r r2r3r4r5s rcasual_tokenizerrs( ##/   htn r)Nstrict)rkTrrb)rgrtypingrrUnltk.tokenize.apir EMOTICONSURLSFLAGS PHONE_REGEXrXr`rVrErYrZr[r=r+rprr-r/rDrCrrrkrrrzs@  ($ $)f   $  (.   /" J[7712;7  --/ 0mmIu}}uww'>'NO  . /]]H 8H|h)Zh)`(% r