[MERGE]

* From PR/MR #168 (feature-implement-from-std-in):
  [PATCH] Apply suggested changes from review (- WIP #168 -)
  [TESTING] Possible fix for low code coverage on new functions (- WIP #168 -)
  [FEATURE] implemented reading and sending from stdin for SAY operations (- WIP #150 -)

* From PR/MR #169 (feature-implement-custom-exceptions-157):
  [STYLE] Minor style fixes from review (- WIP PR #169  -)
  [CI] Possible fix by suppression of PYL-E0603.
  [DOCUMENTATION] Add docstrings to global variables from multicast/exceptions.py (- WIP PR #169 -)
  [REGRESSION] Various fixes and debugging from review (- WIP PR #169 -)
  [STYLE] Refactor exceptions and exit-code utilities (- WIP #117 & #157 -)
  [PATCH] part 2 of implementation (- WIP #157 -)
  [TESTING] implementing use of new exception - part 1 of 2 (- WIP #157 -)
  [DOCUMENTATION] added docstrings for new CommandExecutionError (- WIP #157 -)
  [TESTING] new exceptions file in tests (- WIP #157 -).

* From PR/MR #167 (testing-coverage):
  Update multicast/send.py
  [REGRESSION] Apply suggestions from code review (- WIP #167 -)
  [STYLE] Possible fix for style. (- WIP #53 -)
  [PATCH] Implementation for (- WIP #53 -)
  [TESTING] New test for TestRecvCleanup. (- WIP #53 -)
  [TESTING] New test for TestRecvDaemonMode. (- WIP #53 -)
  [TESTING] New test for TestRecvDataProcessing. (- WIP #53 -)
  [TESTING] New test for TestRecvExceptionHandling. (- WIP #53 -)
  [TESTING] New test for TestRecvInvalidSocket. (- WIP #53 -)
  [TESTING] New test for TestHearCleanup. (- WIP #53 -)
  [TESTING] New test for TestHearSocketErrors. (- WIP #53 -)
  [TESTING] New test for TestHearDaemonMode. (- WIP #53 -)
  [TESTING] New test for TestHearDataProcessing. (- WIP #53 -)
  [TESTING] New test for TestHearSocketException. (- WIP #53 -)
  [TESTING] New test for TestHearMissingParams. (- WIP #53 -)

* multicast/__init__.py
    * added new exceptions handling functions
    * added new exit code mapping globals
    * minor change to documentation
* multicast/hear.py
    * made warnings aware for socket re-use stability
    * slight stability improvement to handling data from transmissions
* multicast/recv.py
    * changed how invalid and empty groups are handled when joining multicast groups.
    * fixed hearstep to close sockets before returning now.
* multicast/send.py
    * Fixed issue where '--groups' was raising errors instead of being silently ignored.
    * New feature to allow reading from standard input when given a dash '-' instead of message data.
    * Improved testing of sending messages where the total size of the message requires packetization.
* multicast/skt.py
    * Fixed socket cleanup and release logic to reduce possible underlying resource leaks.

* added new test suites for:
    * to ensure listener activation logic is well tested
    * to verify sockets and the default listeners properly go away when done
    * to test stability with more kinds of data
    * other minor improvements related to changes

* New file multicast/exceptions.py
    * New Feature -- see #117 and CEP-8

Author: reactive-firewall

multicast/__init__.py

@@ -27,9 +27,13 @@
 # skipcq
 __all__ = [
 	"""__package__""", """__module__""", """__name__""", """__version__""", """__prologue__""",
-	"""__doc__""", """skt""", """skt.__package__""", """skt.__module__""", """skt.__name__""",
+	"""__doc__""", """exceptions""", """exceptions.CommandExecutionError""",
+	"""exceptions.get_exit_code_from_exception""", """exceptions.exit_on_exception""",
+	"""get_exit_code_from_exception""", """exit_on_exception""",
+	"""skt""", """skt.__package__""", """skt.__module__""", """skt.__name__""",
 	"""skt.__file__""", """skt.genSocket""", """skt.genSocket.__func__""", """genSocket""",
 	"""skt.endSocket""", """skt.endSocket.__func__""", """endSocket""",
+	"""EXIT_CODES""", """EXCEPTION_EXIT_CODES""",
 	"""_BLANK""", """_MCAST_DEFAULT_PORT""", """_MCAST_DEFAULT_GROUP""",
 	"""_MCAST_DEFAULT_TTL""", """mtool""", """recv""", """send""", """hear""",
 	"""recv.McastRECV""", """send.McastSAY""", """hear.McastHEAR""",
@@ -352,6 +356,23 @@
 	raise ModuleNotFoundError("FAIL: we could not import Abstract base class. ABORT.") from None
 
 
+if 'multicast.exceptions' not in sys.modules:
+	# pylint: disable=cyclic-import - skipcq: PYL-R0401, PYL-C0414
+	from . import exceptions  # pylint: disable=cyclic-import - skipcq: PYL-R0401, PYL-C0414
+else:  # pragma: no branch
+	exceptions = sys.modules["""multicast.exceptions"""]
+
+EXIT_CODES = exceptions.EXIT_CODES
+
+EXCEPTION_EXIT_CODES = exceptions.EXCEPTION_EXIT_CODES
+
+CommandExecutionError = exceptions.CommandExecutionError
+
+get_exit_code_from_exception = exceptions.get_exit_code_from_exception
+
+exit_on_exception = exceptions.exit_on_exception
+
+
 class mtool(abc.ABC):
 	"""
 	Class for Multicast tools.
@@ -602,9 +623,11 @@ def doStep(self, *args):  # pragma: no cover
 
 
 genSocket = skt.genSocket
+"""See multicast.skt.genSocket."""
 
 
 endSocket = skt.endSocket
+"""See multicast.skt.endSocket."""
 
 
 if 'multicast.recv' not in sys.modules: