twisted.web.test.test_http2.HTTP2ServerTests

No class docstring

Method	connectAndReceive	Takes a single `H2Connection` object and connects it to a `StringTransport` using a brand new `FrameFactory`.
Method	test_basicRequest	Send request over a TCP connection and confirm that we get back the expected data in the order and style we expect.
Method	test_postRequest	Send a POST request and confirm that the data is safely transferred.
Method	test_postRequestNoLength	Send a POST request without length and confirm that the data is safely transferred.
Method	test_interleavedRequests	Many interleaved POST requests all get received and responded to appropriately.
Method	test_sendAccordingToPriority	Data in responses is interleaved according to HTTP/2 priorities.
Method	test_protocolErrorTerminatesConnection	A protocol error from the remote peer terminates the connection.
Method	test_streamProducingData	The H2Stream data implements IPushProducer, and can have its data production controlled by the Request if the Request chooses to.
Method	test_abortStreamProducingData	No summary
Method	test_terminatedRequest	When a RstStream frame is received, the `H2Connection` and `H2Stream` objects tear down the `http.Request` and swallow all outstanding writes.
Method	test_terminatedConnection	When a GoAway frame is received, the `H2Connection` and `H2Stream` objects tear down all outstanding `http.Request` objects and stop all writing.
Method	test_respondWith100Continue	Requests containing Expect: 100-continue cause provisional 100 responses to be emitted.
Method	test_respondWith400	Triggering the call to `H2Stream._respondToBadRequestAndDisconnect` leads to a 400 error being sent automatically and the stream being torn down.
Method	test_loseH2StreamConnection	Calling `Request.loseConnection` causes all data that has previously been sent to be flushed, and then the stream cleanly closed.
Method	test_cannotRegisterTwoProducers	The `H2Stream` object forbids registering two producers.
Method	test_handlesPullProducer	`Request` objects that have registered pull producers get blocked and unblocked according to HTTP/2 flow control.
Method	test_isSecureWorksProperly	`Request` objects can correctly ask isSecure on HTTP/2.
Method	test_lateCompletionWorks	`H2Connection` correctly unblocks when a stream is ended.
Method	test_writeSequenceForChannels	`H2Stream` objects can send a series of frames via `writeSequence`.
Method	test_delayWrites	Delaying writes from `Request` causes the `H2Connection` to block on sending until data is available. However, data is not sent if there's no room in the flow control window.
Method	test_resetAfterBody	A client that immediately resets after sending the body causes Twisted to send no response.
Method	test_RequestRequiringFactorySiteInConstructor	A custom `Request` subclass that requires the site and factory in the constructor is able to get them.
Method	test_notifyOnCompleteRequest	A request sent to a HTTP/2 connection fires the `http.Request.notifyFinish` callback with a `None` value.
Method	test_notifyOnResetStream	A HTTP/2 reset stream fires the `http.Request.notifyFinish` deferred with `ConnectionLost`.
Method	test_failWithProtocolError	A HTTP/2 protocol error triggers the `http.Request.notifyFinish` deferred for all outstanding requests with a Failure that contains the underlying exception.
Method	test_failOnGoaway	A HTTP/2 GoAway triggers the `http.Request.notifyFinish` deferred for all outstanding requests with a Failure that contains a RemoteGoAway error.
Method	test_failOnStopProducing	`The transport telling the HTTP/2 connection to stop producing will fire all L{http.Request.notifyFinish} errbacks with L{error.}`
Method	test_notifyOnFast400	A HTTP/2 stream that has had _respondToBadRequestAndDisconnect called on it from a request handler calls the `http.Request.notifyFinish` errback with `ConnectionLost`.
Method	test_fast400WithCircuitBreaker	No summary
Method	test_bufferingAutomaticFrameData	If a the `H2Connection` has been paused by the transport, it will not write automatic frame data triggered by writes.
Method	test_bufferingAutomaticFrameDataWithCircuitBreaker	If the `H2Connection` has been paused by the transport, it will not write automatic frame data triggered by writes. If this buffer gets too large, the connection will be dropped.
Method	test_bufferingContinuesIfProducerIsPausedOnWrite	If the `H2Connection` has buffered control frames, is unpaused, and then paused while unbuffering, it persists the buffer and stops trying to write.
Method	test_circuitBreakerAbortsAfterProtocolError	A client that triggers a `h2.exceptions.ProtocolError` over a paused connection that's reached its buffered control frame limit causes that connection to be aborted.

