twisted.names.test.test_names.AdditionalProcessingTests

class documentation

class AdditionalProcessingTests(unittest.TestCase): (source)

Tests for FileAuthority's additional processing for those record types which require it (MX, CNAME, etc).

Method	`assertRecordsMatch`	Assert that the `RRHeader` instances given by `expected` and `computed` carry all the same information but without requiring the records appear in the same order.
Method	`test_canonicalNameAnswerA`	If the name of the CNAME response has A records, they are included in the answer section of the response.
Method	`test_canonicalNameAnswerAAAA`	If the name of the CNAME response has AAAA records, they are included in the answer section of the response.
Method	`test_canonicalNameAnswerBoth`	If the name of the CNAME response has both A and AAAA records, they are all included in the answer section of the response.
Method	`test_mailExchangeAdditionalA`	If the name of the MX response has A records, they are included in the additional section of the response.
Method	`test_mailExchangeAdditionalAAAA`	If the name of the MX response has AAAA records, they are included in the additional section of the response.
Method	`test_mailExchangeAdditionalBoth`	If the name of the MX response has both A and AAAA records, they are all included in the additional section of the response.
Method	`test_nameserverAdditionalA`	If the name of the NS response has A records, they are included in the additional section of the response.
Method	`test_nameserverAdditionalAAAA`	If the name of the NS response has AAAA records, they are included in the additional section of the response.
Method	`test_nameserverAdditionalBoth`	If the name of the NS response has both A and AAAA records, they are all included in the additional section of the response.
Method	`_additionalMXTest`	Verify that a response to an MX query has certain records in the additional section.
Method	`_additionalNSTest`	Verify that a response to an NS query has certain records in the additional section.
Method	`_additionalTest`	Verify that certain address records are included in the additional section of a response generated by `FileAuthority`.
Method	`_answerCNAMETest`	Verify that a response to a CNAME query has certain records in the answer section.
Method	`_lookupSomeRecords`	Perform a DNS lookup against a `FileAuthority` configured with records as defined by `makeRecord` and `addresses`.
Constant	`_A`	Undocumented
Constant	`_AAAA`	Undocumented

Inherited from TestCase:

Method	`__call__`	Run the test. Should always do exactly the same thing as run().
Method	`__init__`	Construct an asynchronous test case for `methodName`.
Method	`addCleanup`	Extend the base cleanup feature with support for cleanup functions which return Deferreds.
Method	`assertFailure`	Fail if `deferred` does not errback with one of `expectedFailures`. Returns the original Deferred with callbacks added. You will need to return this Deferred from your test case.
Method	`deferRunCleanups`	Run any scheduled cleanups and report errors (if any) to the result. object.
Method	`deferSetUp`	Undocumented
Method	`deferTearDown`	Undocumented
Method	`deferTestMethod`	Undocumented
Method	`getSuppress`	Undocumented
Method	`getTimeout`	Returns the timeout value set on this test. Checks on the instance first, then the class, then the module, then packages. As soon as it finds something with a `timeout` attribute, returns that. Returns `util.DEFAULT_TIMEOUT_DURATION`...
Instance Variable	`timeout`	A real number of seconds. If set, the test will raise an error if it takes longer than `timeout` seconds. If not set, util.DEFAULT_TIMEOUT_DURATION is used.
Method	`_cbDeferTestMethod`	Undocumented
Method	`_classCleanUp`	Undocumented
Method	`_cleanUp`	Undocumented
Method	`_deprecateReactor`	Deprecate `iterate`, `crash` and `stop` on `reactor`. That is, each method is wrapped in a function that issues a deprecation warning, then calls the original.
Method	`_ebDeferSetUp`	Undocumented
Method	`_ebDeferTearDown`	Undocumented
Method	`_ebDeferTestMethod`	Undocumented
Method	`_makeReactorMethod`	Create a method which wraps the reactor method `name`. The new method issues a deprecation warning and calls the original.
Method	`_run`	Run a single method, either a test method or fixture.
Method	`_runFixturesAndTest`	Really run `setUp`, the test method, and `tearDown`. Any of these may return `defer.Deferred`s. After they complete, do some reactor cleanup.
Method	`_undeprecateReactor`	Restore the deprecated reactor methods. Undoes what `_deprecateReactor` did.
Method	`_wait`	Take a Deferred that only ever callbacks. Block until it happens.
Instance Variable	`_passed`	Undocumented
Instance Variable	`_reactorMethods`	Undocumented
Instance Variable	`_timedOut`	Undocumented

Inherited from SynchronousTestCase (via TestCase):

