o rZh@srdZddlmZmZddlmZmZGdddeZGdddeZGdd d eZ Gd d d eZ dd dZ dS)a Simple Tokenizers These tokenizers divide strings into substrings using the string ``split()`` method. When tokenizing using a particular delimiter string, use the string ``split()`` method directly, as this is more efficient. The simple tokenizers are *not* available as separate functions; instead, you should just use the string ``split()`` method directly: >>> s = "Good muffins cost $3.88\nin New York. Please buy me\ntwo of them.\n\nThanks." >>> s.split() # doctest: +NORMALIZE_WHITESPACE ['Good', 'muffins', 'cost', '$3.88', 'in', 'New', 'York.', 'Please', 'buy', 'me', 'two', 'of', 'them.', 'Thanks.'] >>> s.split(' ') # doctest: +NORMALIZE_WHITESPACE ['Good', 'muffins', 'cost', '$3.88\nin', 'New', 'York.', '', 'Please', 'buy', 'me\ntwo', 'of', 'them.\n\nThanks.'] >>> s.split('\n') # doctest: +NORMALIZE_WHITESPACE ['Good muffins cost $3.88', 'in New York. Please buy me', 'two of them.', '', 'Thanks.'] The simple tokenizers are mainly useful because they follow the standard ``TokenizerI`` interface, and so can be used with any code that expects a tokenizer. For example, these tokenizers can be used to specify the tokenization conventions when building a `CorpusReader`. )StringTokenizer TokenizerI)regexp_span_tokenizestring_span_tokenizec@eZdZdZdZdS)SpaceTokenizeraTokenize a string using the space character as a delimiter, which is the same as ``s.split(' ')``. >>> from nltk.tokenize import SpaceTokenizer >>> s = "Good muffins cost $3.88\nin New York. Please buy me\ntwo of them.\n\nThanks." >>> SpaceTokenizer().tokenize(s) # doctest: +NORMALIZE_WHITESPACE ['Good', 'muffins', 'cost', '$3.88\nin', 'New', 'York.', '', 'Please', 'buy', 'me\ntwo', 'of', 'them.\n\nThanks.']  N__name__ __module__ __qualname____doc___stringrrC/var/www/auris/lib/python3.10/site-packages/nltk/tokenize/simple.pyr*s rc@r) TabTokenizerzTokenize a string use the tab character as a delimiter, the same as ``s.split('\t')``. >>> from nltk.tokenize import TabTokenizer >>> TabTokenizer().tokenize('a\tb c\n\t d') ['a', 'b c\n', ' d']  Nr rrrrr8src@s$eZdZdZdZddZddZdS) CharTokenizerzTokenize a string into individual characters. If this functionality is ever required directly, use ``for char in string``. NcCst|SN)listselfsrrrtokenizeKszCharTokenizer.tokenizeccs"ttdt|dEdHdS)N) enumeraterangelenrrrr span_tokenizeNs zCharTokenizer.span_tokenize)r r r r rrrrrrrrDs  rc@s*eZdZdZd ddZddZddZd S) LineTokenizeraTokenize a string into its lines, optionally discarding blank lines. This is similar to ``s.split('\n')``. >>> from nltk.tokenize import LineTokenizer >>> s = "Good muffins cost $3.88\nin New York. Please buy me\ntwo of them.\n\nThanks." >>> LineTokenizer(blanklines='keep').tokenize(s) # doctest: +NORMALIZE_WHITESPACE ['Good muffins cost $3.88', 'in New York. Please buy me', 'two of them.', '', 'Thanks.'] >>> # same as [l for l in s.split('\n') if l.strip()]: >>> LineTokenizer(blanklines='discard').tokenize(s) # doctest: +NORMALIZE_WHITESPACE ['Good muffins cost $3.88', 'in New York. Please buy me', 'two of them.', 'Thanks.'] :param blanklines: Indicates how blank lines should be handled. Valid values are: - ``discard``: strip blank lines out of the token list before returning it. A line is considered blank if it contains only whitespace characters. - ``keep``: leave all blank lines in the token list. - ``discard-eof``: if the string ends with a newline, then do not generate a corresponding token ``''`` after that newline. discardcCs(d}||vrtdd|||_dS)N)r keep discard-eofzBlank lines must be one of: %sr) ValueErrorjoin _blanklines)r blanklinesZvalid_blanklinesrrr__init__is   zLineTokenizer.__init__cCsJ|}|jdkrdd|D}|S|jdkr#|r#|ds#||S)Nr cSsg|]}|r|qSr)rstrip).0lrrr vsz*LineTokenizer.tokenize..r") splitlinesr%strippop)rrlinesrrrrrs  zLineTokenizer.tokenizeccs4|jdkrt|dEdHdSt|dEdHdS)Nr!z\nz \n(\s+\n)*)r%rrrrrrr}s zLineTokenizer.span_tokenizeNr )r r r r r'rrrrrrrRs   rr cCst||Sr)rr)textr&rrr line_tokenizesr3Nr1) r Znltk.tokenize.apirrZnltk.tokenize.utilrrrrrrr3rrrrs 8