coverage 7.6.7__cp311-cp311-win_amd64.whl → 7.11.1__cp311-cp311-win_amd64.whl

coverage/cmdline.py

@@ -6,25 +6,25 @@
 from __future__ import annotations
 
 import glob
-import optparse     # pylint: disable=deprecated-module
+import optparse
 import os
 import os.path
 import shlex
+import signal
 import sys
 import textwrap
 import traceback
-
-from typing import cast, Any, NoReturn
+import types
+from typing import Any, NoReturn, cast
 
 import coverage
-from coverage import Coverage
-from coverage import env
+from coverage import Coverage, env
 from coverage.config import CoverageConfig
 from coverage.control import DEFAULT_DATAFILE
-from coverage.core import HAS_CTRACER
-from coverage.data import combinable_files, debug_data_file
+from coverage.core import CTRACER_FILE
+from coverage.data import CoverageData, combinable_files, debug_data_file
 from coverage.debug import info_header, short_stack, write_formatted_info
-from coverage.exceptions import _BaseCoverageException, _ExceptionDuringRun, NoSource
+from coverage.exceptions import NoSource, CoverageException, _ExceptionDuringRun
 from coverage.execfile import PyRunner
 from coverage.results import display_covered, should_fail_under
 from coverage.version import __url__
@@ -32,6 +32,12 @@ from coverage.version import __url__
 # When adding to this file, alphabetization is important.  Look for
 # "alphabetize" comments throughout.
 
+
+def oneline(text: str) -> str:
+    """Turn a multi-line string into one line for help to reformat nicely."""
+    return " ".join(text.split())
+
+
 class Opts:
     """A namespace class for individual options we'll build parsers from."""
 
