bathys 0.6.1__py3-none-any.whl

bathys/services.py

@@ -0,0 +1,263 @@
+"""Single-system bootstrap for the SearXNG backend.
+
+Order of attempts on a cold start:
+  1. already-running instance at BATHYS_SEARXNG_URL (someone else manages it);
+  2. container engine (docker compose / podman compose / docker-compose /
+     podman-compose) with the bundled compose.yaml — the standard way on a host;
+  3. native mode: a private searxng checkout + venv under BATHYS_SEARXNG_HOME,
+     cloned and installed on first run, started as a child subprocess — for
+     environments without any container engine (plain VPS, CI, containers
+     without docker-in-docker).
+
+The mode can be forced with BATHYS_START_MODE=docker|native.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import os
+import shutil
+import sys
+from pathlib import Path
+
+import httpx
+
+from .config import Config
+
+_REPO_URL = "https://github.com/searxng/searxng"
+_ENGINES = (
+    ("docker", "compose"),
+    ("podman", "compose"),
+    ("docker-compose",),
+    ("podman-compose",),
+)
+_GET_PIP_URL = "https://bootstrap.pypa.io/get-pip.py"
+
+_running_native: "_Native | None" = None
+
+
+async def _ping(cfg: Config, http: httpx.AsyncClient, timeout: float = 2.0) -> str | None:
+    try:
+        r = await http.get(cfg.searxng_url + "/search", params={"q": "ping", "format": "json"}, timeout=timeout)
+        if r.status_code == 200:
+            return None
+        return f"http {r.status_code}"
+    except (httpx.HTTPError, ValueError) as e:
+        return e.__class__.__name__
+
+
+async def _wait_ready(cfg: Config, http: httpx.AsyncClient, timeout: float) -> str | None:
+    loop = asyncio.get_running_loop()
+    deadline = loop.time() + timeout
+    while True:
+        err = await _ping(cfg, http)
+        if err is None:
+            return None
+        if loop.time() > deadline:
+            return err
+        await asyncio.sleep(1.5)
+
+
+async def _run(argv: list[str], cwd: Path | None = None, timeout: float = 120.0) -> tuple[int, str]:
+    proc = await asyncio.create_subprocess_exec(
+        *argv, cwd=cwd,
+        stdout=asyncio.subprocess.PIPE, stderr=asyncio.subprocess.STDOUT,
+    )
+    try:
+        out, _ = await asyncio.wait_for(proc.communicate(), timeout=timeout)
+    except asyncio.TimeoutError:
+        proc.kill()
+        return 124, "timeout"
+    return proc.returncode or 0, out.decode(errors="replace")[-800:]
+
+
+def _settings_file() -> Path:
+    return Path(__file__).resolve().parent / "searxng-settings.yml"
+
+
+def render_settings(base_text: str, env: dict[str, str] | None = None) -> str:
+    """F-203: optional API-engines injected from env keys — one key enables an
+    engine in the generated searxng settings. Native mode writes the rendered
+    text; keep the mapping deliberately tiny and explicit."""
+    env = env if env is not None else dict(os.environ)
+    blocks: list[str] = []
+    brave = env.get("BATHYS_ENGINE_BRAVE_KEY", "").strip()
+    if brave:
+        blocks.append(
+            "\nengines:\n"
+            "  - name: brave\n"
+            "    engine: brave\n"
+            "    shortcut: br\n"
+            f"    api_key: {brave}\n"
+            "    inactive: false\n"
+        )
+    text = base_text
+    if blocks:
+        text = text.rstrip("\n") + "\n" + "".join(blocks)
+    return text
+
+
+def _compose_file() -> Path:
+    return Path(__file__).resolve().parent / "compose.yaml"
+
+
+async def _start_containers(cfg: Config) -> None:
+    if cfg.start_cmd:
+        argv = cfg.start_cmd.split()
+    else:
+        engine = None
+        for cmd in _ENGINES:
+            if all(shutil.which(c) for c in cmd):
+                engine = cmd
+                break
+        if engine is None:
+            raise FileNotFoundError("no container engine (docker/podman) found")
+        argv = [*engine, "-f", str(_compose_file()), "up", "-d"]
+    rc, out = await _run(argv, timeout=600)
+    if rc != 0:
+        raise RuntimeError(out.strip() or f"exit {rc}")
+
+
+class _Native:
+    """searxng checkout + venv under one home dir, run as a child process."""
+
+    def __init__(self, home: Path, ref: str) -> None:
+        self.home = home
+        self.repo = home / "repo"
+        self.venv = home / "venv"
+        self._ref = ref
+        self.proc: asyncio.subprocess.Process | None = None
+        self.log_path = home / "searxng.log"
+
+    async def prepare(self) -> None:
+        self.home.mkdir(parents=True, exist_ok=True)
+        if not (self.repo / "searx" / "webapp.py").is_file():
+            rc, out = await _run(
+                ["git", "clone", "--depth", "1", _REPO_URL, str(self.repo)],
+                timeout=300,
+            )
+            if rc != 0:
+                raise RuntimeError(f"git clone searxng failed: {out.strip()}")
+        await self._ensure_ref()
+        await self._ensure_venv()
+        marker = self.venv / ".searxng-reqs-done"
+        if not marker.is_file():
+            rc, out = await _run(
+                [str(self.venv / "bin" / "pip"), "install", "-q", "-r", str(self.repo / "requirements.txt")],
+                timeout=900,
+            )
+            if rc != 0:
+                raise RuntimeError(f"searxng requirements install failed: {out.strip()}")
+            marker.write_text("ok")
+
+    async def _ensure_ref(self) -> None:
+        """Pin the checkout to the configured ref (SHA by default); upstream has
+        no tags, so a full-SHA pin replaces the old `master` clone (F-302).
+        Skips the network when the marker already matches the ref."""
+        ref = self._ref
+        marker = self.repo / ".bathys-ref"
+        if marker.is_file() and marker.read_text().strip() == ref:
+            return
+        rc, out = await _run(["git", "-C", str(self.repo), "fetch", "-q", "origin"], timeout=300)
+        if rc != 0:
+            raise RuntimeError(f"git fetch searxng failed: {out.strip()}")
+        rc, out = await _run(["git", "-C", str(self.repo), "checkout", "-q", ref], timeout=120)
+        if rc != 0:
+            raise RuntimeError(f"git checkout {ref} failed: {out.strip()}")
+        marker.write_text(ref)
+
+    async def _ensure_venv(self) -> None:
+        """`python -m venv` needs ensurepip, which minimal debian images lack;
+        fall back to venv --without-pip + get-pip.py bootstrap."""
+        pip = self.venv / "bin" / "pip"
+        if pip.is_file():
+            return
+        rc, out = await _run([sys.executable, "-m", "venv", str(self.venv)], timeout=120)
+        if rc != 0 or not pip.is_file():
+            shutil.rmtree(self.venv, ignore_errors=True)
+            rc, out = await _run([sys.executable, "-m", "venv", "--without-pip", str(self.venv)], timeout=120)
+            if rc != 0:
+                raise RuntimeError(f"venv creation failed: {out.strip()}")
+            getter = self.home / "get-pip.py"
+            rc, out = await _run(["curl", "-sS", _GET_PIP_URL, "-o", str(getter)], timeout=120)
+            if rc != 0 or not getter.is_file():
+                raise RuntimeError(f"cannot download get-pip.py: {out.strip()}")
+            rc, out = await _run([str(self.venv / "bin" / "python"), str(getter), "-q"], timeout=300)
+            if rc != 0 or not pip.is_file():
+                raise RuntimeError(f"pip bootstrap failed: {out.strip()}")
+        await _run([str(pip), "install", "-q", "-U", "pip"], timeout=300)
+
+    async def start(self, cfg: Config) -> None:
+        await self.prepare()
+        settings = self.home / "settings.yml"
+        settings.write_text(render_settings(_settings_file().read_text()))
+        log = open(self.log_path, "ab")
+        env = dict(os.environ, SEARXNG_SETTINGS_PATH=str(settings))
+        self.proc = await asyncio.create_subprocess_exec(
+            str(self.venv / "bin" / "python"), "-m", "searx.webapp",
+            cwd=str(self.repo), env=env,
+            stdout=log, stderr=asyncio.subprocess.STDOUT,
+        )
+
+    async def stop(self) -> None:
+        if self.proc is not None and self.proc.returncode is None:
+            try:
+                self.proc.terminate()
+                await asyncio.wait_for(self.proc.wait(), timeout=5)
+            except asyncio.TimeoutError:
+                self.proc.kill()
+            except Exception:
+                pass
+        self.proc = None
+
+
+def _native(cfg: Config) -> _Native:
+    global _running_native
+    if _running_native is None:
+        _running_native = _Native(cfg.searxng_home, cfg.searxng_ref)
+    return _running_native
+
+
+async def stop_native() -> None:
+    global _running_native
+    if _running_native is not None:
+        await _running_native.stop()
+        _running_native = None
+
+
+async def ensure_running(cfg: Config, http: httpx.AsyncClient) -> str:
+    """Make sure /search answers at cfg.searxng_url; start a backend if allowed.
+    Returns the mode that served the request: external | docker | native."""
+    err = await _ping(cfg, http)
+    if err is None:
+        return "external"
+    if not cfg.auto_start:
+        raise RuntimeError(
+            f"searxng at {cfg.searxng_url} is not answering ({err}); "
+            "BATHYS_AUTO_START=0 disables the built-in backend"
+        )
+    attempts: list[str] = []
+    mode = cfg.start_mode
+    if mode in ("auto", "docker"):
+        try:
+            await _start_containers(cfg)
+        except Exception as e:
+            attempts.append(f"docker: {e}")
+        else:
+            err2 = await _wait_ready(cfg, http, cfg.startup_timeout)
+            if err2 is None:
+                return "docker"
+            attempts.append(f"docker: not ready ({err2})")
+    if mode in ("auto", "native"):
+        nat = _native(cfg)
+        try:
+            if nat.proc is None or nat.proc.returncode is not None:
+                await nat.start(cfg)
+        except Exception as e:
+            attempts.append(f"native: {e}")
+        else:
+            err3 = await _wait_ready(cfg, http, cfg.startup_timeout)
+            if err3 is None:
+                return "native"
+            attempts.append(f"native: not ready ({err3}; log: {nat.log_path})")
+    raise RuntimeError("could not start searxng backend — " + "; ".join(attempts))

bathys-0.6.1.dist-info/METADATA

@@ -0,0 +1,147 @@
+Metadata-Version: 2.5
+Name: bathys
+Version: 0.6.1
+Summary: Deep-research MCP server: SearXNG metasearch + Crawl4AI extraction, distilled to LLM-lean output
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: crawl4ai>=0.6.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp<2,>=1.2.0
+Description-Content-Type: text/markdown
+
+<p align="center"><img src="docs/assets/banner.svg" alt="Bathys" width="720"></p>
+
+# Bathys
+
+**Единый локальный поисковый сервис глубокого ресёрча для ИИ-агентов.** Один процесс владеет всем конвейером — поиск → извлечение → дистилляция под запрос → кэш — и всей стратегией ресёрча: что искать, какие страницы читать, сколько вернуть. Агент видит лишь интерфейс из четырёх MCP-инструментов; SearXNG и Crawl4AI работают внутри как сменные движки. Облачных квот и API-ключей нет, LLM внутри нет — дистилляция детерминированная (BM25).
+
+Сонар находит координаты, батискаф ныряет за полными текстами, дистиллятор поднимает на палубу только то, что отвечает на вопрос.
+
+![python](https://img.shields.io/badge/python-3.10%2B-blue)
+![version](https://img.shields.io/badge/version-0.6.1-9cf)
+![mcp](https://img.shields.io/badge/MCP-stdio%20server-6f42c1)
+![license](https://img.shields.io/badge/license-MIT-green)
+
+## ⚡ Quick start
+
+Нужны Python ≥ 3.10 и `git`. В каталоге проекта:
+
+```bash
+git clone https://github.com/Korrnals/bathys.git && cd bathys
+python3.12 -m venv .venv
+.venv/bin/pip install -e .
+.venv/bin/python -m playwright install chromium   # браузер для извлечения
+.venv/bin/python -m unittest discover -s tests    # 72 теста без сети, ~0.1 c
+.venv/bin/bathys-doctor                           # диагностика стека одним запуском
+```
+
+В минимальном контейнерном образе без `ensurepip` venv собирается через `get-pip.py` — ветка в [docs/getting-started/install.md](docs/getting-started/install.md). SearXNG поднимать руками не нужно: при первом поиске сервер сам пробует внешний инстанс, затем docker/podman, затем нативный режим ([docs/getting-started/configure.md](docs/getting-started/configure.md)).
+
+## 🔌 Подключение к харнессу
+
+**Автоматически.** Одна команда найдёт харнессы по стандартным путям, пропишет сервер с бэкапом конфига и (с `--with-agent`) скопирует субагента:
+
+```bash
+.venv/bin/bathys install            # сначала --dry-run, чтобы увидеть план
+```
+
+Детектируются zcode, Claude Code, Claude Desktop, Cursor; повторный запуск ничего не меняет — запись идемпотентна. Поддерживаются `--print-config` (готовые блоки для ручной вставки) и `--searxng-home <путь>`.
+
+**Вручную.** Bathys — stdio MCP-сервер, конфиг везде один и тот же блок `mcpServers`; от харнесса зависит только файл, в который его кладут. `command` — абсолютный путь к вашему клону (`~` внутри JSON не раскрывается); `BATHYS_SEARXNG_HOME` опциональна.
+
+```json
+{
+  "mcpServers": {
+    "bathys": {
+      "command": "/path/to/bathys/.venv/bin/bathys",
+      "env": {
+        "BATHYS_SEARXNG_HOME": "/path/to/bathys/.runtime/searxng-home"
+      }
+    }
+  }
+}
+```
+
+| Харнесс | Гайд |
+|---|---|
+| zcode | [docs/integrations/zcode.md](docs/integrations/zcode.md) |
+| Claude Code / Claude Desktop | [docs/integrations/claude-code.md](docs/integrations/claude-code.md) |
+| Cursor | [docs/integrations/cursor.md](docs/integrations/cursor.md) |
+| Любой другой MCP-клиент | [docs/integrations/generic-mcp.md](docs/integrations/generic-mcp.md) |
+
+## 🧠 Научить агента работать эффективно
+
+Конфиг — только половина дела. Из коробки харнесс получает **instructions-playbook** (матрицу выбора инструментов), **annotations** и **три стратегии-промпта** — `bathys_deep_research`, `bathys_source_audit`, `bathys_fresh_scan`, — так что выбирает инструменты Bathys уже нативно. Сильнее — профиль: субагент [`agents/bathys-researcher.md`](agents/bathys-researcher.md) с двумя скиллами, которому глубокий ресёрч делегируется целиком; для клиентов, не показывающих MCP instructions, — дроп-ин [`agents/HARNESS-DROPIN.md`](agents/HARNESS-DROPIN.md) в `AGENTS.md` / `CLAUDE.md` / `.cursor/rules`.
+
+Пошаговая инструкция «из коробки → субагент → дроп-ин» и таблица сигналов футеров — в [«Живых кейсах», раздел C](docs/getting-started/cases.md#c-как-научить-харнесс-работать-с-bathys-эффективно).
+
+## 🧭 Ходовые кейсы
+
+**Сравнение технологий.** «Сравни SQLite WAL и PostgreSQL под нагрузку — что выбрать в 2026?» → агент вызывает `deep_research`, доуточняет запрос терминами из найденного и верифицирует вывод по двум источникам. Итог: один вызов вместо цепочки «поиск + N чтений», в контекст попадает 7.5k символов вместо ~35k.
+
+```text
+[bathys: 34 raw hits, top 8 considered · dove 3 pages · 35669 ch fetched → 7508 ch returned · 1.3s]
+```
+
+**Аудит спорного утверждения.** «Правда ли, что в X упали замеры?» → стратегия `bathys_source_audit`: пакетное чтение ссылок из обсуждения + кросс-поиск опровержений → вердикт по каждому тезису с URL. Битая ссылка стоит одну строку, а не сорванный вызов.
+
+**Свежий срез.** «Что нового в Y за две недели?» → `bathys_fresh_scan`: поиск с `time_range=week` → пакетное чтение → сводка с датами; протухший `cache HIT` лечится одним `refresh=true`.
+
+Все кейсы — пользовательские, автономных агентов и эксплуатация — с живыми диалогами и профитом каждого: **[«Живые кейсы» → docs/getting-started/cases.md](docs/getting-started/cases.md)**.
+
+## 🛠 Инструменты
+
+| Инструмент | Что делает |
+|---|---|
+| `deep_research(query, max_sources=3, …)` | ищет, параллельно читает топ-источники, возвращает слитый дистиллят под запрос. Первый вызов для любого ресёрч-вопроса. |
+| `web_search(query, max_results=8, …)` | ранжированный список ссылок со сниппетами без содержимого страниц; `as_json=true` — чистый JSON для программ. |
+| `read_url(url, query=None, max_chars=8000)` | читает одну страницу; с `query` — только релевантные пассажи. |
+| `read_urls(urls, query=None, total_chars=12000)` | пакетно читает до 10 известных страниц; бюджет делится между успешными, сбой страницы — одна строка, не сорванный вызов. |
+
+Поиск сужается общими фильтрами `time_range`, `category`, `engines`, `language`. Живой футер ответа показывает сжатие и кэш: `[bathys: 41 raw hits, top 3 considered · dove 3 pages · 35669 ch fetched → 7508 ch returned · 3.2s]`.
+
+## 📊 Экономия токенов
+
+Шкала честная и символьная, токены ≈ `chars/4`; каждая цифра взята из футера реального вызова.
+
+| Вызов | Из сети | Агенту | Сжатие |
+|---|---|---|---|
+| `web_search` | 37 549 симв. | 1 986 симв. | 18.9× |
+| `read_url` | 17 063 симв. | 2 325 симв. | 7.3× |
+| `deep_research` (3 страницы) | 35 669 симв. | 7 508 симв. | 4.7× |
+
+- **Дистилляция под запрос** — пять стадий очистки (JS-рендер → вырезание бойлерплейта → `PruningContentFilter` → схлопывание markdown → BM25-отбор пассажей) с жёсткими бюджетами символов.
+- **Кэш сырца до дистилляции** — SQLite хранит сырой текст, поэтому перечитать страницу под другим углом можно бесплатно и без сети.
+- **Ноль облачных квот** — `deep_research` заменяет цепочку «поиск + N чтений», то есть N+1 списаний квоты, одним локальным вызовом.
+
+Методика и пороги — в [docs/operations/metrics.md](docs/operations/metrics.md).
+
+## 📚 Документация
+
+Хаб с маршрутами «с чего начать» — [docs/index.md](docs/index.md).
+
+```
+docs/
+├── index.md          # хаб: дерево + три маршрута чтения
+├── getting-started/  # установка · конфигурация · подключение · живые кейсы
+├── integrations/     # zcode · claude-code · cursor · generic-mcp
+├── architecture/     # компоненты · конвейер очистки · потоки данных
+├── contracts/        # инструменты · футеры · модули · конфиг (19 env)
+├── operations/       # runbook · метрики токен-экономии
+├── product/          # хартия · реестр функций · роадмап · конкуренты
+├── adr/              # шесть принятых архитектурных решений
+└── meta/             # стайлгайд · глоссарий
+```
+
+Вне `docs/`: [agents/](agents/) (субагент `bathys-researcher`, дроп-ин для харнессов) · [tests/](tests/) (72 юнит-теста без сети) · [scripts/](scripts/) (smoke, stdio_check, метрики) · [CHANGELOG.md](CHANGELOG.md).
+
+## 📍 Статус
+
+**0.6.1.** Выпускная история: v0.2 «Качество выдачи» (ретраи, здоровье движков), v0.3 «Паритет с Tavily» (`read_urls`, JSON-режим), v0.4 «Эксплуатация» (robots-этика, метрики, `bathys-doctor`), v0.5 «Identity & Harness» (репозиционирование, промпты, субагент), v0.6 «Native Install» (`bathys install`) — итоги в [CHANGELOG.md](CHANGELOG.md).
+
+Репозиторий: `github.com/Korrnals/bathys`. До 1.0 остаются публикация пакета `bathys` на PyPI (имя свободно, публикация планируется к 1.0) и первый прогон Docker-образа; CI с matrix 3.10–3.12 уже в репозитории.
+
+## ⚖️ Лицензия
+
+[MIT](LICENSE) — см. поле `license` в `pyproject.toml`.

bathys-0.6.1.dist-info/RECORD

@@ -0,0 +1,23 @@
+bathys/__init__.py,sha256=QmtPmLBjgmftKbl0cainuRqm7HoVQoLOSgw1VDS9fUY,277
+bathys/batch.py,sha256=q2NJUeKHHfWGOjpYfxkaSm-S7k1FDeMvoj0A2pbBryQ,3407
+bathys/cache.py,sha256=9OH_w41nfOMPlUgamFPH5o3JHRBL68aUpjQ1M4mwY-E,1588
+bathys/compose.yaml,sha256=InwIIabms5bDBdd9jTrLyzz5A5CiBBuZXJHdZCXdHV8,734
+bathys/config.py,sha256=_IXBayDnDfol9twgSwGSXjg19mXXy4aWzefMtn5vXxM,2913
+bathys/core.py,sha256=ytP3d538YLouR2qgzl0XXqjs5ObayvpMq04VnZNucxw,18819
+bathys/crawler.py,sha256=7xU0ydoswLsl5eHMgBYKABwIla-zsgMy13WUGjYWarw,3600
+bathys/distill.py,sha256=VgLI0dZjeeyPJjbze0AgRedAk5DF317iYrd_rsby19Y,5269
+bathys/doctor.py,sha256=BugLmZ91xyAgkwIhKHwLteywzGhfI-KvFEdmQ1RfuQ8,4821
+bathys/installer.py,sha256=8O9AaNZyXh7pXciu1R-Ua6NLOGxPn76KIZb9RczwbgU,18068
+bathys/searx.py,sha256=oHYxbDoKQFZmo75LObq7qgNLkq_l4eqMVczCdbnmQwg,4416
+bathys/searxng-settings.yml,sha256=veNGKNvX8KhO869gzFUd7RGBLjp2MumUu7xzNn8yjE4,397
+bathys/server.py,sha256=d0V2OhibLeJhRO0hv4HCkck3qF0AyLFp_8JxV8wQzI0,20351
+bathys/services.py,sha256=Cx5uGmywWSWituwLi6vmIAWQzV04g_jSovVpLn0XpOA,9993
+bathys/agents/HARNESS-DROPIN.md,sha256=Nrrx-up8YfpifOheHK6tiKDqBuZsjEwxDXMsJbL8U0I,3830
+bathys/agents/bathys-researcher.md,sha256=ABkbSNmV3WnPpgSF_E8ccAyB-6thqEGDBpHMYHa6KUs,7467
+bathys/agents/skills/bathys-deep-dive/SKILL.md,sha256=9QjHqf6Q-kg6DnV92zZayESkQPU9IZlO-u4W8J9YMN4,3890
+bathys/agents/skills/bathys-source-audit/SKILL.md,sha256=XwpYR5--Z7DZkZjrgk5J-ttwApTM64ESoi6i-_8M9Kc,3418
+bathys-0.6.1.dist-info/METADATA,sha256=k99VYCDX6HQZww8CRkQMPFqNyXko5TA9xRSqrmuumrM,12309
+bathys-0.6.1.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+bathys-0.6.1.dist-info/entry_points.txt,sha256=7zVSZ8P_wpf6_awxaiOgFAz70skHGZpV8LdT-AWNX_s,120
+bathys-0.6.1.dist-info/licenses/LICENSE,sha256=7JZBFk7EhBscBnceBwIinx-VehGimQDH1hjwWWc-Ulc,1076
+bathys-0.6.1.dist-info/RECORD,,

bathys-0.6.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

bathys-0.6.1.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+bathys = bathys.server:main
+bathys-doctor = bathys.doctor:main
+bathys-install = bathys.installer:main

bathys-0.6.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bathys contributors
+
+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.