dh$SrSSKrSSKrSSKJr SSKJr SSKJr SSK J r J r J r J r JrJr SSKJr SSKJr \R("\5r"S S \5rg) zDocument loader for EverNote ENEX export files. This module provides functionality to securely load and parse EverNote notebook export files (``.enex`` format) into LangChain Document objects. N) b64decode)Path)strptime)AnyDictIteratorListOptionalUnion)Document) BaseLoaderc\rSrSrSrSS\\\4S\4Sjjr S\ \ 4Sjr S\ \ 4Sjr \S \S\4S j5r\S \S\4S j5r\SS\S\\S\4Sjj5r\S\S\ \\\44Sj5rSrg )EverNoteLoadera?Document loader for EverNote ENEX export files. Loads EverNote notebook export files (``.enex`` format) into LangChain Documents. Extracts plain text content from HTML and preserves note metadata including titles, timestamps, and attachments. Uses secure XML parsing to prevent vulnerabilities. The loader supports two modes: - Single document: Concatenates all notes into one Document (default) - Multiple documents: Creates separate Documents for each note `Instructions for creating ENEX files `__ Example: .. code-block:: python from langchain_community.document_loaders import EverNoteLoader # Load all notes as a single document loader = EverNoteLoader("my_notebook.enex") documents = loader.load() # Load each note as a separate document: # documents = [ document1, document2, ... ] loader = EverNoteLoader("my_notebook.enex", load_single_document=False) documents = loader.load() # Lazy loading for large files for doc in loader.lazy_load(): print(f"Title: {doc.metadata.get('title', 'Untitled')}") print(f"Content: {doc.page_content[:100]}...") Note: Requires the ``lxml`` and ``html2text`` packages to be installed. Install with: ``pip install lxml html2text`` file_pathload_single_documentc0[U5UlX lg)a\Initialize the EverNote loader. Args: file_path: Path to the EverNote export file (``.enex`` extension). load_single_document: Whether to concatenate all notes into a single Document. If ``True``, only the ``source`` metadata is preserved. If ``False``, each note becomes a separate Document with its own metadata. N)strrr)selfrrs e/var/www/html/shao/venv/lib/python3.13/site-packages/langchain_community/document_loaders/evernote.py__init__EverNoteLoader.__init__<sY$8!returnc ## URUR5H`nURS5cM[US0UR 5VVs0sHup#US;dM X#_M snnESUR0ES9v Mb gs snnf7f)aLazily load documents from the EverNote export file. Lazy loading allows processing large EverNote files without loading everything into memory at once. This method yields Documents one by one by parsning the XML. Each document represents a note in the EverNote export, containing the note's content as ``page_content`` and metadata including ``title``, ``created/updated`` ``timestamps``, and other note attributes. Yields: Document: A Document object for each note in the export file. contentN)r content-rawresourcesource page_contentmetadata)_parse_note_xmlrgetr items)rnotekeyvalues r _lazy_loadEverNoteLoader._lazy_loadIs((8Dxx ".!%i/3jjl.: "*PP'CJ.: $T^^4   9 s/B B  B!B'"B c# # UR(dUR5ShvN g[SRUR5Vs/sHoRPM sn5SUR 0S9v gNTs snf7f)aLoad documents from EverNote export file. Depending on the ``load_single_document`` setting, either yields individual Documents for each note or a single Document containing all notes. Yields: Document: Either individual note Documents or a single combined Document. Nrr )rr)r joinr!r)rdocuments r lazy_loadEverNoteLoader.lazy_loadcsq((( ( (WW;???;LM;Lx**;LM#DNN3   )Ns!%BA<'BA> #B>BrcSSKnURU5R5$![an[S5UeSnAff=f)a@Parse HTML content from EverNote into plain text. Converts HTML content to plain text using the ``html2text`` library. Strips whitespace from the result. Args: content: HTML content string from EverNote. Returns: Plain text version of the content. Raises: ImportError: If ``html2text`` is not installed. rNzCould not import `html2text`. Although it is not a required package to use LangChain, using the EverNote loader requires `html2text`. Please install `html2text` via `pip install html2text` and try again.) html2textstrip ImportError)rr2es r_parse_contentEverNoteLoader._parse_contentvsL  &&w/557 7 X   s"% A ;Arc>0nUHnURS:XaiUR(a[UR5OSXR'[R"XR5R 5US'M|URXR'M U$)a+Parse resource elements from EverNote XML. Extracts resource information like attachments, images, etc. Base64 decodes data elements and generates MD5 hashes. Args: resource: List of XML elements representing a resource. Returns: Dictionary containing resource metadata and decoded data. datarhash)tagtextrhashlibmd5 hexdigest)rrsc_dictelems r_parse_resourceEverNoteLoader._parse_resourcesv$&Dxx6!=AYYYtyy%9C"#*;;x/A#B#L#L#N %)YY" rNr&prefixc^0n/nS[S[4U4SjjnUGH%nURS:Xa<[RUR5X%R'URUS'MPURS:Xa&UR [R U55 MURS:XdURS:Xa$[URS 5X%R'MURS :Xa3[RXUR5nURU5 GM URX%R'GM( [U5S :aX2S'UR5VVs0sHupxU"U5U_M snn$s snnf) aQParse a note element from EverNote XML. Extracts note content, metadata, resources, and attributes. Handles nested note-attributes recursively with prefixes. Args: note: List of XML elements representing a note. prefix: Optional prefix for nested attribute names. Returns: Dictionary containing note content and metadata. element_tagrc>TcU$TSU3$)N.)rFrDs r add_prefix.EverNoteLoader._parse_note..add_prefixs~""XQ{m, ,rrrrcreatedupdatedz%Y%m%dT%H%M%SZznote-attributesr) rr;rr6r<appendrBr _parse_noteupdatelenr%) r&rD note_dict resourcesrJrAadditional_attributesr'r(s ` rrOEverNoteLoader._parse_notes?%'   -C -C - Dxx9$&4&C&CDII&N ((#+/99 -(Z'  !?!?!EFY&$((i*?&.tyy:J&K ((#..(6(B(B(()%  !67&*ii ((#" y>A $-j !9B9JK9J:3 3&9JKKKs,Fxml_filec ## SSKJn UR USSSSSS9nUH.upEUR S :XdM[RU5v M0 g![an[R S5 UeSnAff=f7f) avParse EverNote XML file securely. Uses ``lxml`` with secure parsing configuration to prevent XML vulnerabilities including XXE attacks, XML bombs, and malformed XML exploitation. Args: xml_file: Path to the EverNote export XML file. Yields: Dictionary containing parsed note data for each note in the file. Raises: ImportError: If ``lxml`` is not installed. r)etreezCould not import `lxml`. Although it is not a required package to use LangChain, using the EverNote loader requires `lxml`. Please install `lxml` via `pip install lxml` and try again.Nzutf-8FT)encodingresolve_entities no_networkrecover huge_treer&) lxmlrXr4loggererror iterparser;rrO)rVrXr5contextactionrAs rr#EverNoteLoader._parse_note_xmls   "// " " $LFxx6!$0066$#  LL?  G  s,A<A)A<A< A9A44A99A<)rr)T)N)__name__ __module__ __qualname____firstlineno____doc__r rrboolrrr r)r/ staticmethodr6listdictrBr r rOrrr#__static_attributes__rIrrrrs$L 9%T "2 9$ 9HX.48H-&4$4.)L$)L )L)L)LV$7#$7(4S>*B$7$7rr)rir=loggingbase64rpathlibrtimertypingrrrr r r langchain_core.documentsr )langchain_community.document_loaders.baser getLoggerrer_rrIrrrwsE ==-@   8 $e7Ze7r