mirror of
				https://github.com/explosion/spaCy.git
				synced 2025-11-04 09:57:26 +03:00 
			
		
		
		
	* Add Lemmatizer and simplify related components * Add `Lemmatizer` pipe with `lookup` and `rule` modes using the `Lookups` tables. * Reduce `Tagger` to a simple tagger that sets `Token.tag` (no pos or lemma) * Reduce `Morphology` to only keep track of morph tags (no tag map, lemmatizer, or morph rules) * Remove lemmatizer from `Vocab` * Adjust many many tests Differences: * No default lookup lemmas * No special treatment of TAG in `from_array` and similar required * Easier to modify labels in a `Tagger` * No extra strings added from morphology / tag map * Fix test * Initial fix for Lemmatizer config/serialization * Adjust init test to be more generic * Adjust init test to force empty Lookups * Add simple cache to rule-based lemmatizer * Convert language-specific lemmatizers Convert language-specific lemmatizers to component lemmatizers. Remove previous lemmatizer class. * Fix French and Polish lemmatizers * Remove outdated UPOS conversions * Update Russian lemmatizer init in tests * Add minimal init/run tests for custom lemmatizers * Add option to overwrite existing lemmas * Update mode setting, lookup loading, and caching * Make `mode` an immutable property * Only enforce strict `load_lookups` for known supported modes * Move caching into individual `_lemmatize` methods * Implement strict when lang is not found in lookups * Fix tables/lookups in make_lemmatizer * Reallow provided lookups and allow for stricter checks * Add lookups asset to all Lemmatizer pipe tests * Rename lookups in lemmatizer init test * Clean up merge * Refactor lookup table loading * Add helper from `load_lemmatizer_lookups` that loads required and optional lookups tables based on settings provided by a config. Additional slight refactor of lookups: * Add `Lookups.set_table` to set a table from a provided `Table` * Reorder class definitions to be able to specify type as `Table` * Move registry assets into test methods * Refactor lookups tables config Use class methods within `Lemmatizer` to provide the config for particular modes and to load the lookups from a config. * Add pipe and score to lemmatizer * Simplify Tagger.score * Add missing import * Clean up imports and auto-format * Remove unused kwarg * Tidy up and auto-format * Update docstrings for Lemmatizer Update docstrings for Lemmatizer. Additionally modify `is_base_form` API to take `Token` instead of individual features. * Update docstrings * Remove tag map values from Tagger.add_label * Update API docs * Fix relative link in Lemmatizer API docs
		
			
				
	
	
		
			149 lines
		
	
	
		
			4.3 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
			
		
		
	
	
			149 lines
		
	
	
		
			4.3 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
import warnings
 | 
						|
from unittest import TestCase
 | 
						|
import pytest
 | 
						|
import srsly
 | 
						|
from numpy import zeros
 | 
						|
from spacy.kb import KnowledgeBase, Writer
 | 
						|
from spacy.vectors import Vectors
 | 
						|
from spacy.language import Language
 | 
						|
from spacy.pipeline import Pipe
 | 
						|
from spacy.util import registry
 | 
						|
 | 
						|
from ..util import make_tempdir
 | 
						|
 | 
						|
 | 
						|
def nlp():
 | 
						|
    return Language()
 | 
						|
 | 
						|
 | 
						|
def vectors():
 | 
						|
    data = zeros((3, 1), dtype="f")
 | 
						|
    keys = ["cat", "dog", "rat"]
 | 
						|
    return Vectors(data=data, keys=keys)
 | 
						|
 | 
						|
 | 
						|
def custom_pipe():
 | 
						|
    # create dummy pipe partially implementing interface -- only want to test to_disk
 | 
						|
    class SerializableDummy:
 | 
						|
        def __init__(self, **cfg):
 | 
						|
            if cfg:
 | 
						|
                self.cfg = cfg
 | 
						|
            else:
 | 
						|
                self.cfg = None
 | 
						|
            super(SerializableDummy, self).__init__()
 | 
						|
 | 
						|
        def to_bytes(self, exclude=tuple(), disable=None, **kwargs):
 | 
						|
            return srsly.msgpack_dumps({"dummy": srsly.json_dumps(None)})
 | 
						|
 | 
						|
        def from_bytes(self, bytes_data, exclude):
 | 
						|
            return self
 | 
						|
 | 
						|
        def to_disk(self, path, exclude=tuple(), **kwargs):
 | 
						|
            pass
 | 
						|
 | 
						|
        def from_disk(self, path, exclude=tuple(), **kwargs):
 | 
						|
            return self
 | 
						|
 | 
						|
    class MyPipe(Pipe):
 | 
						|
        def __init__(self, vocab, model=True, **cfg):
 | 
						|
            if cfg:
 | 
						|
                self.cfg = cfg
 | 
						|
            else:
 | 
						|
                self.cfg = None
 | 
						|
            self.model = SerializableDummy()
 | 
						|
            self.vocab = SerializableDummy()
 | 
						|
 | 
						|
    return MyPipe(None)
 | 
						|
 | 
						|
 | 
						|
