twisted.mail.test.test_imap.IMAP4ServerParsingTests

Test imap4.IMAP4Server's command parsing.

Method	setUp	Undocumented
Method	tearDown	Undocumented
Method	test_parseMethodExceptionLogged	`imap4.IMAP4Server` logs exceptions raised by parse methods.
Method	test_missingCommand	`imap4.IMAP4Server.parse_command` sends a `BAD` response to a line that includes a tag but no command.
Method	test_emptyLine	`imap4.IMAP4Server.parse_command` sends a `BAD` response to an empty line.
Method	assertParseExceptionResponse	Assert that the given exception results in the expected response.
Method	test_parsingRaisesIllegalClientResponse	When a parsing method raises `IllegalClientResponse`, the server sends a `BAD` response.
Method	test_parsingRaisesIllegalOperationResponse	When a parsing method raises `IllegalOperation`, the server sends a `NO` response.
Method	test_parsingRaisesIllegalMailboxEncoding	When a parsing method raises `IllegalMailboxEncoding`, the server sends a `NO` response.
Method	test_unsupportedCommand	`imap4.IMAP4Server` responds to an unsupported command with a `BAD` response.
Method	test_tooManyArgumentsForCommand	`imap4.IMAP4Server` responds with a `BAD` response to a command with more arguments than expected.
Method	assertCommandExceptionResponse	Assert that the given exception results in the expected response.
Method	test_commandRaisesIllegalClientResponse	When a command raises `IllegalClientResponse`, the server sends a `BAD` response.
Method	test_commandRaisesIllegalOperationResponse	When a command raises `IllegalOperation`, the server sends a `NO` response.
Method	test_commandRaisesIllegalMailboxEncoding	When a command raises `IllegalMailboxEncoding`, the server sends a `NO` response.
Method	test_commandRaisesUnhandledException	Wehn a command raises an unhandled exception, the server sends a `BAD` response and logs the exception.
Method	test_stringLiteralTooLong	A string literal whose length exceeds the maximum allowed length results in a `BAD` response.
Method	test_arg_astringEmptyLine	An empty string argument raises `imap4.IllegalClientResponse`.
Method	test_arg_astringUnmatchedQuotes	An unmatched quote in a string argument raises `imap4.IllegalClientResponse`.
Method	test_arg_astringUnmatchedLiteralBraces	An unmatched brace in a string literal's size raises `imap4.IllegalClientResponse`.
Method	test_arg_astringInvalidLiteralSize	A non-integral string literal size raises `imap4.IllegalClientResponse`.
Method	test_arg_atomEmptyLine	An empty atom raises `IllegalClientResponse`.
Method	test_arg_atomMalformedAtom	A malformed atom raises `IllegalClientResponse`.
Method	test_arg_plistEmptyLine	An empty parenthesized list raises `IllegalClientResponse`.
Method	test_arg_plistUnmatchedParentheses	A parenthesized with unmatched parentheses raises `IllegalClientResponse`.
Method	test_arg_literalEmptyLine	An empty file literal raises `IllegalClientResponse`.
Method	test_arg_literalUnmatchedBraces	A literal with unmatched braces raises `IllegalClientResponse`.
Method	test_arg_literalInvalidLiteralSize	A non-integral literal size raises `imap4.IllegalClientResponse`.
Method	test_arg_seqsetReturnsRest	A sequence set returns the unparsed portion of a line.
Method	test_arg_seqsetInvalidSequence	An invalid sequence raises `imap4.IllegalClientResponse`.
Method	test_arg_flaglistOneFlag	A single flag that is not contained in a list is parsed.
Method	test_arg_flaglistMismatchedParentehses	A list of flags with unmatched parentheses raises `imap4.IllegalClientResponse`.
Method	test_arg_flaglistMalformedFlag	A list of flags that contains a malformed flag raises `imap4.IllegalClientResponse`.
Method	test_opt_plistMissingOpenParenthesis	A line that does not begin with an open parenthesis (`(`) is parsed as `None`, and the remainder is the whole line.
Method	test_opt_datetimeMissingOpenQuote	A line that does not begin with a double quote (`"`) is parsed as `None`, and the remainder is the whole line.
Method	test_opt_datetimeMissingCloseQuote	A line that does not have a closing double quote (`"`) raises `imap4.IllegalClientResponse`.
Method	test_opt_charsetMissingIdentifier	A line that contains `CHARSET` but no character set identifier raises `imap4.IllegalClientResponse`.
Method	test_opt_charsetEndOfLine	A line that ends with a `CHARSET` identifier is parsed as that identifier, and the remainder is the empty string.
Method	test_opt_charsetWithRemainder	A line that has additional data after a `CHARSET` identifier is parsed as that identifier, and the remainder is that additional data.

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):

Undocumented

def tearDown(self):

Undocumented

def test_parseMethodExceptionLogged(self):

imap4.IMAP4Server logs exceptions raised by parse methods.

