mirror of
				https://github.com/explosion/spaCy.git
				synced 2025-11-04 09:57:26 +03:00 
			
		
		
		
	
		
			
				
	
	
		
			289 lines
		
	
	
		
			11 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
			
		
		
	
	
			289 lines
		
	
	
		
			11 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
import pytest
 | 
						|
import numpy
 | 
						|
from spacy.attrs import IS_ALPHA, IS_DIGIT, IS_LOWER, IS_PUNCT, IS_TITLE, IS_STOP
 | 
						|
from spacy.symbols import VERB
 | 
						|
from spacy.vocab import Vocab
 | 
						|
from spacy.tokens import Doc
 | 
						|
from spacy.training import Example
 | 
						|
 | 
						|
 | 
						|
@pytest.fixture
 | 
						|
def doc(en_vocab):
 | 
						|
    # fmt: off
 | 
						|
    words = ["This", "is", "a", "sentence", ".", "This", "is", "another", "sentence", ".", "And", "a", "third", "."]
 | 
						|
    heads = [1, 1, 3, 1, 1, 6, 6, 8, 6, 6, 10, 12, 10, 12]
 | 
						|
    deps = ["nsubj", "ROOT", "det", "attr", "punct", "nsubj", "ROOT", "det",
 | 
						|
            "attr", "punct", "ROOT", "det", "npadvmod", "punct"]
 | 
						|
    # fmt: on
 | 
						|
    return Doc(en_vocab, words=words, heads=heads, deps=deps)
 | 
						|
 | 
						|
 | 
						|
def test_doc_token_api_strings(en_vocab):
 | 
						|
    words = ["Give", "it", "back", "!", "He", "pleaded", "."]
 | 
						|
    pos = ["VERB", "PRON", "PART", "PUNCT", "PRON", "VERB", "PUNCT"]
 | 
						|
    heads = [0, 0, 0, 0, 5, 5, 5]
 | 
						|
    deps = ["ROOT", "dobj", "prt", "punct", "nsubj", "ROOT", "punct"]
 | 
						|
    doc = Doc(en_vocab, words=words, pos=pos, heads=heads, deps=deps)
 | 
						|
    assert doc[0].orth_ == "Give"
 | 
						|
    assert doc[0].text == "Give"
 | 
						|
    assert doc[0].text_with_ws == "Give "
 | 
						|
    assert doc[0].lower_ == "give"
 | 
						|
    assert doc[0].shape_ == "Xxxx"
 | 
						|
    assert doc[0].prefix_ == "G"
 | 
						|
    assert doc[0].suffix_ == "ive"
 | 
						|
    assert doc[0].pos_ == "VERB"
 | 
						|
    assert doc[0].dep_ == "ROOT"
 | 
						|
 | 
						|
 | 
						|
def test_doc_token_api_flags(en_tokenizer):
 | 
						|
    text = "Give it back! He pleaded."
 | 
						|
    tokens = en_tokenizer(text)
 | 
						|
    assert tokens[0].check_flag(IS_ALPHA)
 | 
						|
    assert not tokens[0].check_flag(IS_DIGIT)
 | 
						|
    assert tokens[0].check_flag(IS_TITLE)
 | 
						|
    assert tokens[1].check_flag(IS_LOWER)
 | 
						|
    assert tokens[3].check_flag(IS_PUNCT)
 | 
						|
    assert tokens[2].check_flag(IS_STOP)
 | 
						|
    assert not tokens[5].check_flag(IS_STOP)
 | 
						|
    # TODO: Test more of these, esp. if a bug is found
 | 
						|
 | 
						|
 | 
						|
@pytest.mark.parametrize("text", ["Give it back! He pleaded."])
 | 
						|
def test_doc_token_api_prob_inherited_from_vocab(en_tokenizer, text):
 | 
						|
    word = text.split()[0]
 | 
						|
    en_tokenizer.vocab[word].prob = -1
 | 
						|
    tokens = en_tokenizer(text)
 | 
						|
    assert tokens[0].prob != 0
 | 
						|
 | 
						|
 | 
						|
@pytest.mark.parametrize("text", ["one two"])
 | 
						|
def test_doc_token_api_str_builtin(en_tokenizer, text):
 | 
						|
    tokens = en_tokenizer(text)
 | 
						|
    assert str(tokens[0]) == text.split(" ")[0]
 | 
						|
    assert str(tokens[1]) == text.split(" ")[1]
 | 
						|
 | 
						|
 | 
						|