@@ -39,192 +45,324 @@ class Opts:
     # appears on the command line.
 
     append = optparse.make_option(
-        "-a", "--append", action="store_true",
-        help="Append coverage data to .coverage, otherwise it starts clean each time.",
+        "-a",
+        "--append",
+        action="store_true",
+        help="Append data to the data file. Otherwise it starts clean each time.",
     )
     branch = optparse.make_option(
-        "", "--branch", action="store_true",
+        "",
+        "--branch",
+        action="store_true",
         help="Measure branch coverage in addition to statement coverage.",
     )
     concurrency = optparse.make_option(
-        "", "--concurrency", action="store", metavar="LIBS",
-        help=(
-            "Properly measure code using a concurrency library. " +
-            "Valid values are: {}, or a comma-list of them."
+        "",
+        "--concurrency",
+        action="store",
+        metavar="LIBS",
+        help=oneline(
+            """
+            Properly measure code using a concurrency library.
+            Valid values are: {}, or a comma-list of them.
+            """
         ).format(", ".join(sorted(CoverageConfig.CONCURRENCY_CHOICES))),
     )
     context = optparse.make_option(
-        "", "--context", action="store", metavar="LABEL",
+        "",
+        "--context",
+        action="store",
+        metavar="LABEL",
         help="The context label to record for this coverage run.",
     )
     contexts = optparse.make_option(
-        "", "--contexts", action="store", metavar="REGEX1,REGEX2,...",
-        help=(
-            "Only display data from lines covered in the given contexts. " +
-            "Accepts Python regexes, which must be quoted."
+        "",
+        "--contexts",
+        action="store",
+        metavar="REGEX1,REGEX2,...",
+        help=oneline(
+            """
+            Only display data from lines covered in the given contexts.
+            Accepts Python regexes, which must be quoted.
+            """
         ),
     )
     datafile = optparse.make_option(
-        "", "--data-file", action="store", metavar="DATAFILE",
-        help=(
-            "Base name of the data files to operate on. " +
-            "Defaults to '.coverage'. [env: COVERAGE_FILE]"
+        "",
+        "--data-file",
+        action="store",
+        metavar="DATAFILE",
+        help=oneline(
+            """
+            Base name of the data files to operate on.
+            Defaults to '.coverage'. [env: COVERAGE_FILE]
+            """
         ),
     )
     datafle_input = optparse.make_option(
-        "", "--data-file", action="store", metavar="INFILE",
-        help=(
-            "Read coverage data for report generation from this file. " +
-            "Defaults to '.coverage'. [env: COVERAGE_FILE]"
+        "",
+        "--data-file",
+        action="store",
+        metavar="INFILE",
+        help=oneline(
+            """
+            Read coverage data for report generation from this file.
+            Defaults to '.coverage'. [env: COVERAGE_FILE]
+            """
         ),
     )
     datafile_output = optparse.make_option(
-        "", "--data-file", action="store", metavar="OUTFILE",
-        help=(
-            "Write the recorded coverage data to this file. " +
-            "Defaults to '.coverage'. [env: COVERAGE_FILE]"
+        "",
+        "--data-file",
+        action="store",
+        metavar="OUTFILE",
+        help=oneline(
+            """
+            Write the recorded coverage data to this file.
+            Defaults to '.coverage'. [env: COVERAGE_FILE]
+            """
         ),
     )
     debug = optparse.make_option(
-        "", "--debug", action="store", metavar="OPTS",
+        "",
+        "--debug",
+        action="store",
+        metavar="OPTS",
         help="Debug options, separated by commas. [env: COVERAGE_DEBUG]",
     )
     directory = optparse.make_option(
-        "-d", "--directory", action="store", metavar="DIR",
+        "-d",
+        "--directory",
+        action="store",
+        metavar="DIR",
         help="Write the output files to DIR.",
     )
     fail_under = optparse.make_option(
-        "", "--fail-under", action="store", metavar="MIN", type="float",
+        "",
+        "--fail-under",
+        action="store",
+        metavar="MIN",
+        type="float",
         help="Exit with a status of 2 if the total coverage is less than MIN.",
     )
     format = optparse.make_option(
-        "", "--format", action="store", metavar="FORMAT",
+        "",
+        "--format",
+        action="store",
+        metavar="FORMAT",
         help="Output format, either text (default), markdown, or total.",
     )
     help = optparse.make_option(
-        "-h", "--help", action="store_true",
+        "-h",
+        "--help",
+        action="store_true",
         help="Get help on this command.",
     )
     ignore_errors = optparse.make_option(
-        "-i", "--ignore-errors", action="store_true",
+        "-i",
+        "--ignore-errors",
+        action="store_true",
         help="Ignore errors while reading source files.",
     )
     include = optparse.make_option(
-        "", "--include", action="store", metavar="PAT1,PAT2,...",
-        help=(
-            "Include only files whose paths match one of these patterns. " +
-            "Accepts shell-style wildcards, which must be quoted."
+        "",
+        "--include",
+        action="store",
+        metavar="PAT1,PAT2,...",
+        help=oneline(
+            """
+            Include only files whose paths match one of these patterns.
+            Accepts shell-style wildcards, which must be quoted.
+            """
         ),
     )
     keep = optparse.make_option(
-        "", "--keep", action="store_true",
+        "",
+        "--keep",
+        action="store_true",
         help="Keep original coverage files, otherwise they are deleted.",
     )
     pylib = optparse.make_option(
-        "-L", "--pylib", action="store_true",
-        help=(
-            "Measure coverage even inside the Python installed library, " +
-            "which isn't done by default."
+        "-L",
+        "--pylib",
+        action="store_true",
+        help=oneline(
+            """
+            Measure coverage even inside the Python installed library,
+            which isn't done by default.
+            """
         ),
     )
     show_missing = optparse.make_option(
-        "-m", "--show-missing", action="store_true",
+        "-m",
+        "--show-missing",
+        action="store_true",
         help="Show line numbers of statements in each module that weren't executed.",
     )
     module = optparse.make_option(
-        "-m", "--module", action="store_true",
-        help=(
-            "<pyfile> is an importable Python module, not a script path, " +
-            "to be run as 'python -m' would run it."
+        "-m",
+        "--module",
+        action="store_true",
+        help=oneline(
+            """
+            <pyfile> is an importable Python module, not a script path,
+            to be run as 'python -m' would run it.
+            """
         ),
     )
     omit = optparse.make_option(
-        "", "--omit", action="store", metavar="PAT1,PAT2,...",
-        help=(
-            "Omit files whose paths match one of these patterns. " +
-            "Accepts shell-style wildcards, which must be quoted."
+        "",
+        "--omit",
+        action="store",
+        metavar="PAT1,PAT2,...",
+        help=oneline(
+            """
+            Omit files whose paths match one of these patterns.
+            Accepts shell-style wildcards, which must be quoted.
+            """
         ),
     )
     output_xml = optparse.make_option(
-        "-o", "", action="store", dest="outfile", metavar="OUTFILE",
+        "-o",
+        "",
+        action="store",
+        dest="outfile",
+        metavar="OUTFILE",
         help="Write the XML report to this file. Defaults to 'coverage.xml'",
     )
     output_json = optparse.make_option(
-        "-o", "", action="store", dest="outfile", metavar="OUTFILE",
+        "-o",
+        "",
+        action="store",
+        dest="outfile",
+        metavar="OUTFILE",
         help="Write the JSON report to this file. Defaults to 'coverage.json'",
     )
     output_lcov = optparse.make_option(
-        "-o", "", action="store", dest="outfile", metavar="OUTFILE",
+        "-o",
+        "",
+        action="store",
+        dest="outfile",
+        metavar="OUTFILE",
         help="Write the LCOV report to this file. Defaults to 'coverage.lcov'",
     )
     json_pretty_print = optparse.make_option(
-        "", "--pretty-print", action="store_true",
+        "",
+        "--pretty-print",
+        action="store_true",
         help="Format the JSON for human readers.",
     )
     parallel_mode = optparse.make_option(
-        "-p", "--parallel-mode", action="store_true",
-        help=(
-            "Append the machine name, process id and random number to the " +
-            "data file name to simplify collecting data from " +
-            "many processes."
+        "-p",
+        "--parallel-mode",
+        action="store_true",
+        help=oneline(
+            """
+            Append a unique suffix to the data file name to collect separate
+            data from multiple processes.
+            """
         ),
     )
     precision = optparse.make_option(
-        "", "--precision", action="store", metavar="N", type=int,
-        help=(
-            "Number of digits after the decimal point to display for " +
-            "reported coverage percentages."
+        "",
+        "--precision",
+        action="store",
+        metavar="N",
+        type=int,
+        help=oneline(
+            """
+            Number of digits after the decimal point to display for
+            reported coverage percentages.
+            """
         ),
     )
     quiet = optparse.make_option(
-        "-q", "--quiet", action="store_true",
+        "-q",
+        "--quiet",
+        action="store_true",
         help="Don't print messages about what is happening.",
     )
     rcfile = optparse.make_option(
-        "", "--rcfile", action="store",
-        help=(
-            "Specify configuration file. " +
-            "By default '.coveragerc', 'setup.cfg', 'tox.ini', and " +
-            "'pyproject.toml' are tried. [env: COVERAGE_RCFILE]"
+        "",
+        "--rcfile",
+        action="store",
+        help=oneline(
+            """
+            Specify configuration file.
+            By default '.coveragerc', 'setup.cfg', 'tox.ini', and
+            'pyproject.toml' are tried. [env: COVERAGE_RCFILE]
+            """
+        ),
+    )
+    save_signal = optparse.make_option(
+        "",
+        "--save-signal",
+        action="store",
+        metavar="SIGNAL",
+        choices=["USR1", "USR2"],
+        help=oneline(
+            """
+            Specify a signal that will trigger coverage to write its collected data.
+            Supported values are: USR1, USR2. Not available on Windows.
+            """
         ),
     )
     show_contexts = optparse.make_option(
-        "--show-contexts", action="store_true",
+        "--show-contexts",
+        action="store_true",
         help="Show contexts for covered lines.",
     )
     skip_covered = optparse.make_option(
-        "--skip-covered", action="store_true",
+        "--skip-covered",
+        action="store_true",
         help="Skip files with 100% coverage.",
     )
     no_skip_covered = optparse.make_option(
-        "--no-skip-covered", action="store_false", dest="skip_covered",
+        "--no-skip-covered",
+        action="store_false",
+        dest="skip_covered",
         help="Disable --skip-covered.",
     )
     skip_empty = optparse.make_option(
-        "--skip-empty", action="store_true",
+        "--skip-empty",
+        action="store_true",
         help="Skip files with no code.",
     )
     sort = optparse.make_option(
-        "--sort", action="store", metavar="COLUMN",
-        help=(
-            "Sort the report by the named column: name, stmts, miss, branch, brpart, or cover. " +
-             "Default is name."
+        "--sort",
+        action="store",
+        metavar="COLUMN",
+        help=oneline(
+            """
+            Sort the report by the named column: name, stmts, miss, branch, brpart, or cover.
+            Default is name.
+            """
         ),
     )
     source = optparse.make_option(
-        "", "--source", action="store", metavar="SRC1,SRC2,...",
+        "",
+        "--source",
+        action="store",
+        metavar="SRC1,SRC2,...",
         help="A list of directories or importable names of code to measure.",
     )
     timid = optparse.make_option(
-        "", "--timid", action="store_true",
+        "",
+        "--timid",
+        action="store_true",
         help="Use the slower Python trace function core.",
     )
     title = optparse.make_option(
-        "", "--title", action="store", metavar="TITLE",
+        "",
+        "--title",
+        action="store",
+        metavar="TITLE",
         help="A text string to use as the title on the HTML.",
     )
     version = optparse.make_option(
-        "", "--version", action="store_true",
+        "",
+        "--version",
+        action="store_true",
         help="Display version information and exit.",
     )
 
@@ -264,6 +402,7 @@ class CoverageOptionParser(optparse.OptionParser):
             pylib=None,
             quiet=None,
             rcfile=True,
+            save_signal=None,
             show_contexts=None,
             show_missing=None,
             skip_covered=None,
@@ -279,6 +418,7 @@ class CoverageOptionParser(optparse.OptionParser):
 
     class OptionParserError(Exception):
         """Used to stop the optparse error handler ending the process."""
+
         pass
 
     def parse_args_ok(self, args: list[str]) -> tuple[bool, optparse.Values | None, list[str]]:
@@ -305,10 +445,12 @@ class GlobalOptionParser(CoverageOptionParser):
     def __init__(self) -> None:
         super().__init__()
 
-        self.add_options([
-            Opts.help,
-            Opts.version,
-        ])
+        self.add_options(
+            [
+                Opts.help,
+                Opts.version,
+            ]
+        )
 
 
 class CmdOptionParser(CoverageOptionParser):
@@ -339,12 +481,12 @@ class CmdOptionParser(CoverageOptionParser):
         self.add_options(options)
         self.cmd = action
 
-    def __eq__(self, other: str) -> bool:       # type: ignore[override]
+    def __eq__(self, other: str) -> bool:  # type: ignore[override]
         # A convenience equality, so that I can put strings in unit test
         # results, and they will compare equal to objects.
-        return (other == f"<CmdOptionParser:{self.cmd}>")
+        return other == f"<CmdOptionParser:{self.cmd}>"
 
-    __hash__ = None         # type: ignore[assignment]
+    __hash__ = None  # type: ignore[assignment]
 
     def get_prog_name(self) -> str:
         """Override of an undocumented function in optparse.OptionParser."""
@@ -353,6 +495,7 @@ class CmdOptionParser(CoverageOptionParser):
         # Include the sub-command for this parser as part of the command.
         return f"{program_name} {self.cmd}"
 
+
 # In lists of Opts, keep them alphabetized by the option names as they appear
 # on the command line, since these lists determine the order of the options in
 # the help output.
@@ -374,14 +517,16 @@ COMMANDS = {
             Opts.ignore_errors,
             Opts.include,
             Opts.omit,
-            ] + GLOBAL_ARGS,
+        ]
+        + GLOBAL_ARGS,
         usage="[options] [modules]",
-        description=(
-            "Make annotated copies of the given files, marking statements that are executed " +
-            "with > and statements that are missed with !."
+        description=oneline(
+            """
+            Make annotated copies of the given files, marking statements that are executed
+            with > and statements that are missed with !.
+            """
         ),
     ),
-
     "combine": CmdOptionParser(
         "combine",
         [
@@ -389,47 +534,52 @@ COMMANDS = {
             Opts.datafile,
             Opts.keep,
             Opts.quiet,
-            ] + GLOBAL_ARGS,
+        ]
+        + GLOBAL_ARGS,
         usage="[options] <path1> <path2> ... <pathN>",
-        description=(
-            "Combine data from multiple coverage files. " +
-            "The combined results are written to a single " +
-            "file representing the union of the data. The positional " +
-            "arguments are data files or directories containing data files. " +
-            "If no paths are provided, data files in the default data file's " +
-            "directory are combined."
+        description=oneline(
+            """
+            Combine data from multiple coverage files.
+            The combined results are written to a single
+            file representing the union of the data. The positional
+            arguments are data files or directories containing data files.
+            If no paths are provided, data files in the default data file's
+            directory are combined.
+            """
         ),
     ),
-
     "debug": CmdOptionParser(
-        "debug", GLOBAL_ARGS,
+        "debug",
+        GLOBAL_ARGS,
         usage="<topic>",
-        description=(
-            "Display information about the internals of coverage.py, " +
-            "for diagnosing problems. " +
-            "Topics are: " +
-                "'data' to show a summary of the collected data; " +
-                "'sys' to show installation information; " +
-                "'config' to show the configuration; " +
-                "'premain' to show what is calling coverage; " +
-                "'pybehave' to show internal flags describing Python behavior."
+        description=oneline(
+            """
+            Display information about the internals of coverage.py,
+            for diagnosing problems.
+            Topics are:
+                'data' to show a summary of the collected data;
+                'sys' to show installation information;
+                'config' to show the configuration;
+                'premain' to show what is calling coverage;
+                'pybehave' to show internal flags describing Python behavior;
+                'sqlite' to show SQLite compilation options.
+            """
         ),
     ),
-
     "erase": CmdOptionParser(
         "erase",
         [
             Opts.datafile,
-            ] + GLOBAL_ARGS,
+        ]
+        + GLOBAL_ARGS,
         description="Erase previously collected coverage data.",
     ),
-
     "help": CmdOptionParser(
-        "help", GLOBAL_ARGS,
+        "help",
+        GLOBAL_ARGS,
         usage="[command]",
         description="Describe how to use coverage.py",
     ),
-
     "html": CmdOptionParser(
         "html",
         [
@@ -447,15 +597,17 @@ COMMANDS = {
             Opts.no_skip_covered,
             Opts.skip_empty,
             Opts.title,
-            ] + GLOBAL_ARGS,
+        ]
+        + GLOBAL_ARGS,
         usage="[options] [modules]",
-        description=(
-            "Create an HTML report of the coverage of the files.  " +
-            "Each file gets its own page, with the source decorated to show " +
-            "executed, excluded, and missed lines."
+        description=oneline(
+            """
+            Create an HTML report of the coverage of the files.
+            Each file gets its own page, with the source decorated to show
+            executed, excluded, and missed lines.
+            """
         ),
     ),
-
     "json": CmdOptionParser(
         "json",
         [
@@ -469,11 +621,11 @@ COMMANDS = {
             Opts.json_pretty_print,
             Opts.quiet,
             Opts.show_contexts,
-            ] + GLOBAL_ARGS,
+        ]
+        + GLOBAL_ARGS,
         usage="[options] [modules]",
         description="Generate a JSON report of coverage results.",
     ),
-
     "lcov": CmdOptionParser(
         "lcov",
         [
@@ -484,11 +636,11 @@ COMMANDS = {
             Opts.output_lcov,
             Opts.omit,
             Opts.quiet,
-            ] + GLOBAL_ARGS,
+        ]
+        + GLOBAL_ARGS,
         usage="[options] [modules]",
         description="Generate an LCOV report of coverage results.",
     ),
-
     "report": CmdOptionParser(
         "report",
         [
@@ -505,11 +657,11 @@ COMMANDS = {
             Opts.skip_covered,
             Opts.no_skip_covered,
             Opts.skip_empty,
-            ] + GLOBAL_ARGS,
+        ]
+        + GLOBAL_ARGS,
         usage="[options] [modules]",
         description="Report coverage statistics on modules.",
     ),
-
     "run": CmdOptionParser(
         "run",
         [
@@ -523,13 +675,14 @@ COMMANDS = {
             Opts.omit,
             Opts.pylib,
             Opts.parallel_mode,
+            Opts.save_signal,
             Opts.source,
             Opts.timid,
-            ] + GLOBAL_ARGS,
+        ]
+        + GLOBAL_ARGS,
         usage="[options] <pyfile> [program options]",
         description="Run a Python program, measuring code execution.",
     ),
-
     "xml": CmdOptionParser(
         "xml",
         [
@@ -541,7 +694,8 @@ COMMANDS = {
             Opts.output_xml,
             Opts.quiet,
             Opts.skip_empty,
-            ] + GLOBAL_ARGS,
+        ]
+        + GLOBAL_ARGS,
         usage="[options] [modules]",
         description="Generate an XML report of coverage results.",
     ),
@@ -569,12 +723,12 @@ def show_help(
         # get back to the original form.
         auto_suffix = "-script.py"
         if program_name.endswith(auto_suffix):
-            program_name = program_name[:-len(auto_suffix)]
+            program_name = program_name[: -len(auto_suffix)]
 
     help_params = dict(coverage.__dict__)
     help_params["__url__"] = __url__
     help_params["program_name"] = program_name
-    if HAS_CTRACER:
+    if CTRACER_FILE:
         help_params["extension_modifier"] = "with C extension"
     else:
         help_params["extension_modifier"] = "without C extension"
@@ -807,6 +961,11 @@ class CoverageScript:
 
         return False
 
+    def do_signal_save(self, _signum: int, _frame: types.FrameType | None) -> None:
+        """Signal handler to save coverage report"""
+        print("Saving coverage data...", flush=True)
+        self.coverage.save()
+
     def do_run(self, options: optparse.Values, args: list[str]) -> int:
         """Implementation of 'coverage run'."""
 
@@ -837,9 +996,9 @@ class CoverageScript:
                 # they will be None if they have not been specified.
                 if getattr(options, opt_name) is not None:
                     show_help(
-                        "Options affecting multiprocessing must only be specified " +
-                        "in a configuration file.\n" +
-                        f"Remove --{opt_name} from the command line.",
+                        "Options affecting multiprocessing must only be specified "
+                        + "in a configuration file.\n"
+                        + f"Remove --{opt_name} from the command line.",
                     )
                     return ERR
 
@@ -851,6 +1010,13 @@ class CoverageScript:
         if options.append:
             self.coverage.load()
 
+        if options.save_signal:
+            if env.WINDOWS:
+                show_help("--save-signal is not supported on Windows.")
+                return ERR
+            sig = getattr(signal, f"SIG{options.save_signal}")
+            signal.signal(sig, self.do_signal_save)
+
         # Run the script.
         self.coverage.start()
         code_ran = True
@@ -870,7 +1036,10 @@ class CoverageScript:
         """Implementation of 'coverage debug'."""
 
         if not args:
-            show_help("What information would you like: config, data, sys, premain, pybehave?")
+            show_help(
+                "What information would you like: "
+                + "config, data, sys, premain, pybehave, sqlite?"
+            )
             return ERR
         if args[1:]:
             show_help("Only one topic at a time, please")
@@ -892,6 +1061,8 @@ class CoverageScript:
             print(short_stack(full=True))
         elif args[0] == "pybehave":
             write_formatted_info(print, "pybehave", env.debug_info())
+        elif args[0] == "sqlite":
+            write_formatted_info(print, "sqlite", CoverageData.sys_info())
         else:
             show_help(f"Don't know what you mean by {args[0]!r}")
             return ERR
@@ -948,12 +1119,12 @@ HELP_TOPICS = {
 
         Use "{program_name} help <command>" for detailed help on any command.
     """,
-
-    "minimum_help": (
-        "Code coverage for Python, version {__version__} {extension_modifier}.  " +
-        "Use '{program_name} help' for help."
+    "minimum_help": oneline(
+        """
+        Code coverage for Python, version {__version__} {extension_modifier}.
+        Use '{program_name} help' for help.
+        """
     ),
-
     "version": "Coverage.py, version {__version__} {extension_modifier}",
 }
 
@@ -972,11 +1143,13 @@ def main(argv: list[str] | None = None) -> int | None:
         # An exception was caught while running the product code.  The
         # sys.exc_info() return tuple is packed into an _ExceptionDuringRun
         # exception.
-        traceback.print_exception(*err.args)    # pylint: disable=no-value-for-parameter
+        traceback.print_exception(*err.args)  # pylint: disable=no-value-for-parameter
         status = ERR
-    except _BaseCoverageException as err:
+    except CoverageException as err:
         # A controlled error inside coverage.py: print the message to the user.
         msg = err.args[0]
+        if err.slug:
+            msg = f"{msg.rstrip('.')}; see {__url__}/messages.html#error-{err.slug}"
         print(msg)
         status = ERR
     except SystemExit as err:
@@ -987,16 +1160,18 @@ def main(argv: list[str] | None = None) -> int | None:
             status = None
     return status
 
+
 # Profiling using ox_profile.  Install it from GitHub:
 #   pip install git+https://github.com/emin63/ox_profile.git
 #
 # $set_env.py: COVERAGE_PROFILE - Set to use ox_profile.
 _profile = os.getenv("COVERAGE_PROFILE")
-if _profile:                                                # pragma: debugging
-    from ox_profile.core.launchers import SimpleLauncher    # pylint: disable=import-error
+if _profile:  # pragma: debugging
+    from ox_profile.core.launchers import SimpleLauncher  # pylint: disable=import-error
+
     original_main = main
 
-    def main(                                               # pylint: disable=function-redefined
+    def main(  # pylint: disable=function-redefined
         argv: list[str] | None = None,
     ) -> int | None:
         """A wrapper around main that profiles."""