Method	`__eq__`	Override the comparison defined by the base TestCase which considers instances of the same class with the same _testMethodName to be equal. Since trial puts TestCase instances into a set, that definition of comparison makes it impossible to run the same test method twice...
Method	`__hash__`	Undocumented
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	`flushLoggedErrors`	Remove stored errors received from the log.
Method	`flushWarnings`	Remove stored warnings from the list of captured warnings and return them.
Method	`getDeprecatedModuleAttribute`	Retrieve a module attribute which should have been deprecated, and assert that we saw the appropriate deprecation warning.
Method	`getSkip`	Return the skip reason set on this test, if any is set. Checks on the instance first, then the class, then the module, then packages. As soon as it finds something with a `skip` attribute, returns that in a tuple (...
Method	`getTodo`	Return a `Todo` object if the test is marked todo. Checks on the instance first, then the class, then the module, then packages. As soon as it finds something with a `todo` attribute, returns that. Returns ...
Method	`mktemp`	Create a new path name which can be used for a new file or directory.
Method	`patch`	Monkey patch an object for the duration of the test.
Method	`run`	Run the test case, storing the results in `result`.
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	`shortDescription`	Undocumented
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	`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`.
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.
Method	`_getSkipReason`	Return the reason to use for skipping a test method.
Method	`_getSuppress`	Returns any warning suppressions set for this test. Checks on the instance first, then the class, then the module, then packages. As soon as it finds something with a `suppress` attribute, returns that. ...
Method	`_installObserver`	Undocumented
Method	`_removeObserver`	Undocumented
Method	`_runCleanups`	Synchronously run any cleanups which have been added.
Instance Variable	`_cleanups`	Undocumented
Instance Variable	`_observer`	Undocumented
Instance Variable	`_parents`	Undocumented
Instance Variable	`_testMethodName`	Undocumented
Instance Variable	`_warnings`	Undocumented

Inherited from _Assertions (via TestCase, SynchronousTestCase):

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	`assertEqual`	Fail the test if `first` and `second` are not equal.
Method	`assertFalse`	Fail the test if `condition` evaluates to True.
Method	`assertIn`	Fail the test if `containee` is not found in `container`.
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	`assertIsInstance`	Fail if `instance` is not an instance of the given class or of one of the given classes.
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	`assertNoResult`	Assert that `deferred` does not have a result at this point.
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	`assertNotEqual`	Fail the test if `first` == `second`.
Method	`assertNotIn`	Fail the test if `containee` is found in `container`.
Method	`assertNotIsInstance`	Fail if `instance` is an instance of the given class or of one of the given classes.
Method	`assertNotSubstring`	Fail if `astring` contains `substring`.
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	`assertSubstring`	Fail if `substring` does not exist within `astring`.
Method	`assertTrue`	Fail the test if `condition` evaluates to False.
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	`fail`	Absolutely fail the test. Do not pass go, do not collect $200.
Method	`failureResultOf`	Return the current failure result of `deferred` or raise `self.failureException`.
Method	`successResultOf`	Return the current success result of `deferred` or raise `self.failureException`.

def assertRecordsMatch(self, expected, computed): (source) ¶

Assert that the RRHeader instances given by expected and computed carry all the same information but without requiring the records appear in the same order.

Parameters
expected	A `list` of `RRHeader` instances giving the expected records.
computed	A `list` of `RRHeader` instances giving the records computed by the scenario under test.
Raises
`self.failureException`	If the two collections of records disagree.

def test_canonicalNameAnswerA(self): (source) ¶

If the name of the CNAME response has A records, they are included in the answer section of the response.

def test_canonicalNameAnswerAAAA(self): (source) ¶

If the name of the CNAME response has AAAA records, they are included in the answer section of the response.

def test_canonicalNameAnswerBoth(self): (source) ¶

If the name of the CNAME response has both A and AAAA records, they are all included in the answer section of the response.

def test_mailExchangeAdditionalA(self): (source) ¶

If the name of the MX response has A records, they are included in the additional section of the response.

def test_mailExchangeAdditionalAAAA(self): (source) ¶

If the name of the MX response has AAAA records, they are included in the additional section of the response.

def test_mailExchangeAdditionalBoth(self): (source) ¶

If the name of the MX response has both A and AAAA records, they are all included in the additional section of the response.

def test_nameserverAdditionalA(self): (source) ¶

If the name of the NS response has A records, they are included in the additional section of the response.

def test_nameserverAdditionalAAAA(self): (source) ¶

If the name of the NS response has AAAA records, they are included in the additional section of the response.

def test_nameserverAdditionalBoth(self): (source) ¶

If the name of the NS response has both A and AAAA records, they are all included in the additional section of the response.

def _additionalMXTest(self, addresses): (source) ¶

Verify that a response to an MX query has certain records in the additional section.

Parameters
addresses	See `_additionalTest`

def _additionalNSTest(self, addresses): (source) ¶

Verify that a response to an NS query has certain records in the additional section.

Parameters
addresses	See `_additionalTest`

def _additionalTest(self, method, makeRecord, addresses): (source) ¶

Verify that certain address records are included in the additional section of a response generated by FileAuthority.

Parameters
method	See `_lookupSomeRecords`
makeRecord	See `_lookupSomeRecords`
addresses	A `list` of `IRecord` providers which the additional section of the response is required to match (ignoring order).
Raises
`self.failureException`	If the additional section of the response consists of different records than those given by `addresses`.

def _answerCNAMETest(self, addresses): (source) ¶

Verify that a response to a CNAME query has certain records in the answer section.

Parameters
addresses	See `_additionalTest`

def _lookupSomeRecords(self, method, soa, makeRecord, target, addresses): (source) ¶

Perform a DNS lookup against a FileAuthority configured with records as defined by makeRecord and addresses.

Parameters
method:`str`	The name of the lookup method to use; for example, `"lookupNameservers"`.
soa	A `Record_SOA` for the zone for which the `FileAuthority` is authoritative.
makeRecord	A one-argument callable which accepts a name and returns an `IRecord` provider. `FileAuthority` is constructed with this record. The `FileAuthority` is queried for a record of the resulting type with the given name.
target:`bytes`	The extra name which the record returned by `makeRecord` will be pointed at; this is the name which might require extra processing by the server so that all the available, useful information is returned. For example, this is the target of a CNAME record or the mail exchange host pointed to by an MX record.
addresses	A `list` of records giving addresses of `target`.
Returns
A `Deferred` that fires with the result of the resolver method give by `method`.

_A = (source) ¶

Undocumented

Value

dns.Record_A(b'10.0.0.1')

_AAAA = (source) ¶

Undocumented

Value

dns.Record_AAAA(b'f080::1')