def test_doc_token_api_is_properties(en_vocab):
 | 
						|
    doc = Doc(en_vocab, words=["Hi", ",", "my", "email", "is", "test@me.com"])
 | 
						|
    assert doc[0].is_title
 | 
						|
    assert doc[0].is_alpha
 | 
						|
    assert not doc[0].is_digit
 | 
						|
    assert doc[1].is_punct
 | 
						|
    assert doc[3].is_ascii
 | 
						|
    assert not doc[3].like_url
 | 
						|
    assert doc[4].is_lower
 | 
						|
    assert doc[5].like_email
 | 
						|
 | 
						|
 | 
						|
def test_doc_token_api_vectors():
 | 
						|
    vocab = Vocab()
 | 
						|
    vocab.reset_vectors(width=2)
 | 
						|
    vocab.set_vector("apples", vector=numpy.asarray([0.0, 2.0], dtype="f"))
 | 
						|
    vocab.set_vector("oranges", vector=numpy.asarray([0.0, 1.0], dtype="f"))
 | 
						|
    doc = Doc(vocab, words=["apples", "oranges", "oov"])
 | 
						|
    assert doc.has_vector
 | 
						|
    assert doc[0].has_vector
 | 
						|
    assert doc[1].has_vector
 | 
						|
    assert not doc[2].has_vector
 | 
						|
    apples_norm = (0 * 0 + 2 * 2) ** 0.5
 | 
						|
    oranges_norm = (0 * 0 + 1 * 1) ** 0.5
 | 
						|
    cosine = ((0 * 0) + (2 * 1)) / (apples_norm * oranges_norm)
 | 
						|
    assert doc[0].similarity(doc[1]) == cosine
 | 
						|
 | 
						|
 | 
						|
def test_doc_token_api_ancestors(en_vocab):
 | 
						|
    # the structure of this sentence depends on the English annotation scheme
 | 
						|
    words = ["Yesterday", "I", "saw", "a", "dog", "that", "barked", "loudly", "."]
 | 
						|
    heads = [2, 2, 2, 4, 2, 6, 4, 6, 2]
 | 
						|
    doc = Doc(en_vocab, words=words, heads=heads)
 | 
						|
    assert [t.text for t in doc[6].ancestors] == ["dog", "saw"]
 | 
						|
    assert [t.text for t in doc[1].ancestors] == ["saw"]
 | 
						|
    assert [t.text for t in doc[2].ancestors] == []
 | 
						|
    assert doc[2].is_ancestor(doc[7])
 | 
						|
    assert not doc[6].is_ancestor(doc[2])
 | 
						|
 | 
						|
 | 
						|
def test_doc_token_api_head_setter(en_vocab):
 | 
						|
    words = ["Yesterday", "I", "saw", "a", "dog", "that", "barked", "loudly", "."]
 | 
						|
    heads = [2, 2, 2, 4, 2, 6, 4, 6, 2]
 | 
						|
    deps = ["dep"] * len(heads)
 | 
						|
    doc = Doc(en_vocab, words=words, heads=heads, deps=deps)
 | 
						|
    assert doc[6].n_lefts == 1
 | 
						|
    assert doc[6].n_rights == 1
 | 
						|
    assert doc[6].left_edge.i == 5
 | 
						|
    assert doc[6].right_edge.i == 7
 | 
						|
    assert doc[4].n_lefts == 1
 | 
						|
    assert doc[4].n_rights == 1
 | 
						|
    assert doc[4].left_edge.i == 3
 | 
						|
    assert doc[4].right_edge.i == 7
 | 
						|
    assert doc[3].n_lefts == 0
 | 
						|
    assert doc[3].n_rights == 0
 | 
						|
    assert doc[3].left_edge.i == 3
 | 
						|
    assert doc[3].right_edge.i == 3
 | 
						|
    assert doc[2].left_edge.i == 0
 | 
						|
    assert doc[2].right_edge.i == 8
 | 
						|
 | 
						|
    doc[6].head = doc[3]
 | 
						|
    assert doc[6].n_lefts == 1
 | 
						|
    assert doc[6].n_rights == 1
 | 
						|
    assert doc[6].left_edge.i == 5
 | 
						|
    assert doc[6].right_edge.i == 7
 | 
						|
    assert doc[3].n_lefts == 0
 | 
						|
    assert doc[3].n_rights == 1
 | 
						|
    assert doc[3].left_edge.i == 3
 | 
						|
    assert doc[3].right_edge.i == 7
 | 
						|
    assert doc[4].n_lefts == 1
 | 
						|
    assert doc[4].n_rights == 0
 | 
						|
    assert doc[4].left_edge.i == 3
 | 
						|
    assert doc[4].right_edge.i == 7
 | 
						|
    assert doc[2].left_edge.i == 0
 | 
						|
    assert doc[2].right_edge.i == 8
 | 
						|
 | 
						|
    doc[0].head = doc[5]
 | 
						|
    assert doc[5].left_edge.i == 0
 | 
						|
    assert doc[6].left_edge.i == 0
 | 
						|
    assert doc[3].left_edge.i == 0
 | 
						|
    assert doc[4].left_edge.i == 0
 | 
						|
    assert doc[2].left_edge.i == 0
 | 
						|
    # head token must be from the same document
 | 
						|
    doc2 = Doc(en_vocab, words=words, heads=heads)
 | 
						|
    with pytest.raises(ValueError):
 | 
						|
        doc[0].head = doc2[0]
 | 
						|
    # test sentence starts when two sentences are joined
 | 
						|
    # fmt: off
 | 
						|
    words = ["This", "is", "one", "sentence", ".", "This", "is", "another", "sentence", "."]
 | 
						|
    heads = [0, 0, 0, 0, 0, 5, 5, 5, 5, 5]
 | 
						|
    # fmt: on
 | 
						|
    doc = Doc(en_vocab, words=words, heads=heads, deps=["dep"] * len(heads))
 | 
						|
    # initially two sentences
 | 
						|
    assert doc[0].is_sent_start
 | 
						|
    assert doc[5].is_sent_start
 | 
						|
    assert doc[0].left_edge == doc[0]
 | 
						|
    assert doc[0].right_edge == doc[4]
 | 
						|
    assert doc[5].left_edge == doc[5]
 | 
						|
    assert doc[5].right_edge == doc[9]
 | 
						|
    # modifying with a sentence doesn't change sent starts
 | 
						|
    doc[2].head = doc[3]
 | 
						|
    assert doc[0].is_sent_start
 | 
						|
    assert doc[5].is_sent_start
 | 
						|
    assert doc[0].left_edge == doc[0]
 | 
						|
    assert doc[0].right_edge == doc[4]
 | 
						|
    assert doc[5].left_edge == doc[5]
 | 
						|
    assert doc[5].right_edge == doc[9]
 | 
						|
    # attach the second sentence to the first, resulting in one sentence
 | 
						|
    doc[5].head = doc[0]
 | 
						|
    assert doc[0].is_sent_start
 | 
						|
    assert not doc[5].is_sent_start
 | 
						|
    assert doc[0].left_edge == doc[0]
 | 
						|
    assert doc[0].right_edge == doc[9]
 | 
						|
 | 
						|
 | 
						|
