Method _get_core_print_console

cmd2/cmd2.py:1390–1440

Get a console configured for the specified stream and formatting settings. This method is intended for internal use by cmd2's core print methods. To avoid the overhead of repeated initialization, it manages a thread-local cache for consoles targeting ``self.stdout`` or ``sys

(
        self,
        *,
        file: IO[str],
        emoji: bool,
        markup: bool,
        highlight: bool,
    )

        return su.strip_style(self.prompt)

    def _get_core_print_console(
        self,
        *,
        file: IO[str],
        emoji: bool,
        markup: bool,
        highlight: bool,
    ) -> Cmd2BaseConsole:
        """Get a console configured for the specified stream and formatting settings.

        This method is intended for internal use by cmd2's core print methods.
        To avoid the overhead of repeated initialization, it manages a thread-local
        cache for consoles targeting ``self.stdout`` or ``sys.stderr``. It returns a cached
        instance if its configuration matches the request. For all other streams, or if
        the configuration has changed, a new console is created.

        Note: This implementation works around a bug in Rich where passing formatting settings
        (emoji, markup, and highlight) directly to console.print() or console.log() does not
        always work when printing certain Renderables. Passing them to the constructor instead
        ensures they are correctly propagated. Once this bug is fixed, these parameters can
        be removed from this method. For more details, see:
        https://github.com/Textualize/rich/issues/4028
        """
        # Dictionary of settings to check against cached consoles
        kwargs = {
            "emoji": emoji,
            "markup": markup,
            "highlight": highlight,
        }

        # Check if we should use or update a cached console
        if file is self.stdout:
            cached = self._console_cache.stdout
            if cached is not None and cached.matches_config(file=file, **kwargs):
                return cached

            # Create new console and update cache
            self._console_cache.stdout = Cmd2BaseConsole(file=file, **kwargs)
            return self._console_cache.stdout

        if file is sys.stderr:
            cached = self._console_cache.stderr
            if cached is not None and cached.matches_config(file=file, **kwargs):
                return cached

            # Create new console and update cache
            self._console_cache.stderr = Cmd2BaseConsole(file=file, **kwargs)
            return self._console_cache.stderr

        # For any other file, just create a new console
        return Cmd2BaseConsole(file=file, **kwargs)

    def print_to(
        self,