refactor(web): remove legacy in-tree provider modules

Deletes tools/web_providers/{brave_free,ddgs,searxng}.py — the three
providers that moved to plugins/web/ in prior commits. tools/web_tools.py
no longer imports them (registry dispatch as of d8735963f), so removing
them is purely a cleanup pass.

Also migrates the existing tests to the new import paths:
  tests/tools/test_web_providers_brave_free.py
  tests/tools/test_web_providers_ddgs.py
  tests/tools/test_web_providers_searxng.py

Mechanical rewrites:
  - `from tools.web_providers.X import YSearchProvider`
      -> `from plugins.web.X.provider import YWebSearchProvider`
  - `.is_configured()` -> `.is_available()`        (legacy method  -> new method)
  - `.provider_name()` -> `.name`                  (legacy method  -> new property)
  - `from tools.web_providers.base import WebSearchProvider`
      -> `from agent.web_search_provider import WebSearchProvider`
      (the subclass-check asserts membership in the new plugin-facing ABC)
  - `sys.modules.delitem("tools.web_providers.ddgs")` updated to point at
    `plugins.web.ddgs.provider` (cache-busting for lazy ddgs imports)

The TestXBackendWiring / TestXSearchOnlyErrors classes (covering
_is_backend_available, _get_backend, check_web_api_key, and the
"search-only" error paths in web_extract/web_crawl) are untouched —
those still test web_tools.py's backend-selection logic, which continues
to recognize the names "brave-free" / "ddgs" / "searxng" even after the
modules behind them moved to plugins.

tools/web_providers/base.py is intentionally NOT deleted by this commit
— it's the parent ABC of the legacy modules and shares its name with
agent/web_search_provider.py::WebSearchProvider. Removing it surfaces the
naming collision (see PR description Finding 0); the real migration PR
deletes it in the same commit that drops the _WEB_PLUGIN_SKIPLIST
guards in hermes_cli/tools_config.py.

Test results:
  bash scripts/run_tests.sh tests/tools/test_web_providers_*.py
  -> 65 passed in 3.41s (all rewritten unit tests + unchanged integration tests)
  bash scripts/run_tests.sh tests/tools/test_web_*.py
  -> 141 passed in 4.70s (full web test set, post-deletion)
This commit is contained in:
kshitijk4poor 2026-05-13 23:52:02 +05:30 committed by Teknium
parent 714630110b
commit 6b219f5af6
9 changed files with 105 additions and 462 deletions

View file

