Method handle_options

scenedetect/_cli/context.py:176–332

Parse all global options/arguments passed to the main scenedetect command, before other sub-commands (e.g. this function processes the [options] when calling `scenedetect [options] [commands [command options]]`). Raises: click.BadParameter: One of the given optio

(
        self,
        input_path: str | None,
        output: str | None,
        frame_rate: float | None,
        stats_file: str | None,
        frame_skip: int | None,
        min_scene_len: str | None,
        drop_short_scenes: bool | None,
        merge_last_scene: bool | None,
        backend: str | None,
        crop: tuple[int, int, int, int] | None,
        downscale: int | None,
        quiet: bool,
        logfile: str | None,
        config: str | None,
        stats: str | None,
        verbosity: str | None,
    )

            ) from ex

    def handle_options(
        self,
        input_path: str | None,
        output: str | None,
        frame_rate: float | None,
        stats_file: str | None,
        frame_skip: int | None,
        min_scene_len: str | None,
        drop_short_scenes: bool | None,
        merge_last_scene: bool | None,
        backend: str | None,
        crop: tuple[int, int, int, int] | None,
        downscale: int | None,
        quiet: bool,
        logfile: str | None,
        config: str | None,
        stats: str | None,
        verbosity: str | None,
    ):
        """Parse all global options/arguments passed to the main scenedetect command,
        before other sub-commands (e.g. this function processes the [options] when calling
        `scenedetect [options] [commands [command options]]`).

        Raises:
            click.BadParameter: One of the given options/parameters is invalid.
            click.Abort: Fatal initialization failure.
        """

        # TODO(v1.0): Make the stats value optional (e.g. allow -s only), and allow use of
        # $VIDEO_NAME macro in the name.  Default to $VIDEO_NAME.csv.

        # The `scenedetect` command was just started, let's initialize logging and try to load any
        # config files that were specified.
        init_log: list = []
        try:
            init_failure = not self.config.initialized
            init_log = self.config.get_init_log()
            quiet = not init_failure and quiet
            self._initialize_logging(quiet, verbosity, logfile)

            # Configuration file was specified via CLI argument -c/--config.
            if config and not init_failure:
                self.config = ConfigRegistry(config)
                init_log += self.config.get_init_log()
                # Re-initialize logger with the correct verbosity.
                if verbosity is None and not self.config.is_default("global", "verbosity"):
                    verbosity_str = self.config.get_value("global", "verbosity")
                    assert verbosity_str in CHOICE_MAP["global"]["verbosity"]
                    self.quiet_mode = False
                    self._initialize_logging(verbosity=verbosity_str, logfile=logfile)

        except ConfigLoadFailure as ex:
            init_failure = True
            init_log += ex.init_log
            if ex.reason is not None:
                init_log += [
                    (logging.ERROR, "Error: {}".format(str(ex.reason).replace("\t", "  ")))
                ]