Source code for langchain_community.utilities.arxiv
"""Util that calls Arxiv."""importloggingimportosimportrefromtypingimportAny,Dict,Iterator,List,Optionalfromlangchain_core.documentsimportDocumentfrompydanticimportBaseModel,model_validatorlogger=logging.getLogger(__name__)
[docs]classArxivAPIWrapper(BaseModel):"""Wrapper around ArxivAPI. To use, you should have the ``arxiv`` python package installed. https://lukasschwab.me/arxiv.py/index.html This wrapper will use the Arxiv API to conduct searches and fetch document summaries. By default, it will return the document summaries of the top-k results. If the query is in the form of arxiv identifier (see https://info.arxiv.org/help/find/index.html), it will return the paper corresponding to the arxiv identifier. It limits the Document content by doc_content_chars_max. Set doc_content_chars_max=None if you don't want to limit the content size. Attributes: top_k_results: number of the top-scored document used for the arxiv tool ARXIV_MAX_QUERY_LENGTH: the cut limit on the query used for the arxiv tool. continue_on_failure (bool): If True, continue loading other URLs on failure. load_max_docs: a limit to the number of loaded documents load_all_available_meta: if True: the `metadata` of the loaded Documents contains all available meta info (see https://lukasschwab.me/arxiv.py/index.html#Result), if False: the `metadata` contains only the published date, title, authors and summary. doc_content_chars_max: an optional cut limit for the length of a document's content Example: .. code-block:: python from langchain_community.utilities.arxiv import ArxivAPIWrapper arxiv = ArxivAPIWrapper( top_k_results = 3, ARXIV_MAX_QUERY_LENGTH = 300, load_max_docs = 3, load_all_available_meta = False, doc_content_chars_max = 40000 ) arxiv.run("tree of thought llm") """arxiv_search:Any#: :meta private:arxiv_exceptions:Any# :meta private:top_k_results:int=3ARXIV_MAX_QUERY_LENGTH:int=300continue_on_failure:bool=Falseload_max_docs:int=100load_all_available_meta:bool=Falsedoc_content_chars_max:Optional[int]=4000
[docs]defis_arxiv_identifier(self,query:str)->bool:"""Check if a query is an arxiv identifier."""arxiv_identifier_pattern=r"\d{2}(0[1-9]|1[0-2])\.\d{4,5}(v\d+|)|\d{7}.*"forquery_iteminquery[:self.ARXIV_MAX_QUERY_LENGTH].split():match_result=re.match(arxiv_identifier_pattern,query_item)ifnotmatch_result:returnFalseassertmatch_resultisnotNoneifnotmatch_result.group(0)==query_item:returnFalsereturnTrue
@model_validator(mode="before")@classmethoddefvalidate_environment(cls,values:Dict)->Any:"""Validate that the python package exists in environment."""try:importarxivvalues["arxiv_search"]=arxiv.Searchvalues["arxiv_exceptions"]=(arxiv.ArxivError,arxiv.UnexpectedEmptyPageError,arxiv.HTTPError,)values["arxiv_result"]=arxiv.ResultexceptImportError:raiseImportError("Could not import arxiv python package. ""Please install it with `pip install arxiv`.")returnvaluesdef_fetch_results(self,query:str)->Any:"""Helper function to fetch arxiv results based on query."""ifself.is_arxiv_identifier(query):returnself.arxiv_search(id_list=query.split(),max_results=self.top_k_results).results()returnself.arxiv_search(query[:self.ARXIV_MAX_QUERY_LENGTH],max_results=self.top_k_results).results()
[docs]defget_summaries_as_docs(self,query:str)->List[Document]:""" Performs an arxiv search and returns list of documents, with summaries as the content. If an error occurs or no documents found, error text is returned instead. Wrapper for https://lukasschwab.me/arxiv.py/index.html#Search Args: query: a plaintext search query """try:results=self._fetch_results(query)# Using helper function to fetch resultsexceptself.arxiv_exceptionsasex:logger.error(f"Arxiv exception: {ex}")# Added error loggingreturn[Document(page_content=f"Arxiv exception: {ex}")]docs=[Document(page_content=result.summary,metadata={"Entry ID":result.entry_id,"Published":result.updated.date(),"Title":result.title,"Authors":", ".join(a.nameforainresult.authors),},)forresultinresults]returndocs
[docs]defrun(self,query:str)->str:""" Performs an arxiv search and A single string with the publish date, title, authors, and summary for each article separated by two newlines. If an error occurs or no documents found, error text is returned instead. Wrapper for https://lukasschwab.me/arxiv.py/index.html#Search Args: query: a plaintext search query """try:results=self._fetch_results(query)# Using helper function to fetch resultsexceptself.arxiv_exceptionsasex:logger.error(f"Arxiv exception: {ex}")# Added error loggingreturnf"Arxiv exception: {ex}"docs=[f"Published: {result.updated.date()}\n"f"Title: {result.title}\n"f"Authors: {', '.join(a.nameforainresult.authors)}\n"f"Summary: {result.summary}"forresultinresults]ifdocs:return"\n\n".join(docs)[:self.doc_content_chars_max]else:return"No good Arxiv Result was found"
[docs]defload(self,query:str)->List[Document]:""" Run Arxiv search and get the article texts plus the article meta information. See https://lukasschwab.me/arxiv.py/index.html#Search Returns: a list of documents with the document.page_content in text format Performs an arxiv search, downloads the top k results as PDFs, loads them as Documents, and returns them in a List. Args: query: a plaintext search query """returnlist(self.lazy_load(query))
[docs]deflazy_load(self,query:str)->Iterator[Document]:""" Run Arxiv search and get the article texts plus the article meta information. See https://lukasschwab.me/arxiv.py/index.html#Search Returns: documents with the document.page_content in text format Performs an arxiv search, downloads the top k results as PDFs, loads them as Documents, and returns them. Args: query: a plaintext search query """try:importfitzexceptImportError:raiseImportError("PyMuPDF package not found, please install it with ""`pip install pymupdf`")try:# Remove the ":" and "-" from the query, as they can cause search problemsquery=query.replace(":","").replace("-","")results=self._fetch_results(query)# Using helper function to fetch resultsexceptself.arxiv_exceptionsasex:logger.debug("Error on arxiv: %s",ex)returnforresultinresults:try:doc_file_name:str=result.download_pdf()withfitz.open(doc_file_name)asdoc_file:text:str="".join(page.get_text()forpageindoc_file)except(FileNotFoundError,fitz.fitz.FileDataError)asf_ex:logger.debug(f_ex)continueexceptExceptionase:ifself.continue_on_failure:logger.error(e)continueelse:raiseeifself.load_all_available_meta:extra_metadata={"entry_id":result.entry_id,"published_first_time":str(result.published.date()),"comment":result.comment,"journal_ref":result.journal_ref,"doi":result.doi,"primary_category":result.primary_category,"categories":result.categories,"links":[link.hrefforlinkinresult.links],}else:extra_metadata={}metadata={"Published":str(result.updated.date()),"Title":result.title,"Authors":", ".join(a.nameforainresult.authors),"Summary":result.summary,**extra_metadata,}yieldDocument(page_content=text[:self.doc_content_chars_max],metadata=metadata)os.remove(doc_file_name)