def tagger():
 | 
						|
    nlp = Language()
 | 
						|
    tagger = nlp.add_pipe("tagger")
 | 
						|
    # need to add model for two reasons:
 | 
						|
    # 1. no model leads to error in serialization,
 | 
						|
    # 2. the affected line is the one for model serialization
 | 
						|
    tagger.begin_training(pipeline=nlp.pipeline)
 | 
						|
    return tagger
 | 
						|
 | 
						|
 | 
						|
def entity_linker():
 | 
						|
    nlp = Language()
 | 
						|
 | 
						|
    @registry.assets.register("TestIssue5230KB.v1")
 | 
						|
    def dummy_kb() -> KnowledgeBase:
 | 
						|
        kb = KnowledgeBase(entity_vector_length=1)
 | 
						|
        kb.initialize(nlp.vocab)
 | 
						|
        kb.add_entity("test", 0.0, zeros((1, 1), dtype="f"))
 | 
						|
        return kb
 | 
						|
 | 
						|
    config = {"kb": {"@assets": "TestIssue5230KB.v1"}}
 | 
						|
    entity_linker = nlp.add_pipe("entity_linker", config=config)
 | 
						|
    # need to add model for two reasons:
 | 
						|
    # 1. no model leads to error in serialization,
 | 
						|
    # 2. the affected line is the one for model serialization
 | 
						|
    entity_linker.begin_training(pipeline=nlp.pipeline)
 | 
						|
    return entity_linker
 | 
						|
 | 
						|
 | 
						|
objects_to_test = (
 | 
						|
    [nlp(), vectors(), custom_pipe(), tagger(), entity_linker()],
 | 
						|
    ["nlp", "vectors", "custom_pipe", "tagger", "entity_linker"],
 | 
						|
)
 | 
						|
 | 
						|
 | 
						|
def write_obj_and_catch_warnings(obj):
 | 
						|
    with make_tempdir() as d:
 | 
						|
        with warnings.catch_warnings(record=True) as warnings_list:
 | 
						|
            warnings.filterwarnings("always", category=ResourceWarning)
 | 
						|
            obj.to_disk(d)
 | 
						|
            # in python3.5 it seems that deprecation warnings are not filtered by filterwarnings
 | 
						|
            return list(filter(lambda x: isinstance(x, ResourceWarning), warnings_list))
 | 
						|
 | 
						|
 | 
						|
@pytest.mark.parametrize("obj", objects_to_test[0], ids=objects_to_test[1])
 | 
						|
def test_to_disk_resource_warning(obj):
 | 
						|
    warnings_list = write_obj_and_catch_warnings(obj)
 | 
						|
    assert len(warnings_list) == 0
 | 
						|
 | 
						|
 | 
						|
def test_writer_with_path_py35():
 | 
						|
    writer = None
 | 
						|
    with make_tempdir() as d:
 | 
						|
        path = d / "test"
 | 
						|
        try:
 | 
						|
            writer = Writer(path)
 | 
						|
        except Exception as e:
 | 
						|
            pytest.fail(str(e))
 | 
						|
        finally:
 | 
						|
            if writer:
 | 
						|
                writer.close()
 | 
						|
 | 
						|
 | 
						|
def test_save_and_load_knowledge_base():
 | 
						|
    nlp = Language()
 | 
						|
    kb = KnowledgeBase(entity_vector_length=1)
 | 
						|
    kb.initialize(nlp.vocab)
 | 
						|
    with make_tempdir() as d:
 | 
						|
        path = d / "kb"
 | 
						|
        try:
 | 
						|
            kb.dump(path)
 | 
						|
        except Exception as e:
 | 
						|
            pytest.fail(str(e))
 | 
						|
 | 
						|
        try:
 | 
						|
            kb_loaded = KnowledgeBase(entity_vector_length=1)
 | 
						|
            kb_loaded.initialize(nlp.vocab)
 | 
						|
            kb_loaded.load_bulk(path)
 | 
						|
        except Exception as e:
 | 
						|
            pytest.fail(str(e))
 | 
						|
 | 
						|
 | 
						|
class TestToDiskResourceWarningUnittest(TestCase):
 | 
						|
    def test_resource_warning(self):
 | 
						|
        scenarios = zip(*objects_to_test)
 | 
						|
 | 
						|
        for scenario in scenarios:
 | 
						|
            with self.subTest(msg=scenario[1]):
 | 
						|
                warnings_list = write_obj_and_catch_warnings(scenario[0])
 | 
						|
                self.assertEqual(len(warnings_list), 0)
 |