twisted.internet.test.test_resolver.HostnameResolutionTests

Tests for hostname resolution.

Method	setUp	Set up a `GAIResolver`.
Method	test_resolveOneHost	Resolving an individual hostname that results in one address from getaddrinfo results in a single call each to `resolutionBegan`, `addressResolved`, and `resolutionComplete`.
Method	test_resolveOneIPv6Host	No summary
Method	test_gaierror	No summary
Method	test_resolveOnlyIPv4	When passed an `addressTypes` parameter containing only `IPv4Address`, `GAIResolver` will pass `AF_INET` to `getaddrinfo`.
Method	test_resolveOnlyIPv6	When passed an `addressTypes` parameter containing only `IPv6Address`, `GAIResolver` will pass `AF_INET6` to `getaddrinfo`.
Method	test_resolveBoth	When passed an `addressTypes` parameter containing both `IPv4Address` and `IPv6Address` (or the default of `None`, which carries the same meaning), `GAIResolver` will pass `AF_UNSPEC` to `getaddrinfo`.
Method	test_transportSemanticsToSocketType	When passed a `transportSemantics` paramter, `'TCP'` (the value present in `IPv4Address.type` to indicate a stream transport) maps to `SOCK_STREAM` and `'UDP'` maps to `SOCK_DGRAM`.
Method	test_socketTypeToAddressType	When `GAIResolver` receives a `SOCK_DGRAM` result from `getaddrinfo`, it returns a `'TCP'` `IPv4Address` or `IPv6Address`; if it receives `SOCK_STREAM` then it returns a `'UDP'` type of same.
Method	_resolveOnlyTest	Verify that the given set of address types results in the given `AF_` constant being passed to `getaddrinfo`.

Inherited from SynchronousTestCase:

Instance Variable	failureException	An exception class, defaulting to `FailTest`. If the test method raises this exception, it will be reported as a failure, rather than an exception. All of the assertion methods raise this if the assertion fails.
Instance Variable	skip	`None` or a string explaining why this test is to be skipped. If defined, the test will not be run. Instead, it will be reported to the result object as 'skipped' (if the `TestResult` supports skipping).
Instance Variable	todo	`None`, a string or a tuple of `(errors, reason)` where `errors` is either an exception class or an iterable of exception classes, and `reason` is a string. See `Todo` or `makeTodo` for more information.
Instance Variable	suppress	`None` or a list of tuples of `(args, kwargs)` to be passed to `warnings.filterwarnings`. Use these to suppress warnings raised in a test. Useful for testing deprecated code. See also `util.suppress`.
Method	__init__	Undocumented
Method	__eq__	No summary
Method	__ne__	Undocumented
Method	__hash__	Undocumented
Method	shortDescription	Undocumented
Method	getSkip	No summary
Method	getTodo	No summary
Method	runTest	If no `methodName` argument is passed to the constructor, `run` will treat this method as the thing with the actual test inside.
Method	run	Run the test case, storing the results in `result`.
Method	addCleanup	Add the given function to a list of functions to be called after the test has run, but before `tearDown`.
Method	patch	Monkey patch an object for the duration of the test.
Method	flushLoggedErrors	Remove stored errors received from the log.
Method	flushWarnings	Remove stored warnings from the list of captured warnings and return them.
Method	callDeprecated	Call a function that should have been deprecated at a specific version and in favor of a specific alternative, and assert that it was thusly deprecated.
Method	mktemp	Create a new path name which can be used for a new file or directory.
Method	_getSuppress	No summary
Method	_getSkipReason	Return the reason to use for skipping a test method.
Method	_run	Run a single method, either a test method or fixture.
Method	_runFixturesAndTest	Run `setUp`, a test method, test cleanups, and `tearDown`.
Method	_runCleanups	Synchronously run any cleanups which have been added.
Method	_installObserver	Undocumented
Method	_removeObserver	Undocumented

Inherited from _Assertions (via SynchronousTestCase):

