glitchlings 0.4.1__cp312-cp312-macosx_11_0_universal2.whl → 0.4.3__cp312-cp312-macosx_11_0_universal2.whl

glitchlings/lexicon/graph.py

@@ -1,290 +0,0 @@
-"""Graph-based lexicon backed by ConceptNet/Numberbatch embeddings."""
-
-from __future__ import annotations
-
-import re
-from pathlib import Path
-from typing import Iterable, Mapping, MutableMapping, Sequence
-
-from . import LexiconBackend
-from ._cache import CacheSnapshot, load_cache as _load_cache_file, write_cache as _write_cache_file
-from .vector import VectorLexicon
-
-
-_CONCEPT_RE = re.compile(r"^/c/(?P<lang>[a-z]{2})/(?P<term>[^/]+)")
-_PUNCTUATION_RE = re.compile(r"[^\w\s-]+", re.UNICODE)
-
-
-def _lemmatize_token(token: str) -> str:
-    """Return a lightweight lemma for ``token`` using heuristic rules."""
-
-    irregular = {
-        "children": "child",
-        "mice": "mouse",
-        "geese": "goose",
-        "feet": "foot",
-        "teeth": "tooth",
-        "men": "man",
-        "women": "woman",
-        "better": "good",
-        "worse": "bad",
-    }
-    lowered = token.lower()
-    if lowered in irregular:
-        return irregular[lowered]
-
-    if lowered.endswith("ies") and len(lowered) > 3:
-        return lowered[:-3] + "y"
-    if lowered.endswith("ves") and len(lowered) > 3:
-        return lowered[:-3] + "f"
-    if lowered.endswith("men") and len(lowered) > 3:
-        return lowered[:-3] + "man"
-    if lowered.endswith("ses") and len(lowered) > 3:
-        return lowered[:-2]
-    if lowered.endswith("es") and len(lowered) > 3:
-        return lowered[:-2]
-    if lowered.endswith("s") and len(lowered) > 2 and not lowered.endswith("ss"):
-        return lowered[:-1]
-    if lowered.endswith("ing") and len(lowered) > 4:
-        stem = lowered[:-3]
-        if len(stem) > 2 and stem[-1] == stem[-2]:
-            stem = stem[:-1]
-        return stem
-    if lowered.endswith("ed") and len(lowered) > 3:
-        stem = lowered[:-2]
-        if len(stem) > 2 and stem[-1] == stem[-2]:
-            stem = stem[:-1]
-        return stem
-    return lowered
-
-
-def _normalize_phrase(phrase: str) -> str:
-    """Normalise ``phrase`` for ConceptNet lookups."""
-
-    stripped = _PUNCTUATION_RE.sub(" ", phrase.lower())
-    tokens = [token for token in stripped.split() if token]
-    if not tokens:
-        return ""
-    lemmatised = [_lemmatize_token(token) for token in tokens]
-    return " ".join(lemmatised)
-
-
-def _concept_terms(normalized: str) -> list[str]:
-    """Return ConceptNet term variants for ``normalized``."""
-
-    collapsed = normalized.replace(" ", "_")
-    if not collapsed:
-        return []
-    variants = {collapsed}
-    variants.add(collapsed.replace("_", "-"))
-    variants.add(collapsed.replace("-", "_"))
-    return list(variants)
-
-
-def _surface_from_concept(concept: str) -> str | None:
-    """Return a human-readable surface form for ``concept``."""
-
-    match = _CONCEPT_RE.match(concept)
-    if match is None:
-        return None
-    term = match.group("term")
-    surface = term.replace("_", " ")
-    surface = surface.replace("-", " ")
-    return " ".join(surface.split())
-
-
-def _language_from_concept(concept: str) -> str | None:
-    match = _CONCEPT_RE.match(concept)
-    if match is None:
-        return None
-    return match.group("lang")
-
-
-def _load_numberbatch(path: Path, *, languages: set[str]) -> Mapping[str, list[float]]:
-    """Load ConceptNet Numberbatch embeddings from ``path``."""
-
-    if not path.exists():
-        return {}
-
-    if path.suffix == ".gz":
-        import gzip
-
-        handle = gzip.open(path, "rt", encoding="utf8")
-    else:
-        handle = path.open("r", encoding="utf8")
-
-    with handle as stream:
-        header = stream.readline()
-        try:
-            parts = header.strip().split()
-            if len(parts) >= 2:
-                int(parts[0])
-                int(parts[1])
-        except ValueError:
-            stream.seek(0)
-
-        embeddings: dict[str, list[float]] = {}
-        for line in stream:
-            tokens = line.strip().split()
-            if len(tokens) <= 2:
-                continue
-            concept = tokens[0]
-            lang = _language_from_concept(concept)
-            if lang is None or lang not in languages:
-                continue
-            try:
-                vector = [float(value) for value in tokens[1:]]
-            except ValueError:
-                continue
-            embeddings[concept] = vector
-    return embeddings
-
-
-class GraphLexicon(LexiconBackend):
-    """Lexicon backed by ConceptNet/Numberbatch embeddings."""
-
-    def __init__(
-        self,
-        *,
-        source: Mapping[str, Sequence[float]] | str | Path | None = None,
-        cache: Mapping[str, Sequence[str]] | None = None,
-        cache_path: str | Path | None = None,
-        languages: Iterable[str] = ("en",),
-        max_neighbors: int = 50,
-        min_similarity: float = 0.0,
-        seed: int | None = None,
-    ) -> None:
-        super().__init__(seed=seed)
-        self._languages = {language.lower() for language in languages}
-        if not self._languages:
-            self._languages = {"en"}
-        self._max_neighbors = max(1, max_neighbors)
-        self._min_similarity = min_similarity
-        self._cache: MutableMapping[str, list[str]] = {}
-        self._cache_path: Path | None = Path(cache_path) if cache_path is not None else None
-        self._cache_checksum: str | None = None
-        if self._cache_path is not None:
-            snapshot = _load_cache_file(self._cache_path)
-            self._cache.update(snapshot.entries)
-            self._cache_checksum = snapshot.checksum
-        if cache is not None:
-            for key, values in cache.items():
-                self._cache[str(key)] = [str(value) for value in values]
-        self._cache_dirty = False
-
-        prepared_source = self._prepare_source(source)
-        self._backend = VectorLexicon(
-            source=prepared_source if prepared_source else None,
-            max_neighbors=self._max_neighbors,
-            min_similarity=self._min_similarity,
-            case_sensitive=True,
-            seed=seed,
-        )
-
-    def _prepare_source(
-        self, source: Mapping[str, Sequence[float]] | str | Path | None
-    ) -> Mapping[str, Sequence[float]]:
-        if source is None:
-            return {}
-        if isinstance(source, Mapping):
-            prepared: dict[str, list[float]] = {}
-            for key, vector in source.items():
-                lang = _language_from_concept(key)
-                if lang is None or lang not in self._languages:
-                    continue
-                prepared[key] = [float(value) for value in vector]
-            return prepared
-        path = Path(source)
-        embeddings = _load_numberbatch(path, languages=self._languages)
-        return embeddings
-
-    def reseed(self, seed: int | None) -> None:
-        super().reseed(seed)
-        self._backend.reseed(seed)
-
-    def _concept_candidates(self, normalized: str) -> list[str]:
-        terms = _concept_terms(normalized)
-        concepts = []
-        for language in sorted(self._languages):
-            for term in terms:
-                concepts.append(f"/c/{language}/{term}")
-        return concepts
-
-    def _collect_synonyms(self, normalized: str) -> list[str]:
-        candidates: list[str] = []
-        seen: set[str] = set()
-        for concept in self._concept_candidates(normalized):
-            neighbors = self._backend.precompute(concept, limit=self._max_neighbors)
-            for neighbor in neighbors:
-                lang = _language_from_concept(neighbor)
-                if lang is None or lang not in self._languages:
-                    continue
-                surface = _surface_from_concept(neighbor)
-                if surface is None:
-                    continue
-                surface_norm = _normalize_phrase(surface)
-                if not surface_norm or surface_norm == normalized:
-                    continue
-                if surface_norm in seen:
-                    continue
-                seen.add(surface_norm)
-                candidates.append(surface)
-        return candidates
-
-    def _ensure_cached(self, normalized: str) -> list[str]:
-        if normalized in self._cache:
-            return self._cache[normalized]
-        synonyms = self._collect_synonyms(normalized)
-        self._cache[normalized] = synonyms
-        if self._cache_path is not None:
-            self._cache_dirty = True
-        return synonyms
-
-    def get_synonyms(
-        self, word: str, pos: str | None = None, n: int = 5
-    ) -> list[str]:
-        normalized = _normalize_phrase(word)
-        if not normalized:
-            return []
-        synonyms = self._ensure_cached(normalized)
-        return self._deterministic_sample(synonyms, limit=n, word=word, pos=pos)
-
-    def precompute(self, word: str) -> list[str]:
-        normalized = _normalize_phrase(word)
-        if not normalized:
-            return []
-        return list(self._ensure_cached(normalized))
-
-    def export_cache(self) -> dict[str, list[str]]:
-        return {key: list(values) for key, values in self._cache.items()}
-
-    @classmethod
-    def load_cache(cls, path: str | Path) -> CacheSnapshot:
-        """Load and validate a persisted ConceptNet cache file."""
-
-        return _load_cache_file(Path(path))
-
-    def save_cache(self, path: str | Path | None = None) -> Path:
-        if path is None:
-            if self._cache_path is None:
-                raise RuntimeError("No cache path supplied to GraphLexicon.")
-            target = self._cache_path
-        else:
-            target = Path(path)
-            self._cache_path = target
-        snapshot = _write_cache_file(target, self._cache)
-        self._cache_checksum = snapshot.checksum
-        self._cache_dirty = False
-        return target
-
-    def supports_pos(self, pos: str | None) -> bool:
-        return True
-
-    def __repr__(self) -> str:  # pragma: no cover - debug helper
-        adapter = getattr(self._backend, "_adapter", None)
-        state = "loaded" if adapter else "empty"
-        return (
-            f"GraphLexicon(languages={sorted(self._languages)!r}, "
-            f"max_neighbors={self._max_neighbors}, seed={self.seed!r}, state={state})"
-        )
-

