)g~SSKrSSKrSSKrSSKrSSKrSSKJr SSKJ r SSK J r J r J r JrJrJrJrJrJrJrJrJrJrJrJrJrJr SSKJr SSKJrJrJ r SSK!J"r"J#r#J$r$ SSK%J&r&J'r'J(r(J)r) SS K*J+r+J,r,J-r-J.r.J/r/J0r0J1r1J2r2J3r3J4r4J5r5J6r6J7r7J8r8J9r9 SS K:J;r;Jr>J?r?J@r@JArAJBrBJCrC SS K=JDrD SS K:JErEJFrFJGrGJHrHJIrIJJrJJKrKJLrL \\+\\+/\F4rM\\N/\ \S\F44rO\@SrP"SS\\G5rQ\RS:d\(a\R\DrTO"SS\\D5rT"SS\\F\E4\TS5rU"SS\\D5rV"SS\V\D\\D\F45rWSrX"SS\W\U\F\E4\F45rYSrZS r[S!r\S"r]"S#S$\&5r^"S%S&\^5r_"S'S(\^5r`"S)S*\^5ra"S+S,\^5rb"S-S.\^5rc"S/S0\^5rd"S1S\^5reS2rfSUS4jrgS5rh\RS:d\(a\R R2\H\D4riO$"S6S7\R R2\\D\5ri"S8S9\\D\i\D5rj"S:S;\j\N\5rk"S<S=\j\D\5rl"S>S?\l\D5rm"S@SA\l\N\k5rn"SBSC\^\k\5ro"SDSE\o5rp"SFSG\o5rq"SHSI\^5rr\"\6\`5rs\"\/\d5rt\"\a\b5ru\"\e\o\oRSJ9rwSKrx\Y"\9\Z\c\-SL\x5ry\Y"\8\\\c\3\3\x5rz\Y"\8\]\c\3\3\x5r{SMr|SNr}SOr~SPrS3S3SQSR.SSjr\ST:XaSSKr\GR"5 gg)VN)ABC) TracebackType)IterableIteratorListUnionDictOptionalCallableAnyGenericTypeTupleIOcastoverloadMapping TYPE_CHECKINGSequence) ReferenceType)combine_into_replacementBufferingIteratorlen_check_iterator)FormatterContentToken%one_value_per_line_trailing_separator format_field) LocatableSTART_POSITIONPositionRange) Deb822TokenDeb822ValueToken'Deb822SemanticallySignificantWhiteSpaceDeb822SpaceSeparatorTokenDeb822CommentTokenDeb822WhitespaceTokenDeb822ValueContinuationTokenDeb822NewlineAfterValueTokenDeb822CommaTokenDeb822FieldNameTokenDeb822FieldSeparatorTokenDeb822ErrorTokentokenize_deb822_filecomma_split_tokenizerwhitespace_split_tokenizer)AmbiguousDeb822FieldKeyErrorSyntaxOrParseError) resolve_ref LinkedListLinkedListNode OrderedSet_strIdefault_field_sort_key)T)STVETE ParagraphKeyTokenOrElement CommentishParagraphKeyBaseFormatterCallbackr!Deb822KeyValuePairElementc\rSrSrSrSrSrSr\S\ 4Sj5r \ RS5r \S\ 4S j5r S S jrS rg )ValueReference0a2Reference to a value inside a Deb822 paragraph This is useful for cases where want to modify values "in-place" or maybe conditionally remove a value after looking at it. ValueReferences can be invalidated by various changes or actions performed to the underlying provider of the value reference. As an example, sorting a list of values will generally invalidate all ValueReferences related to that list. The ValueReference will raise validity issues where it detects them but most of the time it will not notice. As a means to this end, the ValueReference will *not* keep a strong reference to the underlying value. This enables it to detect when the container goes out of scope. However, keep in mind that the timeliness of garbage collection is implementation defined (e.g., pypy does not use ref-counting). )_node_render_value_factory_removal_handler_mutation_notifiercj[R"U5UlX lX0lX@lXPlgN)weakrefrefrErFrGrHrI)selfnoderender value_factoryremoval_handlermutation_notifiers >/usr/lib/python3/dist-packages/debian/_deb822_repro/parsing.py__init__ValueReference.__init__Fs+[[&  + /"3crURc [S5eUR5nUc [S5eU$)Nz(Cannot use ValueReference after remove()z-ValueReference is invalid (garbage collected))rE RuntimeError)rNrOs rT _resolve_nodeValueReference._resolve_nodeSs; :: IJ Jzz| <NO O rWreturncTURUR5R5$)z Resolve the reference into a str)rFrZvaluerNs rTr^ValueReference.value^s"||D..06677rWcURU5UR5lURbUR5 gg)aeUpdate the reference value Updating the value via this method will *not* invalidate the reference (or other references to the same container). This can raise an exception if the new value does not follow the requirements for the referenced values. As an example, values in whitespace separated lists cannot contain spaces and would trigger an exception. N)rGrZr^rIrN new_values rTr^r`cs=&*%8%8%C"  " " .  # # % /rWc6UR5R$)zJReference to a locatable that can be used to determine where this value is)rZr^r_s rT locatableValueReference.locatabless!!#)))rWNcdUR[SUR555 SUlg)zRemove the underlying value This will invalidate the ValueReference (and any other ValueReferences pointing to that exact value). The validity of other ValueReferences to that container remains unaffected. zLinkedListNode[TokenOrElement]N)rHrrZrEr_s rTremoveValueReference.removexs* d#CTEWEWEYZ[ rW)rIrErHrFrGr\N)__name__ __module__ __qualname____firstlineno____doc__ __slots__rUrZpropertystrr^setterrrerh__static_attributes__rWrTrCrC0sl$aI 4 8s88 \\ & &*9**rWrC) c \rSrSrSrSrSrg)%_Deb822ParsedTokenList_ContextManagercU$rKrur_s rT __enter__/_Deb822ParsedTokenList_ContextManager.__enter__sKrWcgrKru)rNexc_typeexc_valexc_tbs rT__exit__._Deb822ParsedTokenList_ContextManager.__exit__srWruN)rkrlrmrnr|rrtrurWrTryrys   rWryc^\rSrSrSrSrS\4SjrU4Sjr\ S5r S\ \ 4Sjr S*S jrS rS+S jrS rSrSrSrSrS\4SjrS*SjrSr\ S\4Sj5rS*SjrS*SjrS*SjrS*SjrS,SjrS*Sjr Sr!S\4Sjr"S\4Sjr#S-S jr$SS!.S"\S\4S#jjr%S*S$jr&S SS%.S&jr'S S'.S(jr(S)r)U=r*$).Deb822ParsedTokenListcXlX l[UR5UlX0lX@lXPlX`l[XS5Ul Xpl SUl [UlSUlSUlUR(deURR"nUb1[%U[&5(aURR)5 gggNTF)_kvpair_element_proxy_elementr3parts _token_list_vtype_stype_str2value_parser_default_separator_factory_parser_to_value_factoryrGrF$_format_preserve_original_formattingr _formatter_changed._Deb822ParsedTokenList__continuation_line_chartail isinstancer(pop) rNkvpair_elementinterpreted_value_elementvtypestypestr2value_parserdefault_separator_factoryrP last_tokens rTrUDeb822ParsedTokenList.__init__s .7%&?&E&EF  !1*C'67GO 481? (,%%%**  !j=Y&Z&Z    "'[ !rWc#N^# U4SjTR5ShvN gN7f)Nc3F># UHnTRU5v M g7frK)rF.0vrNs rT 1Deb822ParsedTokenList.__iter__..s>-=DLLOO-=s!) value_partsr_s`rT__iter__Deb822ParsedTokenList.__iter__s>T-=-=>>> %#%r\c0[[U5S5SL$rK)nextiterr_s rT__bool__Deb822ParsedTokenList.__bool__sDJ%T11rWcl>Uc!UR(aUR5 [TU] XU5$rK)r _update_fieldsuperr)rNrrr __class__s rTrDeb822ParsedTokenList.__exit__s/      w6::rWc#N^# U4SjTR5ShvN gN7f)Nc3b># UH$n[UTR5(dM Uv M& g7frK)rrrs rTr4Deb822ParsedTokenList.value_parts..s"N/!:a3MAA/s/ /rr_s`rTr!Deb822ParsedTokenList.value_partssOt//NNNrc#8# URShvN gN7frKrr_s rT iter_parts Deb822ParsedTokenList.iter_partss#### NcSUlgNT)rr_s rT _mark_changed#Deb822ParsedTokenList._mark_changeds  rWc#j^# U4SjTRR55ShvN gN7f)zIterate over all values in the list (as ValueReferences) This is useful for doing inplace modification of the values or even streaming removal of field values. It is in general also more efficient when more than one value is updated or removed. c3># UHmn[URTR5(dM*[[ SU5TR TR TRTR5v Mo g7f)zLinkedListNode[VE]N) rr^rrCrrFrG _remove_noder)rnrNs rTr>Deb822ParsedTokenList.iter_value_references..sg 1a!''4;;/ N %q ) LL            1s )A8AA8N)r iter_nodesr_s`rTiter_value_references+Deb822ParsedTokenList.iter_value_referencess. ##..0    s (313c*UR5nUR(aSnSUlUR5 URR U5 U(a7UR(d%URR [ S55 gggNFT )r is_whitespacer,_append_continuation_line_token_if_necessaryrappendr&)rNspace_after_separatorseparator_tokens rTappend_separator&Deb822ParsedTokenList.append_separatorsv99;  ( ($) !  99; 0 )F)F    # #$9#$> ?*G rWc(URnURR5H^n[URU5(dM UR UR5U:XdMAUR U5UlSUl g [S5e)zsReplace the first instance of a value with another This method will *not* affect the validity of ValueReferences. Tz!list.replace(x, y): x not in listN) rrrrr^rFrGr ValueError)rN orig_valuercrrOs rTreplaceDeb822ParsedTokenList.replacesu  $$//1D$**e,,djj1IZ1W!00; $  2 @A ArWcURnURR5HCn[URU5(dM UR UR5U:XdMAUn O [ S5eURU5$)zRemove the first instance of a value Removal will invalidate ValueReferences to the value being removed. ValueReferences to other values will be unaffected. zlist.remove(x): x not in list)rrrrr^rFrr)rNr^rrOnode_to_removes rTrhDeb822ParsedTokenList.removesr $$//1D$**e,,djj1IU1R!%2 <= =  00rWcURnSUlSnSnSnSnURSS9HMnURn[ U[ 5(aUR (aSnM9[ X5(dMKUn O URSS9HMn U Rn [ U [ 5(aU R (aSnM9[ X5(dMKU n O UcUcURR5 gUb U(dSn OUb U(dSn OUSLn U (aUn URn OURn Un U cXRl U cXRl [R"X5 g)NTF skip_current)rr iter_previousr^rr! is_comment iter_nextrclear next_node previous_node head_node tail_noder4 link_nodes)rNrrfirst_value_on_lhsfirst_value_on_rhscomment_before_previous_valuecomment_before_next_value past_node past_token future_node future_tokendelete_lhs_of_nodefirst_remain_lhsfirst_remain_rhss rTr"Deb822ParsedTokenList._remove_nodes  v"!(-%$)!'5545HI"J*k22z7L7L04-*,,%."I*333FK&,,L, 449P9P,0),..%0"G  %*<*D    " " $   )2O!%   +4M!&  "44!?  1 -77 -;; 1   #)9   &  #)9   &!!"2ErWcHURU5nURU5 grK)rG append_value)rNr^vts rTrDeb822ParsedTokenList.appends   ' "rWcURnU(ajSnURnURn[U5H)n[ Xe5(aSn O[ Xd5(dM) O U(aUR 5 O$URR [S55 UR5 SUl UR U5 gr) rrrreversedrrrr&rr)rNrrneeds_separatorrrts rTr"Deb822ParsedTokenList.append_values&& #OKKEKKEk*a''&*Oa'' +%%'    # #$9#$> ? 99; 2rWcURRnUSL=(a UR5RS5$N )rrconvert_to_textendswithrNrs rT_previous_is_newline*Deb822ParsedTokenList._previous_is_newlines7$$4ID$8$8$:$C$CD$IIrWcUR5(a [S5eURR[ 55 g)Nz9Cannot add a newline after a token that ends on a newline)rrrrr(r_s rTappend_newline$Deb822ParsedTokenList.append_newlines5  $ $ & &XY Y  < >?rWcURRnUb$UR5RS5(dUR 5 [ [ U55nURRU5 gr)rrrrrr%_format_commentr)rN comment_textr comment_tokens rTappend_comment$Deb822ParsedTokenList.append_comments`$$ >tDD    !*?<+HI   .rWcURnUc>SnURH&n[U[5(dMURn O XlU$Nr)rrrr'text)rNchartokens rT_continuation_line_char-Deb822ParsedTokenList._continuation_line_charsN,, <D))e%ABB ::D*-1 ) rWcURRnUbTUR5RS5(a/URR [ UR 55 gggr)rrrrrr'rrs rTrBDeb822ParsedTokenList._append_continuation_line_token_if_necessarys[$$   4 4 6 ? ? E E    # #$@A]A]$^ _!F rWc2UR5 SUlgr)_enable_reformattingrr_s rTreformat_when_finished,Deb822ParsedTokenList.reformat_when_finisheds !!# rWcSUlgNFrr_s rTr*Deb822ParsedTokenList._enable_reformattings 491rWcSUlgrrr_s rTno_reformatting_when_finished3Deb822ParsedTokenList.no_reformatting_when_finisheds 481rWFc<XlSUlU(aSUlgg)a<Use a custom formatter when formatting the value :param formatter: A formatter (see debian._deb822_repro.formatter.format_field for details) :param force_reformat: If True, always reformat the field even if there are no (other) changes performed. By default, fields are only reformatted if they are changed. FTN)rrr)rN formatterforce_reformats rTvalue_formatter%Deb822ParsedTokenList.value_formatters $491  DM rWchUR(aSUlURR5 g)zGLike list.clear() - removes all content (including comments and spaces)TN)rrrr_s rTrDeb822ParsedTokenList.clears$    DM  rWc## URH6n[U[5(aUR5ShvN M2Uv M8 gN7frK)rr Deb822Element iter_tokens)rNtes rT_iter_content_as_tokens-Deb822ParsedTokenList._iter_content_as_tokenss:""B"m,,>>+++ #+s8A A A c^^^UR5nURmURmURmUUU4Sjn[ UR UR R[R"UR5U"55$)Nc3># SnTHn[U[5(anUR(a$[R"UR 5v MM[UT5(a&UR n[R "U5v MM[UT5(deUR5n[R"U5v M g7f)N) rr!rrr rrr value_token)rr-r token_listrs rT _token_iterNDeb822ParsedTokenList._generate_reformatted_field_content.._token_itersD b+..}}3AA"''JJ#B..!ww3CCDII/&b%0000--/D/;;DAA!sC C) rrrrrrr field_namerrr)rNrr5rr4rs @@@rT#_generate_reformatted_field_content9Deb822ParsedTokenList._generate_reformatted_field_contentsq99;  %%  BDOO 00;;1AA/BVBVW'M rWcNSRSUR555$)Nr2c38# UHoRv M g7frKrrrs rTr@Deb822ParsedTokenList._generate_field_content..sF'E!vv'E)joinr.r_s rT_generate_field_content-Deb822ParsedTokenList._generate_field_contents wwFt'C'C'EFFFrWcURnURnURnURnSnUR 5H+nSnUR (aMUR (aM+ O U(a [S5eUb[U[5(aUR (a [S5eUR5RS5(dUR5 UR(a#UR5nSRX'45nOUR!5nUR#SS9n OUS-/n [%['U 55n U R)5n U (a[S U-5e[+['U 55n [U [,5(deU R/U5n U ceU $) NFTzUField must be completely empty or have content (i.e. non-whitespace and non-comments)z Fields must not end on a commentr:keependsz: $Syntax error in new field value for )rr7rrr.rrrrr!rrrrrAr@r8 splitlinesparse_deb822_filerfind_first_error_elementr'Deb822NoDuplicateFieldsParagraphElementget_kvpair_element)rNrr7r4r had_tokensr value_textr new_content deb822_file error_token paragraphnew_kvpair_elements rT_generate_kvpair&Deb822ParsedTokenList._generate_kvpairs--#.. %%  --/AJ<<<0  "JKK  $ ,, !CDD'')22488##%88!99; xx 89??A//4/8K &-.K([(9: !::< CjPQ Qk*+ )%LMMMM&99*E!---!!rW)with_field_namerVclUR5nU(aUO URnUR5$rK)rT value_elementr)rNrVkvpairelements rTr%Deb822ParsedTokenList.convert_to_textBs.&&(+&1E1E&&((rWchURnUR5RUlSUlgr)rrTrXr)rNrs rTr#Deb822ParsedTokenList._update_fieldGs+--'+'<'<'>'L'L$ rWkeyreversec8^^SnURnURmU4Sjn/nURR5HnURn[ U[ 5(aUR(aUcUnM<[ X5(dMN/n Ub7URSS9H$n XLa OU RU R5 M& URX45 SnM URXRS9 SUl URR5 Sn UR5Rn UHupU (a?Sn U (a5U V s/sHn [ U T5(aMU PM n n UR5 OlU (d)[!U4SjU 55(dUR#SS9 U (aUR5 O$URR[%S 55 URR'U 5 UR)U5 M gs sn f) aSort the elements (abstract values) in this list. This method will sort the logical values of the list. It will attempt to preserve comments associated with a given value where possible. Whether space and separators are preserved depends on the contents of the field as well as the formatting settings. Sorting (without reformatting) is likely to leave you with "awkward" whitespace. Therefore, you almost always want to apply reformatting such as the reformat_when_finished() method. Sorting will invalidate all ValueReferences. NcN>T(a T"US5$USR5$Nrr)xr_s rTkey_func5Deb822ParsedTokenList.sort_elements..key_funcbs'1Q4y Q4'') )rWFrr^Tc3<># UHn[UT5v M g7frK)r)rrers rTr6Deb822ParsedTokenList.sort_elements..s5]T\qjE6J6JT\s)rr)rrrrr^rr!rrrsortrrrrranyrr&extendr)rNr_r`comment_start_noderrfrrOr^comments keep_node first_valueseparator_is_spacerers ` @rT sort_elements#Deb822ParsedTokenList.sort_elementsLs$"   * $$//1DJJE%--%2B2B%-)-&%''%1%7%A%Au%A%U $,!  8&V e./%)"2"  x 1    !<<>LL$OE# ,4P8a:a;O8HP''))#5]T\5]2]2] )))F'')$$++,A#,FG    # #H -   e $/ % Qs H!Hr_c ^^^TbURmUU4SjUS'UR"S0UD6 g)aSort the values (rendered as str) in this list. This method will sort the logical values of the list. It will attempt to preserve comments associated with a given value where possible. Whether space and separators are preserved depends on the contents of the field as well as the formatting settings. Sorting (without reformatting) is likely to leave you with "awkward" whitespace. Therefore, you almost always want to apply reformatting such as the reformat_when_finished() method. Sorting will invalidate all ValueReferences. Nc >T"T"U55$rKru)rr_rPs rT,Deb822ParsedTokenList.sort..s s6":rWr_ru)rFrr)rNr_kwargsrPs ` @rTrjDeb822ParsedTokenList.sorts-& ?\\F6F5M $V$rW) __continuation_line_charrrrrrrrFrrrrGrrjTF)r\rA)+rkrlrmrnrUrboolrrrqrrr=rrrrrrhrrrrrr rrrrrrr!r&rr.r8rArTrrrrrjrt __classcell__rs@rTrrs+"#H?2$2;OO$H^4$ $ @ B1"rFh .JdJ@ /   ` :9 (-!$! S6GG."`:?)$)3)  #N%d%%rWrzDeb822ParsedTokenList[VE, ST]c \rSrSrSSjrSrg)Interpretationic[erKNotImplementedError)rNrdiscard_comments_on_reads rT interpretInterpretation.interpret "!rWruNr|)rkrlrmrnrrtrurWrTrrs ,0"rWrcR^\rSrSrU4SjrS SjrSrSrSrS Sjr Sr U=r $) !GenericContentBasedInterpretationic:>[TU]5 XlX lgrK)rrU _tokenizer _value_parser)rN tokenizer value_parserrs rTrU*GenericContentBasedInterpretation.__init__s #)rWc[erKrrNr proxy_elementrs rT_high_level_interpretationcURnUR5n/nURURU55 [ X$5$rK)rXrrl _parse_str Deb822InterpretationProxyElement)rNrYrXcontentr4s rT _parse_kvpair/GenericContentBasedInterpretation._parse_kvpairsD ,, //1 $//'23/ JJrWc## [U5n[[UURU5US95n[UUR U5US9ShvN gN7f)N) content_len)lenrrrr)rNrrbiters rTr,GenericContentBasedInterpretation._parse_strsZ'l !"4W59__W5MAL#OP&g&*&8&8&?2=( ( (sA AAAcFURU5nURUUUS9$N)r)rr)rNrrrs rTr+GenericContentBasedInterpretation.interprets4 **>: ..~/US:Xa [S5e[T"U55n[US5n[US5nUc SU-S-5eUb.[R"S5R US9n[U5e[ UT5(dh[ U[5(a-UR(dUR(a [S5eSn[UR UTRUS 95e[UR55[U5:Xd5S R [UR55[U5S 95eU$) Nr2zThe empty string is not a valuez.Bad parser - it returned None (or no TE) for ""z The input "{v}" should have been exactly one element, but the parser provided at least two. This can happen with unnecessary leading/trailing whitespace or including commas the value for a comma list. rz._value_factorys= 7>? ?&)_ *d # *d #~YORSSVYYY~ >//#!  S/ !"e$$"k** AQAQ !_``.CSZZ!2ZNO O2%%'(CF2  ,,2F2--/0A-3- 2  rWru)rrrGs`` rTrrs: rWc4^\rSrSrU4SjrSSjrSrU=r$)ListInterpretationi$cT>[TU]X5 X0lX@lXPlX`lgrK)rrUrrr_render_factory)rNrrrrrrender_factoryrs rTrUListInterpretation.__init__&s( 1  *C'-rWc [UUURURURURUR U55$rK)rrrrrrrs rTr-ListInterpretation._high_level_interpretation5sD %   KK KK OO  + +  !9 :  rW)rrrrr|)rkrlrmrnrUrrtrrs@rTrr$s .$=A  rWrc[U/5$rK)Deb822ParsedValueElement)r_s rT_parse_whitespace_list_valuerFs #UG ,,rWc"[U[5$rK)rr)rs rT_is_comma_tokenrKs a) **rWcUR[5nU/nUb$URURUS- 55 OURUR 55 U(aI[ US[ 5(d1UR5 U(a[ US[ 5(dM1UR[U5S- 5 [U5$)N) peek_findrrl peek_many peek_bufferrr"r consume_manyrr)rr comma_offsetrs rT_parse_comma_list_valuerQs$..?L'K,66|a7GHI ,88:; jR:JKK jR:JKK""3{#3a#78 #K 00rWcU/nSnUGbUR[5nUGb9US/nURURUS- 55 Sn[ U5S- nUS:aXFn[ U[ 5(aURRS5(apURURU55 [ US[ 5(a#USRRS5(dS[U5-5eSnO US-nUS:aMU(aOURURU55 [ US[5(deOUR5n[ U5nURU5 U(aN[ US[ 5(d6UR5 US-nU(a[ US[ 5(dM6URU5 UbGM[U5$)NrrFr>zGot: T)rrrlrrrr"rrrrrr)rrr) rrrrpeeked_elementscomma_was_separatoriremaining_partconsume_elementss rT_parse_uploaders_list_valuercs 'KL  "(22?C  # +2/O  " "#4#>#>|a?O#P Q"' O$q(Aq&'*e%566zz**3//#**+<+I+I!+LM)+b/;KLL*233<2    ~ .jRBR&S&S! A% jRBR&S&S  * *+; UR5H nXlM grK)rrrs rT_init_parent_of_parts#Deb822Element._init_parent_of_partssOO%D"& &rWcNSRSUR555$)Nr2c38# UHoRv M g7frKr<r=s rTr0Deb822Element.convert_to_text..s:'9!vv'9r?r@r,r_s rTrDeb822Element.convert_to_texts ww:t'7'7'9:::rWc0XRLaSUlggrK)rrrNparents rTclear_parent_if_parent$Deb822Element.clear_parent_if_parents (( (#'D  )rWcURnUc6[R"[SUR 555nXlU$)Nc3@# UHoR5v M g7frKsizerps rTr%Deb822Element.size..5#4a#4)rr from_position_and_sizesrr)rN size_caches rTrDeb822Element.sizesC**  6654??#45J%/ !rW)rrrj)rkrlrmrnrorprUrrr,rrqr~rrrrrrsrrrrr r rrtrurWrTr+r+s;FI%" 15d$Dtd11[[' ;;( erWr+cr^\rSrSrSrS\S\\SS4U4SjjrSr S\ 4S jr S\ 4S jr S\ 4S jrS rU=r$) ri)r real_elementrr\NcX>[TU]5 XlX lUH nXlM grK)rrUrr)rNrrrrs rTrU)Deb822InterpretationProxyElement.__init__s) * A# rWc,[UR5$rK)rrr_s rTr+Deb822InterpretationProxyElement.iter_partssDJJrWcVURnUc [S5eUR5$Nzparent was garbage collected)rrYposition_in_parentrs rTr 3Deb822InterpretationProxyElement.position_in_parents-$$ >=> >((**rWcVURnUc [S5eUR5$r)rrYposition_in_filers rTr#1Deb822InterpretationProxyElement.position_in_files-$$ >=> >&&((rWcfSUR55n[R"[U5$)Nc3@# UHoR5v M g7frKrrs rTr8Deb822InterpretationProxyElement.size.. rr)rr rr)rNsizess rTr%Deb822InterpretationProxyElement.sizes&54??#45,,^UCCrW)rr)rkrlrmrnrpr+rr=rUrrr r#r rrtrrs@rTrrsYI$]$4;O$TX$ +H+ )() DeDDrWrcN^\rSrSrSrSrU4SjrSr\S\ 4Sj5r Sr U=r $)Deb822ErrorElementi ahElement representing elements or tokens that are out of place Commonly, it will just be instances of Deb822ErrorToken, but it can be other things. As an example if a parser discovers out of order elements/tokens, it can bundle them in a Deb822ErrorElement to signal that the sequence of elements/tokens are invalid (even if the tokens themselves are valid). _partscb>[TU]5 [U5UlUR 5 grK)rrUtupler-r)rNrrs rTrUDeb822ErrorElement.__init__s% El  ""$rWc#8# URShvN gN7frKr,r_s rTrDeb822ErrorElement.iter_partss;;rr\cgrrur_s rTrDeb822ErrorElement.is_error"rW) rkrlrmrnrorprUrrqr~rrtrrs@rTr+r+ s4I% $rWr+c^\rSrSrSrSrU4Sjr\S5r\S5r \S5r S\ 4S jr S r S rS\4S jrS rSrU=r$)Deb822ValueLineElementi'z!Consists of one "line" of a value)_comment_element_continuation_line_token_leading_whitespace_token _value_tokens_trailing_whitespace_token_newline_tokenc>[TU]5 UbUc [S5eXlX lUUlX@lXPlX`lUR5 g)Nz)Only continuation lines can have comments) rrUrr8r9r:r;r<r=r)rNcomment_elementcontinuation_line_tokenleading_whitespace_tokenrtrailing_whitespace_token newline_tokenrs rTrUDeb822ValueLineElement.__init__-s]   &+B+JHI I /(?% $ &(*C'+ ""$rWcUR$rKr8r_s rTr?&Deb822ValueLineElement.comment_elementD$$$rWcUR$rK)r9r_s rTr@.Deb822ValueLineElement.continuation_line_tokenIs,,,rWcUR$rK)r=r_s rTrC$Deb822ValueLineElement.newline_tokenN"""rWr\clURc'[5UlXRlSUlggr)r=r(rrr_s rTadd_newline_if_missing-Deb822ValueLineElement.add_newline_if_missingSs3    &">"@D 15   .$(D !rWc## UR(aURv URShvN UR(aURv ggN%7frK)r:r;r<r_s rT_iter_content_parts*Deb822ValueLineElement._iter_content_parts[sH  ) )00 0%%%%  * *11 1 + &s/AA&Ac## UR5H6n[U[5(aUR5ShvN M2Uv M8 gN7frK)rRrr+r,rs rT_iter_content_tokens+Deb822ValueLineElement._iter_content_tokenscs?,,.D$ ..++--- /-s.usC'B!vv'Br?) rr;r:r<rr!rr@rUr_s rTconvert_content_to_text.Deb822ValueLineElement.convert_content_to_textksv t!! "a '6677t11!4kBB%%a(-- -wwCt'@'@'BCCCrWc## UR(aURv UR(aURv UR5ShvN UR(aURv ggN%7frK)r8r9rRr=r_s rTr!Deb822ValueLineElement.iter_partsws`  '' '  ( (// /++---   %% %  .sAA<A:&A<)r8r9rr:r=r<r;)rkrlrmrnrorprUrqr?r@rCr~rOrRrUrrrZrrtrrs@rTr7r7's}+RI%.%%--##2 D D&&rWr7cP^\rSrSrSrU4Sjr\S5rSrS\ 4Sjr Sr U=r $) Deb822ValueElementi_value_entry_elementscd>[TU]5 [U5nX lUR 5 grK)rrUr/rar)rNvalue_entry_elementsrrs rTrUDeb822ValueElement.__init__s+  & '%&" ""$rWcUR$)zRead-only list of value entriesr`r_s rT value_linesDeb822ValueElement.value_liness)))rWc#8# URShvN gN7frKr`r_s rTrDeb822ValueElement.iter_partss----rr\cUR(a-URSR5nU(aSUlU$g)NrF)rarOr)rNchangeds rTadd_final_newline_if_missing/Deb822ValueElement.add_final_newline_if_missings7  % %004KKMG(,%NrW)rra) rkrlrmrnrprUrqrfrr~rlrtrrs@rTr_r_s7*I%** .drWr_cT^\rSrSrSrU4SjrS\4U4SjjrS\4SjrSr Sr U=r $)ri) _text_cached_text_no_comments_cachedrc|>[TU]5 XlUR5 [ US[ 5(a[ US[ 5(d"[ URRS-5e[U5S:Xa(USnURUl URUl gSUl SUl g)Nrrz) MUST start and end on a Deb822ValueTokenr) rrUrrrr"rrrkrrrorp)rNtokensrrs rTrU!Deb822ParsedValueElement.__init__s ! ""$&)%566vbz+;<<T^^447bbc c v;! 1IE % D ,1JJD ) $D ,0D )rWr\c\>URc[TU] 5UlUR$rK)rprr)rNrs rTr(Deb822ParsedValueElement.convert_to_texts+  ( ( 0,1G,C,ED ),,,rWcURc+SRSUR555UlUR$)Nr2c3`# UH$nUR(aMURv M& g7frKrrr=s rTrLDeb822ParsedValueElement.convert_to_text_without_comments..s%4I=O;<<<5;AFF=O..)rpr@r,r_s rT convert_to_text_without_comments9Deb822ParsedValueElement.convert_to_text_without_commentssF  ( ( 0,.GG4I=A=M=M=O4I-ID ),,,rWc#8# URShvN gN7frKrr_s rTr#Deb822ParsedValueElement.iter_partss####r) rkrlrmrnrprUrrrr{rrtrrs@rTrrs/KI1 -- -#-$$rWrc^^\rSrSrSrU4Sjr\S\4Sj5rS\ 4Sjr Sr Sr Sr U=r$) Deb822CommentElementi_comment_tokensc>[TU]5 [U5UlU(d [ S5eUR 5 g)Nz5Comment elements must have at least one comment token)rrUr/rrr)rNcomment_tokensrs rTrUDeb822CommentElement.__init__s6 $^4TU U ""$rWr\cgrrur_s rTrDeb822CommentElement.is_commentr5rWc,[UR5$rK)rrr_s rT__len__Deb822CommentElement.__len__s4''((rWc URU$rKrrNitems rT __getitem__ Deb822CommentElement.__getitem__s##D))rWc#8# URShvN gN7frKrr_s rTrDeb822CommentElement.iter_partss''''r)rkrlrmrnrprUrqr~rintrrrrtrrs@rTrrsC$I%D))*((rWrc^\rSrSrSrU4Sjr\S5r\S5r\S5r \ RS5r S Sjr \S 5r \ RS 5r S r S rU=r$)rAir8 _field_token_separator_token_value_elementcr>[TU]5 XlX lX0lX@lUR 5 grK)rrUr8rrrr)rNr? field_tokenrrXrs rTrU"Deb822KeyValuePairElement.__init__s4  /' /+ ""$rWc.URR$rK)rrr_s rTr7$Deb822KeyValuePairElement.field_names$$$rWcUR$rK)rr_s rTr%Deb822KeyValuePairElement.field_tokens   rWcUR$rK)rr_s rTrX'Deb822KeyValuePairElement.value_elementrMrWc`SUlURRU5 XlXlgrK)rrr rrbs rTrXrs,!% 2248'#' rWc URXS9$r)r)rN interpreterrs rT interpret_as&Deb822KeyValuePairElement.interpret_ass $$T$]]rWcUR$rKrFr_s rTr?)Deb822KeyValuePairElement.comment_elementrHrWcSUlUb.USRRS5(d [S5eUR(aURR U5 UbXlXlg)Nrrz&Field comments must end with a newline)rrrrr8r r)rNr^s rTr?rsf!%  9>>**400 !IJJ   ! ! 8 8 >  #' %rWc## UR(aURv URv URv URv g7frKrr_s rTr$Deb822KeyValuePairElement.iter_parts!s>  '' '###!!!sA A )r8rrrrr|)rkrlrmrnrprUrqr7rrXrsrr?rrtrrs@rTrArAsZI %%%!!##((/3^%% & &""rWcUS:XagSUSS;a [S5eURS5(dUR5S-nURS5(dSUR 5-nU$)Nr2z# rrz-Comment lines must not have embedded newlines#z# )rrrstrip startswithlstrip)cs rTr r *shBw q"v~HII ::d   HHJ  <<   188:  HrWFcSnSn[U[5(a9UupBU(a"US:waSn[URXBS95eSn[ U5nO1Sn[U[ 5(aUnUR nO [ U5nXBU4$)NrzECannot resolve key "{key}" with index {index}. The key is not indexedr_index)rr/KeyErrorrr6r*r)rraise_if_indexedr name_tokenr_rs rT _unpack_keyr8s EJ$  z]szzcz?@@ECj d0 1 1J//C+C z !!rWc## U(dSU5ShvN gUH+nSRSUR555v M- gN77f)Nc3@# UHoR5v M g7frKrd)rrs rTr0_convert_value_lines_to_lines..Xs=A%%''rr2c3`# UH$nUR(aMURv M& g7frKrxrres rTrr[s$/*?Q!"!!&&*?rzr)rfstrip_commentsrZs rT_convert_value_lines_to_linesrSsM ===="G''/'*=*=*?// /# >sAA8Ac\rSrSrSrg)_ParagraphMapping_BaseidruN)rkrlrmrnrtrurWrTrrds rWrch\rSrSr\S\4Sj5r\S5rS\4Sjr Sr Sr Sr S r S rS rg ) AutoResolvingMixinikr\cgrrur_s rT_auto_resolve_ambiguous_fields1AutoResolvingMixin._auto_resolve_ambiguous_fieldsmr5rWc[erKrr_s rT _paragraphAutoResolvingMixin._paragraphq "!rWc.URR$rK)r kvpair_countr_s rTrAutoResolvingMixin.__len__vs+++rWc8URRU5$rK)rcontains_kvpair_elementrs rT __contains__AutoResolvingMixin.__contains__ys66t<# UH)upT(aUS:XaUR5S-OUv M+ g7f)rrN)strip)rrlineauto_map_spaces rTrIDeb822ParagraphToStrWrapperMixin._convert_value_to_str..s4 -J'!6DQdjjlT1TXX-Js14startrr) rXrfrrrrrrr@ enumerater) rNrrX value_entries value_entryr converteras_textrs @rT_convert_value_to_str6Deb822ParagraphToStrWrapperMixin._convert_value_to_strs&44 %11 }  "(*K++-A55GGIH  1 1T5S5S5m6:6T6T8I"CCNgg -6y-J  G $335G  ; ; t@ScrlGrWc$URnSnU(aWUR(aFSnUn[U[5(aUS4nURR USS9nUb UR nUR(aURS5nUS:XdU[U5:Xa+URRUUR5UUS9 gURSS5upU(a-USSS;a$S RS UR5SU 45nOS RUSU 45nURS5(d!UR (d [S 5eUS- nURR#UUUUS9 g![a SnNf=f) NrTuse_getrrpreserve_original_field_comment field_commentr) rr2rzeValues must end with a newline (or be single line values and use the auto whitespace mapping feature))rrrrrrrLr?rrrrset_field_to_simple_valuersplitr@rrset_field_from_raw_string) rNrr^ keep_commentscomment key_lookup orig_kvpairidx first_linerests rT __setitem__,Deb822ParagraphToStrWrapperMixin.__setitem__sFF  T@@ !MJ$$$"AY //<_AbstractDeb822ParagraphWrapper__auto_resolve_ambiguous_fields9_AbstractDeb822ParagraphWrapper__discard_comments_on_read)rNrRrrs rTrU'AbstractDeb822ParagraphWrapper.__init__s%/L,*B'rWcUR$rK)rr_s rTr)AbstractDeb822ParagraphWrapper._paragraph srWr\cUR$rK)rr_s rTr8AbstractDeb822ParagraphWrapper._discard_comments_on_reads...rWcUR$rK)rr_s rTr=AbstractDeb822ParagraphWrapper._auto_resolve_ambiguous_fieldss333rW)__auto_resolve_ambiguous_fields__discard_comments_on_read __paragraphN) rkrlrmrnrUrqrr~rrrtrurWrTrrsZ 05*. C  /4//444rWrc8^\rSrSrSSS.U4SjjrSrSrU=r$)"Deb822InterpretingParagraphWrapperiFTrc0>[TU]UUUS9 X lgNr)rrU_interpretation)rNrRinterpretationrrrs rTrU+Deb822InterpretingParagraphWrapper.__init__s' 7T2J   .rWc8URRU5$rK)r&rrs rTr3Deb822InterpretingParagraphWrapper._interpret_value+s##--e44rW)r&)rkrlrmrnrUrrtrrs@rTr#r#s 05*. . .55rWr#c^\rSrSrSSSSSS.U4Sjjr\S\4Sj5r\S\4Sj5r\S\4S j5r S r U=r $) Deb822DictishParagraphWrapperi0TFr auto_map_initial_line_whitespacer(preserve_field_comments_on_field_updates*auto_map_final_newline_in_multiline_valuescJ>[TU]UUUS9 X0lXPlUUlgr%)rrU@_Deb822DictishParagraphWrapper__auto_map_initial_line_whitespaceH_Deb822DictishParagraphWrapper__preserve_field_comments_on_field_updatesJ_Deb822DictishParagraphWrapper__auto_map_final_newline_in_multiline_values)rNrRrr.rr/r0rs rTrU&Deb822DictishParagraphWrapper.__init__3s9 7T2J  3S/:b7 6 9rWr\cUR$rK)r2r_s rTr?Deb822DictishParagraphWrapper._auto_map_initial_line_whitespaceFs666rWcUR$rK)r3r_s rTrGDeb822DictishParagraphWrapper._preserve_field_comments_on_field_updatesJs>>>rWcUR$rK)r4r_s rTrIDeb822DictishParagraphWrapper._auto_map_final_newline_in_multiline_valuesNs@@@rW),__auto_map_final_newline_in_multiline_values"__auto_map_initial_line_whitespace*__preserve_field_comments_on_field_updates) rkrlrmrnrUrqr~rrrrtrrs@rTr,r,0sr +/26/4:><@77&7477?4??ATAArWr,cD\rSrSr\S5r\S5r\S5r\S\ 4Sj5r SS.S jr SSSSSS .S jr \S 5r S rSrSrSr\S\4Sj5rSrSrS SjrSrSrS!SjrSSS.SjrSSS.Sjr\S5r\S\4Sj5rS!SjrSrg)"Deb822ParagraphElementiSc*[/[55$rK)rKr5clss rTnew_empty_paragraph*Deb822ParagraphElement.new_empty_paragraphUs7r:<HHrWc`UR5nUR5H up4XBU'M U$rK)rDitems)rCmappingrRkrs rT from_dict Deb822ParagraphElement.from_dictZs1++- MMODAaL$rWcU(d [S5e[SU55n[U5[U5:Xa [X5$[ U5$)Nz9A paragraph must consist of at least one field/value pairc38# UHoRv M g7frKr7rkvs rTr6Deb822ParagraphElement.from_kvpairs..gs!J/B--/r?)rr5rrK%Deb822DuplicateFieldsParagraphElement)rCkvpair_elements kvpair_orders rT from_kvpairs#Deb822ParagraphElement.from_kvpairsbsOXY Y!!J/!JJ | O 4 4;?Y Y5_EErWr\cg)z0Tell whether this paragraph has duplicate fieldsFrur_s rThas_duplicate_fields+Deb822ParagraphElement.has_duplicate_fieldsqsrWTrc[UUUS9$)a Provide a Dict-like view of the paragraph This method returns a dict-like object representing this paragraph and is useful for accessing fields in a given interpretation. It is possible to use multiple versions of this dict-like view with different interpretations on the same paragraph at the same time (for different fields). >>> example_deb822_paragraph = ''' ... Package: foo ... # Field comment (because it becomes just before a field) ... Architecture: amd64 ... # Inline comment (associated with the next line) ... i386 ... # We also support arm ... arm64 ... armel ... ''' >>> dfile = parse_deb822_file(example_deb822_paragraph.splitlines()) >>> paragraph = next(iter(dfile)) >>> list_view = paragraph.as_interpreted_dict_view(LIST_SPACE_SEPARATED_INTERPRETATION) >>> # With the defaults, you only deal with the semantic values >>> # - no leading or trailing whitespace on the first part of the value >>> list(list_view["Package"]) ['foo'] >>> with list_view["Architecture"] as arch_list: ... orig_arch_list = list(arch_list) ... arch_list.replace('i386', 'kfreebsd-amd64') >>> orig_arch_list ['amd64', 'i386', 'arm64', 'armel'] >>> list(list_view["Architecture"]) ['amd64', 'kfreebsd-amd64', 'arm64', 'armel'] >>> print(paragraph.dump(), end='') Package: foo # Field comment (because it becomes just before a field) Architecture: amd64 # Inline comment (associated with the next line) kfreebsd-amd64 # We also support arm arm64 armel >>> # Format preserved and architecture replaced >>> with list_view["Architecture"] as arch_list: ... # Prettify the result as sorting will cause awkward whitespace ... arch_list.reformat_when_finished() ... arch_list.sort() >>> print(paragraph.dump(), end='') Package: foo # Field comment (because it becomes just before a field) Architecture: amd64 # We also support arm arm64 armel # Inline comment (associated with the next line) kfreebsd-amd64 >>> list(list_view["Architecture"]) ['amd64', 'arm64', 'armel', 'kfreebsd-amd64'] >>> # Format preserved and architecture values sorted :param interpretation: Decides how the field values are interpreted. As an example, use LIST_SPACE_SEPARATED_INTERPRETATION for fields such as Architecture in the debian/control file. :param auto_resolve_ambiguous_fields: This parameter is only relevant for paragraphs that contain the same field multiple times (these are generally invalid). If the caller requests an ambiguous field from an invalid paragraph via a plain field name, the return dict-like object will refuse to resolve the field (not knowing which version to pick). This parameter (if set to True) instead changes the error into assuming the caller wants the *first* variant. rZ)r#)rNr'rs rTas_interpreted_dict_view/Deb822ParagraphElement.as_interpreted_dict_viewvsT2  *G  rWr-c [UUUUUUS9$)ayProvide a Dict[str, str]-like view of this paragraph with non-standard parameters This method returns a dict-like object representing this paragraph that is optionally configured differently from the default view. >>> example_deb822_paragraph = ''' ... Package: foo ... # Field comment (because it becomes just before a field) ... Depends: libfoo, ... # Inline comment (associated with the next line) ... libbar, ... ''' >>> dfile = parse_deb822_file(example_deb822_paragraph.splitlines()) >>> paragraph = next(iter(dfile)) >>> # With the defaults, you only deal with the semantic values >>> # - no leading or trailing whitespace on the first part of the value >>> paragraph["Package"] 'foo' >>> # - no inline comments in multiline values (but whitespace will be present >>> # subsequent lines.) >>> print(paragraph["Depends"]) libfoo, libbar, >>> paragraph['Foo'] = 'bar' >>> paragraph.get('Foo') 'bar' >>> paragraph.get('Unknown-Field') is None True >>> # But you get asymmetric behaviour with set vs. get >>> paragraph['Foo'] = ' bar\n' >>> paragraph['Foo'] 'bar' >>> paragraph['Bar'] = ' bar\n#Comment\n another value\n' >>> # Note that the whitespace on the first line has been normalized. >>> print("Bar: " + paragraph['Bar']) Bar: bar another value >>> # The comment is present (in case you where wondering) >>> print(paragraph.get_kvpair_element('Bar').convert_to_text(), end='') Bar: bar #Comment another value >>> # On the other hand, you can choose to see the values as they are >>> # - We will just reset the paragraph as a "nothing up my sleeve" >>> dfile = parse_deb822_file(example_deb822_paragraph.splitlines()) >>> paragraph = next(iter(dfile)) >>> nonstd_dictview = paragraph.configured_view( ... discard_comments_on_read=False, ... auto_map_initial_line_whitespace=False, ... # For paragraphs with duplicate fields, you can choose to get an error ... # rather than the dict picking the first value available. ... auto_resolve_ambiguous_fields=False, ... auto_map_final_newline_in_multiline_values=False, ... ) >>> # Because we have reset the state, Foo and Bar are no longer there. >>> 'Bar' not in paragraph and 'Foo' not in paragraph True >>> # We can now see the comments (discard_comments_on_read=False) >>> # (The leading whitespace in front of "libfoo" is due to >>> # auto_map_initial_line_whitespace=False) >>> print(nonstd_dictview["Depends"], end='') libfoo, # Inline comment (associated with the next line) libbar, >>> # And all the optional whitespace on the first value line >>> # (auto_map_initial_line_whitespace=False) >>> nonstd_dictview["Package"] == ' foo\n' True >>> # ... which will give you symmetric behaviour with set vs. get >>> nonstd_dictview['Foo'] = ' bar \n' >>> nonstd_dictview['Foo'] ' bar \n' >>> nonstd_dictview['Bar'] = ' bar \n#Comment\n another value\n' >>> nonstd_dictview['Bar'] ' bar \n#Comment\n another value\n' >>> # But then you get no help either. >>> try: ... nonstd_dictview["Baz"] = "foo" ... except ValueError: ... print("Rejected") Rejected >>> # With auto_map_initial_line_whitespace=False, you have to include minimum a newline >>> nonstd_dictview["Baz"] = "foo\n" >>> # The absence of leading whitespace gives you the terse variant at the expensive >>> # readability >>> paragraph.get_kvpair_element('Baz').convert_to_text() 'Baz:foo\n' >>> # But because they are views, changes performed via one view is visible in the other >>> paragraph['Foo'] 'bar' >>> # The views show the values according to their own rules. Therefore, there is an >>> # asymmetric between paragraph['Foo'] and nonstd_dictview['Foo'] >>> # Nevertheless, you can read or write the fields via either - enabling you to use >>> # the view that best suit your use-case for the given field. >>> 'Baz' in paragraph and nonstd_dictview.get('Baz') is not None True >>> # Deletion via the view also works >>> del nonstd_dictview['Baz'] >>> 'Baz' not in paragraph and nonstd_dictview.get('Baz') is None True :param discard_comments_on_read: When getting a field value from the dict, this parameter decides how in-line comments are handled. When setting the value, inline comments are still allowed and will be retained. However, keep in mind that this option makes getter and setter asymmetric as a "get" following a "set" with inline comments will omit the comments even if they are there (see the code example). :param auto_map_initial_line_whitespace: Special-case the first value line by trimming unnecessary whitespace leaving only the value. For single-line values, all space including newline is pruned. For multi-line values, the newline is preserved / needed to distinguish the first line from the following lines. When setting a value, this option normalizes the whitespace of the initial line of the value field. When this option is set to True makes the dictionary behave more like the original Deb822 module. :param preserve_field_comments_on_field_updates: Whether to preserve the field comments when mutating the field. :param auto_resolve_ambiguous_fields: This parameter is only relevant for paragraphs that contain the same field multiple times (these are generally invalid). If the caller requests an ambiguous field from an invalid paragraph via a plain field name, the return dict-like object will refuse to resolve the field (not knowing which version to pick). This parameter (if set to True) instead changes the error into assuming the caller wants the *first* variant. :param auto_map_final_newline_in_multiline_values: This parameter controls whether a multiline field with have / need a trailing newline. If True, the trailing newline is hidden on get and automatically added in set (if missing). When this option is set to True makes the dictionary behave more like the original Deb822 module. r-)r,)rNrr.rr/r0s rTconfigured_view&Deb822ParagraphElement.configured_views$V- %=-M*G5]7a   rWcU$rKrur_s rTr!Deb822ParagraphElement._paragraphZs  rWc[e)9Re-order the given field so it is "last" in the paragraphrrNfields rT order_last!Deb822ParagraphElement.order_last_rrWc[e):Re-order the given field so it is "first" in the paragraphrres rT order_first"Deb822ParagraphElement.order_firstdrrWc[e)}Re-order the given field so appears directly after the reference field in the paragraph The reference field must be present.rrNrfreference_fields rT order_before#Deb822ParagraphElement.order_beforeirrWc[e)Re-order the given field so appears directly before the reference field in the paragraph The reference field must be present. rros rT order_after"Deb822ParagraphElement.order_afterprrWc[erKrr_s rTr#Deb822ParagraphElement.kvpair_countxrrWc[erKrr_s rTr Deb822ParagraphElement.iter_keys|rrWc[erKrrs rTr.Deb822ParagraphElement.contains_kvpair_elementrrWc[erKr)rNrrs rTrL)Deb822ParagraphElement.get_kvpair_elementrrWc[erKrrs rTset_kvpair_element)Deb822ParagraphElement.set_kvpair_elementrrWc[erKrrNr_s rTr,Deb822ParagraphElement.remove_kvpair_elementrrWNc[e)Re-order all fields :param key: Provide a key function (same semantics as for sorted). Keep in mind that the module preserve the cases for field names - in generally, callers are recommended to use "lower()" to normalize the case. rrs rT sort_fields"Deb822ParagraphElement.sort_fieldss "!rWrcSU;a [S5eUR5nU(a SU-S-nOSnURUUUUS9 g)aSets a field in this paragraph to a simple "word" or "phrase" In many cases, it is better for callers to just use the paragraph as if it was a dictionary. However, this method does enable to you choose the field comment (if any), which can be a reason for using it. This is suitable for "simple" fields like "Package". Example: >>> example_deb822_paragraph = ''' ... Package: foo ... ''' >>> dfile = parse_deb822_file(example_deb822_paragraph.splitlines()) >>> p = next(iter(dfile)) >>> p.set_field_to_simple_value("Package", "mscgen") >>> p.set_field_to_simple_value("Architecture", "linux-any kfreebsd-any", ... field_comment=['Only ported to linux and kfreebsd']) >>> p.set_field_to_simple_value("Priority", "optional") >>> print(p.dump(), end='') Package: mscgen # Only ported to linux and kfreebsd Architecture: linux-any kfreebsd-any Priority: optional >>> # Values are formatted nicely by default, but it does not work with >>> # multi-line values >>> p.set_field_to_simple_value("Foo", "bar\nbin\n") Traceback (most recent call last): ... ValueError: Cannot use set_field_to_simple_value for values with newlines :param item: Name of the field to set. If the paragraph already contains the field, then it will be replaced. If the field exists, then it will preserve its order in the paragraph. Otherwise, it is added to the end of the paragraph. Note this can be a "paragraph key", which enables you to control *which* instance of a field is being replaced (in case of duplicate fields). :param simple_value: The text to use as the value. The value must not contain newlines. Leading and trailing will be stripped but space within the value is preserved. The value cannot contain comments (i.e. if the "#" token appears in the value, then it is considered a value rather than "start of a comment) :param preserve_original_field_comment: See the description for the parameter with the same name in the set_field_from_raw_string method. :param field_comment: See the description for the parameter with the same name in the set_field_from_raw_string method. rz=Cannot use set_field_to_simple_value for values with newlinesrrN)rrr)rNr simple_valuerrstripped raw_values rTr0Deb822ParagraphElement.set_field_to_simple_values`l < \] ]  %%' h-II &&  ,K' ' rWc/nUbUb [S5eO4Ub1[U[5(dURSU55 SnSn[ U5un nUnUR USS9n UcSnU (a U RnSRX45n U RSS 9n [U S S 9HaupU RS 5(d[S RU S95eU S :wdM;U SS;dMFSn[URXSS95e [U 5S :a$U SRS5(a [S5eURU 5 [[!U55nUR#5nU(a[SU-5e[%[!U55n[U[&5(deUR U5nUceU(a U (aU R(UlSU lO UbUUlUR+UU5 g![ a U(aeUR US4SS9n GNf=f)a Sets a field in this paragraph to a given text value In many cases, it is better for callers to just use the paragraph as if it was a dictionary. However, this method does enable to you choose the field comment (if any) and lets to have a higher degree of control over whitespace (on the first line), which can be a reason for using it. Example usage: >>> example_deb822_paragraph = ''' ... Package: foo ... ''' >>> dfile = parse_deb822_file(example_deb822_paragraph.splitlines()) >>> p = next(iter(dfile)) >>> raw_value = ''' ... Build-Depends: debhelper-compat (= 12), ... some-other-bd, ... # Comment ... another-bd, ... '''.lstrip() # Remove leading newline, but *not* the trailing newline >>> fname, new_value = raw_value.split(':', 1) >>> p.set_field_from_raw_string(fname, new_value) >>> print(p.dump(), end='') Package: foo Build-Depends: debhelper-compat (= 12), some-other-bd, # Comment another-bd, >>> # Format preserved :param item: Name of the field to set. If the paragraph already contains the field, then it will be replaced. Otherwise, it is added to the end of the paragraph. Note this can be a "paragraph key", which enables you to control *which* instance of a field is being replaced (in case of duplicate fields). :param raw_string_value: The text to use as the value. The text must be valid deb822 syntax and is used *exactly* as it is given. Accordingly, multi-line values must include mandatory leading space on continuation lines, newlines after the value, etc. On the flip-side, any optional space or comments will be included. Note that the first line will *never* be read as a comment (if the first line of the value starts with a "#" then it will result in "Field-Name:#..." which is parsed as a value starting with "#" rather than a comment). :param preserve_original_field_comment: If True, then if there is an existing field and that has a comment, then the comment will remain after this operation. This is the default is the `field_comment` parameter is omitted. Note that if the parameter is True and the item is ambiguous, this will raise an AmbiguousDeb822FieldKeyError. When the parameter is omitted, the ambiguity is resolved automatically and if the resolved field has a comment then that will be preserved (assuming field_comment is None). :param field_comment: If not None, add or replace the comment for the field. Each string in the list will become one comment line (inserted directly before the field name). Will appear in the same order as they do in the list. If you want complete control over the formatting of the comments, then ensure that each line start with "#" and end with "\n" before the call. Otherwise, leading/trailing whitespace is normalized and the missing "#"/"\n" character is inserted. NzNThe "preserve_original_field_comment" conflicts with "field_comment" parameterc38# UHn[U5v M g7frK)r rs rTrCDeb822ParagraphElement.set_field_from_raw_string..9s"M}!?1#5#5}r?FTrrrDrErrrz2Line {i} in new value was missing trailing newline)r)rrrzLine {i} in new value was invalid. It must either start with " " space (continuation line) or "#" (comment line). The line started with "{line}")rrrrz2The last line in a value field cannot be a commentrG)rrrrlrrLr0r7r@rHrrrrrrIrrJrrKr?r)rNrraw_string_valuerrrOr7rcased_field_nameoriginalraw raw_linesrrrrPrQrRr^s rTr0Deb822ParagraphElement.set_field_from_raw_stringsfT * 6( ">??) &m-ABB"""M}"MM $ .3 +&t, Aq% N..tT.BH + 2/3 + '22 hh(;<NNDN1  !4GA==&& !U!\!\_`!\!abbAv$q')998!a1g!>??5 y>A )B-":":3"?"?QR R9%([(9: !::< CjPQ Qk*+ )%LMMMM,,Z8   *(0(@(@%+/(  &$1E ! e,[, N... A.MH  NsH$H=<H=cgrKrurNfds rTdumpDeb822ParagraphElement.dumpq rWcgrKrur_s rTrrx rWcUc&SRSUR555$UR5H-nURURR S55 M/ g)Nr2c38# UHoRv M g7frKr<r=s rTr.Deb822ParagraphElement.dump..>+=a66+=r?utf-8r@r,writerencoderNrrs rTrr|X :77>4+;+;+=>> >%%'E HHUZZ&&w/ 0(rWrur}rK) rkrlrmrn classmethodrDrJrUrqr~rXr\r_rrgrkrqrurrrrrLrrrrrrrrrrtrurWrTr@r@SsGII F Fd@DN d269=6:AECG R h" " """c"""" $)"""  " CG04 G ZCG04 G-R   c  rWr@c^\rSrSrSrU4Sjr\S\4Sj5rSr Sr Sr S r S r S rS rS rSSjrSrSSjrSrSrU=r$)rKizParagraph implementation optimized for valid deb822 files When there are no duplicated fields, we can use simpler and faster datastructures for common operations. c>[TU]5 UVs0sHo3RU_M snUlX lUR 5 gs snfrK)rrUr7_kvpair_elements _kvpair_orderr)rNrSrTrPrs rTrU0Deb822NoDuplicateFieldsParagraphElement.__init__sF =L M_r!2_ M) ""$!NsA r\c,[UR5$rK)rrr_s rTr4Deb822NoDuplicateFieldsParagraphElement.kvpair_counts4(())rWcV[USS9un nURRU5 g)rdTrN)rrrgrNrfunpacked_fieldrs rTrg2Deb822NoDuplicateFieldsParagraphElement.order_lasts+ +54H1 %%n5rWcV[USS9un nURRU5 g)rjTrN)rrrkrs rTrk3Deb822NoDuplicateFieldsParagraphElement.order_firsts+ +54H1 &&~6rWcr[USS9un n[USS9un nURRX55 g)rnTrN)rrrqrNrfrprrunpacked_ref_fields rTrq4Deb822NoDuplicateFieldsParagraphElement.order_befores@ +54H1#.QU#V Aq ''KrWcr[USS9un n[USS9un nURRX55 g)rtTrN)rrrurs rTru3Deb822NoDuplicateFieldsParagraphElement.order_afters@ +54H1#.QU#V Aq &&~JrWc:[SUR55$)Nc38# UHn[U5v M g7frKrrrrIs rTrCDeb822NoDuplicateFieldsParagraphElement.__iter__..7$6qCFF$6r?)rrr_s rTr0Deb822NoDuplicateFieldsParagraphElement.__iter__s7D$6$6777rWc#F# SUR5ShvN gN7f)Nc38# UHn[U5v M g7frKrrs rTrDDeb822NoDuplicateFieldsParagraphElement.iter_keys..rr?rr_s rTr1Deb822NoDuplicateFieldsParagraphElement.iter_keyss7D$6$6777 !!c~SUl[USS9un nURU URR U5 gNTr)rrrrrh)rNr_rs rTr=Deb822NoDuplicateFieldsParagraphElement.remove_kvpair_elements> $d; Q  ! !# & !!#&rWc[U[[[45(dg[ SU5n[ USS9un nX R ;$)NFr<Tr)rrrr/r*rrr)rNrr_rs rTr?Deb822NoDuplicateFieldsParagraphElement.contains_kvpair_elementsG$e-A BCCND)t< Q++++rWc[USS9un nU(aURRU5$URU$r)rrget)rNrrrs rTrL:Deb822NoDuplicateFieldsParagraphElement.get_kvpair_elementsA != a ((,,T2 2$$T**rWc[USS9un n[U[5(a&XRLa [ S5eUR nO&XR :wa [ S5eUR nUR RU5nSUlX R U'URRU5 UbSUl Xl g)NTrzOKey is a Deb822FieldNameToken, but not *the* Deb822FieldNameToken for the valuegCannot insert value under a different field value than field name from its Deb822FieldNameToken implies) rrr*rrr7rrrrrr)rNr_r^roriginal_values rTr:Deb822NoDuplicateFieldsParagraphElement.set_kvpair_elementsd; Q c/ 0 0+++ "233""C&&& "JKK""C..2237 $%*c" !!#&  %,0N )#rWc[UR5HBnUR[SU5nURR 5(aSUl O Uc[n[[URUS95Ulg)rr6Nrt) rrrrrXrlrr7r5sorted)rNr_last_field_name last_kvpairs rTr3Deb822NoDuplicateFieldsParagraphElement.sort_fieldssv ((:(:;O//Wo0NOK((EEGG(,%  < ;(C't/A/As(KLrWc#b^# U4Sj[STR55ShvN gN7f)Nc3B># UHnTRUv M g7frK)r)rrerNs rTrEDeb822NoDuplicateFieldsParagraphElement.iter_parts.. s$JH))!,HszIterable[_strI])rrr_s`rTr2Deb822NoDuplicateFieldsParagraphElement.iter_parts s/J!"3T5G5GHJ J Js $/-/rrrr}rK)rkrlrmrnrorUrqrrrgrkrqrurrrrrLrrrrtrrs@rTrKrKss %*c**6 7 LK88',$)+$.M&JJrWrKc^\rSrSrU4Sjr\S\4Sj5rSrSr Sr Sr S r S r S rS r\S\4S j5rSrSSjrSSjr\S5rSrSrSrSSjrSrU=r$)rRi c>[TU]5 [5Ul0UlUR U5 UR 5 grK)rrUr3rr_init_kvpair_fieldsr)rNrSrs rTrU.Deb822DuplicateFieldsParagraphElement.__init__ s= '\     1 ""$rWr\cX[UR5[UR5:$rK)rrrr_s rTrX:Deb822DuplicateFieldsParagraphElement.has_duplicate_fields s%4%%&T-B-B)CCCrWc.UR(aeUR(aeUHinURnURRU5nX0R;aU/URU'MKURURU5 Mk grK)rrr7r)rNkvpairsrPr7rOs rTr9Deb822DuplicateFieldsParagraphElement._init_kvpair_fields s%%%%((((BJ%%,,R0D!6!6659F%%j1%%j188> rWc[U5up#nURUn/nUcUb+URXRX45nUceURU5 XV4$UnXV4$rK)rr_resolve_to_single_noder)rNrfr_rrnodesnodes_being_relocated single_nodes rT_nodes_being_relocated0> *rWcURU5up4[U5S:Xd[U5[U5:XdeURU5upVUSnXt;a [S5eURn[ U5H%n UR U 5 UR X5 M' [U5S:Xa;[U5S:a+USRRn URU 5 ggg)rtrrrrN) rrrrrrrr^r7rrs rTru1Deb822DuplicateFieldsParagraphElement.order_aftery s (,'B'B5'I$()Q.#e*DY@Z2ZZZ!88I(,  2IJ J)) 23D  $ $T *  * *4 @4 $ % *s5zA~.q177BBJ  2 2: >0> *rWc/nURR5H0nURRU:XdMUR U5 M2 X R U'grK)rrr^r7rr)rNr7rrOs rTrGDeb822DuplicateFieldsParagraphElement._regenerate_relative_kvapir_order sN&&113Dzz$$ 2 T"4-2j)rWc#8# URShvN gN7frKrr_s rTr0Deb822DuplicateFieldsParagraphElement.iter_parts s%%%%rc,[UR5$rK)rrr_s rTr2Deb822DuplicateFieldsParagraphElement.kvpair_count s4%%&&rWc#F# SUR5ShvN gN7f)Nc38# UHoRv M g7frKrNrOs rTrBDeb822DuplicateFieldsParagraphElement.iter_keys.. s?,>bMM,>r?rr_s rTr/Deb822DuplicateFieldsParagraphElement.iter_keys s?D,>,>???rc *Uc[[U5S:waJUbURXA5nUbU$Sn[URU[U5[U5S- S95eSnX$![a$ U(agSn[ URX#S95ef=f)NrzAmbiguous key {key} - the field appears {res_len} times. Use ({key}, index) to denote which instance of the field you want. (Index can be 0..{res_len_1} or e.g. -1 to denote the last field))r_res_len res_len_1rz>Field "{key}" was present but the index "{index}" was invalid.r)r_find_node_via_name_tokenr0r IndexErrorr)rNrr_rrrrOrs rTr=Deb822DuplicateFieldsParagraphElement._resolve_to_single_node s =5zQ)99*LD'# T33::#FI%jHKE UV4>4XYYE =<  =RC3::#:;< <  =s A$$B7Bc[U5up4nU(a URRU5nUcgOURUnURXcXEUS9nUb UR$g)Nr)rrrrr^)rNrrr_rrrrOs rTrL8Deb822DuplicateFieldsParagraphElement.get_kvpair_element sv "-T!2J ))--c2E}))#.E++ESZ+[  :: rWcNUHnXRRLdMUs $ grK)r^r)relementsrOs rTr?Deb822DuplicateFieldsParagraphElement._find_node_via_name_token s(DZZ333 rWc[U[[[45(dg[ SU5nUR USS9SL$![ a gf=f)NFr<Tr)rrrr/r*rrLr0rs rTr=Deb822DuplicateFieldsParagraphElement.contains_kvpair_element sX$e-A BCCND) **4*>dJ J+  sA A Ac[U5upnU(azXBRLa_URRUR5nSnUbUR XE5nUc [ S5eUceURU5nURnO&XR:wa [ S5eURnSUlURRU5nUbU(d}Ub US:waSn[URXS95eURRU5nXR;aU/URU'gURURU5 gSn Uc'Sn USn[U5S:waU/URU'OXSnSURlXlX(lU (aI[U5S:wa9USSH/n SU RlURR!U 5 M1 ggg) NzKey is a Deb822FieldNameToken, but not *the* Deb822FieldNameToken for the value nor the Deb822FieldNameToken for an existing field in the paragraphrrzCannot replace field ({key}, {index}) as the field does not exist in the first place. Please index-less key or ({key}, 0) if you want to add the field.rFTr)rrrrr7rrrrrrrrrr^rr) rNr_r^rroriginal_nodes original_noderrO replace_allrs rTr8Deb822DuplicateFieldsParagraphElement.set_kvpair_element s!,S!1J !2!22!%!6!6!:!:5;K;K!L $ !-$($B$B:$^M ($&dee&111&,,];""C&&& "JKK""C $..2237  ! UaZ0szzcz?@@%%,,U3D///.2V%%c* %%c*11$7  =K!!$D>"a'.2V%%c* "(D%) !# 3~.!3#AB')-&""..q1(4;rWcl[U5upnURUnUcMUcJSUlUH/nSURlUR R U5 M1 URU gUb1URX45nUcSn[URUS95eUnO UceXBnSUl[U5S:XaURU OURU5 SURlUR R U5 g![a Sn[URXS95ef=f)Nz>The field "{key}" is present but key used to access it is not.rtz@The field "{key}" is present, but the index "{idx}" was invalid.)r_r r) rrrr^rrrrrrrrh)rNr_r r field_listrOrrs rTr;Deb822DuplicateFieldsParagraphElement.remove_kvpair_element. s@*3/***3/  #+$(D !",0 )""..t4#%%c*   ! :::RM$Vszzcz233 D? "? =! !% z?a %%c*   d #$( ! &&t, =Xszzcz;<< =s (D%D3c"^Uc[nUmU4Sjn[UR5H)nURR 5(aSUl O [ URUS9n[5Ul0UlURU5 g)zRe-order all fields :param key: Provide a key function (same semantics as for sorted). Keep in mind that the module preserve the cases for field names - in generally, callers are recommended to use "lower()" to normalize the case. Nc(>T"UR5$rKrN)rYkey_impls rT _actual_keyFDeb822DuplicateFieldsParagraphElement.sort_fields.._actual_keyc sF--. .rWrt) r7rrrXrlrrr3rr)rNr_r%rsorted_kvpair_listr$s @rTr1Deb822DuplicateFieldsParagraphElement.sort_fieldsS s ;(C /$D$6$67K((EEGG(,% 8 $D$6$6KH'\ "   !34rWrr}rK)rkrlrmrnrUrqr~rXrrrgrkrqrurrrrrrrL staticmethodrrrrrrtrrs@rTrRrR s%DdDD ? ,&*)*?.?22&'c''@). =>$)"  ?2B#-J55rWrRc^\rSrSrSrU4Sjr\S5r\S\ 4Sj5r Sr Sr S r S rS rS rS rS\4SjrS\4Sjr\S5r\S\4Sj5rSSjrSrU=r$)Deb822FileElementir z!Represents the entire deb822 filecN>[TU]5 XlUR5 grK)rrU_token_and_elementsr)rNtoken_and_elementsrs rTrUDeb822FileElement.__init__u s  #5  ""$rWc"U"[55$)zsCreates a new Deb822FileElement with no contents Note that a deb822 file must be non-empty to be considered valid )r3rBs rTnew_empty_file Deb822FileElement.new_empty_file{ s:<  rWr\cSnUHnSnU(aUR(dM g U(dgUR5SL$)zReturns true if the file is valid Invalid elements include error elements (Deb822ErrorElement) but also issues such as paragraphs with duplicate fields or "empty" files (a valid deb822 file contains at least one paragraph). FTN)rXrJ)rN had_paragraphrRs rT is_valid_fileDeb822FileElement.is_valid_file sE I M > > > ,,.$66rWcN[[UR[S95S5$)z:Returns the first Deb822ErrorElement (or None) in the filerN)rrrr+r_s rTrJ*Deb822FileElement.find_first_error_element s&D**FX*YZ\`aarWc>[UR[55$rK)rrr@r_s rTrDeb822FileElement.__iter__ sD++,BCDDrWc#8# URShvN gN7frK)r-r_s rTrDeb822FileElement.iter_parts s++++rcfSnSnSUlUS:XaOUR(dURU5 gURRn[ UR5nOUSnURR 5H5nUR n[U[5(aUS- nXS- :XdM3Un O UcURU5 gU(a5UR[S55nURRX5nURRURU5U5 g)aInserts a paragraph into the file at the given "index" of paragraphs Note that if the index is between two paragraphs containing a "free floating" comment (e.g. paragraph/start-of-file, empty line, comment, empty line, paragraph) then it is unspecified which "side" of the comment the new paragraph will appear and this may change between versions of python-debian. >>> original = ''' ... Package: libfoo-dev ... Depends: libfoo1 (= ${binary:Version}), ${shlib:Depends}, ${misc:Depends} ... '''.lstrip() >>> deb822_file = parse_deb822_file(original.splitlines()) >>> para1 = Deb822ParagraphElement.new_empty_paragraph() >>> para1["Source"] = "foo" >>> para1["Build-Depends"] = "debhelper-compat (= 13)" >>> para2 = Deb822ParagraphElement.new_empty_paragraph() >>> para2["Package"] = "libfoo1" >>> para2["Depends"] = "${shlib:Depends}, ${misc:Depends}" >>> deb822_file.insert(0, para1) >>> deb822_file.insert(1, para2) >>> expected = ''' ... Source: foo ... Build-Depends: debhelper-compat (= 13) ... ... Package: libfoo1 ... Depends: ${shlib:Depends}, ${misc:Depends} ... ... Package: libfoo-dev ... Depends: libfoo1 (= ${binary:Version}), ${shlib:Depends}, ${misc:Depends} ... '''.lstrip() >>> deb822_file.dump() == expected True NTrrr) rr-rrr~rr^rr@ _set_parentr& insert_before) rNr para anchor_node needs_newlinerrOentrynl_tokens rTrDeb822FileElement.insert s L  $ !8++ D!22<   KK ++,A$,GH"66DDX[  $ $ 2 243C3CD3I; WrWcURRnURb%URULa [S5e[S5eSUlU(aH[ U[ 5(d3URRUR[ S555 URRURU55 g)azAppends a paragraph to the file >>> deb822_file = Deb822FileElement.new_empty_file() >>> para1 = Deb822ParagraphElement.new_empty_paragraph() >>> para1["Source"] = "foo" >>> para1["Build-Depends"] = "debhelper-compat (= 13)" >>> para2 = Deb822ParagraphElement.new_empty_paragraph() >>> para2["Package"] = "foo" >>> para2["Depends"] = "${shlib:Depends}, ${misc:Depends}" >>> deb822_file.append(para1) >>> deb822_file.append(para2) >>> expected = ''' ... Source: foo ... Build-Depends: debhelper-compat (= 13) ... ... Package: foo ... Depends: ${shlib:Depends}, ${misc:Depends} ... '''.lstrip() >>> deb822_file.dump() == expected True Nz(Paragraph is already a part of this filez/Paragraph is already part of another Deb822Filer) r-rrrrrr&rr>)rNrR tail_elements rTrDeb822FileElement.append s.//44  # # /''4/ !KLLNO O $  <9N O O  $ $ + +D,<,<=RSW=X,Y Z   ''(8(8(CDrWc<URULa [S5eSnURR5HnURULdM O Uc [ S5eSUlURnURnURRU5 UcBU(a:[UR[5(aURRU5 O:[UR[5(aURRU5 SUlg)Nz%Paragraph is part of a different filezunable to find paragraph) rrr-rr^rYrrrrrr&)rNrRrOrrs rTrhDeb822FileElement.remove s  # #4 /DE E,,779DzzY&: <9: : $** NN    ,,T2  M,?,?AV!W!W((44]C)//+@AA((44Y?#'  rWcXlU$rK)r)rNrs rTr>Deb822FileElement._set_parent& s rWc[$rKrr_s rTr $Deb822FileElement.position_in_parent+ rWc[$rKrNr_s rTr#"Deb822FileElement.position_in_file/ rPrWcgrKrurs rTrDeb822FileElement.dump3 rrWcgrKrur_s rTrrT: rrWcUc&SRSUR555$UR5H-nURURR S55 M/ g)Nr2c38# UHoRv M g7frKr<r=s rTr)Deb822FileElement.dump..C rr?rrrs rTrrT> rrW)rr-rK)rkrlrmrnrorUrr1rqr~r5rJrrrrrhr>rr r#rrrrrtrrs@rTr+r+r s+% !!7t77$b E,DXL$EL(, H(   c  rWr+) constructorcPU(a[R$[R$rK)rr{r)discard_commentss rT_parsed_value_render_factoryr\U s!HX # D D6 % 5 56rWc[S5$r)r$rurWrTrwrw_ s AZ[^A_rWcX[U[5(+=(d URS:g$r)rr&rrs rT_non_end_of_line_tokenr_r s"!23 3 Eqvv~ErWc #$# [U5nSnSnSnUGHtnSn[U[5(aUnSnSnOs[U[5(aSnO[[U[5(aFUR 5n[U[5(a!SnUnSn[ S[US55nUceUbUv U(dM[UR[55n[ S[US55nUbURS:XdeSn Sn U(ae[US[5(a[ SUR55n U(a,[US[5(a[ SUS5n US Sn[UUU UU U5v SnSnGMw g7f) zYParser helper - consumes tokens part of a Deb822ValueEntryElement and turns them into oneNFTr'r&rrrr)rrr'r+rpeekrrlist takewhiler_rr&rr7) token_streambuffered_streamr?r@rstart_of_value_entry next_tokentokens_in_value eol_tokenleading_whitespacetrailing_whitespaces rT_build_value_linerlx s( 5O:O" E $ e9 : :&+ ##' E 8 9 9#' 3 4 4(--/J*&BCC'+$"'+//M/3OT/J+1'/:::  K  "?#<#<=S#TUO4d?D6QRI$ $(> >>!% "& ob13HII*./F/>/B/B/D+1'#z/"2EG\']'])-.EWXGY)Z&&5ab&9O()@);)8)<)2 + +#O&* #q!s B5F;CFc#t# [U5nUGHnSnSn[U[5(aSnOJ[U[5(a5UnUR 5n[U[5nU(a [ U5nU(GaUn[ US5n[ US5nUbUc1U(aUv U/n UbU RU5 [U 5v g[U[5(a2[U[5(a[U[SU5UU5v GM U/n U RUR[ 55 UR 5n U (a2[U ["5(a[ US5 U RU 5 [U 5v GMUv GM g![ a [ef=f7f)NFTr*)rrr*rrar StopIterationAssertionErrorrr+r+r_rArrlrcr_r() rdretoken_or_elementstart_of_fieldr?rgr7 separatorrXerror_elements error_tokensnls rT_build_field_with_valuerv s( 5O+ &(< = =!N (*> ? ?.O(--/J' 4HIN)'+O'<$ )J_d3I $7M M$9#))",(")))4(88)%>??"=2DEE/045KZ0X090=22!11 ##O$=$=>T$UV$))+*R)EFF$/ ''+(66# "e,%)(()sA,F8/ F$:D*F8$F55F8c## SnUHrnUR(a9UR5RSS5n[SR UUS95eXR5R S5- nUv Mt g7f)Nrrz\nzBSyntax or Parse error on or near line {line_no}: "{error_as_text}") error_as_textline_no)rrrr1rcount)sequenceryrrxs rT_abort_on_error_tokensr| sG >>!113;;D%HM$T[["/#\%& & ((*0066 sAr)accept_files_with_error_tokens#accept_files_with_duplicated_fieldsencodingc[U[[45(aURS5n[ XS9nU(d [ U5n[ U5n[U5n[U5n[U5n[U5n[U5n[[U55nU(d[U5Hupg[U[5(dM[!5nSn UR#5HCn [%U 5un n [U [5(deX;aU n OUR'U 5 ME U cMSn [)U R+XS95e U$)a; :param sequence: An iterable over lines of str or bytes (an open file for reading will do). If line endings are provided in the input, then they must be present on every line (except the last) will be preserved as-is. If omitted and the content is at least 2 lines, then parser will assume implicit newlines. :param accept_files_with_error_tokens: If True, files with critical syntax or parse errors will be returned as "successfully" parsed. Usually, working on files with this kind of errors are not desirable as it is hard to make sense of such files (and they might in fact not be a deb822 file at all). When set to False (the default) a ValueError is raised if there is a critical syntax or parse error. Note that duplicated fields in a paragraph is not considered a critical parse error by this parser as the implementation can gracefully cope with these. Use accept_files_with_duplicated_fields to determine if such files should be accepted. :param accept_files_with_duplicated_fields: If True, then files containing paragraphs with duplicated fields will be returned as "successfully" parsed even though they are invalid according to the specification. The paragraphs will prefer the first appearance of the field unless caller explicitly requests otherwise (e.g., via Deb822ParagraphElement.configured_view). If False, then this method will raise a ValueError if any duplicated fields are seen inside any paragraph. :param encoding: The encoding to use (this is here to support Deb822-like APIs, new code should not use this parameter). T)rNz6Duplicate field "{dup_field}" in paragraph number {no}) dup_fieldno)rrrbytesrHr-r|%_combine_comment_tokens_into_elementsrl(_combine_vl_elements_into_value_elementsrv%_combine_kvp_elements_into_paragraphs#_combine_error_tokens_into_elementsr+r3rrRsetkeysraddrr)r{r}r~rrrrPrrR field_namesrrfr7rrs rTrIrI! s4H(S%L))&&t,"( >F )'/ 26 :F v &F 5f =F $V ,F 26 :F1 8F#Jv$67K .&{3MB)%JKK!e  &^^-E'25'9$J1%j#6666!0$. OOJ/.(RC$SZZ)Z%KLL4 rW__main__r})collections.abc collections contextlibsysrrLabcrtypesrtypingrrrrr r r r r rrrrrrrrrdebian._deb822_repro._utilrrrdebian._deb822_repro.formatterrrrdebian._deb822_repro.locatablerrrr debian._deb822_repro.tokensr!r"r#r$r%r&r'r(r)r*r+r,r-r.r/debian._deb822_repro.typesr0r1 debian._utilr2r3r4r5r6r7r8r9r:r;r<r=r>r?r@StreamingValueParserrrStrToValueParserKVPNoderC version_infoAbstractContextManagerryrrrrrrrrrr+rr+r7r_rrrAr rrrrrrr#r,r@rKrRr+rrrrUrr\#LIST_SPACE_SEPARATED_INTERPRETATION#LIST_COMMA_SEPARATED_INTERPRETATIONLIST_UPLOADERS_INTERPRETATIONr_rlrvr|rIrkdoctesttestmodrurWrTrs% "**VUX  .? .L Mr QRSE8E-2C,D#EEF 4 5PWR[Pfv,6,M,Ma,P)  _%GBFOABab_%D"WQZ">1q(971b5>>1B!H :;PQSUWQW;XZ\;\] D- + 1$-1`VIVrD}DB4X&]X&v<"$}"$J(=(6G" G"T  "'"6 /v(__44\1_E !8!8'!*c %"%;A%>%"Vg1'9#'>'*g1T4%7%:C465)G)J5* A$B3$G$D AFq],LcqhCJ.DCJLb5,Bb5J T Tn'??OQc&d#(@ASAU)W%+CDZDV,X((@&33)%6 '99S9U9Q9`9_9U ';#'99N9P9Q9I9I9U ';#!33H3N3K3C3C3O !5F ]+@7#t "6;:?& M` z OOrW