U T‚gã@s˜dZddlZddlmZddlmZddlmZGdd„dƒZ dd „Z Gd d „d ƒZ Gd d „d ƒZ Gdd„dƒZ Gdd„dƒZdd„ZeƒZdd„ZdS)a¼ I{Private} test utilities for use throughout Twisted's test suite. Unlike C{proto_helpers}, this is no exception to the don't-use-it-outside-Twisted-we-won't-maintain-compatibility rule! @note: Maintainers be aware: things in this module should be gradually promoted to more full-featured test helpers and exposed as public API as your maintenance time permits. In order to be public API though, they need their own test cases. éN)ÚBytesIO)Úminidom)Ú FileWrapperc@s(eZdZdZdd„Zdd„Zdd„ZdS) ÚIOPumpzŠUtility to pump data between clients and servers for protocol testing. Perhaps this is a utility worthy of being in protocol.py? cCs||_||_||_||_dS)N)ÚclientÚserverÚclientIOÚserverIO)Úselfrrrr ©r ú:/tmp/pip-unpacked-wheel-1_7di8ic/twisted/test/testutils.pyÚ__init__szIOPump.__init__cCs| ¡r qdS)z,Pump until there is no more input or output.N)Úpump)r r r r Úflush"sz IOPump.flushcCs˜|j d¡|j d¡|j ¡}|j ¡}|j d¡|j d¡|j ¡|j ¡|D]}|j |¡q\|D]}|j |¡qr|sŒ|rdSdSdS)zOMove data back and forth. Returns whether any data was moved. réN)rÚseekr ÚreadÚtruncaterZ dataReceivedr)r ZcDataZsDataÚbyter r r r's        z IOPump.pumpN)Ú__name__Ú __module__Ú __qualname__Ú__doc__r rrr r r r rsrcCsJtƒ}tƒ}| t|ƒ¡| t|ƒ¡t||||ƒ}| ¡| ¡|S)z-Take two Protocol instances and connect them.)rZmakeConnectionrrr)rrZcioÚsiorr r r ÚreturnConnected>src@seZdZdZdd„ZdS)ÚXMLAssertionMixinzŠ Test mixin defining a method for comparing serialized XML documents. Must be mixed in to a L{test case}. cCs$| t |¡ ¡t |¡ ¡¡dS)zï Verify that two strings represent the same XML document. @param first: An XML string. @type first: L{bytes} @param second: An XML string that should match C{first}. @type second: L{bytes} N)Ú assertEqualÚdomÚ parseStringZtoxml)r ÚfirstÚsecondr r r ÚassertXMLEqualSs  ÿz XMLAssertionMixin.assertXMLEqualN)rrrrr!r r r r rLsrc@s eZdZdZeedœdd„ZdS)Ú_EqualzN A class the instances of which are equal to anything and everything. ©ÚotherÚreturncCsdS)NTr ©r r$r r r Ú__eq__gsz _Equal.__eq__N©rrrrÚobjectÚboolr'r r r r r"bsr"c@s eZdZdZeedœdd„ZdS)Ú _NotEqualz> A class the instances of which are equal to nothing. r#cCsdS)NFr r&r r r r'psz_NotEqual.__eq__Nr(r r r r r+ksr+c@seZdZdZdd„ZdS)ÚComparisonTestsMixina¾ A mixin which defines a method for making assertions about the correctness of an implementation of C{==} and C{!=}. Use this to unit test objects which follow the common convention for C{==} and C{!=}: - The object compares equal to itself - The object cooperates with unrecognized types to allow them to implement the comparison - The object implements not-equal as the opposite of equal cCs˜| ||k¡| ||k¡| ||k¡| ||k¡| ||k¡| ||k¡| |tƒk¡| |tƒk¡| |tƒk¡| |tƒk¡dS)aU Assert that C{firstValueOne} is equal to C{secondValueOne} but not equal to C{valueOne} and that it defines equality cooperatively with other types it doesn't know about. @param firstValueOne: An object which is expected to compare as equal to C{secondValueOne} and not equal to C{valueTwo}. @param secondValueOne: A different object than C{firstValueOne} but which is expected to compare equal to that object. @param valueTwo: An object which is expected to compare as not equal to C{firstValueOne}. N)Ú assertTrueZ assertFalser"r+)r Z firstValueOneZsecondValueOneZvalueTwor r r Ú"assertNormalEqualityImplementation‚sz7ComparisonTestsMixin.assertNormalEqualityImplementationN)rrrrr.r r r r r,ts r,cCsLd}d}zt tj¡}| d¡d}Wntk r:YnX|rH| ¡|S)z4Returns True if the system can bind an IPv6 address.NF)z::1rT)ÚsocketÚAF_INET6ÚbindÚOSErrorÚclose)ÚsockÚhas_ipv6r r r Ú _has_ipv6¥s  r6cCsts d|_|S)Nz.Does not work on systems without IPv6 support.)ÚHAS_IPV6Úskip)Úfr r r ÚskipWithoutIPv6¹sr:)rr/ÚiorÚxml.domrrZtwisted.internet.protocolrrrrr"r+r,r6r7r:r r r r Ús    (  1