glitchlings-0.4.1.dist-info/RECORD

@@ -1,39 +0,0 @@
-glitchlings/__init__.py,sha256=hEmQ1rl3G5uZBDbfJX_W4aIUNSsPAsy_Ai5DgQHasvk,813
-glitchlings/__main__.py,sha256=EOiBgay0x6B9VlSDzSQvMuoq6bHJdSvFSgcAVGGKkd4,121
-glitchlings/_zoo_rust.cpython-312-darwin.so,sha256=Bo96FBERNP5nurDkdpXPWDzSgvY2NGERbEtMmXHhCW0,2488416
-glitchlings/config.py,sha256=hwkcMkhEvUzK8FECgG6kbf_4MpMQcopskiSgXzK5B3o,7785
-glitchlings/config.toml,sha256=MWwgbx1-KIRAY3JZmMrCVbZNxFjHgRJXbtNAVuUNcxY,108
-glitchlings/main.py,sha256=Rw9pCgNrGxwzC1rZbbng7cHUP9xlL0WWWTdjW95XiSM,10084
-glitchlings/dlc/__init__.py,sha256=eTLEEWrVWPqniXHqee4W23H1rjElI1PQ_jcqWFe9D3g,141
-glitchlings/dlc/huggingface.py,sha256=I1QWanWVxO02awgSpHDtgQEVF-9AQRLtsta2RCitWhE,2933
-glitchlings/dlc/prime.py,sha256=wpRMNtgka1vNlEzifeCjGMp1q_-QclZn3NxXczGnNpM,9278
-glitchlings/lexicon/__init__.py,sha256=e3MbtV3R_UOoZXsckR3gnThwgqCi4HXnfduaqxqYXvw,6229
-glitchlings/lexicon/_cache.py,sha256=KlcHKtOFH1yPxwhr8_HF_qgpALmUuHkGTzNfWnQ2Jb8,3955
-glitchlings/lexicon/graph.py,sha256=YYLrYnmSZ8uf8VvrNLuVF_nIVDH7OoR3RuxJ-9JMA2c,10041
-glitchlings/lexicon/metrics.py,sha256=W8TCemZaCjBOUSX8G7JdgQAbMykXXfRTfodkDSkc3aQ,4599
-glitchlings/lexicon/vector.py,sha256=oeZQwYxrK25REu4MhUUlMmaStW17Gx6RwrU1v6NooOg,19713
-glitchlings/lexicon/wordnet.py,sha256=Zv0YNHSM-DE2ucVZl_OOutTV1s0-i2xPOrfqYYdZKTU,6034
-glitchlings/lexicon/data/default_vector_cache.json,sha256=7obKHqmR3odbTfgJPWLSRFYFh4J_6uvv_CntCSe_EjI,725
-glitchlings/util/__init__.py,sha256=7KiZ0gKMjocfd34cajneZhTqYb7Hkwi_PpjltPqvkNI,4498
-glitchlings/zoo/__init__.py,sha256=eFYmaWeFDlSqfaiED51HWM-OqiTo_BOz0ASeyhOwOsw,4818
-glitchlings/zoo/_ocr_confusions.py,sha256=MkCbwk9T24SO2pD3JNPajYCfpMMlm2vQ5_sJty5GoXE,1218
-glitchlings/zoo/_rate.py,sha256=TMyfVFV7pLxSGVswPlOAtBvk25Bjtx5xXTtpb_utgik,527
-glitchlings/zoo/_sampling.py,sha256=VOSWDgYWXIiAuKxn2IckFJhpRgGotQP_KW28db8kTKI,1587
-glitchlings/zoo/_text_utils.py,sha256=nAfFT_VdXMXciCR7eQ5EAmym5wvzL6_Sdn9dvCx2s3Q,2758
-glitchlings/zoo/adjax.py,sha256=N3CzfM7m7mAYgFcQYLQkqK2VYLw_vFvEMBM2aNU--ZA,3530
-glitchlings/zoo/core.py,sha256=YymiEc66V4mW_4MbTST2038D7YdZVyRkiUZn886IV4I,17203
-glitchlings/zoo/jargoyle.py,sha256=6-DJxUFz2AjT-iQDFlK2ZG9pVwq2boDtslEzCNyI_04,11481
-glitchlings/zoo/mim1c.py,sha256=yAt1ngR3j2KXLbzc8LhrQlIWRO_KT5dFK1EE8QivMAQ,3429
-glitchlings/zoo/ocr_confusions.tsv,sha256=KhtR7vJDTITpfTSGa-I7RHr6CK7LkGi2KjdhEWipI6o,183
-glitchlings/zoo/redactyl.py,sha256=H4PwAMBCIsDw1KBOBiTR3VUbRZwynqakwwfx3wHjVp8,5457
-glitchlings/zoo/reduple.py,sha256=Q9NRCdvUgaHvvJu8A0n6zW9v_L3pdmNZbWqaJ7uycw4,4216
-glitchlings/zoo/rushmore.py,sha256=J1wd4IB7WOAR2TdntkxCMZWseWR0Yii8UQZ7ucfpWCc,4335
-glitchlings/zoo/scannequin.py,sha256=Ps8nxysKjkJV408zaL1kjVjy4jliATDBpYcNHLWbNFg,4859
-glitchlings/zoo/typogre.py,sha256=0fYaxOEiTnxiCqmsiSN1r_wl1vC1Ueaiks2e94kks70,6668
-glitchlings/zoo/zeedub.py,sha256=l51swlo556-TXhDk4nayHOm1XgHwWmfUKzQ01YMuCpE,4801
-glitchlings-0.4.1.dist-info/licenses/LICENSE,sha256=YCvGip-LoaRyu6h0nPo71q6eHEkzUpsE11psDJOIRkw,11337
-glitchlings-0.4.1.dist-info/METADATA,sha256=9HdqQt7PazdHMtPP5JpINljl3kvL8HOqTFE3Wwyrm2g,28260
-glitchlings-0.4.1.dist-info/WHEEL,sha256=o0zAoJUNILGJZxEeFPjb7OMHp_94eqIkZBeZ0gvgOpo,114
-glitchlings-0.4.1.dist-info/entry_points.txt,sha256=kGOwuAsjFDLtztLisaXtOouq9wFVMOJg5FzaAkg-Hto,54
-glitchlings-0.4.1.dist-info/top_level.txt,sha256=VHFNBrLjtDwPCYXbGKi6o17Eueedi81eNbR3hBOoST0,12
-glitchlings-0.4.1.dist-info/RECORD,,