Lg\SrSSKrSSKrSSKJrJrJrJr SSKr SSK r SSK r 1Skr S1r SrSrSrSrS rS rS r"S S \ R*R,5r"SS5r"SS5rg)zTokenize DNS zone file formatN)AnyListOptionalTuple>   "();r c\rSrSrSrSrg)UngetBufferFull(zDAn attempt was made to unget a token when the unget buffer was full.N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r//usr/lib/python3/dist-packages/dns/tokenizer.pyrr(sNrrc \rSrSrSrSS\S\S\S\\ 4Sjjr S \4S jr S \4S jr S \4S jr S \4S jrS \4SjrS \4SjrS \4SjrS \4SjrSrSrSrSSjrSSjrSrg)Token,z~A DNS zone file format token. ttype: The token type value: The token value has_escape: Does the token value contain escapes? Nttypevalue has_escapecommentc4XlX lX0lX@lg)zInitialize a token instance.N)r#r$r%r&)selfr#r$r%r&s r__init__Token.__init__4s  $ rreturnc(UR[:H$N)r#EOFr(s ris_eof Token.is_eofBzzS  rc(UR[:H$r-)r#EOLr/s ris_eol Token.is_eolEr2rc(UR[:H$r-)r# WHITESPACEr/s r is_whitespaceToken.is_whitespaceHzzZ''rc(UR[:H$r-)r# IDENTIFIERr/s r is_identifierToken.is_identifierKr;rc(UR[:H$r-)r# QUOTED_STRINGr/s ris_quoted_stringToken.is_quoted_stringNszz]**rc(UR[:H$r-)r#COMMENTr/s r is_commentToken.is_commentQszzW$$rc(UR[:H$r-)r# DELIMITERr/s r is_delimiterToken.is_delimiterTszzY&&rc\UR[:H=(d UR[:H$r-)r#r4r.r/s r is_eol_or_eofToken.is_eol_or_eofWszzS 5DJJ#$55rc[U[5(dgURUR:H=(a URUR:H$)NF isinstancer!r#r$r(others r__eq__ Token.__eq__Zs7%''zzU[[(FTZZ5;;-FFrc[U[5(dgURUR:g=(d URUR:g$)NTrPrRs r__ne__ Token.__ne___s7%''zzU[[(EDJJ%++,EErc8SURUR4-$)Nz%d "%s")r#r$r/s r__str__ Token.__str__dsDJJ 333rclUR(dU$Sn[UR5nSnX2:GamURUnUS- nUS:XGaFX2:a[RR eURUnUS- nUR 5(aX2:a[RR eURUnUS- nX2:a[RR eURUnUS- nUR 5(aUR 5(d[RRe[U5S-[U5S--[U5-nUS:a[RRe[U5nX- nX2:aGMm[URU5$)Nrr\d ) r%lenr$dns exception UnexpectedEndisdigit SyntaxErrorintchrr!r#r( unescapedlicc2c3 codepoints runescapeToken.unescapegs\K  O e 1 A FADy6--555JJqMQ99;;v!mm999ABFAv!mm999ABFAJJLLRZZ\\!mm777 #A s2w| ;c"g EI 3!mm777IA NI/e0TZZ++rcSn[UR5nSnX2:GaURUnUS- nUS:XGaWX2:a[RReURUnUS- nUR 5(aX2:a[RReURUnUS- nX2:a[RReURUnUS- nUR 5(aUR 5(d[RR e[U5S-[U5S--[U5-nUS:a[RR eUSU-- nO%XR5- nOXR5- nX2:aGM[UR[U55$) Nrrrr^r_r`ras%c) rbr$rcrdrerfrgrhencoder!r#bytesrjs runescape_to_bytesToken.unescape_to_bytessu2  O e 1 A FADy6--555JJqMQ99;;v!mm999ABFAv!mm999ABFAJJLLRZZ\\!mm777 #A s2w| ;c"g EI 3!mm777)!44I+IXXZ' ?e@TZZy!122r)r&r%r#r$)r]FN)r+r!)rrrrrrhrboolrstrr)r0r5r9r>rBrFrJrMrTrWrZrrrwrrrrr!r!,s !%     # !!!!(t((t(+$+%D%'d'6t6G F 4,@<3rr!c H\rSrSrSr\R SS4S\S\\ S\\ RR4Sjjr S\ 4S jrS\\ \44S jrS \ SS4S jrS\4S jrS+S\S\S\4SjjrS\SS4SjrSr\rSrS,S\S\4SjjrS\4SjrS,S\S\4SjjrS,S\S\4SjjrS,S\S\4SjjrS-S\\S\ 4Sjjr S\ 4Sjr!S-S\\S\"\4Sjjr#S.S \S\ 4S!jjr$S/S\S"\\ RRJS#\S$\\ RRJS\ RRJ4 S%jjr&S/S"\\ RRJS#\S$\\ RRJS\ RRJ4S&jjr'S\4S'jr(S\ 4S(jr)S\4S)jr*S*r+g)0 TokenizeraA DNS zone file format tokenizer. A token object is basically a (type, value) tuple. The valid types are EOF, EOL, WHITESPACE, IDENTIFIER, QUOTED_STRING, COMMENT, and DELIMITER. file: The file to tokenize ungotten_char: The most recently ungotten character, or None. ungotten_token: The most recently ungotten token, or None. multiline: The current multiline level. This value is increased by one every time a '(' delimiter is read, and decreased by one every time a ')' delimiter is read. quoting: This variable is true if the tokenizer is currently reading a quoted string. eof: This variable is true if the tokenizer has encountered EOF. delimiters: The current delimiter dictionary. line_number: The current line number filename: A filename that will be returned by the where() method. idna_codec: A dns.name.IDNACodec, specifies the IDNA encoder/decoder. If None, the default IDNA 2003 encoder/decoder is used. Nffilename idna_codecc[U[5(a[R"U5nUcSnOZ[U[5(a*[R"UR 55nUcSnOUcU[ RLaSnOSnXlSUl SUl SUl SUl SUl [UlSUlUceX lUc [$R&R(UlgX0lg)aInitialize a tokenizer instance. f: The file to tokenize. The default is sys.stdin. This parameter may also be a string, in which case the tokenizer will take its input from the contents of the string. filename: the name of the filename that the where() method will return. idna_codec: A dns.name.IDNACodec, specifies the IDNA encoder/decoder. If None, the default IDNA 2003 encoder/decoder is used. NzzzrFr)rQrzioStringIOrvdecodesysstdinfile ungotten_charungotten_token multilinequotingeof _DELIMITERS delimiters line_numberrrcname IDNA_2003r)r(r~rrs rr)Tokenizer.__init__s( a   AA% 5 ! ! AHHJ'A% >(H'H ,0/3 %###  25((2D2DDO(Orr+cURc\UR(aSnU$URRS5nUS:Xa SUlU$US:XaU=RS- slU$URnSUlU$)zRead a character from input.Nr]rTr)rrrreadrr(rns r _get_charTokenizer._get_chars    %xxIINN1%7#DH  $Y$$)$""A!%D rc2URUR4$)zReturn the current location in the input. Returns a (string, int) tuple. The first item is the filename of the input, the second is the current line number. )rrr/s rwhereTokenizer.where)s t//00rrnc6URb[eXlg)zUnget a character. The unget buffer for characters is only one character large; it is an error to try to unget a character when the unget buffer is not empty. c: the character to unget raises UngetBufferFull: there is already an ungotten char N)rrrs r _unget_charTokenizer._unget_char2s    )! !rcSnUR5nUS:wa0US:wa*US:wdUR(dURU5 U$US- nMM)aConsume input until a non-whitespace character is encountered. The non-whitespace character is then ungotten, and the number of whitespace characters consumed is returned. If the tokenizer is in multiline mode, then newlines are whitespace. Returns the number of characters skipped. rr rrr)rrr)r(skippedrns rskip_whitespaceTokenizer.skip_whitespaceBsS ACxAIIdnn$$Q'"N qLG r want_leading want_commentcvURbSURnSUlUR5(a U(aU$O!UR5(a U(aU$OU$UR5nU(aUS:a[ [ S5$Sn[ nSnUR5nUS:XdXR;GaUS:Xa+UR(a[RReUS:XGaU[:wGaUS:Xa'U=RS- slUR5 MUS :XaQURS::a[RReU=RS-slUR5 MUS :XaQUR(dSUl [ Ul[nGM SUl ["UlUR5 GMEUS :Xa[ [$S 5$US :XaUR5nUS :XdUS:XaOXX- nM#U(a!UR'U5 [ [(U5$US:Xa>UR(a[RRS 5e[ [*US9$UR(aUR5 SnGM[ [$S US9$Un[,nOUR'U5 OUR(a%US :Xa[RRS5eUS:XaMXX- nSnUR5nUS:XdUS :Xa+UR(d[RReXX- nGMUS:Xa@U[:wa6UR(a[RRS 5e[*n[ XeU5$)a}Get the next token. want_leading: If True, return a WHITESPACE token if the first character read is whitespace. The default is False. want_comment: If True, return a COMMENT token if the first token read is a comment. The default is False. Raises dns.exception.UnexpectedEnd: input ended prematurely Raises dns.exception.SyntaxError: input was badly formed Returns a Token. Nrr r]FTr rr r rr zunbalanced parentheses)r&znewline in quoted stringr^)rr9rFrr!r8r=rrrrcrdrerArrg_QUOTING_DELIMITERSrr4rrEr.rI) r(rrutokenrtokenr#r%rns rget Tokenizer.getVs    *((F"&D ##%%!M ""$$!M  &&( GaKS) )  ABw!.7t||--555B;5M#9Cx!+,,. c>>Q."%--";";;!+,,. c#||+/DL.ADO$1E$+0DL.9DO 002$d$S$//c $ 0A DyAG %!JE  ( ,,Q/#(%#88"W#~~&)mm&?&?$<'"!"$)e#<<!^^ 002$&E$#(dE#BB !" )$$Q'!t)mm//0JKKd  ! NN$7qDy--555 JEOP B;5M1~~mm//0HIIEU:..rrc6URb[eXlg)zUnget a token. The unget buffer for tokens is only one token large; it is an error to try to unget a token when the unget buffer is not empty. token: the token to unget Raises UngetBufferFull: there is already an ungotten token N)rrr(rs rungetTokenizer.ungets    *! !#rc\UR5nUR5(a[eU$)z8Return the next item in an iteration. Returns a Token. )rr0 StopIterationrs rnextTokenizer.nexts%   <<>>  rcU$r-rr/s r__iter__Tokenizer.__iter__s rbasecNUR5R5nUR5(d[RR S5eUR R5(d[RR S5e[UR U5$)zRead the next token and interpret it as an unsigned integer. Raises dns.exception.SyntaxError if not an unsigned integer. Returns an int. expecting an identifierzexpecting an integer) rrrr>rcrdrgr$rfrh)r(rrs rget_intTokenizer.get_intsw ##%""$$--++,EF F{{""$$--++,BC C5;;%%rcUR5nUS:dUS:a"[RRSU-5eU$)zRead the next token and interpret it as an 8-bit unsigned integer. Raises dns.exception.SyntaxError if not an 8-bit unsigned integer. Returns an int. rraz#%d is not an unsigned 8-bit integerrrcrdrg)r(r$s r get_uint8Tokenizer.get_uint8sB  19 --++5=  rcURUS9nUS:dUS:aKUS:Xa#[RRUSS35e[RRSU-5eU$)zRead the next token and interpret it as a 16-bit unsigned integer. Raises dns.exception.SyntaxError if not a 16-bit unsigned integer. Returns an int. rrioz( is not an octal unsigned 16-bit integerz$%d is not an unsigned 16-bit integerrr(rr$s r get_uint16Tokenizer.get_uint16st $ ' 19 qymm//QiGHmm//:UB rcURUS9nUS:dUS:a"[RRSU-5eU$)zRead the next token and interpret it as a 32-bit unsigned integer. Raises dns.exception.SyntaxError if not a 32-bit unsigned integer. Returns an int. rrlz$%d is not an unsigned 32-bit integerrrs r get_uint32Tokenizer.get_uint32sH $ ' 19 *--++6>  rcURUS9nUS:dUS:a"[RRSU-5eU$)zRead the next token and interpret it as a 48-bit unsigned integer. Raises dns.exception.SyntaxError if not a 48-bit unsigned integer. Returns an int. rrlz$%d is not an unsigned 48-bit integerrrs r get_uint48Tokenizer.get_uint48+sH $ ' 19/--++6>  r max_lengthcfUR5R5nUR5(d4UR5(d[R R S5eU(a8[UR5U:a[R R S5eUR$)zRead the next token and interpret it as a string. Raises dns.exception.SyntaxError if not a string. Raises dns.exception.SyntaxError if token value length exceeds max_length (if specified). Returns a string. zexpecting a stringzstring too long) rrrr>rBrcrdrgrbr$)r(rrs r get_stringTokenizer.get_string;s~ ##%##%%)?)?)A)A--++,@A A #ekk*Z7--++,=> >{{rcUR5R5nUR5(d[RR S5eUR $)zRead the next token, which should be an identifier. Raises dns.exception.SyntaxError if not an identifier. Returns a string. r)rrrr>rcrdrgr$rs rget_identifierTokenizer.get_identifierLsG ##%""$$--++,EF F{{r max_tokensc/nUR5nUR5(aURU5 U$URU5 [ U5U:XaU$M^)zReturn the remaining tokens on the line, until an EOL or EOF is seen. max_tokens: If not None, stop after this number of tokens. Returns a list of tokens. )rrMrappendrb)r(rtokensrs r get_remainingTokenizer.get_remainingYscHHJE""$$ 5!  MM% 6{j( r allow_emptycnSnUR5R5nUR5(aURU5 O?UR 5(d[ R ReX#R- nMU(d&U(d[ R RS5eU$)aGRead the remaining tokens on the line, which should be identifiers. Raises dns.exception.SyntaxError if there are no remaining tokens, unless `allow_empty=True` is given. Raises dns.exception.SyntaxError if a token is seen that is not an identifier. Returns a string containing a concatenation of the remaining identifiers. r]zexpecting another identifier) rrrrMrr>rcrdrgr$)r(rsrs r!concatenate_remaining_identifiers+Tokenizer.concatenate_remaining_identifiersls HHJ'')E""$$ 5!&&((mm///  Aq--++,JK Krorigin relativize relativize_tocUR5(d[RRS5e[RR UR X R5nURU=(d UU5$)zuTry to interpret the token as a DNS name. Raises dns.exception.SyntaxError if not a name. Returns a dns.name.Name. r) r>rcrdrgr from_textr$rchoose_relativity)r(rrrrrs ras_nameTokenizer.as_names_""$$--++,EF Fxx!!%++vG%%m&=vzJJrcFUR5nURXAX#5$)zRead the next token and interpret it as a DNS name. Raises dns.exception.SyntaxError if not a name. Returns a dns.name.Name. )rr)r(rrrrs rget_nameTokenizer.get_names  ||E:EErcUR5nUR5(d8[RR SUR UR 4-5eU$)zVRead the next token and raise an exception if it isn't EOL or EOF. Returns a string. z expected EOL or EOF, got %d "%s")rrMrcrdrgr#r$rs rget_eol_as_tokenTokenizer.get_eol_as_tokensQ ""$$--++2ekk5;;5OO  rc6UR5R$r-)rr$r/s rget_eolTokenizer.get_eols$$&,,,rcUR5R5nUR5(d[RR S5e[R RUR5$)zRead the next token and interpret it as a DNS TTL. Raises dns.exception.SyntaxError or dns.ttl.BadTTL if not an identifier or badly formed. Returns an int. r) rrrr>rcrdrgttlrr$rs rget_ttlTokenizer.get_ttlsV ##%""$$--++,EF Fww  --r) rrrrrrrrrr)FF)r`r-)F)NFN),rrrrrrrrrrzrcr IDNACodecr)rrrhrrrryr!rrr__next__rrrrrrrrrrrNamerrrrrrrrrr|r|s`D"&37 /) /)3-/)SXX//0 /)b3"1uS#X1ST (m/m/Dm/Um/^$5$T$ H &C & &3 sC*sC sC Xc]c"   e&Tc8+/ 15 KK'K K   . K  K(+/ 15 F'FF  . F  F % -- . .rr|)rrrtypingrrrr dns.exceptionrcdns.namedns.ttlrrr.r4r8r=rArErIrd DNSExceptionrr!r|rrrrs$$ --3 e     Ocmm00OW3W3t~.~.r