Run the CLI tool in try-except block to catch all exceptions.

Start the DHT service in background thread. Args: timeout: Maximum time to wait for service to start. Returns:

Stop the DHT client. Args: timeout: Maximum time to wait for service to stop.

Decode the Bing-wrapped raw_url to extract the original url.

Check if a key may be present.

Enter the context manager.

Enter the context manager and return the DDGS instance.

Exit the context manager.

Exit the context manager.

Initialize the HttpClient object. Args: headers (dict, optional): headers for the HTTP client. proxy (str, optional):

Initialize the HttpClient object. Args: proxy (str, optional): proxy for the HTTP client, supports http/https/socks5 protocols.

Temporary, delete when HttpClient is fixed.

Return the number of items in the cache.

Get total number of cached entries.

Cleanup any spawned API server process on exit.

Normalize date from integer to ISO format if applicable.

Normalize text. Strip HTML tags, unescape HTML entities, normalize Unicode, remove "c" category characters, and collapse whitespace.

Unquote URL and replace spaces with '+'.

Background task to refresh DHT records periodically.

Run Trio event loop in background thread with all DHT operations.

Run Trio event loop in background thread.

Get the age of the cached result in seconds.

Start/stop the DDGS API server. Starts a FastAPI server with REST endpoints for search tools. Supports text, image, news, video, and book sea

Get average DHT query latency in milliseconds.

CLI function to perform a DDGS books metasearch.

Build a payload for the search request.

Build a payload for the search request.

Build a payload for the search request.

Build a payload for the search request.

Build a payload for the search request.

Build a payload for the search request.

Build a payload for the Bing search request.

Build a payload for the Bing search request.

Build a payload for the search request.

Build a payload for the Google search request.

Build a payload for the search request.

Build a payload for the search request.

Build a payload for the search request.

Build a payload for the Startpage search request.

Build a payload for the search request.

Build a payload for the search request.

Build a payload for the search request.

Get the number of cached entries.

Get number of cached entries.

Cache results to DHT.

Get the size of the cache in bytes.

Get cache size in bytes.

Remove all expired entries.

Connect to a specific peer. Args: peer_addr: The multiaddress of the peer to connect to. Returns: True if co

Get local DHT network map view as graph structure. Each node only sees its own routing table neighborhood. No global crawling, no gos

Get DHT metrics in Prometheus format.

Get list of connected DHT peers.

Get detailed information about all connected peers.

Get DHT service status.

CLI function to extract content from a URL.

Extract content from a URL. Args: url: The URL to fetch and extract content from. fmt: Output format: "text_markdown", "text_plai

Extract text content from a URL.

Extract text content from a URL via GET request.

Extract search results from html text.

Extract search results from lxml tree.

Extract search results from lxml tree.

Extract search results from html text.

Extract search results from html text.

Extract search results from html text.

Make a GET request to the HTTP client.

Get cached results from DHT.

Get a shared DHT client instance. Args: api_url: URL of the ddgs API service. If None, uses direct mode. Returns: A started

Health check endpoint.

CLI function to perform a DDGS images metasearch.

Invalidate cached results.

Check if the node has been seen in the last 5 minutes.

Check if the DHT client is connected.

Check if the cached result is still valid based on TTL.