Method __init__

IPython/core/debugger.py:203–283

Create a new IPython debugger. :param color_scheme: Deprecated, do not use. :param completekey: Passed to pdb.Pdb. :param stdin: Passed to pdb.Pdb. :param stdout: Passed to pdb.Pdb. :param context: Number of lines of source code context to show when

(self, color_scheme=None, completekey=None,
                 stdin=None, stdout=None, context=5, **kwargs)

    """

    def __init__(self, color_scheme=None, completekey=None,
                 stdin=None, stdout=None, context=5, **kwargs):
        """Create a new IPython debugger.
        
        :param color_scheme: Deprecated, do not use.
        :param completekey: Passed to pdb.Pdb.
        :param stdin: Passed to pdb.Pdb.
        :param stdout: Passed to pdb.Pdb.
        :param context: Number of lines of source code context to show when
            displaying stacktrace information.
        :param kwargs: Passed to pdb.Pdb.
            The possibilities are python version dependent, see the python
            docs for more info.
        """

        # Parent constructor:
        try:
            self.context = int(context)
            if self.context <= 0:
                raise ValueError("Context must be a positive integer")
        except (TypeError, ValueError):
                raise ValueError("Context must be a positive integer")

        # `kwargs` ensures full compatibility with stdlib's `pdb.Pdb`.
        OldPdb.__init__(self, completekey, stdin, stdout, **kwargs)

        # IPython changes...
        self.shell = get_ipython()

        if self.shell is None:
            save_main = sys.modules['__main__']
            # No IPython instance running, we must create one
            from IPython.terminal.interactiveshell import \
                TerminalInteractiveShell
            self.shell = TerminalInteractiveShell.instance()
            # needed by any code which calls __import__("__main__") after
            # the debugger was entered. See also #9941.
            sys.modules['__main__'] = save_main 

        if color_scheme is not None:
            warnings.warn(
                "The `color_scheme` argument is deprecated since version 5.1",
                DeprecationWarning, stacklevel=2)
        else:
            color_scheme = self.shell.colors

        self.aliases = {}

        # Create color table: we copy the default one from the traceback
        # module and add a few attributes needed for debugging
        self.color_scheme_table = exception_colors()

        # shorthands
        C = coloransi.TermColors
        cst = self.color_scheme_table

        cst['NoColor'].colors.prompt = C.NoColor
        cst['NoColor'].colors.breakpoint_enabled = C.NoColor