"""Basic function to preprocess text before assembling it in a `DataLoaders`. Docs: https://docs.fast.ai/text.core.html.md""" # AUTOGENERATED! DO NOT EDIT! File to edit: ../../nbs/30_text.core.ipynb. # %% auto #0 __all__ = ['UNK', 'PAD', 'BOS', 'EOS', 'FLD', 'TK_REP', 'TK_WREP', 'TK_UP', 'TK_MAJ', 'WordTokenizer', 'fn_counter_pkl', 'fn_lengths_pkl', 'eu_langs', 'SubwordTokenizer', 'spec_add_spaces', 'rm_useless_spaces', 'replace_rep', 'replace_wrep', 'fix_html', 'replace_all_caps', 'replace_maj', 'lowercase', 'replace_space', 'BaseTokenizer', 'SpacyTokenizer', 'TokenizeWithRules', 'tokenize1', 'parallel_tokenize', 'tokenize_folder', 'tokenize_files', 'tokenize_texts', 'tokenize_df', 'tokenize_csv', 'load_tokenized_csv', 'Tokenizer', 'SentencePieceTokenizer'] # %% ../../nbs/30_text.core.ipynb #632f4956 from ..torch_basics import * from ..data.all import * from multiprocessing import get_context from concurrent.futures import as_completed # %% ../../nbs/30_text.core.ipynb #82f8f4b3 import html # %% ../../nbs/30_text.core.ipynb #4116cfe6 #special tokens UNK, PAD, BOS, EOS, FLD, TK_REP, TK_WREP, TK_UP, TK_MAJ = "xxunk xxpad xxbos xxeos xxfld xxrep xxwrep xxup xxmaj".split() # %% ../../nbs/30_text.core.ipynb #a5c23426 _all_ = ["UNK", "PAD", "BOS", "EOS", "FLD", "TK_REP", "TK_WREP", "TK_UP", "TK_MAJ"] # %% ../../nbs/30_text.core.ipynb #10423b42 _re_spec = re.compile(r'([/#\\])') def spec_add_spaces(t): "Add spaces around / and #" return _re_spec.sub(r' \1 ', t) # %% ../../nbs/30_text.core.ipynb #342cd27d _re_space = re.compile(' {2,}') def rm_useless_spaces(t): "Remove multiple spaces" return _re_space.sub(' ', t) # %% ../../nbs/30_text.core.ipynb #20a624fb _re_rep = re.compile(r'(\S)(\1{2,})') def replace_rep(t): "Replace repetitions at the character level: cccc -- TK_REP 4 c" def _replace_rep(m): c,cc = m.groups() return f' {TK_REP} {len(cc)+1} {c} ' return _re_rep.sub(_replace_rep, t) # %% ../../nbs/30_text.core.ipynb #f6e38021 _re_wrep = re.compile(r'(?:\s|^)(\w+)\s+((?:\1\s+)+)\1(\s|\W|$)') # %% ../../nbs/30_text.core.ipynb #7ecee575 def replace_wrep(t): "Replace word repetitions: word word word word -- TK_WREP 4 word" def _replace_wrep(m): c,cc,e = m.groups() return f' {TK_WREP} {len(cc.split())+2} {c} {e}' return _re_wrep.sub(_replace_wrep, t) # %% ../../nbs/30_text.core.ipynb #2b43950d def fix_html(x): "Various messy things we've seen in documents" x = x.replace('#39;', "'").replace('amp;', '&').replace('#146;', "'").replace('nbsp;', ' ').replace( '#36;', '$').replace('\\n', "\n").replace('quot;', "'").replace('
', "\n").replace( '\\"', '"').replace('',UNK).replace(' @.@ ','.').replace(' @-@ ','-').replace('...',' …') return html.unescape(x) # %% ../../nbs/30_text.core.ipynb #572218af _re_all_caps = re.compile(r'(\s|^)([A-Z]+[^a-z\s]*)(?=(\s|$))') # %% ../../nbs/30_text.core.ipynb #a938c285 def replace_all_caps(t): "Replace tokens in ALL CAPS by their lower version and add `TK_UP` before." def _replace_all_caps(m): tok = f'{TK_UP} ' if len(m.groups()[1]) > 1 else '' return f"{m.groups()[0]}{tok}{m.groups()[1].lower()}" return _re_all_caps.sub(_replace_all_caps, t) # %% ../../nbs/30_text.core.ipynb #29850f4f _re_maj = re.compile(r'(\s|^)([A-Z][^A-Z\s]*)(?=(\s|$))') # %% ../../nbs/30_text.core.ipynb #c2177810 def replace_maj(t): "Replace tokens in Sentence Case by their lower version and add `TK_MAJ` before." def _replace_maj(m): tok = f'{TK_MAJ} ' if len(m.groups()[1]) > 1 else '' return f"{m.groups()[0]}{tok}{m.groups()[1].lower()}" return _re_maj.sub(_replace_maj, t) # %% ../../nbs/30_text.core.ipynb #34e5abad def lowercase(t, add_bos=True, add_eos=False): "Converts `t` to lowercase" return (f'{BOS} ' if add_bos else '') + t.lower().strip() + (f' {EOS}' if add_eos else '') # %% ../../nbs/30_text.core.ipynb #c192a646 def replace_space(t): "Replace embedded spaces in a token with unicode line char to allow for split/join" return t.replace(' ', '▁') # %% ../../nbs/30_text.core.ipynb #c77dbdd9 defaults.text_spec_tok = [UNK, PAD, BOS, EOS, FLD, TK_REP, TK_WREP, TK_UP, TK_MAJ] defaults.text_proc_rules = [fix_html, replace_rep, replace_wrep, spec_add_spaces, rm_useless_spaces, replace_all_caps, replace_maj, lowercase] defaults.text_postproc_rules = [replace_space] # %% ../../nbs/30_text.core.ipynb #4bf29621 class BaseTokenizer(): "Basic tokenizer that just splits on spaces" def __init__(self, split_char=' ', **kwargs): self.split_char=split_char def __call__(self, items): return (t.split(self.split_char) for t in items) # %% ../../nbs/30_text.core.ipynb #57ee3427 class SpacyTokenizer(): "Spacy tokenizer for `lang`" def __init__(self, lang='en', special_toks=None, buf_sz=5000): import spacy from spacy.symbols import ORTH self.special_toks = ifnone(special_toks, defaults.text_spec_tok) nlp = spacy.blank(lang) for w in self.special_toks: nlp.tokenizer.add_special_case(w, [{ORTH: w}]) self.pipe,self.buf_sz = nlp.pipe,buf_sz def __call__(self, items): return (L(doc).attrgot('text') for doc in self.pipe(map(str,items), batch_size=self.buf_sz)) # %% ../../nbs/30_text.core.ipynb #d9b13d89 WordTokenizer = SpacyTokenizer # %% ../../nbs/30_text.core.ipynb #5d4e97ca class TokenizeWithRules: "A wrapper around `tok` which applies `rules`, then tokenizes, then applies `post_rules`" def __init__(self, tok, rules=None, post_rules=None): self.rules = L(ifnone(rules, defaults.text_proc_rules)) self.post_f = compose(*L(ifnone(post_rules, defaults.text_postproc_rules))) self.tok = tok def __call__(self, batch): return (L(o).map(self.post_f) for o in self.tok(maps(*self.rules, batch))) # %% ../../nbs/30_text.core.ipynb #4a82d24e @delegates(TokenizeWithRules) def tokenize1(text, tok, **kwargs): "Call `TokenizeWithRules` with a single text" return first(TokenizeWithRules(tok=tok, **kwargs)([text])) # %% ../../nbs/30_text.core.ipynb #9e8696ca _pg_obj = None def _pg_setup(cls, kwargs): "Build this process's `cls` instance (runs once per worker via `initializer`)" global _pg_obj _pg_obj = cls(**kwargs) def _pg_call(batch): return list(_pg_obj(batch)) # %% ../../nbs/30_text.core.ipynb #ec4f3c77 def parallel_tokenize(items, tok=None, rules=None, n_workers=defaults.cpus, progress=False, **kwargs): "Call optional `setup` on `tok`, then tokenize `items` with `TokenizeWithRules` in parallel, yielding unordered `(idx,toks)` pairs" if tok is None: tok = WordTokenizer() if hasattr(tok, 'setup'): tok.setup(items, rules) kwargs = dict(tok=tok, rules=rules, **kwargs) if not parallelable('n_workers', n_workers): n_workers = 0 if n_workers==0: yield from enumerate(list(TokenizeWithRules(**kwargs)(items))) return batches = L(chunked(items, n_chunks=n_workers)) idxs = L(itertools.accumulate(0 + batches.map(len))) ctx = get_context('fork') if sys.platform == 'darwin' else None with ProcessPoolExecutor(n_workers, mp_context=ctx, initializer=_pg_setup, initargs=(TokenizeWithRules, kwargs)) as ex: futs = {ex.submit(_pg_call, b): st for b,st in zip(batches, idxs)} it = as_completed(futs) if progress: from fastprogress import progress_bar it = progress_bar(it, total=len(futs), leave=False) for f in it: yield from enumerate(f.result(), futs[f]) # %% ../../nbs/30_text.core.ipynb #bd4f2f13 fn_counter_pkl = 'counter.pkl' fn_lengths_pkl = 'lengths.pkl' # %% ../../nbs/30_text.core.ipynb #5406c366 def _tokenize_files(func, files, path, output_dir=None, output_names=None, n_workers=defaults.cpus, rules=None, tok=None, encoding='utf8', skip_if_exists=False): "Tokenize text `files` in parallel using `n_workers`" if tok is None: tok = WordTokenizer() output_dir = Path(ifnone(output_dir, path.parent/f'{path.name}_tok')) if skip_if_exists and output_dir.exists(): return output_dir output_dir.mkdir(exist_ok=True) if output_names is None: output_names = L(output_dir/f.relative_to(path) for f in files) rules = partial(Path.read_text, encoding=encoding) + L(ifnone(rules, defaults.text_proc_rules.copy())) lengths,counter = {},Counter() for i,tok in parallel_tokenize(files, tok, rules, n_workers=n_workers): out = func(i,output_dir) out.mk_write(' '.join(tok), encoding=encoding) lengths[str(files[i].relative_to(path))] = len(tok) counter.update(tok) save_pickle(output_dir/fn_lengths_pkl, lengths) save_pickle(output_dir/fn_counter_pkl, counter) return output_dir # %% ../../nbs/30_text.core.ipynb #6b5f0975 @delegates(_tokenize_files) def tokenize_folder(path, extensions=None, folders=None, output_dir=None, skip_if_exists=True, **kwargs): "Tokenize text files in `path` in parallel using `n_workers`" path,extensions = Path(path),ifnone(extensions, ['.txt']) files = get_files(path, extensions=extensions, recurse=True, folders=folders) def _f(i,output_dir): return output_dir/files[i].relative_to(path) return _tokenize_files(_f, files, path, skip_if_exists=skip_if_exists, **kwargs) # %% ../../nbs/30_text.core.ipynb #429353d7 @delegates(_tokenize_files) def tokenize_files(files, path, output_dir, output_names=None, **kwargs): "Tokenize text `files` in parallel using `n_workers`" if output_names is None: output_names = L(output_dir/f.relative_to(path) for f in files) def _f(i,output_dir): return output_dir/output_names[i] return _tokenize_files(_f, files, path, output_dir=output_dir, **kwargs) # %% ../../nbs/30_text.core.ipynb #6e2d7f7a def _join_texts(df, mark_fields=False): "Join texts in row `idx` of `df`, marking each field with `FLD` if `mark_fields=True`" text_col = (f'{FLD} {1} ' if mark_fields else '' ) + df.iloc[:,0].astype(str) for i in range(1,len(df.columns)): text_col += (f' {FLD} {i+1} ' if mark_fields else ' ') + df.iloc[:,i].astype(str) return text_col.values # %% ../../nbs/30_text.core.ipynb #e976b8ab def tokenize_texts(texts, n_workers=defaults.cpus, rules=None, tok=None): "Tokenize `texts` in parallel using `n_workers`" rules = L(ifnone(rules, defaults.text_proc_rules.copy())) outputs = L(parallel_tokenize(texts, tok=tok, rules=rules, n_workers=n_workers) ).sorted().itemgot(1) return outputs # %% ../../nbs/30_text.core.ipynb #0be3f7d9 def tokenize_df(df, text_cols, n_workers=defaults.cpus, rules=None, mark_fields=None, tok=None, tok_text_col="text"): "Tokenize texts in `df[text_cols]` in parallel using `n_workers` and stores them in `df[tok_text_col]`" text_cols = [df.columns[c] if isinstance(c, int) else c for c in L(text_cols)] #mark_fields defaults to False if there is one column of texts, True if there are multiple if mark_fields is None: mark_fields = len(text_cols)>1 rules = L(ifnone(rules, defaults.text_proc_rules.copy())) texts = _join_texts(df[text_cols], mark_fields=mark_fields) outputs = L(parallel_tokenize(texts, tok, rules, n_workers=n_workers) ).sorted().itemgot(1) other_cols = df.columns[~df.columns.isin(text_cols)] res = df[other_cols].copy() res[tok_text_col] = outputs res[f'{tok_text_col}_length'] = [len(o) for o in outputs] return res,Counter(outputs.concat()) # %% ../../nbs/30_text.core.ipynb #33f20169 def tokenize_csv(fname, text_cols, outname=None, n_workers=4, rules=None, mark_fields=None, tok=None, header='infer', chunksize=50000): "Tokenize texts in the `text_cols` of the csv `fname` in parallel using `n_workers`" df = pd.read_csv(fname, header=header, chunksize=chunksize) outname = Path(ifnone(outname, fname.parent/f'{fname.stem}_tok.csv')) cnt = Counter() for i,dfp in enumerate(df): out,c = tokenize_df(dfp, text_cols, n_workers=n_workers, rules=rules, mark_fields=mark_fields, tok=tok) out.text = out.text.str.join(' ') out.to_csv(outname, header=(None,header)[i==0], index=False, mode=('a','w')[i==0]) cnt.update(c) save_pickle(outname.with_suffix('.pkl'), cnt) # %% ../../nbs/30_text.core.ipynb #ddee3fe4 def load_tokenized_csv(fname): "Utility function to quickly load a tokenized csv ans the corresponding counter" fname = Path(fname) out = pd.read_csv(fname) for txt_col in out.columns[1:-1]: out[txt_col] = tuple(out[txt_col].str.split(' ')) return out,load_pickle(fname.with_suffix('.pkl')) # %% ../../nbs/30_text.core.ipynb #b1be4363 class Tokenizer(Transform): "Provides a consistent `Transform` interface to tokenizers operating on `DataFrame`s and folders" input_types = (str, list, L, tuple, Path) def __init__(self, tok, rules=None, counter=None, lengths=None, mode=None, sep=' '): if isinstance(tok,type): tok=tok() store_attr('tok,counter,lengths,mode,sep') self.rules = defaults.text_proc_rules if rules is None else rules @classmethod @delegates(tokenize_df, keep=True) def from_df(cls, text_cols, tok=None, rules=None, sep=' ', **kwargs): if tok is None: tok = WordTokenizer() res = cls(tok, rules=rules, mode='df') res.kwargs,res.train_setup = merge({'tok': tok}, kwargs),False res.text_cols,res.sep = text_cols,sep default_val = inspect.signature(tokenize_df).parameters['tok_text_col'].default res.tok_text_col = kwargs.get('tok_text_col', default_val) return res @classmethod @delegates(tokenize_folder, keep=True) def from_folder(cls, path, tok=None, rules=None, **kwargs): path = Path(path) if tok is None: tok = WordTokenizer() output_dir = tokenize_folder(path, tok=tok, rules=rules, **kwargs) res = cls(tok, counter=load_pickle(output_dir/fn_counter_pkl), lengths=load_pickle(output_dir/fn_lengths_pkl), rules=rules, mode='folder') res.path,res.output_dir = path,output_dir return res def setups(self, dsets): if not self.mode == 'df' or not isinstance(dsets.items, pd.DataFrame): return dsets.items,count = tokenize_df(dsets.items, self.text_cols, rules=self.rules, **self.kwargs) if self.counter is None: self.counter = count if self.lengths is None: self.lengths = dsets.items[f'{self.tok_text_col}_length'].values return dsets def encodes(self, o:Path): if self.mode=='folder' and str(o).startswith(str(self.path)): tok = self.output_dir/o.relative_to(self.path) return L(tok.read_text(encoding='UTF-8').split(' ')) else: return self._tokenize1(o.read_text()) def encodes(self, o:str): return self._tokenize1(o) def _tokenize1(self, o): return first(self.tok([compose(*self.rules)(o)])) def get_lengths(self, items): if self.lengths is None: return None if self.mode == 'df': if isinstance(items, pd.DataFrame) and f'{self.tok_text_col}_length' in items.columns: return items[f'{self.tok_text_col}_length'].values if self.mode == 'folder': try: res = [self.lengths[str(Path(i).relative_to(self.path))] for i in items] if len(res) == len(items): return res except: return None def decodes(self, o): return TitledStr(self.sep.join(o)) # %% ../../nbs/30_text.core.ipynb #acd353be eu_langs = ["bg", "cs", "da", "de", "el", "en", "es", "et", "fi", "fr", "ga", "hr", "hu", "it","lt","lv","mt","nl","pl","pt","ro","sk","sl","sv"] # all European langs # %% ../../nbs/30_text.core.ipynb #c0fef4e9 class SentencePieceTokenizer():#TODO: pass the special tokens symbol to sp "SentencePiece tokenizer for `lang`" def __init__(self, lang='en', special_toks=None, sp_model=None, vocab_sz=None, max_vocab_sz=30000, model_type='unigram', char_coverage=None, cache_dir='tmp'): try: from sentencepiece import SentencePieceTrainer,SentencePieceProcessor except ImportError: raise Exception('sentencepiece module is missing: run `pip install sentencepiece!=0.1.90,!=0.1.91`') self.sp_model,self.cache_dir = sp_model,Path(cache_dir) self.vocab_sz,self.max_vocab_sz,self.model_type = vocab_sz,max_vocab_sz,model_type self.char_coverage = ifnone(char_coverage, 0.99999 if lang in eu_langs else 0.9998) self.special_toks = ifnone(special_toks, defaults.text_spec_tok) if sp_model is None: self.tok = None else: self.tok = SentencePieceProcessor() self.tok.Load(str(sp_model)) os.makedirs(self.cache_dir, exist_ok=True) def _get_vocab_sz(self, raw_text_path): cnt = Counter() with open(raw_text_path, 'r') as f: for line in f.readlines(): cnt.update(line.split()) if len(cnt)//4 > self.max_vocab_sz: return self.max_vocab_sz res = len(cnt)//4 while res%8 != 0: res+=1 return max(res,29) def train(self, raw_text_path): "Train a sentencepiece tokenizer on `texts` and save it in `path/tmp_dir`" from sentencepiece import SentencePieceTrainer vocab_sz = self._get_vocab_sz(raw_text_path) if self.vocab_sz is None else self.vocab_sz spec_tokens = ['\u2581'+s for s in self.special_toks] SentencePieceTrainer.Train(" ".join([ f"--input={raw_text_path} --vocab_size={vocab_sz} --model_prefix={self.cache_dir/'spm'}", f"--character_coverage={self.char_coverage} --model_type={self.model_type}", f"--unk_id={len(spec_tokens)} --pad_id=-1 --bos_id=-1 --eos_id=-1 --minloglevel=2", f"--user_defined_symbols={','.join(spec_tokens)} --hard_vocab_limit=false"])) raw_text_path.unlink() return self.cache_dir/'spm.model' def setup(self, items, rules=None): from sentencepiece import SentencePieceProcessor if rules is None: rules = [] if self.tok is not None: return {'sp_model': self.sp_model} raw_text_path = self.cache_dir/'texts.out' with open(raw_text_path, 'w') as f: for t in progress_bar(maps(*rules, items), total=len(items), leave=False): f.write(f'{t}\n') sp_model = self.train(raw_text_path) self.tok = SentencePieceProcessor() self.tok.Load(str(sp_model)) return {'sp_model': sp_model} def __call__(self, items): if self.tok is None: self.setup(items) for t in items: yield self.tok.EncodeAsPieces(t) # %% ../../nbs/30_text.core.ipynb #31abcbbc SubwordTokenizer = SentencePieceTokenizer