@ -1,8 +1,8 @@
"""Tests for the DuckDuckGo (ddgs) web search provider.
Covers:
- DDGSSearchProvider.is_configured() reflects package importability
- DDGSSearchProvider.search() happy path, missing package, runtime error
- DDGSWebSearchProvider.is_available() reflects package importability
- DDGSWebSearchProvider.search() happy path, missing package, runtime error
- Result normalization (title, url, description, position)
- _is_backend_available("ddgs") / _get_backend() integration
- web_extract / web_crawl return search-only errors when ddgs is active
@ -40,21 +40,21 @@ def _install_fake_ddgs(monkeypatch, *, text_results=None, text_raises=None):
# ---------------------------------------------------------------------------
# DDGSSearchProvider unit tests
# DDGSWebSearchProvider unit tests
# ---------------------------------------------------------------------------
class TestDDGSProviderIsConfigured:
def test_configured_when_package_importable(self, monkeypatch):
_install_fake_ddgs(monkeypatch)
# Drop any cached ``tools.web_providers.ddgs`` so is_configured re-imports ddgs fresh
monkeypatch.delitem(sys.modules, "tools.web_providers.ddgs", raising=False)
from tools.web_providers.ddgs import DDGSSearchProvider
assert DDGSSearchProvider().is_configured() is True
# Drop any cached ``plugins.web.ddgs.provider`` so is_configured re-imports ddgs fresh
monkeypatch.delitem(sys.modules, "plugins.web.ddgs.provider", raising=False)
from plugins.web.ddgs.provider import DDGSWebSearchProvider
assert DDGSWebSearchProvider().is_available() is True
def test_not_configured_when_package_missing(self, monkeypatch):
monkeypatch.delitem(sys.modules, "ddgs", raising=False)
monkeypatch.delitem(sys.modules, "tools.web_providers.ddgs", raising=False)
monkeypatch.delitem(sys.modules, "plugins.web.ddgs.provider", raising=False)
# Block the import so ``import ddgs`` raises ImportError even if the package is actually installed
import builtins
orig_import = builtins.__import__
@ -65,17 +65,17 @@ class TestDDGSProviderIsConfigured:
return orig_import(name, *args, **kwargs)
monkeypatch.setattr(builtins, "__import__", blocked_import)
from tools.web_providers.ddgs import DDGSSearchProvider
assert DDGSSearchProvider().is_configured() is False
from plugins.web.ddgs.provider import DDGSWebSearchProvider
assert DDGSWebSearchProvider().is_available() is False
def test_provider_name(self):
from tools.web_providers.ddgs import DDGSSearchProvider
assert DDGSSearchProvider().provider_name() == "ddgs"
from plugins.web.ddgs.provider import DDGSWebSearchProvider
assert DDGSWebSearchProvider().name == "ddgs"
def test_implements_web_search_provider(self):
from tools.web_providers.base import WebSearchProvider
from tools.web_providers.ddgs import DDGSSearchProvider
assert issubclass(DDGSSearchProvider, WebSearchProvider)
from agent.web_search_provider import WebSearchProvider
from plugins.web.ddgs.provider import DDGSWebSearchProvider
assert issubclass(DDGSWebSearchProvider, WebSearchProvider)
class TestDDGSProviderSearch:
@ -85,9 +85,9 @@ class TestDDGSProviderSearch:
{"title": "B", "href": "https://b.example.com", "body": "desc B"},
{"title": "C", "href": "https://c.example.com", "body": "desc C"},
])
from tools.web_providers.ddgs import DDGSSearchProvider
from plugins.web.ddgs.provider import DDGSWebSearchProvider
result = DDGSSearchProvider().search("q", limit=5)
result = DDGSWebSearchProvider().search("q", limit=5)
assert result["success"] is True
web = result["data"]["web"]
@ -99,9 +99,9 @@ class TestDDGSProviderSearch:
_install_fake_ddgs(monkeypatch, text_results=[
{"title": "A", "url": "https://a.example.com", "body": "desc A"},
])
from tools.web_providers.ddgs import DDGSSearchProvider
from plugins.web.ddgs.provider import DDGSWebSearchProvider
result = DDGSSearchProvider().search("q", limit=5)
result = DDGSWebSearchProvider().search("q", limit=5)
assert result["success"] is True
assert result["data"]["web"][0]["url"] == "https://a.example.com"
@ -111,16 +111,16 @@ class TestDDGSProviderSearch:
{"title": f"R{i}", "href": f"https://r{i}.example.com", "body": ""}
for i in range(10)
])
from tools.web_providers.ddgs import DDGSSearchProvider
from plugins.web.ddgs.provider import DDGSWebSearchProvider
result = DDGSSearchProvider().search("q", limit=3)
result = DDGSWebSearchProvider().search("q", limit=3)
assert result["success"] is True
assert len(result["data"]["web"]) == 3
def test_missing_package_returns_failure(self, monkeypatch):
monkeypatch.delitem(sys.modules, "ddgs", raising=False)
monkeypatch.delitem(sys.modules, "tools.web_providers.ddgs", raising=False)
monkeypatch.delitem(sys.modules, "plugins.web.ddgs.provider", raising=False)
import builtins
orig_import = builtins.__import__
@ -130,25 +130,25 @@ class TestDDGSProviderSearch:
return orig_import(name, *args, **kwargs)
monkeypatch.setattr(builtins, "__import__", blocked_import)
from tools.web_providers.ddgs import DDGSSearchProvider
from plugins.web.ddgs.provider import DDGSWebSearchProvider
result = DDGSSearchProvider().search("q", limit=5)
result = DDGSWebSearchProvider().search("q", limit=5)
assert result["success"] is False
assert "ddgs" in result["error"].lower()
def test_runtime_error_returns_failure(self, monkeypatch):
_install_fake_ddgs(monkeypatch, text_raises=RuntimeError("rate limited 202"))
from tools.web_providers.ddgs import DDGSSearchProvider
from plugins.web.ddgs.provider import DDGSWebSearchProvider
result = DDGSSearchProvider().search("q", limit=5)
result = DDGSWebSearchProvider().search("q", limit=5)
assert result["success"] is False
assert "rate limited" in result["error"] or "failed" in result["error"].lower()
def test_empty_results(self, monkeypatch):
_install_fake_ddgs(monkeypatch, text_results=[])
from tools.web_providers.ddgs import DDGSSearchProvider
from plugins.web.ddgs.provider import DDGSWebSearchProvider
result = DDGSSearchProvider().search("nothing", limit=5)
result = DDGSWebSearchProvider().search("nothing", limit=5)
assert result["success"] is True
assert result["data"]["web"] == []