+ Dfj2dRt^RIHt^RIHt^RIHtHtHtH t ^RI H t ^RI H t Ht^RIHtHtHtHtHtHtHtHtHtHtHtHtHtHt^RIHtH t ^RI!H"t"^R I#H$t$^R I%H&t&^R I'H(t(^R I)H*t*H+t+R t,Rt-!RR]+4t.!RR]/4t0Rt1!RR]+4t2.ROt3]!] 4!RR44t4]!] ]44!RR]*4t5!RR4t6](Pn!]8RR7t9R#) z. Test cases for Twisted.names' root resolver. ) implementer) verifyClass)Deferred TimeoutError gatherResultssucceed)IResolverSimple)clientroot)CNAMEENAMEHSINNSOKAMessageNameQueryRecord_A Record_CNAME Record_NSRRHeader) DNSNameError ResolverError)Resolver) MemoryReactor)msg)util)SynchronousTestCaseTestCasec2VwrpV^,P#)z From the result of a L{Deferred} returned by L{IResolver.lookupAddress}, return the payload of the first record in the answer section. payloadresultsansauthadds& E/usr/lib/python3/dist-packages/twisted/names/test/test_rootresolve.py getOnePayloadr*&s NCs q6>>c4\V4P4#)z From the result of a L{Deferred} returned by L{IResolver.lookupAddress}, return the first IPv4 address from the answer section. )r* dottedQuadr%s&r) getOneAddressr//s  ! , , ..r+ca]tRt^7toRtRtRtRt...]3Rlt RRlt Rt Rt R t R tR tR tR tRtRtRtRtRtRtVtR#)RootResolverTestsz+ Tests for L{twisted.names.root.Resolver}. c `\4p\.VR7pVP\R\\ 4R.RV4pVP P4wrVVPwwrx\4p V PV4VPV P\R\\ 4.4VPV P.4VPV P.4VPV P.4.p VP!V P"4VPV .4V PR^V nV PP#\'R\)R4R74VP*P-V P/4R4V ^,#)a Invoke L{Resolver._query} and verify that it sends the correct DNS query. Deliver a canned response to the query and return whatever the L{Deferred} returned by L{Resolver._query} fires with. @param filter: The value to pass for the C{filter} parameter to L{Resolver._query}. )reactorfoo.example.com:NNN 5.8.13.21r")1.1.2.3i))rr_queryrrrudpPortspopitem _sentPacketsrfromStr assertEqualqueriesanswers authority additional addCallbackappendanswerrr _protocoldatagramReceivedtoStr) selffilterr3resolverd portNumber transportpacketaddressmessageresponses && r) _queryTestRootResolverTests._queryTest<sc /B0 OO $a ,/@.A5&  !( 0 0 8 8 : (44 &) 51CQ+K*LM "- **B/ ++R0 hoo& 2& OOA  '+1F G  ,,W]]_>OP{r+c  VPR4wrpVPV\R\R^R7R7.4VPV.4VPV.4R#)a L{Resolver._query} accepts a L{Query} instance and an address, issues the query, and returns a L{Deferred} which fires with the response to the query. If a true value is passed for the C{filter} parameter, the result is a three-tuple of lists of records. Tr4r5ttlr"N)rRr=rr)rHrDr@rAs& r)test_filteredQuery$RootResolverTests.test_filteredQuerygs_)-(=%:  X0(;TU:VWX  B' R(r+c  bVPR4pVPV\4VPVP.4VPVP \ R\R^R7R7.4VPVP.4VPVP.4R#)z Similar to L{test_filteredQuery}, but for the case where a false value is passed for the C{filter} parameter. In this case, the result is a L{Message} instance. Fr4r5rUr"N) rRassertIsInstancerr=r>r?rrr@rA)rHrPs& r)test_unfilteredQuery&RootResolverTests.test_unfilteredQueryus //%( gw/ "-  OO ((;A2N O P  **B/ ++R0r+c "\VR7pVPV3VPV3VPV33FOwrgTP VUU u.uF,wr\ WP \V R\4V R7NK. up p4KQ V#uup pi)aK Create a L{Message} suitable for use as a response to a query. @param answers: A C{list} of two-tuples giving data for the answers section of the message. The first element of each tuple is a name for the L{RRHeader}. The second element is the payload. @param authority: A C{list} like C{answers}, but for the authority section of the response. @param additional: A C{list} like C{answers}, but for the additional section of the response. @param rCode: The response code the message will be created with. @return: A new L{Message} initialized with the given values. )rCodeCLASSr") rr?r@rAextendrTYPEgetattrr) rHr?r@rAr^rQsectiondatanamerecords &&&&& r)_respondRootResolverTests._responds'   w '    +  * - MG NN +/ +/kk767B+GQW+/    s 2B c @aaR.p\W24pVV3RlpWTnV#)ah Create and return a new L{root.Resolver} modified to resolve queries against the record data represented by C{servers}. @param serverResponses: A mapping from dns server addresses to mappings. The inner mappings are from query two-tuples (name, type) to dictionaries suitable for use as **arguments to L{_respond}. See that method for details. r6c<\RVP RV: 24VFPpSV,pYPPPTP3,p\ SP !R/TB4u# R# \dKdi;i)zQuery for QNAME z at N)rreKeyErrortyperrg) queryserverAddressestimeoutrIaddrserverrecordsrHserverResponsess &&&& r)rn-RootResolverTests._getResolver..querys} "5::,d?2EF G',T2F!%**!<=t}}7w788 ( s A66 BB)rr8)rHrtmaximumQueriesrootsrJrnsff& r) _getResolverRootResolverTests._getResolvers' E2 9 r+c  ,RR\3RR\R43.RR\R43.//R R\3RR\R43.///pVPV4pVP R4pVP \ 4VP VPR4V#) z L{root.Resolver.lookupAddress} looks up the I{A} records for the specified hostname by first querying one of the root servers the resolver was created with and then following the authority delegations until a result is received. r4r@ns1.example.comrA 34.55.89.144r?10.0.0.1r65)r|rrrrrx lookupAddressrBr/r=rHserversrJrKs& r)test_lookupAddress$RootResolverTests.test_lookupAddresss #Q'#5yAS7T"U!V $68P#Q"R* !#Q'!3Xj5I JK*#  $$W-  " "#5 6 m$ d&& 3r+c  t\R4p\VnR R\3RRV3.RR\ R43.RR\R43.//R R\3RR\R43.///pVP V4pVP R4pVP\4VPVP\R44V#) z If a response includes a record with a class different from the one in the query, it is ignored and lookup continues until a record with the right class is found. r}r4r?r@r{rA10.0.0.210.0.0.3r~rr) rr r_rrrxrrBr*r=)rHbadClassrrJrKs& r)test_lookupChecksClass(RootResolverTests.test_lookupChecksClasss J' #Q'!3X >?#5yAS7T"U!V $68L#M"N* #Q'!3Xj5I JK*  $$W-  " "#5 6 m$ d&&(<=r+c  <RR\3RR\R43./R\3RR\R43.//RR\3RR\R43.///pVPV4pVP R4pVP \ 4VP VPR4V#) z~ If an intermediate response includes no glue records for the authorities, separate queries are made to find those addresses. r4r@sns1.example.orgr?r}rr~)r}rrrs& r)test_missingGlue"RootResolverTests.test_missingGlues #Q'#5yAS7T"U!V*$Q'!3Xj5I JK*  #Q'!3Xj5I JK*  $$W-  " "#5 6 m$ d&& 3r+c RR\3R\///pVPV4pVPR4pVP V\ 4#)zi If a name is missing, L{Resolver.lookupAddress} returns a L{Deferred} which fails with L{DNSNameError}. r4r^r~)rr rxr assertFailurerrs& r)test_missingName"RootResolverTests.test_missingNames[ #Q'U* $$W-  " "#5 6!!!\22r+c RR\3///pVPV4pVPR4pVPV\4#)z If a query is responded to with no answers or nameserver records, the L{Deferred} returned by L{Resolver.lookupAddress} fires with L{ResolverError}. example.comr~)rrxrrrrs& r)test_answerless!RootResolverTests.test_answerlesssR #R  $$W-  " "> 2!!!]33r+c RR\3RR\R43./R\3R\///pVPV4pVP R4pVP V\ 4#)z If there is an error resolving the nameserver in a delegation response, the L{Deferred} returned by L{Resolver.lookupAddress} fires with that error. rr@r{r^r~)rrr rxrrrrs& r)test_delegationLookupError,RootResolverTests.test_delegationLookupError.s| #>9=O3P"Q!R&$Q'U*   $$W-  " "> 2!!!\22r+c RR\3RR\R43./R\3///pVPV4pVPR4pVP V\ 4#)z If there are no records in the response to a lookup of a delegation nameserver, the L{Deferred} returned by L{Resolver.lookupAddress} fires with L{ResolverError}. rr@r{r~)rrrxrrrrs& r)test_delegationLookupEmpty,RootResolverTests.test_delegationLookupEmptyBst #>9=O3P"Q!R&$Q'  $$W-  " "> 2!!!]33r+c  RR\3R\/R\3RR\R43.///pVP V4pVP R4pRpVP V4VP VP\R44V#)z L{Resolver.lookupNameservers} is like L{Resolver.lookupAddress}, except it queries for I{NS} records instead of I{A} records. rr^r?r{cFVwrpV^,PP#)r#rer$s& r) getOneName.getOneNamefs$NCsq6>>&& &r+r~) rr rrrxlookupNameserversrBr=r)rHrrJrKrs& r)test_lookupNameservers(RootResolverTests.test_lookupNameserversTs #U& $;M1N OP'   $$W-  & &~ 6 ' j! d&&-?(@Ar+c  ZRR\3RR\R43R\R43.///pVPV4pVP R4pVP R4VP VP \R\\R4R7\R\\R4R7.4V#)z~ If a I{CNAME} record is encountered as the answer to a query for another record type, that record is returned as the answer. rr? example.netz10.0.0.7cV^,#rrkr.s&r).gajr+r"r~ rrrrxrrBr=rr rs& r)test_returnCanonicalName*RootResolverTests.test_returnCanonicalNamens #'n)EF'*)=> &  $$W-  " "> 2 01    ^8TUHZ4HI  r+c  nRR\3RR\R43./R\3RR\R43.///pVPV4pVP R4pVP R4VP VP \R\\R4R7\R\\R4R7.4V#)z If no record of the requested type is included in a response, but a I{CNAME} record for the query name is included, queries are made to resolve the value of the I{CNAME}. rr?rz10.0.0.5cV^,#rrkr.s&r)r.rr+r"r~rrs& r)test_followCanonicalName*RootResolverTests.test_followCanonicalNames #n1M NO& #*1E FG&   $$W-  " "> 2 01    ^8TUHZ4HI  r+c RR\3RR\R43R\R43.///pVPV4pVPR4pVP V\ 4#)z If there is a cycle between I{CNAME} records in a response, this is detected and the L{Deferred} returned by the lookup method fails with L{ResolverError}. rr?rr~)rrrxrrrrs& r)test_detectCanonicalNameLoop.RootResolverTests.test_detectCanonicalNameLoopsw #'n)EF'n)EF &  $$W-  " "> 2!!!]33r+c  R R\3RR\R43./R\3RR\R43.//R R\3RR\R43.RR\R43.//R R\3RR\R 43.///pVPV^4pVP VP R4\ 4pVPV^4pVP R4pVP\4VPVP\R 44\W5.4#) zt L{Resolver.lookupAddress} won't issue more queries following delegations than the limit passed to its initializer. rr@r{r?rsns2.example.comrArz10.0.0.4r~r)rr) rrrrxrrrrBr*r=r)rHrfailerfailD succeedersucceedDs& r)test_boundedQueries%RootResolverTests.test_boundedQueriessJ  #>9=O3P"Q!R& $Q'!3Xj5I JK*   #>9=O3P"Q!R $68L#M"N&  #*1E FG&- B""7A.""6#7#7#GW%%gq1 **>:]+T--x /CDe.//r+rkN) )__name__ __module__ __qualname____firstlineno____doc__rRrWr[rrgrxrrrrrrrrrrrr__static_attributes____classdictcell__ __classdict__s@r)r1r17sp)V )1 "RBb>44863 43(4$4684(.0.0r+r1c*a]tRtRtoRtRtRtVtR#)ResolverFactoryArgumentsizZ Raised by L{raisingResolverFactory} with the *args and **kwargs passed to that function. c WnW nR#)zy Store the supplied args and kwargs as attributes. @param args: Positional arguments. @param kwargs: Keyword arguments. Nargskwargs)rHrrs&&&r)__init__!ResolverFactoryArguments.__init__s  r+rN)rrrrrrrrrs@r)rrs r+rc\W4h)a! Raise a L{ResolverFactoryArguments} exception containing the positional and keyword arguments passed to resolverFactory. @param args: A L{list} of all the positional arguments supplied by the caller. @param kwargs: A L{list} of all the keyword arguments supplied by the caller. )rrs*,r)raisingResolverFactoryrs #4 00r+c6a]tRtRtoRtRtRtRtRtVt R#) RootResolverResolverFactoryTestsi z. Tests for L{root.Resolver._resolverFactory}. c j\R.\R7pVPVP\4R#)zm L{root.Resolver.__init__} accepts a C{resolverFactory} argument and assigns it to C{self._resolverFactory}. N)hintsresolverFactory)rrassertIs_resolverFactoryrHrs& r)#test_resolverFactoryArgumentPresentDRootResolverResolverFactoryTests.test_resolverFactoryArgumentPresents( D63I J a((*@Ar+c t\R.R7pVPVP\P4R#)z L{root.Resolver.__init__} sets L{client.Resolver} as the C{_resolverFactory} if a C{resolverFactory} argument is not supplied. N)r)rrrr rs& r)"test_resolverFactoryArgumentAbsentCRootResolverResolverFactoryTests.test_resolverFactoryArgumentAbsents( D6 " a((&//:r+c \4p\R.\VR7pVP\VP R4pVP RRVRR./3VPVP34R#) za L{root.Resolver._resolverFactory} is supplied with C{reactor} and C{servers} keyword arguments. 192.0.2.101)rrr3z example.comr3rNrk)rr) objectrr assertRaisesrrr=rr)rH dummyReactorres& r))test_resolverFactoryOnlyExpectedArgumentsJRootResolverResolverFactoryTests.test_resolverFactoryOnlyExpectedArgumentssn x  /2     6 W  )\97J6KL M VVQXX  r+rkN) rrrrrrrrrrrs@r)rr sB;  r+rc0a]tRtRtoRtRtRtRtVtR#) StubResolveriDz An L{IResolverSimple} implementer which traces all getHostByName calls and their deferred results. The deferred results can be accessed and fired synchronously. c ".Vn.VnR#)z @type calls: L{list} of L{tuple} containing C{args} and C{kwargs} supplied to C{getHostByName} calls. @type pendingResults: L{list} of L{Deferred} returned by C{getHostByName}. NcallspendingResults)rHs&r)rStubResolver.__init__Ls  r+c VPPW34\4pVPPV4V#)a, A fake implementation of L{IResolverSimple.getHostByName} @param args: A L{list} of all the positional arguments supplied by the caller. @param kwargs: A L{list} of all the keyword arguments supplied by the caller. @return: A L{Deferred} which may be fired later from the test fixture. )rrCrr)rHrrrKs&*, r) getHostByNameStubResolver.getHostByNameVs8 4.) J ""1%r+rN) rrrrrrrrrrs@r)rrDs !r+rcNa]tRtRtoRtRtRtRtRtRt Rt R t R t Vt R #) BootstrapTestsilz Tests for L{root.bootstrap} c \P!\44pVPV\P4R#)zT L{root.bootstrap} returns an object which is initially a L{root.DeferredResolver}. N)r bootstraprrZDeferredResolver)rHdeferredResolvers& r)test_returnsDeferredResolver+BootstrapTests.test_returnsDeferredResolverqs,  >>,.9 .0E0EFr+c \4p\P!V4TPVP\ Uu.uFq"3/3NK up4R#uupi)zv The L{IResolverSimple} supplied to L{root.bootstrap} is used to lookup the IP addresses of the 13 root name servers. N)rr rr=r ROOT_SERVERS)rH stubResolverss& r)test_resolves13RootServers)BootstrapTests.test_resolves13RootServersysC $~  |$ ++,-O,QtRj,-OP-Os A c \4p\P!V4pVPFpVP R4K VP V\ 4R#)z The L{root.DeferredResolver} initially returned by L{root.bootstrap} becomes a L{root.Resolver} when the supplied resolver has successfully looked up all root hints. rN)rr rrcallbackrZrrHrrrKs& r)test_becomesResolver#BootstrapTests.test_becomesResolversG $~ >>,7,,A JJ} %- .9r+c \4p\P!V4pVPFpVP R4K VP VP R.^ ,4R#)z The L{root.Resolver} which eventually replaces L{root.DeferredResolver} is supplied with the IP addresses of the 13 root servers. rN)rr rrrr=rrs& r)test_resolverReceivesRootHints-BootstrapTests.test_resolverReceivesRootHintssT $~ >>,7,,A JJ} %- )//-21EFr+c aa\4p\P!V4o\VP4p\ V4pVFpVP R4K VP\44VV3RlpVPV4R#)z The L{root.Resolver} is eventually created, even if some of the root hint lookups fail. Only the working root hint IP addresses are supplied to the L{root.Resolver}. rcP<SPSPR.^ ,4R#)rNr=rresrrHs&r) checkHintsFBootstrapTests.test_continuesWhenSomeRootHintsFail..checkHintss!   -33m_r5I Jr+N) rr riterrnextrerrbackraddBothrHrr%d1rKrrsf @r)#test_continuesWhenSomeRootHintsFail2BootstrapTests.test_continuesWhenSomeRootHintsFailsl $~ >>,7|223 ']A JJ} % <>" K :r+c paa\4p\P!V4o\VP4p\ V4pVFpVP \44K VP \44VV3RlpVPV4SPSP\4R#)z The L{root.Resolver} is eventually created, even if all of the root hint lookups fail. Pending and new lookups will then fail with AttributeError. c@<SPSP.4R#Nr r s&r)rEBootstrapTests.test_continuesWhenAllRootHintsFail..checkHintss   -33R 8r+N) rr rrrrrrr addCleanupflushLoggedErrorsrsf @r)"test_continuesWhenAllRootHintsFail1BootstrapTests.test_continuesWhenAllRootHintsFails $~ >>,7|223 ']A IIln % <>" 9 : .. =r+c \4p\P!V\R7pVPFpVP R4K VP VP\4R#)z L{root.bootstrap} accepts a C{resolverFactory} argument which is passed as an argument to L{root.Resolver} when it has successfully looked up root hints. )rrN)rr rrrrrrrs& r)test_passesResolverFactory)BootstrapTests.test_passesResolverFactorysV $~ >> *@ ,,A JJ} %- &779OPr+rkN)rrrrrrrrrrrr!rrrs@r)rrls7GQ : G&>*QQr+rc*a]tRtRtoRtRtRtVtR#)StubDNSDatagramProtocoliz A do-nothing stand-in for L{DNSDatagramProtocol} which can be used to avoid network traffic in tests where that kind of thing doesn't matter. c\4#r)r)rHakws&*,r)rnStubDNSDatagramProtocol.querys zr+rkN)rrrrrrnrrrs@r)r$r$s r+r$zbtwisted.names.root.retry is deprecated since Twisted 10.0. Use a Resolver object for retry logic.)categoryrPN) za.root-servers.netzb.root-servers.netzc.root-servers.netzd.root-servers.netze.root-servers.netzf.root-servers.netzg.root-servers.netzh.root-servers.netzi.root-servers.netzj.root-servers.netzk.root-servers.netzl.root-servers.netzm.root-servers.net):rzope.interfacerzope.interface.verifyrtwisted.internet.deferrrrrtwisted.internet.interfacesr twisted.namesr r twisted.names.dnsr r r rrrrrrrrrrrtwisted.names.errorrrtwisted.names.rootrtwisted.names.test.test_utilrtwisted.python.logr twisted.trialrtwisted.trial.unittestrr r*r/r1 Exceptionrrrrrrr$suppressDeprecationWarning_retrySuppressionrkr+r)r:s'-QQ7& <'6"@/p0p0f y" 1' x' T " _!!!H O\*cQ(cQLMM  +r+