def test_is_sent_start(en_tokenizer):
 | 
						|
    doc = en_tokenizer("This is a sentence. This is another.")
 | 
						|
    assert doc[5].is_sent_start is None
 | 
						|
    doc[5].is_sent_start = True
 | 
						|
    assert doc[5].is_sent_start is True
 | 
						|
    assert len(list(doc.sents)) == 2
 | 
						|
 | 
						|
 | 
						|
def test_is_sent_end(en_tokenizer):
 | 
						|
    doc = en_tokenizer("This is a sentence. This is another.")
 | 
						|
    assert doc[4].is_sent_end is None
 | 
						|
    doc[5].is_sent_start = True
 | 
						|
    assert doc[4].is_sent_end is True
 | 
						|
    assert len(list(doc.sents)) == 2
 | 
						|
 | 
						|
 | 
						|
def test_set_pos():
 | 
						|
    doc = Doc(Vocab(), words=["hello", "world"])
 | 
						|
    doc[0].pos_ = "NOUN"
 | 
						|
    assert doc[0].pos_ == "NOUN"
 | 
						|
    doc[1].pos = VERB
 | 
						|
    assert doc[1].pos_ == "VERB"
 | 
						|
 | 
						|
 | 
						|
def test_tokens_sent(doc):
 | 
						|
    """Test token.sent property"""
 | 
						|
    assert len(list(doc.sents)) == 3
 | 
						|
    assert doc[1].sent.text == "This is a sentence ."
 | 
						|
    assert doc[7].sent.text == "This is another sentence ."
 | 
						|
    assert doc[1].sent.root.left_edge.text == "This"
 | 
						|
    assert doc[7].sent.root.left_edge.text == "This"
 | 
						|
 | 
						|
 | 
						|
def test_token0_has_sent_start_true():
 | 
						|
    doc = Doc(Vocab(), words=["hello", "world"])
 | 
						|
    assert doc[0].is_sent_start is True
 | 
						|
    assert doc[1].is_sent_start is None
 | 
						|
    assert not doc.has_annotation("SENT_START")
 | 
						|
 | 
						|
 | 
						|
def test_tokenlast_has_sent_end_true():
 | 
						|
    doc = Doc(Vocab(), words=["hello", "world"])
 | 
						|
    assert doc[0].is_sent_end is None
 | 
						|
    assert doc[1].is_sent_end is True
 | 
						|
    assert not doc.has_annotation("SENT_START")
 | 
						|
 | 
						|
 | 
						|