def test_missingCommand(self):

imap4.IMAP4Server.parse_command sends a BAD response to a line that includes a tag but no command.

def test_emptyLine(self):

imap4.IMAP4Server.parse_command sends a BAD response to an empty line.

def assertParseExceptionResponse(self, exception, tag, expectedResponse):

Assert that the given exception results in the expected response.

Parameters	exception	The exception to raise. (type: `Exception`)
	tag	The IMAP tag.
	expectedResponse	The expected bad response. (type: `bytes`)

def test_parsingRaisesIllegalClientResponse(self):

When a parsing method raises IllegalClientResponse, the server sends a BAD response.

def test_parsingRaisesIllegalOperationResponse(self):

When a parsing method raises IllegalOperation, the server sends a NO response.

def test_parsingRaisesIllegalMailboxEncoding(self):

When a parsing method raises IllegalMailboxEncoding, the server sends a NO response.

def test_unsupportedCommand(self):

imap4.IMAP4Server responds to an unsupported command with a BAD response.

def test_tooManyArgumentsForCommand(self):

imap4.IMAP4Server responds with a BAD response to a command with more arguments than expected.

def assertCommandExceptionResponse(self, exception, tag, expectedResponse):

Assert that the given exception results in the expected response.

Parameters	exception	The exception to raise. (type: `Exception`)
	The IMAP tag. (type: `bytes`)
	expectedResponse	The expected bad response. (type: `bytes`)

def test_commandRaisesIllegalClientResponse(self):

When a command raises IllegalClientResponse, the server sends a BAD response.

def test_commandRaisesIllegalOperationResponse(self):

When a command raises IllegalOperation, the server sends a NO response.

def test_commandRaisesIllegalMailboxEncoding(self):

When a command raises IllegalMailboxEncoding, the server sends a NO response.

def test_commandRaisesUnhandledException(self):

Wehn a command raises an unhandled exception, the server sends a BAD response and logs the exception.

def test_stringLiteralTooLong(self):

A string literal whose length exceeds the maximum allowed length results in a BAD response.

def test_arg_astringEmptyLine(self):

An empty string argument raises imap4.IllegalClientResponse.

def test_arg_astringUnmatchedQuotes(self):

An unmatched quote in a string argument raises imap4.IllegalClientResponse.

def test_arg_astringUnmatchedLiteralBraces(self):

An unmatched brace in a string literal's size raises imap4.IllegalClientResponse.

def test_arg_astringInvalidLiteralSize(self):

A non-integral string literal size raises imap4.IllegalClientResponse.

def test_arg_atomEmptyLine(self):

An empty atom raises IllegalClientResponse.

def test_arg_atomMalformedAtom(self):

A malformed atom raises IllegalClientResponse.

def test_arg_plistEmptyLine(self):

An empty parenthesized list raises IllegalClientResponse.

def test_arg_plistUnmatchedParentheses(self):

A parenthesized with unmatched parentheses raises IllegalClientResponse.

def test_arg_literalEmptyLine(self):

An empty file literal raises IllegalClientResponse.

def test_arg_literalUnmatchedBraces(self):

A literal with unmatched braces raises IllegalClientResponse.

def test_arg_literalInvalidLiteralSize(self):

A non-integral literal size raises imap4.IllegalClientResponse.

def test_arg_seqsetReturnsRest(self):

A sequence set returns the unparsed portion of a line.

def test_arg_seqsetInvalidSequence(self):

An invalid sequence raises imap4.IllegalClientResponse.

def test_arg_flaglistOneFlag(self):

A single flag that is not contained in a list is parsed.

def test_arg_flaglistMismatchedParentehses(self):

A list of flags with unmatched parentheses raises imap4.IllegalClientResponse.

def test_arg_flaglistMalformedFlag(self):

A list of flags that contains a malformed flag raises imap4.IllegalClientResponse.

def test_opt_plistMissingOpenParenthesis(self):

A line that does not begin with an open parenthesis (() is parsed as None, and the remainder is the whole line.

def test_opt_datetimeMissingOpenQuote(self):

A line that does not begin with a double quote (") is parsed as None, and the remainder is the whole line.

def test_opt_datetimeMissingCloseQuote(self):

A line that does not have a closing double quote (") raises imap4.IllegalClientResponse.

def test_opt_charsetMissingIdentifier(self):

A line that contains CHARSET but no character set identifier raises imap4.IllegalClientResponse.

def test_opt_charsetEndOfLine(self):

A line that ends with a CHARSET identifier is parsed as that identifier, and the remainder is the empty string.

def test_opt_charsetWithRemainder(self):

A line that has additional data after a CHARSET identifier is parsed as that identifier, and the remainder is that additional data.

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

twisted.mail.test.test_imap.IMAP4ServerParsingTests(unittest.SynchronousTestCase) class documentation

`twisted.mail.test.test_imap.IMAP4ServerParsingTests(unittest.SynchronousTestCase)` class documentation