eyecore 1.0.0__tar.gz

eyecore-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,87 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+    tags: ['v*']
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - uses: dtolnay/rust-toolchain@stable
+      - name: Build wheel
+        run: |
+          pip install maturin
+          maturin build --out dist
+          pip install --no-index --find-links dist eyecore
+      - name: Run tests
+        run: pip install pytest && pytest tests/ -q
+
+  build-wheels:
+    needs: test
+    if: startsWith(github.ref, 'refs/tags/v')
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64
+          - os: windows-latest
+            target: x86_64
+          - os: macos-latest
+            target: x86_64
+          - os: macos-latest
+            target: aarch64
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist --find-interpreter
+          sccache: 'true'
+          manylinux: auto
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}-${{ matrix.target }}
+          path: dist/
+
+  sdist:
+    needs: test
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/
+
+  publish:
+    needs: [build-wheels, sdist]
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist/
+      - uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

eyecore-1.0.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.pyc
+*.pyo
+.pytest_cache/
+*.egg-info/
+.eggs/
+build/
+dist/
+target/
+Cargo.lock
+.env
+.venv/

eyecore-1.0.0/Cargo.lock

@@ -0,0 +1,133 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "eyecore-core"
+version = "1.0.0"
+dependencies = [
+ "pyo3",
+]
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "libc"
+version = "0.2.186"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68ab91017fe16c622486840e4c83c9a37afeff978bd239b5293d61ece587de66"
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "portable-atomic"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.28.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "91fd8e38a3b50ed1167fb981cd6fd60147e091784c427b8f7183a7ee32c31c12"
+dependencies = [
+ "libc",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.28.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e368e7ddfdeb98c9bca7f8383be1648fd84ab466bf2bc015e94008db6d35611e"
+dependencies = [
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.28.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7f29e10af80b1f7ccaf7f69eace800a03ecd13e883acfacc1e5d0988605f651e"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.28.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "df6e520eff47c45997d2fc7dd8214b25dd1310918bbb2642156ef66a67f29813"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.28.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c4cdc218d835738f81c2338f822078af45b4afdf8b2e33cbb5916f108b813acb"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "pyo3-build-config",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.117"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e665b8803e7b1d2a727f4023456bbbbe74da67099c585258af0ad9c5013b9b99"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.13.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "adb6935a6f5c20170eeceb1a3835a49e12e19d792f6dd344ccc76a985ca5a6ca"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"

eyecore-1.0.0/Cargo.toml

@@ -0,0 +1,12 @@
+[package]
+name = "eyecore-core"
+version = "1.0.0"
+edition = "2021"
+readme = "README.md"
+
+[lib]
+name = "_core"
+crate-type = ["cdylib"]
+
+[dependencies]
+pyo3 = { version = "0.28", features = ["extension-module"] }

eyecore-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andrew Watts
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

eyecore-1.0.0/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: eyecore
+Version: 1.0.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Database
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Requires-Dist: requests>=2.28 ; extra == 'corpus'
+Requires-Dist: feedparser>=6.0 ; extra == 'feed'
+Requires-Dist: requests>=2.28 ; extra == 'feed'
+Requires-Dist: beautifulsoup4>=4.12 ; extra == 'feed'
+Requires-Dist: ollama>=0.1 ; extra == 'llm'
+Requires-Dist: openai>=1.0 ; extra == 'llm'
+Requires-Dist: llama-cpp-python>=0.2 ; extra == 'llm'
+Requires-Dist: llama-cpp-python>=0.2 ; extra == 'llm-cpp'
+Requires-Dist: ollama>=0.1 ; extra == 'llm-ollama'
+Requires-Dist: openai>=1.0 ; extra == 'llm-openai'
+Requires-Dist: pytest>=7.0 ; extra == 'test'
+Requires-Dist: pytest-cov>=4.0 ; extra == 'test'
+Provides-Extra: corpus
+Provides-Extra: feed
+Provides-Extra: llm
+Provides-Extra: llm-cpp
+Provides-Extra: llm-ollama
+Provides-Extra: llm-openai
+Provides-Extra: test
+License-File: LICENSE
+Summary: Core data retrieval and organisation library — SQLite DB, topic graph, corpus management, and LLM integration
+Keywords: database,knowledge-graph,corpus,llm
+Author-email: Andrew Watts <andrewkwatts@gmail.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/andrewkwatts-maker/EyeCore
+Project-URL: Issues, https://github.com/andrewkwatts-maker/EyeCore/issues
+Project-URL: Repository, https://github.com/andrewkwatts-maker/EyeCore
+
+# eyecore
+
+Core data retrieval and organisation library — SQLite DB management, topic graph, corpus management, and LLM integration.
+
+## Features
+
+- **BaseDB** — lazy SQLite connection with transparent `.db.gz` decompression to user cache
+- **TopicGraph** — generalized topic registry with parent/child relationships, BFS traversal, and typed links
+- **CorpusManager** — on-demand corpus checkout (Project Gutenberg, URL, git) with FTS5 indexing
+- **LLMClient** — lazy-loaded LLM wrapper with auto-detected backends (Ollama, llama-cpp, OpenAI-compatible)
+- **compress_db / decompress_to_cache** — platform-aware compression utilities for bake scripts
+
+## Installation
+
+```bash
+pip install eyecore
+```
+
+With optional extras:
+
+```bash
+pip install "eyecore[llm-ollama]"   # Ollama backend
+pip install "eyecore[llm-cpp]"      # llama-cpp-python backend
+pip install "eyecore[llm-openai]"   # OpenAI-compatible backend
+pip install "eyecore[corpus]"       # corpus download support
+```
+
+## Quick start
+
+```python
+from pathlib import Path
+from eyecore import BaseDB, TopicGraph, CorpusManager, LLMClient
+
+# Lazy SQLite — decompresses .db.gz to user cache on first access
+db = BaseDB("myapp", gz_path=Path("data/myapp.db.gz"))
+rows = db.fetchall("SELECT * FROM entities LIMIT 10")
+
+# Topic graph
+graph = TopicGraph(db.conn)
+related = graph.get_related("topic-id")
+tree    = graph.subtree("root-id")
+
+# LLM — auto-detects Ollama / llama-cpp / OpenAI
+llm = LLMClient.get()
+if llm.is_available():
+    summary = llm.summarize("Some long text to summarize...")
+    topics  = llm.extract_topics("Article text about AI and machine learning...")
+    report  = llm.generate_report(articles, "Technology", "title", "summary")
+```
+
+## LLM configuration
+
+Configure via environment variables:
+
+| Variable | Default | Description |
+|---|---|---|
+| `LLM_BACKEND` | auto | `ollama`, `llama-cpp`, or `openai` |
+| `LLM_MODEL` | `llama3` | Model name (Ollama) or model ID (OpenAI) |
+| `LLM_HOST` | `http://localhost:11434` | Ollama server URL |
+| `LLM_MODEL_PATH` | — | Path to GGUF model file (llama-cpp) |
+| `OPENAI_API_KEY` | — | API key for OpenAI-compatible endpoints |
+| `OPENAI_BASE_URL` | — | Base URL for OpenAI-compatible endpoints |
+
+
+## License
+
+MIT — see [LICENSE](LICENSE)
+

eyecore-1.0.0/README.md

@@ -0,0 +1,67 @@
+# eyecore
+
+Core data retrieval and organisation library — SQLite DB management, topic graph, corpus management, and LLM integration.
+
+## Features
+
+- **BaseDB** — lazy SQLite connection with transparent `.db.gz` decompression to user cache
+- **TopicGraph** — generalized topic registry with parent/child relationships, BFS traversal, and typed links
+- **CorpusManager** — on-demand corpus checkout (Project Gutenberg, URL, git) with FTS5 indexing
+- **LLMClient** — lazy-loaded LLM wrapper with auto-detected backends (Ollama, llama-cpp, OpenAI-compatible)
+- **compress_db / decompress_to_cache** — platform-aware compression utilities for bake scripts
+
+## Installation
+
+```bash
+pip install eyecore
+```
+
+With optional extras:
+
+```bash
+pip install "eyecore[llm-ollama]"   # Ollama backend
+pip install "eyecore[llm-cpp]"      # llama-cpp-python backend
+pip install "eyecore[llm-openai]"   # OpenAI-compatible backend
+pip install "eyecore[corpus]"       # corpus download support
+```
+
+## Quick start
+
+```python
+from pathlib import Path
+from eyecore import BaseDB, TopicGraph, CorpusManager, LLMClient
+
+# Lazy SQLite — decompresses .db.gz to user cache on first access
+db = BaseDB("myapp", gz_path=Path("data/myapp.db.gz"))
+rows = db.fetchall("SELECT * FROM entities LIMIT 10")
+
+# Topic graph
+graph = TopicGraph(db.conn)
+related = graph.get_related("topic-id")
+tree    = graph.subtree("root-id")
+
+# LLM — auto-detects Ollama / llama-cpp / OpenAI
+llm = LLMClient.get()
+if llm.is_available():
+    summary = llm.summarize("Some long text to summarize...")
+    topics  = llm.extract_topics("Article text about AI and machine learning...")
+    report  = llm.generate_report(articles, "Technology", "title", "summary")
+```
+
+## LLM configuration
+
+Configure via environment variables:
+
+| Variable | Default | Description |
+|---|---|---|
+| `LLM_BACKEND` | auto | `ollama`, `llama-cpp`, or `openai` |
+| `LLM_MODEL` | `llama3` | Model name (Ollama) or model ID (OpenAI) |
+| `LLM_HOST` | `http://localhost:11434` | Ollama server URL |
+| `LLM_MODEL_PATH` | — | Path to GGUF model file (llama-cpp) |
+| `OPENAI_API_KEY` | — | API key for OpenAI-compatible endpoints |
+| `OPENAI_BASE_URL` | — | Base URL for OpenAI-compatible endpoints |
+
+
+## License
+
+MIT — see [LICENSE](LICENSE)

eyecore-1.0.0/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["maturin>=1.4,<2.0"]
+build-backend = "maturin"
+
+[project]
+name = "eyecore"
+version = "1.0.0"
+description = "Core data retrieval and organisation library — SQLite DB, topic graph, corpus management, and LLM integration"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {file = "LICENSE"}
+authors = [
+    {name = "Andrew Watts", email = "andrewkwatts@gmail.com"},
+]
+keywords = ["database", "knowledge-graph", "corpus", "llm"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Database",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+]
+
+[project.optional-dependencies]
+llm-ollama  = ["ollama>=0.1"]
+llm-cpp     = ["llama-cpp-python>=0.2"]
+llm-openai  = ["openai>=1.0"]
+llm         = ["ollama>=0.1", "openai>=1.0", "llama-cpp-python>=0.2"]
+corpus      = ["requests>=2.28"]
+feed        = ["feedparser>=6.0", "requests>=2.28", "beautifulsoup4>=4.12"]
+test        = ["pytest>=7.0", "pytest-cov>=4.0"]
+
+[project.urls]
+Homepage = "https://github.com/andrewkwatts-maker/EyeCore"
+Repository = "https://github.com/andrewkwatts-maker/EyeCore"
+Issues = "https://github.com/andrewkwatts-maker/EyeCore/issues"
+
+[tool.maturin]
+python-source = "src"
+module-name = "eyecore._core"
+features = ["pyo3/extension-module"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

eyecore-1.0.0/src/eyecore/__init__.py

@@ -0,0 +1,105 @@
+"""
+eyecore — Core data retrieval and organisation library.
+
+Provides:
+  BaseDB        — lazy SQLite connection with transparent gz decompression
+  TopicGraph    — generalized topic registry with PK/FK parent/child links
+  CorpusManager — on-demand corpus download (Gutenberg / URL / git) + FTS indexing
+  LLMClient     — lazy-loaded LLM wrapper (ollama / llama-cpp / openai-compatible)
+  EntityDB      — base class for baked SQLite entity databases
+  cache_dir     — platform-appropriate user cache directory
+  compress_db   — compress a .db file to .db.gz
+  decompress_to_cache — decompress .db.gz to user cache on first use
+
+Corpus registry (shared reference texts, usable by any module):
+  from eyecore.corpus_registry import ALL_CORPUSES, get_by_topic, get_by_id
+
+Feed infrastructure (requires eyecore[feed]):
+  feed_data_dir, today_db, open_day, available_days, compress_old_days, insert_articles
+  add_source, remove_source, load_sources, scrape_all
+  cluster_by_keyword, cluster_with_llm, generate_topic_report, generate_daily_reports
+"""
+from __future__ import annotations
+
+try:
+    from ._core import sha256_hex, score_text, fuzzy_match as _fuzzy_match
+    _RUST_CORE = True
+except ImportError:
+    _RUST_CORE = False
+
+    def sha256_hex(data: bytes) -> str:
+        h: int = 5381
+        for b in data:
+            h = ((h * 33) + b) & 0xFFFFFFFFFFFFFFFF
+        return format(h, "016x")
+
+    def score_text(haystack: str, query: str) -> float:
+        h, q = haystack.lower(), query.lower()
+        if not q:
+            return 0.0
+        if h.startswith(q):
+            return 1000.0
+        if q in h:
+            return 500.0
+        return 0.0
+
+    def _fuzzy_match(text: str, pattern: str) -> bool:
+        qi = iter(pattern)
+        pc = next(qi, None)
+        for tc in text:
+            if tc == pc:
+                pc = next(qi, None)
+                if pc is None:
+                    return True
+        return pc is None
+
+from ._compress import cache_dir, compress_db, decompress_to_cache
+from ._db import BaseDB
+from ._graph import TopicGraph, GRAPH_SCHEMA
+from ._corpus import CorpusManager, CORPUS_REGISTRY_SCHEMA
+from ._llm import LLMClient
+from ._entity_db import EntityDB
+from ._feed_store import (
+    data_dir as feed_data_dir,
+    today_db,
+    open_day,
+    available_days,
+    compress_old_days,
+    insert_articles,
+)
+from ._feed_scraper import add_source, remove_source, load_sources, scrape_all
+from ._feed_report import cluster_by_keyword, cluster_with_llm, generate_topic_report, generate_daily_reports
+
+__version__ = "1.0.0"
+
+__all__ = [
+    "BaseDB",
+    "TopicGraph",
+    "CorpusManager",
+    "LLMClient",
+    "EntityDB",
+    "cache_dir",
+    "compress_db",
+    "decompress_to_cache",
+    "GRAPH_SCHEMA",
+    "CORPUS_REGISTRY_SCHEMA",
+    # Feed store
+    "feed_data_dir",
+    "today_db",
+    "open_day",
+    "available_days",
+    "compress_old_days",
+    "insert_articles",
+    # Feed scraper
+    "add_source",
+    "remove_source",
+    "load_sources",
+    "scrape_all",
+    # Feed report
+    "cluster_by_keyword",
+    "cluster_with_llm",
+    "generate_topic_report",
+    "generate_daily_reports",
+    "__version__",
+    "_RUST_CORE",
+]

eyecore-1.0.0/src/eyecore/_compress.py

@@ -0,0 +1,44 @@
+"""Shared compression / cache utilities — used by all libs in the suite."""
+from __future__ import annotations
+
+import gzip
+import os
+import platform
+import shutil
+from pathlib import Path
+
+
+def cache_dir(app_name: str) -> Path:
+    """Platform-appropriate user cache directory for *app_name*."""
+    system = platform.system()
+    if system == "Windows":
+        base = Path(os.environ.get("LOCALAPPDATA", Path.home() / "AppData" / "Local"))
+    elif system == "Darwin":
+        base = Path.home() / "Library" / "Caches"
+    else:
+        base = Path(os.environ.get("XDG_CACHE_HOME", Path.home() / ".cache"))
+    d = base / app_name
+    d.mkdir(parents=True, exist_ok=True)
+    return d
+
+
+def compress_db(db_path: Path, compresslevel: int = 9) -> Path:
+    """Compress *db_path* to *.db.gz* and delete the original. Returns gz path."""
+    gz = db_path.with_suffix(".db.gz")
+    with open(db_path, "rb") as src, gzip.open(gz, "wb", compresslevel=compresslevel) as dst:
+        shutil.copyfileobj(src, dst)
+    db_path.unlink()
+    return gz
+
+
+def decompress_to_cache(gz_path: Path, app_name: str) -> Path:
+    """Decompress *.db.gz* to the user cache dir on first use.
+
+    Cache key = gz file size — stable across pip installs, invalidates on re-bake.
+    Returns the path to the uncompressed *.db* file.
+    """
+    dest = cache_dir(app_name) / f"{app_name}-{gz_path.stat().st_size}.db"
+    if not dest.exists():
+        with gzip.open(gz_path, "rb") as src, open(dest, "wb") as dst:
+            shutil.copyfileobj(src, dst)
+    return dest

eyecore-1.0.0/src/eyecore/_core.pyi

@@ -0,0 +1,3 @@
+def sha256_hex(data: bytes) -> str: ...
+def score_text(haystack: str, query: str) -> float: ...
+def fuzzy_match(text: str, pattern: str) -> bool: ...