RiF/ddlZddlZddlZddlmZmZmZmZmZddl m Z eje Z dgZdZGddeZy)N) BibDatabase BibDataStringas_textBibDataStringExpressionSTANDARD_TYPES)BibtexExpression BibTexParserc:t|i|}|j|SN)r parse)dataargskwargsparsers L/home/agent/.friday_env/lib/python3.12/site-packages/bibtexparser/bparser.pyr r s 4 *6 *F << ceZdZdZdfd Z ddZddZddZdZdZ dZ d Z d Z d Z d Zd ZdZxZS)r a A parser for reading BibTeX bibliographic data files. Example:: from bibtexparser.bparser import BibTexParser bibtex_str = ... parser = BibTexParser() parser.ignore_nonstandard_types = False parser.homogenize_fields = False parser.common_strings = False bib_database = bibtexparser.loads(bibtex_str, parser) :param customization: function or None (default) Customization to apply to parsed entries. :param ignore_nonstandard_types: bool (default True) If True ignores non-standard bibtex entry types. :param homogenize_fields: bool (default False) Common field name replacements (as set in alt_dict attribute). :param interpolate_strings: bool (default True) If True, replace bibtex string by their value, else uses BibDataString objects. :param common_strings: bool (default True) Include common string definitions (e.g. month abbreviations) to the bibtex file. :param add_missing_from_crossref: bool (default False) Resolve BibTeX references set in the crossref field for BibTeX entries and add the fields from the referenced entry to the referencing entry. c F|tt| |St|fi|S)z~ To catch the old API structure in which creating the parser would immediately parse and return data. )superr __new__r )clsr r __class__s rrzBibTexParser.__new__<s. <s3C8 8&& &rc .d|_d|_t|_||_|jr|jj ||_||_||_||_ d|_ ||_ ddddddddd d |_ |jy ) zs Creates a parser for reading BibTeX files :return: parser :rtype: `BibTexParser` rFutf8keywordauthoreditorurlsubjectcrossref) keywkeywordsauthorseditorsurlslinklinkssubjectsxrefN)_parse_call_countexpect_multiple_parser bib_databasecommon_stringsload_common_strings customizationignore_nonstandard_typeshomogenize_fieldsinterpolate_stringsencodingadd_missing_from_crossrefalt_dict_init_expressions)selfr r/r0r1r2r-r4s r__init__zBibTexParser.__init__Is"#&+"'M-       1 1 3 +)A% "3$7  *C&"  "     rc|xjdz c_|jdk(r(|jstjdtd|j |} |j j||jr|jj|jS#|j j$r.}tjd|j|s|Yd}~td}~wwxYw)aFParse a BibTeX string into an object :param bibtex_str: BibTeX string :type: str or unicode :param partial: If True, print errors only on parsing failures. If False, an exception is raised. :type: boolean :return: bibliographic database :rtype: BibDatabase zThe parser has been called more than once. Subsequent parse calls lead to a combined BibTeX library. To avoid the warning, set property `parser.expect_multiple_parse` to `True`.)category stacklevelz(Could not parse properly, starting at %sN)r*r+warningswarn UserWarning_bibtex_file_obj_expr parse_fileParseExceptionloggererrorliner4r,)r7 bibtex_strpartialbibtex_file_objexcs rr zBibTexParser.parses !#  ! !Q &t/I/I MMi$/1 > // ;  JJ ! !/ 2  ) )    7 7 9   zz((  LLCSXX N  sB,,C3$C..C3cD|j|j|S)aFParse a BibTeX file into an object :param file: BibTeX file or file-like object :type: file :param partial: If True, print errors only on parsing failures. If False, an exception is raised. :type: boolean :return: bibliographic database :rtype: BibDatabase )rI)r read)r7filerIs rrCzBibTexParser.parse_fileszz$))+wz77rcBt_jjfdjjtj jj jfdjjjfdjjjfdjjjfdjjjfdy)zA Defines all parser expressions used internally. c6tj|dSNr)rr,sltr7s rz0BibTexParser._init_expressions..sd//16rcj|jd|jd|jdS)N EntryTypeKeyFields) _add_entrygetrRs rrVz0BibTexParser._init_expressions..s1DOOk"AEE%L!%%/Crc,j|dSrQ _add_commentrRs rrVz0BibTexParser._init_expressions..D--ad3rc,j|dSrQr^rRs rrVz0BibTexParser._init_expressions..r`rc,j|dSrQ) _add_preamblerRs rrVz0BibTexParser._init_expressions..sD..qt4rcHj|dj|dS)N StringName StringValue) _add_stringnamerRs rrVz0BibTexParser._init_expressions..s&D,,Q|_-A-A-.}-=?rN) rrBset_string_name_parse_actionadd_log_functionrEdebugentryadd_parse_actionimplicit_commentexplicit_comment preamble_decl string_def)r7s`rr6zBibTexParser._init_expressionss&'  // 7 8 ##FLL1 )) C  ##44 3  ##44 3    11 4  .. ? rc$d}t|tr3t||jd}t|dk\rE|d|k(r=|dd}n7t|dk\r |dd|k(r|dd}|j |j}t j |S)Nsignorer:r)r3) isinstancestrr3lendecodeioStringIO)r7rHbytes rrAzBibTexParser._bibtex_file_objs j# &tT]]H5D:!# 1 (='^ :!# 2A$(>'^ #**DMM*BJ{{:&&rcD|r|dk(ry|jr t|S|S)z Clean instring before adding to dictionary :param val: a value :type val: string :returns: string -- value z{})r2r)r7vals r _clean_valzBibTexParser._clean_vals(cTk  % %3< Jrc^|j}t|ts t|dS|S)z Lowercase a key and return as unicode. :param key: a key :type key: string :returns: (unicode) string -- value zutf-8)lowerrurvr7keys r _clean_keyzBibTexParser._clean_keys+iik#s#sG$ $Jrc|j|}|jr4|t|jj vr|j|}|S)z Clean a bibtex field key and homogenize alternative forms. :param key: a key :type key: string :returns: string -- value )rr1listr5keysrs r_clean_field_keyzBibTexParser._clean_field_keysHooc"  ! !d4==--/00mmC( rci}|j|}|jr|tvrtj d|y|D](}|j ||||j |<*||d<||d<|jdd}|jr|||d<|j&tjd|j|}|jjj|y)ap Adds a parsed entry. Includes checking type and fields, cleaning, applying customizations. :param entry_type: the entry type :type entry_type: string :param entry_id: the entry bibid :type entry_id: string :param fields: the fields and values :type fields: dictionary :returns: string -- value z+Entry type %s not standard. Not considered.N ENTRYTYPEIDr _crossrefz$Apply customizations and return dict)rr0rrEwarningrrr\r4r/rkr,entriesappend)r7 entry_typeentry_idfieldsdrr s rr[zBibTexParser._add_entrys __Z0  ( (Z~-M NNH% '  IC,0OOF3K,HAd##C( ) I#+$55T*  ) )h.B%AkN    ) LL? @""1%A !!((+rctjd|jz|jjj |y)z Stores a comment in the list of comment. :param comment: the parsed comment :type comment: string z#Store comment in list of comments: N)rErk__repr__r,commentsr)r7comments rr_zBibTexParser._add_comment2s>  :%%'( ) ""))'2rc||jjvrtjd|tj dj |||j ||jj|<y)z Stores a new string in the string dictionary. :param string_key: the string key :type string_key: string :param string: the string value :type string: string z(Overwriting existing string for key: %s.zStore string: {} -> {}N)r,stringsrErrkformatr)r7 string_keystrings rrgzBibTexParser._add_string=sc **22 2 NNE% ' .55j&IJ040G!!*-rcxtjd|jjj |y)zq Stores a preamble. :param preamble: the parsed preamble :type preamble: string z#Store preamble in list of preamblesN)rErkr, preamblesr)r7preambles rrczBibTexParser._add_preambleLs+  :; ##**84rr )NNTFTTF)F)__name__ __module__ __qualname____doc__rr8r rCr6rArrrr[r_rgrc __classcell__)rs@rr r sg@ '!#*.#(%) $+0 B!H!@ 8B '   ,B 3 H5r)ryloggingr>bibtexparser.bibdatabaserrrrrbibtexparser.bibtexexpressionr getLoggerrrE__all__r objectr rrrsL OO:   8 $   y56y5r