textdistance 1.1.1

Lots of algorithms to compare how similar two sequences are
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85


from pathlib import Path
from typing import Iterator

import pytest


SKIP = frozenset({'algorithm', 'counter'})
ROOT = Path(__file__).parent.parent


def get_algorithms() -> Iterator[str]:
    for fpath in (ROOT / 'src' / 'algorithms').iterdir():
        alg_name = fpath.stem
        if alg_name not in SKIP:
            yield alg_name


ALGORITHMS = tuple(get_algorithms())


@pytest.mark.parametrize('alg', ALGORITHMS)
def test_name_is_ascii(alg: str) -> None:
    assert alg.replace('_', '').isalnum()
    assert alg.isascii()


@pytest.mark.parametrize('alg', ALGORITHMS)
def test_is_in_readme(alg: str) -> None:
    text = (ROOT / 'README.md').read_text()
    alg = alg.replace('_', '')
    assert f'1. `{alg}`' in text.lower()


@pytest.mark.parametrize('alg', ALGORITHMS)
def test_str_shortcut_exists(alg: str) -> None:
    fpath = (ROOT / 'src' / 'str.rs')
    text = fpath.read_text()
    assert f'fn {alg}(' in text
    alg = alg.replace('_', '')
    assert f'{alg}::default().for_str(s1, s2).' in text.lower()
    assert f'/// a wrapper for [`{alg}`].\n' in text.lower()


def test_str_docs_consistency() -> None:
    fpath = (ROOT / 'src' / 'str.rs')
    text = fpath.read_text()
    assert text.count('/// Calculate ') == text.count('pub fn')


@pytest.mark.parametrize('alg', ALGORITHMS)
def test_nstr_shortcut_exists(alg: str) -> None:
    fpath = (ROOT / 'src' / 'nstr.rs')
    text = fpath.read_text()
    assert f'fn {alg}(' in text
    alg = alg.replace('_', '')
    assert f'{alg}::default().for_str(s1, s2).nval()' in text.lower()
    assert f'/// a wrapper for [`{alg}`].\n' in text.lower()


def test_nstr_docs_consistency() -> None:
    fpath = (ROOT / 'src' / 'nstr.rs')
    text = fpath.read_text()
    assert text.count('/// Calculate normalized ') == text.count('pub fn')


@pytest.mark.parametrize('alg', ALGORITHMS)
def test_is_exported(alg: str) -> None:
    fpath = (ROOT / 'src' / 'lib.rs')
    text = fpath.read_text()
    assert f'pub mod {alg}' in text
    assert f'pub use self::algorithms::{alg}::' in text


@pytest.mark.parametrize('alg', ALGORITHMS)
def test_is_smoke_tested(alg: str) -> None:
    fpath = (ROOT / 'src' / 'lib.rs')
    text = fpath.read_text()
    assert f'#[case::{alg}(' in text


@pytest.mark.parametrize('alg', ALGORITHMS)
def test_is_tested(alg: str) -> None:
    fpath = (ROOT / 'src' / 'algorithms' / f'{alg}.rs')
    assert '#[rstest]' in fpath.read_text()