Add colour.utilities.suppress_stdout context manager.

colour/utilities/__init__.py

@@ -64,6 +64,7 @@
     usage_warning,
     filter_warnings,
     suppress_warnings,
+    suppress_stdout,
     numpy_print_options,
     ANCILLARY_COLOUR_SCIENCE_PACKAGES,
     ANCILLARY_RUNTIME_PACKAGES,
@@ -188,6 +189,7 @@
     "usage_warning",
     "filter_warnings",
     "suppress_warnings",
+    "suppress_stdout",
     "numpy_print_options",
     "ANCILLARY_COLOUR_SCIENCE_PACKAGES",
     "ANCILLARY_RUNTIME_PACKAGES",

colour/utilities/tests/test_verbose.py

@@ -11,6 +11,7 @@
     multiline_repr,
     multiline_str,
     show_warning,
+    suppress_stdout,
     suppress_warnings,
     warning,
 )
@@ -25,6 +26,7 @@
 __all__ = [
     "TestShowWarning",
     "TestSuppressWarnings",
+    "TestSuppressStdout",
     "TestDescribeEnvironment",
     "TestMultilineStr",
     "TestMultilineRepr",
@@ -68,6 +70,19 @@ def test_suppress_warnings(self):
             warning("This is a suppressed unit test warning!")
 
 
+class TestSuppressStdout(unittest.TestCase):
+    """
+    Define :func:`colour.utilities.verbose.suppress_stdout` definition unit
+    tests methods.
+    """
+
+    def test_suppress_stdout(self):
+        """Test :func:`colour.utilities.verbose.suppress_stdout` definition."""
+
+        with suppress_stdout():
+            print("This is a suppressed message!")  # noqa: T201
+
+
 class TestDescribeEnvironment(unittest.TestCase):
     """
     Define :func:`colour.utilities.verbose.describe_environment` definition

colour/utilities/verbose.py

@@ -7,6 +7,7 @@
 
 from __future__ import annotations
 
+import functools
 import os
 import sys
 import traceback
@@ -51,6 +52,7 @@
     "usage_warning",
     "filter_warnings",
     "suppress_warnings",
+    "suppress_stdout",
     "numpy_print_options",
     "ANCILLARY_COLOUR_SCIENCE_PACKAGES",
     "ANCILLARY_RUNTIME_PACKAGES",
@@ -449,6 +451,45 @@ def suppress_warnings(
         warnings.showwarning = show_warnings
 
 
+class suppress_stdout:
+    """
+    Define a context manager and decorator temporarily suppressing standard
+    output.
+
+    Examples
+    --------
+    >>> with suppress_stdout():
+    ...     print("Hello World!")
+    ...
+    >>> print("Hello World!")
+    'Hello World!'
+    """
+
+    def __enter__(self) -> suppress_stdout:
+        """Redirect the standard output upon entering the context manager."""
+
+        self._stdout = sys.stdout
+        sys.stdout = open(os.devnull, "w")  # noqa: SIM115
+
+        return self
+
+    def __exit__(self, *args: Any):
+        """Restore the standard output upon exiting the context manager."""
+
+        sys.stdout.close()
+        sys.stdout = self._stdout
+
+    def __call__(self, function: Callable) -> Callable:
+        """Call the wrapped definition."""
+
+        @functools.wraps(function)
+        def wrapper(*args: Any, **kwargs: Any) -> Callable:
+            with self:
+                return function(*args, **kwargs)
+
+        return wrapper
+
+
 @contextmanager
 def numpy_print_options(*args: Any, **kwargs: Any) -> Generator:
     """

docs/colour.utilities.rst

@@ -190,6 +190,7 @@ Verbose
     warning
     filter_warnings
     suppress_warnings
+    suppress_stdout
     numpy_print_options
     describe_environment
     multiline_str