Method	fail	Absolutely fail the test. Do not pass go, do not collect $200.
Method	assertFalse	Fail the test if `condition` evaluates to True.
Method	assertTrue	Fail the test if `condition` evaluates to False.
Method	assertRaises	Fail the test unless calling the function `f` with the given `args` and `kwargs` raises `exception`. The failure will report the traceback and call stack of the unexpected exception.
Method	assertEqual	Fail the test if `first` and `second` are not equal.
Method	assertIs	Fail the test if `first` is not `second`. This is an obect-identity-equality test, not an object equality (i.e. `__eq__`) test.
Method	assertIsNot	Fail the test if `first` is `second`. This is an obect-identity-equality test, not an object equality (i.e. `__eq__`) test.
Method	assertNotEqual	Fail the test if `first` == `second`.
Method	assertIn	Fail the test if `containee` is not found in `container`.
Method	assertNotIn	Fail the test if `containee` is found in `container`.
Method	assertNotAlmostEqual	Fail if the two objects are equal as determined by their difference rounded to the given number of decimal places (default 7) and comparing to zero.
Method	assertAlmostEqual	Fail if the two objects are unequal as determined by their difference rounded to the given number of decimal places (default 7) and comparing to zero.
Method	assertApproximates	Fail if `first` - `second` > `tolerance`
Method	assertSubstring	Fail if `substring` does not exist within `astring`.
Method	assertNotSubstring	Fail if `astring` contains `substring`.
Method	assertWarns	Fail if the given function doesn't generate the specified warning when called. It calls the function, checks the warning, and forwards the result of the function if everything is fine.
Method	assertIsInstance	Fail if `instance` is not an instance of the given class or of one of the given classes.
Method	assertNotIsInstance	Fail if `instance` is an instance of the given class or of one of the given classes.
Method	successResultOf	Return the current success result of `deferred` or raise `self.failureException`.
Method	failureResultOf	Return the current failure result of `deferred` or raise `self.failureException`.
Method	assertNoResult	Assert that `deferred` does not have a result at this point.
Method	assertRegex	Fail the test if a `regexp` search of `text` fails.

def setUp(self):

Set up a GAIResolver.

def test_resolveOneHost(self):

Resolving an individual hostname that results in one address from getaddrinfo results in a single call each to resolutionBegan, addressResolved, and resolutionComplete.

def test_resolveOneIPv6Host(self):

Resolving an individual hostname that results in one address from getaddrinfo results in a single call each to resolutionBegan, addressResolved, and resolutionComplete; addressResolved will receive an IPv6Address.

def test_gaierror(self):

Resolving a hostname that results in getaddrinfo raising a gaierror will result in the IResolutionReceiver receiving a call to resolutionComplete with no addressResolved calls in between; no failure is logged.

def _resolveOnlyTest(self, addrTypes, expectedAF):

Verify that the given set of address types results in the given AF_ constant being passed to getaddrinfo.

Parameters	addrTypes	iterable of `IAddress` implementers
	expectedAF	an `AF_*` constant

def test_resolveOnlyIPv4(self):

When passed an addressTypes parameter containing only IPv4Address, GAIResolver will pass AF_INET to getaddrinfo.

def test_resolveOnlyIPv6(self):

When passed an addressTypes parameter containing only IPv6Address, GAIResolver will pass AF_INET6 to getaddrinfo.

def test_resolveBoth(self):

When passed an addressTypes parameter containing both IPv4Address and IPv6Address (or the default of None, which carries the same meaning), GAIResolver will pass AF_UNSPEC to getaddrinfo.

def test_transportSemanticsToSocketType(self):

When passed a transportSemantics paramter, 'TCP' (the value present in IPv4Address.type to indicate a stream transport) maps to SOCK_STREAM and 'UDP' maps to SOCK_DGRAM.

def test_socketTypeToAddressType(self):

When GAIResolver receives a SOCK_DGRAM result from getaddrinfo, it returns a 'TCP' IPv4Address or IPv6Address; if it receives SOCK_STREAM then it returns a 'UDP' type of same.

API Documentation for twisted, generated by pydoctor at 2020-03-25 17:34:30.

twisted.internet.test.test_resolver.HostnameResolutionTests(UnitTest) class documentation

`twisted.internet.test.test_resolver.HostnameResolutionTests(UnitTest)` class documentation