def test_token_api_conjuncts_chain(en_vocab):
 | 
						|
    words = ["The", "boy", "and", "the", "girl", "and", "the", "man", "went", "."]
 | 
						|
    heads = [1, 8, 1, 4, 1, 4, 7, 4, 8, 8]
 | 
						|
    deps = ["det", "nsubj", "cc", "det", "conj", "cc", "det", "conj", "ROOT", "punct"]
 | 
						|
    doc = Doc(en_vocab, words=words, heads=heads, deps=deps)
 | 
						|
    assert [w.text for w in doc[1].conjuncts] == ["girl", "man"]
 | 
						|
    assert [w.text for w in doc[4].conjuncts] == ["boy", "man"]
 | 
						|
    assert [w.text for w in doc[7].conjuncts] == ["boy", "girl"]
 | 
						|
 | 
						|
 | 
						|
def test_token_api_conjuncts_simple(en_vocab):
 | 
						|
    words = ["They", "came", "and", "went", "."]
 | 
						|
    heads = [1, 1, 1, 1, 3]
 | 
						|
    deps = ["nsubj", "ROOT", "cc", "conj", "dep"]
 | 
						|
    doc = Doc(en_vocab, words=words, heads=heads, deps=deps)
 | 
						|
    assert [w.text for w in doc[1].conjuncts] == ["went"]
 | 
						|
    assert [w.text for w in doc[3].conjuncts] == ["came"]
 | 
						|
 | 
						|
 | 
						|
def test_token_api_non_conjuncts(en_vocab):
 | 
						|
    words = ["They", "came", "."]
 | 
						|
    heads = [1, 1, 1]
 | 
						|
    deps = ["nsubj", "ROOT", "punct"]
 | 
						|
    doc = Doc(en_vocab, words=words, heads=heads, deps=deps)
 | 
						|
    assert [w.text for w in doc[0].conjuncts] == []
 | 
						|
    assert [w.text for w in doc[1].conjuncts] == []
 | 
						|
 | 
						|
 | 
						|
def test_missing_head_dep(en_vocab):
 | 
						|
    """ Check that the Doc constructor and Example.from_dict parse missing information the same"""
 | 
						|
    heads = [1, 1, 1, 1, 2, None]  # element 5 is missing
 | 
						|
    deps = ["", "ROOT", "dobj", "cc", "conj", None]  # element 0 and 5 are missing
 | 
						|
    words = ["I", "like", "London", "and", "Berlin", "."]
 | 
						|
    doc = Doc(en_vocab, words=words, heads=heads, deps=deps)
 | 
						|
    pred_has_heads = [t.has_head() for t in doc]
 | 
						|
    pred_has_deps = [t.has_dep() for t in doc]
 | 
						|
    pred_heads = [t.head.i for t in doc]
 | 
						|
    pred_deps = [t.dep_ for t in doc]
 | 
						|
    pred_sent_starts = [t.is_sent_start for t in doc]
 | 
						|
    assert pred_has_heads == [False, True, True, True, True, False]
 | 
						|
    assert pred_has_deps == [False, True, True, True, True, False]
 | 
						|
    assert pred_heads[1:5] == [1, 1, 1, 2]
 | 
						|
    assert pred_deps[1:5] == ["ROOT", "dobj", "cc", "conj"]
 | 
						|
    assert pred_sent_starts == [True, False, False, False, False, False]
 | 
						|
    example = Example.from_dict(doc, {"heads": heads, "deps": deps})
 | 
						|
    ref_has_heads = [t.has_head() for t in example.reference]
 | 
						|
    ref_has_deps = [t.has_dep() for t in example.reference]
 | 
						|
    ref_heads = [t.head.i for t in example.reference]
 | 
						|
    ref_deps = [t.dep_ for t in example.reference]
 | 
						|
    ref_sent_starts = [t.is_sent_start for t in example.reference]
 | 
						|
    assert ref_has_heads == pred_has_heads
 | 
						|
    assert ref_has_deps == pred_has_heads
 | 
						|
    assert ref_heads == pred_heads
 | 
						|
    assert ref_deps == pred_deps
 | 
						|
    assert ref_sent_starts == pred_sent_starts
 | 
						|
    # check that the aligned parse preserves the missing information
 | 
						|
    aligned_heads, aligned_deps = example.get_aligned_parse(projectivize=True)
 | 
						|
    assert aligned_deps[0] == ref_deps[0]
 | 
						|
    assert aligned_heads[0] == ref_heads[0]
 | 
						|
    assert aligned_deps[5] == ref_deps[5]
 | 
						|
    assert aligned_heads[5] == ref_heads[5]
 |