Inherited from TestCase:

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	__init__	Construct an asynchronous test case for `methodName`.
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	__call__	Run the test. Should always do exactly the same thing as run().
Method	deferSetUp	Undocumented
Method	deferTestMethod	Undocumented
Method	deferTearDown	Undocumented
Method	deferRunCleanups	Run any scheduled cleanups and report errors (if any to the result object.
Method	addCleanup	Extend the base cleanup feature with support for cleanup functions which return Deferreds.
Method	getSuppress	Undocumented
Method	getTimeout	No summary
Method	_run	Run a single method, either a test method or fixture.
Method	_ebDeferSetUp	Undocumented
Method	_cbDeferTestMethod	Undocumented
Method	_ebDeferTestMethod	Undocumented
Method	_ebDeferTearDown	Undocumented
Method	_cbDeferRunCleanups	Undocumented
Method	_cleanUp	Undocumented
Method	_classCleanUp	Undocumented
Method	_makeReactorMethod	Create a method which wraps the reactor method `name`. The new method issues a deprecation warning and calls the original.
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	_undeprecateReactor	Restore the deprecated reactor methods. Undoes what `_deprecateReactor` did.
Method	_runCleanups	Run the cleanups added with `addCleanup` in order.
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	_wait	Take a Deferred that only ever callbacks. Block until it happens.

Inherited from SynchronousTestCase (via TestCase):

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	__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	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	_installObserver	Undocumented
Method	_removeObserver	Undocumented

Inherited from _Assertions (via TestCase, 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.

Inherited from HTTP2TestHelpers:

Method

assertAllStreamsBlocked

Confirm that all streams are blocked: that is, the priority tree believes that none of the streams have data ready to send.

def connectAndReceive(self, connection, headers, body):

Takes a single H2Connection object and connects it to a StringTransport using a brand new FrameFactory.

Parameters	connection	The `H2Connection` object to connect. (type: `H2Connection`)
	headers	The headers to send on the first request. (type: `Iterable` of `tuple` of `(bytes, bytes)`)
	body	Chunks of body to send, if any. (type: `Iterable` of `bytes`)
Returns	A tuple of `FrameFactory`, `StringTransport`

def test_basicRequest(self):

Send request over a TCP connection and confirm that we get back the expected data in the order and style we expect.

def test_postRequest(self):

Send a POST request and confirm that the data is safely transferred.

def test_postRequestNoLength(self):

Send a POST request without length and confirm that the data is safely transferred.

def test_interleavedRequests(self):

Many interleaved POST requests all get received and responded to appropriately.

def test_sendAccordingToPriority(self):

Data in responses is interleaved according to HTTP/2 priorities.

def test_protocolErrorTerminatesConnection(self):

A protocol error from the remote peer terminates the connection.

def test_streamProducingData(self):

The H2Stream data implements IPushProducer, and can have its data production controlled by the Request if the Request chooses to.

def test_abortStreamProducingData(self):

The H2Stream data implements IPushProducer, and can have its data production controlled by the Request if the Request chooses to. When the production is stopped, that causes the stream connection to be lost.

def test_terminatedRequest(self):

When a RstStream frame is received, the H2Connection and H2Stream objects tear down the http.Request and swallow all outstanding writes.

def test_terminatedConnection(self):

When a GoAway frame is received, the H2Connection and H2Stream objects tear down all outstanding http.Request objects and stop all writing.

def test_respondWith100Continue(self):

Requests containing Expect: 100-continue cause provisional 100 responses to be emitted.

def test_respondWith400(self):

Triggering the call to H2Stream._respondToBadRequestAndDisconnect leads to a 400 error being sent automatically and the stream being torn down.

def test_loseH2StreamConnection(self):

Calling Request.loseConnection causes all data that has previously been sent to be flushed, and then the stream cleanly closed.

def test_cannotRegisterTwoProducers(self):

The H2Stream object forbids registering two producers.

def test_handlesPullProducer(self):

Request objects that have registered pull producers get blocked and unblocked according to HTTP/2 flow control.

def test_isSecureWorksProperly(self):

Request objects can correctly ask isSecure on HTTP/2.

def test_lateCompletionWorks(self):

H2Connection correctly unblocks when a stream is ended.

def test_writeSequenceForChannels(self):

H2Stream objects can send a series of frames via writeSequence.

def test_delayWrites(self):

Delaying writes from Request causes the H2Connection to block on sending until data is available. However, data is *not* sent if there's no room in the flow control window.

def test_resetAfterBody(self):

A client that immediately resets after sending the body causes Twisted to send no response.

def test_RequestRequiringFactorySiteInConstructor(self):

A custom Request subclass that requires the site and factory in the constructor is able to get them.

def test_notifyOnCompleteRequest(self):

A request sent to a HTTP/2 connection fires the http.Request.notifyFinish callback with a None value.

def test_notifyOnResetStream(self):

A HTTP/2 reset stream fires the http.Request.notifyFinish deferred with ConnectionLost.

def test_failWithProtocolError(self):

A HTTP/2 protocol error triggers the http.Request.notifyFinish deferred for all outstanding requests with a Failure that contains the underlying exception.

def test_failOnGoaway(self):

A HTTP/2 GoAway triggers the http.Request.notifyFinish deferred for all outstanding requests with a Failure that contains a RemoteGoAway error.

def test_failOnStopProducing(self):

The transport telling the HTTP/2 connection to stop producing will
fire all L{http.Request.notifyFinish} errbacks with L{error.}

def test_notifyOnFast400(self):

A HTTP/2 stream that has had _respondToBadRequestAndDisconnect called on it from a request handler calls the http.Request.notifyFinish errback with ConnectionLost.

def test_fast400WithCircuitBreaker(self):

A HTTP/2 stream that has had _respondToBadRequestAndDisconnect called on it does not write control frame data if its transport is paused and its control frame limit has been reached.

def test_bufferingAutomaticFrameData(self):

If a the H2Connection has been paused by the transport, it will not write automatic frame data triggered by writes.

def test_bufferingAutomaticFrameDataWithCircuitBreaker(self):

If the H2Connection has been paused by the transport, it will not write automatic frame data triggered by writes. If this buffer gets too large, the connection will be dropped.

def test_bufferingContinuesIfProducerIsPausedOnWrite(self):

If the H2Connection has buffered control frames, is unpaused, and then paused while unbuffering, it persists the buffer and stops trying to write.

def test_circuitBreakerAbortsAfterProtocolError(self):

A client that triggers a h2.exceptions.ProtocolError over a paused connection that's reached its buffered control frame limit causes that connection to be aborted.

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

twisted.web.test.test_http2.HTTP2ServerTests(unittest.TestCase, HTTP2TestHelpers) class documentation

`twisted.web.test.test_http2.HTTP2ServerTests(unittest.TestCase, HTTP2TestHelpers)` class documentation