[MERGE] Add pragma coverage annotations to test files

 * tweaked coverage so it won't complain about test-code for project-wide stats as much.

 - [x] Contributes to #365

* **Chores**
  * Updated test files to exclude certain functions and code branches from coverage analysis. No changes to application behavior or test logic.

Author: reactive-firewall

tests/MulticastUDPClient.py

@@ -179,7 +179,7 @@ class MCastClient(object):  # skipcq: PYL-R0205
 	"""The source port for the client."""
 
 	# skipcq: TCV-002
-	def __init__(self, *args, **kwargs):
+	def __init__(self, *args, **kwargs) -> None:  # pragma: no cover
 		"""
 		Initialize a MCastClient object with optional group address and source port.
 
@@ -240,11 +240,11 @@ def __init__(self, *args, **kwargs):
 
 		"""
 		# skipcq: TCV-002
-		if str("grp_addr") in kwargs:
+		if "grp_addr" in kwargs:  # pragma: no branch
 			self._group_addr = kwargs.get("grp_addr", None)  # skipcq: PTC-W0039 - ensure None
-		if str("src_port") in kwargs:
+		if "src_port" in kwargs:  # pragma: no branch
 			self._source_port = kwargs.get("src_port", 0)
-		else:
+		else:  # pragma: no branch
 			self._source_port = int(
 				50000 + (
 					int(random.SystemRandom().randbytes(int(60000).__sizeof__()).hex(), 16) % 9999
@@ -253,7 +253,7 @@ def __init__(self, *args, **kwargs):
 
 	# skipcq: TCV-002
 	@staticmethod
-	def say(address, port, sock, msg):
+	def say(address: str, port: int, sock: socket.socket, msg: str) -> None:  # pragma: no cover
 		"""
 		Send a message to a specified multicast address and port, then receive and print it.
 
@@ -306,9 +306,9 @@ def say(address, port, sock, msg):
 
 		"""
 		# skipcq: TCV-002
-		sock.sendto(bytes(msg + "\n", "utf-8"), (address, port))
-		received = str(sock.recv(1024), "utf-8")
-		sp = " " * 4
+		sock.sendto(bytes(msg + "\n", "utf-8"), (address, port))  # pragma: no cover
+		received = str(sock.recv(1024), "utf-8")  # pragma: no cover
+		sp = " " * 4  # pragma: no cover
 		if (sys.stdout.isatty()):  # pragma: no cover
 			print(f"Sent: {sp}{msg}")  # skipcq: PYL-C0209  -  must remain compatible
 			print(f"Received: {received}")  # skipcq: PYL-C0209  -  must remain compatible
@@ -340,7 +340,7 @@ class MyUDPHandler(socketserver.BaseRequestHandler):
 	__module__ = "tests.MulticastUDPClient.MyUDPHandler"
 
 	# skipcq: TCV-002
-	def handle(self):
+	def handle(self) -> None:  # pragma: no cover
 		"""
 		Handle incoming UDP requests.
 
@@ -389,15 +389,15 @@ def handle(self):
 
 		"""
 		# skipcq: TCV-002
-		data = self.request[0].strip()
-		sock = self.request[1]
-		print(f"{self.client_address[0]} wrote: ")
-		print(data)
-		sock.sendto(data.upper(), self.client_address)
+		data = self.request[0].strip()  # pragma: no cover
+		sock = self.request[1]  # pragma: no cover
+		print(f"{self.client_address[0]} wrote: ")  # pragma: no cover
+		print(data)  # pragma: no cover
+		sock.sendto(data.upper(), self.client_address)  # pragma: no cover
 
 
 # skipcq: TCV-002
-def main():
+def main() -> None:  # pragma: no cover
 	"""
 	The main test operations.
 
@@ -423,16 +423,16 @@ def main():
 
 	"""
 	# skipcq: TCV-002
-	HOST, PORT = "224.0.0.1", 59991
-	data = "TEST This is a test"
-	sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM, socket.IPPROTO_UDP)
-	tsts_fxr = MCastClient()
-	print(str((HOST, PORT)))
-	tsts_fxr.say(HOST, PORT, sock, data)
-	tsts_fxr.say(HOST, PORT, sock, str("STOP"))
+	HOST, PORT = "224.0.0.1", 59991  # pragma: no cover
+	data = "TEST This is a test"  # pragma: no cover
+	sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM, socket.IPPROTO_UDP)  # pragma: no cover
+	tsts_fxr = MCastClient()  # pragma: no cover
+	print(str((HOST, PORT)))  # pragma: no cover
+	tsts_fxr.say(HOST, PORT, sock, data)  # pragma: no cover
+	tsts_fxr.say(HOST, PORT, sock, "STOP")  # pragma: no cover
 
 
-if __name__ == "__main__":
+if __name__ == "__main__":  # pragma: no branch
 	main()  # skipcq: TCV-002
 	# skipcq: PYL-R1722
 	exit(0)  # skipcq: PYL-R1722 -- intentionally allow overwriteing exit for testing.

tests/run_selective.py

@@ -28,24 +28,24 @@
 	python3 -m tests.run_selective --group [mat|extra|fuzzing|performance] [--category CATEGORY]
 """
 
-__module__ = "tests"
+__module__ = "tests"  # pragma: no cover
 
-import sys
-import argparse
-import unittest
-import logging
+import sys  # pragma: no cover
+import argparse  # pragma: no cover
+import unittest  # pragma: no cover
+import logging  # pragma: no cover
 
-if __debug__ and __name__ == "__main__":
+if __debug__ and __name__ == "__main__":  # pragma: no branch
 	logging.getLogger(__module__).debug(
 		"Bootstrapping %s",  # lazy formatting to avoid PYL-W1203
 		__file__,
 	)
 
-from tests import get_test_suite
-from tests import TEST_GROUPS
+from tests import get_test_suite  # pragma: no cover
+from tests import TEST_GROUPS  # pragma: no cover
 
 
-def main() -> None:
+def main() -> None:  # pragma: no cover
 	"""Run selective tests based on specified group and category.
 
 	Parses command line arguments to select the appropriate test suite and executes the tests using
@@ -80,5 +80,5 @@ def main() -> None:
 		sys.exit(1)
 
 
-if __name__ == "__main__":
+if __name__ == "__main__":  # pragma: no branch
 	main()