RAHHH
This commit is contained in:
290
backend/lib/python3.12/site-packages/twisted/test/test_error.py
Normal file
290
backend/lib/python3.12/site-packages/twisted/test/test_error.py
Normal file
@@ -0,0 +1,290 @@
|
||||
# Copyright (c) Twisted Matrix Laboratories.
|
||||
# See LICENSE for details.
|
||||
from __future__ import annotations
|
||||
|
||||
import errno
|
||||
import socket
|
||||
import sys
|
||||
from typing import Sequence
|
||||
|
||||
from twisted.internet import error
|
||||
from twisted.trial import unittest
|
||||
|
||||
|
||||
class StringificationTests(unittest.SynchronousTestCase):
|
||||
"""Test that the exceptions have useful stringifications."""
|
||||
|
||||
listOfTests: list[
|
||||
tuple[
|
||||
str,
|
||||
type[Exception],
|
||||
Sequence[str | int | Exception | None],
|
||||
dict[str, str | int],
|
||||
]
|
||||
] = [
|
||||
# (output, exception[, args[, kwargs]]),
|
||||
("An error occurred binding to an interface.", error.BindError, [], {}),
|
||||
(
|
||||
"An error occurred binding to an interface: foo.",
|
||||
error.BindError,
|
||||
["foo"],
|
||||
{},
|
||||
),
|
||||
(
|
||||
"An error occurred binding to an interface: foo bar.",
|
||||
error.BindError,
|
||||
["foo", "bar"],
|
||||
{},
|
||||
),
|
||||
(
|
||||
"Couldn't listen on eth0:4242: Foo.",
|
||||
error.CannotListenError,
|
||||
("eth0", 4242, socket.error("Foo")),
|
||||
{},
|
||||
),
|
||||
("Message is too long to send.", error.MessageLengthError, [], {}),
|
||||
(
|
||||
"Message is too long to send: foo bar.",
|
||||
error.MessageLengthError,
|
||||
["foo", "bar"],
|
||||
{},
|
||||
),
|
||||
("DNS lookup failed.", error.DNSLookupError, [], {}),
|
||||
("DNS lookup failed: foo bar.", error.DNSLookupError, ["foo", "bar"], {}),
|
||||
("An error occurred while connecting.", error.ConnectError, [], {}),
|
||||
(
|
||||
"An error occurred while connecting: someOsError.",
|
||||
error.ConnectError,
|
||||
["someOsError"],
|
||||
{},
|
||||
),
|
||||
(
|
||||
"An error occurred while connecting: foo.",
|
||||
error.ConnectError,
|
||||
[],
|
||||
{"string": "foo"},
|
||||
),
|
||||
(
|
||||
"An error occurred while connecting: someOsError: foo.",
|
||||
error.ConnectError,
|
||||
["someOsError", "foo"],
|
||||
{},
|
||||
),
|
||||
("Couldn't bind.", error.ConnectBindError, [], {}),
|
||||
("Couldn't bind: someOsError.", error.ConnectBindError, ["someOsError"], {}),
|
||||
(
|
||||
"Couldn't bind: someOsError: foo.",
|
||||
error.ConnectBindError,
|
||||
["someOsError", "foo"],
|
||||
{},
|
||||
),
|
||||
("Hostname couldn't be looked up.", error.UnknownHostError, [], {}),
|
||||
("No route to host.", error.NoRouteError, [], {}),
|
||||
("Connection was refused by other side.", error.ConnectionRefusedError, [], {}),
|
||||
("TCP connection timed out.", error.TCPTimedOutError, [], {}),
|
||||
("File used for UNIX socket is no good.", error.BadFileError, [], {}),
|
||||
(
|
||||
"Service name given as port is unknown.",
|
||||
error.ServiceNameUnknownError,
|
||||
[],
|
||||
{},
|
||||
),
|
||||
("User aborted connection.", error.UserError, [], {}),
|
||||
("User timeout caused connection failure.", error.TimeoutError, [], {}),
|
||||
("An SSL error occurred.", error.SSLError, [], {}),
|
||||
(
|
||||
"Connection to the other side was lost in a non-clean fashion.",
|
||||
error.ConnectionLost,
|
||||
[],
|
||||
{},
|
||||
),
|
||||
(
|
||||
"Connection to the other side was lost in a non-clean fashion: foo bar.",
|
||||
error.ConnectionLost,
|
||||
["foo", "bar"],
|
||||
{},
|
||||
),
|
||||
("Connection was closed cleanly.", error.ConnectionDone, [], {}),
|
||||
(
|
||||
"Connection was closed cleanly: foo bar.",
|
||||
error.ConnectionDone,
|
||||
["foo", "bar"],
|
||||
{},
|
||||
),
|
||||
(
|
||||
"Uh.", # TODO nice docstring, you've got there.
|
||||
error.ConnectionFdescWentAway,
|
||||
[],
|
||||
{},
|
||||
),
|
||||
("Tried to cancel an already-called event.", error.AlreadyCalled, [], {}),
|
||||
(
|
||||
"Tried to cancel an already-called event: foo bar.",
|
||||
error.AlreadyCalled,
|
||||
["foo", "bar"],
|
||||
{},
|
||||
),
|
||||
("Tried to cancel an already-cancelled event.", error.AlreadyCancelled, [], {}),
|
||||
(
|
||||
"Tried to cancel an already-cancelled event: x 2.",
|
||||
error.AlreadyCancelled,
|
||||
["x", "2"],
|
||||
{},
|
||||
),
|
||||
(
|
||||
"A process has ended without apparent errors: process finished with exit code 0.",
|
||||
error.ProcessDone,
|
||||
[None],
|
||||
{},
|
||||
),
|
||||
(
|
||||
"A process has ended with a probable error condition: process ended.",
|
||||
error.ProcessTerminated,
|
||||
[],
|
||||
{},
|
||||
),
|
||||
(
|
||||
"A process has ended with a probable error condition: process ended with exit code 42.",
|
||||
error.ProcessTerminated,
|
||||
[],
|
||||
{"exitCode": 42},
|
||||
),
|
||||
(
|
||||
"A process has ended with a probable error condition: process ended by signal SIGBUS.",
|
||||
error.ProcessTerminated,
|
||||
[],
|
||||
{"signal": "SIGBUS"},
|
||||
),
|
||||
(
|
||||
"The Connector was not connecting when it was asked to stop connecting.",
|
||||
error.NotConnectingError,
|
||||
[],
|
||||
{},
|
||||
),
|
||||
(
|
||||
"The Connector was not connecting when it was asked to stop connecting: x 13.",
|
||||
error.NotConnectingError,
|
||||
["x", "13"],
|
||||
{},
|
||||
),
|
||||
(
|
||||
"The Port was not listening when it was asked to stop listening.",
|
||||
error.NotListeningError,
|
||||
[],
|
||||
{},
|
||||
),
|
||||
(
|
||||
"The Port was not listening when it was asked to stop listening: a 12.",
|
||||
error.NotListeningError,
|
||||
["a", "12"],
|
||||
{},
|
||||
),
|
||||
]
|
||||
|
||||
def testThemAll(self) -> None:
|
||||
for entry in self.listOfTests:
|
||||
output = entry[0]
|
||||
exception = entry[1]
|
||||
args = entry[2]
|
||||
kwargs = entry[3]
|
||||
|
||||
self.assertEqual(str(exception(*args, **kwargs)), output)
|
||||
|
||||
def test_connectingCancelledError(self) -> None:
|
||||
"""
|
||||
L{error.ConnectingCancelledError} has an C{address} attribute.
|
||||
"""
|
||||
address = object()
|
||||
e = error.ConnectingCancelledError(address)
|
||||
self.assertIs(e.address, address)
|
||||
|
||||
|
||||
class SubclassingTests(unittest.SynchronousTestCase):
|
||||
"""
|
||||
Some exceptions are subclasses of other exceptions.
|
||||
"""
|
||||
|
||||
def test_connectionLostSubclassOfConnectionClosed(self) -> None:
|
||||
"""
|
||||
L{error.ConnectionClosed} is a superclass of L{error.ConnectionLost}.
|
||||
"""
|
||||
self.assertTrue(issubclass(error.ConnectionLost, error.ConnectionClosed))
|
||||
|
||||
def test_connectionDoneSubclassOfConnectionClosed(self) -> None:
|
||||
"""
|
||||
L{error.ConnectionClosed} is a superclass of L{error.ConnectionDone}.
|
||||
"""
|
||||
self.assertTrue(issubclass(error.ConnectionDone, error.ConnectionClosed))
|
||||
|
||||
def test_invalidAddressErrorSubclassOfValueError(self) -> None:
|
||||
"""
|
||||
L{ValueError} is a superclass of L{error.InvalidAddressError}.
|
||||
"""
|
||||
self.assertTrue(issubclass(error.InvalidAddressError, ValueError))
|
||||
|
||||
|
||||
class GetConnectErrorTests(unittest.SynchronousTestCase):
|
||||
"""
|
||||
Given an exception instance thrown by C{socket.connect},
|
||||
L{error.getConnectError} returns the appropriate high-level Twisted
|
||||
exception instance.
|
||||
"""
|
||||
|
||||
def assertErrnoException(
|
||||
self, errno: int, expectedClass: type[error.ConnectError]
|
||||
) -> None:
|
||||
"""
|
||||
When called with a tuple with the given errno,
|
||||
L{error.getConnectError} returns an exception which is an instance of
|
||||
the expected class.
|
||||
"""
|
||||
e = (errno, "lalala")
|
||||
result = error.getConnectError(e)
|
||||
self.assertCorrectException(errno, "lalala", result, expectedClass)
|
||||
|
||||
def assertCorrectException(
|
||||
self,
|
||||
errno: int | None,
|
||||
message: object,
|
||||
result: error.ConnectError,
|
||||
expectedClass: type[error.ConnectError],
|
||||
) -> None:
|
||||
"""
|
||||
The given result of L{error.getConnectError} has the given attributes
|
||||
(C{osError} and C{args}), and is an instance of the given class.
|
||||
"""
|
||||
|
||||
# Want exact class match, not inherited classes, so no isinstance():
|
||||
self.assertEqual(result.__class__, expectedClass)
|
||||
self.assertEqual(result.osError, errno)
|
||||
self.assertEqual(result.args, (message,))
|
||||
|
||||
def test_errno(self) -> None:
|
||||
"""
|
||||
L{error.getConnectError} converts based on errno for C{socket.error}.
|
||||
"""
|
||||
self.assertErrnoException(errno.ENETUNREACH, error.NoRouteError)
|
||||
self.assertErrnoException(errno.ECONNREFUSED, error.ConnectionRefusedError)
|
||||
self.assertErrnoException(errno.ETIMEDOUT, error.TCPTimedOutError)
|
||||
if sys.platform == "win32":
|
||||
self.assertErrnoException(
|
||||
errno.WSAECONNREFUSED, error.ConnectionRefusedError
|
||||
)
|
||||
self.assertErrnoException(errno.WSAENETUNREACH, error.NoRouteError)
|
||||
|
||||
def test_gaierror(self) -> None:
|
||||
"""
|
||||
L{error.getConnectError} converts to a L{error.UnknownHostError} given
|
||||
a C{socket.gaierror} instance.
|
||||
"""
|
||||
result = error.getConnectError(socket.gaierror(12, "hello"))
|
||||
self.assertCorrectException(12, "hello", result, error.UnknownHostError)
|
||||
|
||||
def test_nonTuple(self) -> None:
|
||||
"""
|
||||
L{error.getConnectError} converts to a L{error.ConnectError} given
|
||||
an argument that cannot be unpacked.
|
||||
"""
|
||||
e = Exception()
|
||||
result = error.getConnectError(e)
|
||||
self.assertCorrectException(None, e, result, error.ConnectError)
|
||||
Reference in New Issue
Block a user