U h"@s<dZddlmZmZmZddlmZmZGdddeZdS)ziUtil that calls DuckDuckGo Search. No setup required. Free. https://pypi.org/project/duckduckgo-search/ )DictListOptional) BaseModelroot_validatorc@seZdZUdZdZeeed<dZeed<dZ eeed<dZ e ed <d Z eed <d Z eed <GdddZeddeedddZd!eee eeeefdddZd"eee eeeefdddZeedddZd#ee eeeeeefddd ZdS)$DuckDuckGoSearchAPIWrapperzQWrapper for DuckDuckGo Search API. Free and does not require any setup. zwt-wtregionZmoderate safesearchytime max_resultsapibackendtextsourcec@seZdZdZdS)z!DuckDuckGoSearchAPIWrapper.ConfigZforbidN)__name__ __module__ __qualname__extrarrS/tmp/pip-unpacked-wheel-9gdii04g/langchain_community/utilities/duckduckgo_search.pyConfig(srT)pre)valuesreturncCs2zddlm}Wntk r,tdYnX|S)z3Validate that python package exists in environment.rDDGSzmCould not import duckduckgo-search python package. Please install it with `pip install -U duckduckgo-search`.)duckduckgo_searchr ImportError)clsrrrrrvalidate_environment+s z/DuckDuckGoSearchAPIWrapper.validate_environmentN)queryr rc Csdddlm}|H}|j||j|j|j|p.|j|jd}|rVdd|DW5QRSW5QRXgS)zGsz9DuckDuckGoSearchAPIWrapper._ddgs_text..)rrrrr r r rselfr"r rZddgsZddgs_genrrr _ddgs_text7s $z%DuckDuckGoSearchAPIWrapper._ddgs_textc Cs`ddlm}|D}|j||j|j|j|p.|jd}|rRdd|DW5QRSW5QRXgS)z.)rrnewsrr r r r(rrr _ddgs_newsJs $z%DuckDuckGoSearchAPIWrapper._ddgs_news)r"rcCsL|jdkr||}n|jdkr,||}ng}|s8dSddd|DS)z=Run query through DuckDuckGo and return concatenated results.rr+*No good DuckDuckGo Search Result was found css|]}|dVqdS)bodyNrr$rrr gsz1DuckDuckGoSearchAPIWrapper.run..)rr*r,join)r)r"resultsrrrrun\s    zDuckDuckGoSearchAPIWrapper.run)r"r rrcCsh|p|j}|dkr,dd|j||dD}n&|dkrNdd|j||dD}ng}|dkrddd ig}|S) aRun query through DuckDuckGo and return metadata. Args: query: The query to search for. max_results: The number of results to return. source: The source to look from. Returns: A list of dictionaries with the following keys: snippet - The description of the result. title - The title of the result. link - The link to the result. rcSs$g|]}|d|d|ddqS)r/titlehref)snippetr4linkrr$rrrr'{sz6DuckDuckGoSearchAPIWrapper.results..)r r+cSs0g|](}|d|d|d|d|ddqS)r/r4urldater)r6r4r7r9rrr$rrrr'sNZResultr-)rr*r,)r)r"r rr2rrrr2is     z"DuckDuckGoSearchAPIWrapper.results)N)N)N)rrr__doc__rrstr__annotations__r r r intrrrrrr!rr*r,r3r2rrrrr s<        rN) r:typingrrrZlangchain_core.pydantic_v1rrrrrrrs