^ i#SrSSKrSSKrSSKJrJr SSKJr SSKJrJ r SSK J r SSK J r Jr SS KJr SS KJr SS KJrJr SS KJr SS KJr SSKJr \R8"\5r"SS5rg)zDDGS class implementation.N)ThreadPoolExecutorwait)ceil)randomshuffle) TracebackType)AnyClassVar)BaseSearchEngine)ENGINES) DDGSExceptionTimeoutException)ResultsAggregator)SimpleFilterRanker)_expand_proxy_tb_aliasc4\rSrSr%SrSr\\S-\S'Sr \\ S-\S'S+SS.S\ S-S \S-S \ \ -S S4S jjjr S,S jrS-S\\S-S\S-S\S-S S4Sjjr\S \ 4Sj5rS\ S\ S \\\4SjrS.SSSSSSS.S\ S\ S\ S-S\ S\ S \ S-S!\S-S"\S\ S#\ S \\\ \44S$jjjrS\ S#\S \\\ \44S%jrS\ S#\S \\\ \44S&jrS\ S#\S \\\ \44S'jrS\ S#\S \\\ \44S(jrS\ S#\S \\\ \44S)jrS*r g)/DDGSa{DDGS | Dux Distributed Global Search. A metasearch library that aggregates results from diverse web search services. Args: proxy: The proxy to use for the search. Defaults to None. timeout: The timeout for the search. Defaults to 5. verify: bool (True to verify, False to skip) or str path to a PEM file. Defaults to True. Attributes: threads: The number of threads to use for the search. Defaults to None (automatic). _executor: The ThreadPoolExecutor instance. Raises: DDGSException: If an error occurs during the search. Example: >>> from ddgs import DDGS >>> results = DDGS().search("python") Nthreads _executorT)verifyproxytimeoutrreturnc[U5=(d [RRS5UlX lX0l0Ulg)N DDGS_PROXY)rosenvironget_proxy_timeout_verify_engines_cache)selfrrrs C/home/james-whalen/.local/lib/python3.13/site-packages/ddgs/ddgs.py__init__ DDGS.__init__/s7,U3Srzz~~l7S     cU$)z7Enter the context manager and return the DDGS instance.)r%s r& __enter__DDGS.__enter__7s r)exc_typeexc_valexc_tbcg)zExit the context manager.Nr+)r%r.r/r0s r&__exit__ DDGS.__exit__;sr)cfURc[URSS9UlUR$)z/Get a ThreadPoolExecutor instance and cache it.r) max_workersthread_name_prefix)rrr)clss r& get_executorDDGS.get_executorCs+ == .3;;[abCM}}r)categorybackendc [U[5(aSRU5nURS5Vs/sHo3R 5PM nn[[ UR 55n[U5 SU;dSU;a'UnUS:XaS/UVs/sH owS:wdM UPM sn-nOUnUVs/sHn[ UUPM nn/n UHwn XR;a U RURU 5 M2U "URURURS9n XRU 'U RU 5 My U RSSS 9 U $s snfs snfs snf![aKn [R!S U S R[#U555 UR%US5sS n A $S n A ff=f) a~Retrieve a list of search engine instances for a given category and backend. Args: category: The category of search engines (e.g., 'text', 'images', etc.). backend: A single or comma-delimited backends. Defaults to "auto". Returns: A list of initialized search engine instances corresponding to the specified category and backend. Instances are cached for reuse. ,autoalltext wikipedia)rrrc&UR[4$N)priorityr)es r&#DDGS._get_engines..vs !**f)=r)T)keyreversezB%r - backend is not exist or disabled. Available: %s. Using 'auto'z, N) isinstancelistjoinsplitstripr keysrr$appendr!r"r#sortKeyErrorloggerwarningsorted _get_engines) r%r:r;x backend_list engine_keysrOrHengine_classes instances engine_classengine_instanceexs r&rVDDGS._get_enginesJs gt $ $hhw'G+2==+=>+=a += >78,1134   \ !Ul%:D6!#}t'Rtk?Qt'RRD @DEgh/4NEI . #6#66$$T%8%8%FG'3dmmdhdpdp&qO8G'' 5$$_5!/ NN=tN L G?(S F 7 NNT &-.  $$Xv6 6  7sCE$ E)'E)6E3:E.BE3.E33 G=AG=GGzus-enmoderate r r>)region safesearch timelimit max_resultspager;querykeywordsrbrcrdrerfkwargsc U=(d UnU(d Sn [U 5eURX5n [U V s1sHoRiM sn 5n[ 5n[ 1Sk5nU(a[ U[US- 5S-5OUnUR5n0Snn[U SS9GHunn U RU;aMUR"U RU4UUUUS.U D6nU UU'[U5U:dUU:a[UURSS 9unnUR5HTunnUU;dMUR5=n(a.UR!U5 UR#UR5 MTMV UVs0sH nUUU_M nnU(dM[U5U:dGM O UR-5n[/5nUR1UU5nU(aU(aUSU$U$S U;a [3U5e[U=(d S 5es sn f![$a/nUn[&R)S U R*U5 SnAGM-SnAff=fs snf) aPerform a search across engines in the given category. Args: category: The category of search engines (e.g., 'text', 'images', etc.). query: The search query. keywords: Deprecated alias for `query`. region: The region to use for the search (e.g., us-en, uk-en, ru-ru, etc.). safesearch: The safesearch setting (e.g., on, moderate, off). timelimit: The timelimit for the search (e.g., d, w, m, y) or custom date range. max_results: The maximum number of results to return. Defaults to 10. page: The page of results to return. Defaults to 1. backend: A single or comma-delimited backends. Defaults to "auto". **kwargs: Additional keyword arguments to pass to the search engines. Returns: A list of dictionaries containing the search results. zquery is mandatory.>urlhrefimage embed_urlrar N)start)rbrcrdrfFIRST_EXCEPTION)r return_whenzError in engine %s: %rz timed outzNo results found.)rrVlenprovidersetrminrr8 enumeratesubmitsearchrr"itemsresultextendadd ExceptionrSinfoname extract_dictsrrankr)r%r:rgrhrbrcrdrerfr;rimsgenginesenginelen_unique_providersseen_providersresults_aggregatorr5executorfutureserrifuturedonenot_doneff_enginerr^resultsrankers r&_search DDGS._searchsU@!E'C$ $##H6"'#J'OO'#JK#&5;LLq:rOZc.[25E0F0JK`t $$&4"7!4IAv.0__ %# F%GFO7|{*a;.>!%gt}}Rc!dh#*==?KAxDyS$%HHJq 2 9 9! < . 2 283D3D E /$33;;(Q1gaj=(;{s#56+E95<%224#%++gu- ,77rsK  7" "7&*)   8 $V6V6r)