重要

本文档涵盖 IPython 6.0 及更高版本。从 6.0 版本开始，IPython 不再支持与低于 3.3 的 Python 版本（包括所有版本的 Python 2.7）的兼容性。

如果您正在寻找与 Python 2.7 兼容的 IPython 版本，请使用 IPython 5.x LTS 版本并参阅其文档（LTS 是长期支持版本）。

IPython 内核选项¶

这些选项可在 ipython_kernel_config.py 中使用。内核还遵循 ipython_config.py 中的任何选项

ConnectionFileMixin.connection_file¶

用于存储连接信息的 JSON 文件 [默认值：kernel-<pid>.json]

此文件将包含连接客户端到此内核所需的 IP、端口和身份验证密钥。默认情况下，此文件将在当前配置文件的安全目录中创建，但可以通过绝对路径指定。

特征类型:: Unicode

ConnectionFileMixin.control_port¶

设置控制 (ROUTER) 端口 [默认值：随机]

特征类型:: 整数
默认值:: 0

ConnectionFileMixin.hb_port¶

设置心跳端口 [默认值：随机]

特征类型:: 整数
默认值:: 0

ConnectionFileMixin.iopub_port¶

设置 iopub (PUB) 端口 [默认值：随机]

特征类型:: 整数
默认值:: 0

ConnectionFileMixin.ip¶

设置内核的 IP 地址 [默认值：localhost]。如果 IP 地址不是 localhost，则其他机器上的控制台将能够连接到内核，因此请小心！

特征类型:: Unicode

ConnectionFileMixin.shell_port¶

设置 shell (ROUTER) 端口 [默认值：随机]

特征类型:: 整数
默认值:: 0

ConnectionFileMixin.stdin_port¶

设置 stdin (ROUTER) 端口 [默认值：随机]

特征类型:: 整数
默认值:: 0

ConnectionFileMixin.transport¶

无描述

选项:: 'tcp', 'ipc'
默认值:: 'tcp'

InteractiveShellApp.code_to_run¶

执行给定的命令字符串。

特征类型:: Unicode
CLI 选项:: -c

InteractiveShellApp.exec_PYTHONSTARTUP¶

在 IPython 启动时运行 PYTHONSTARTUP 环境变量引用的文件。

特征类型:: 布尔值
默认值:: 真

InteractiveShellApp.exec_files¶

在 IPython 启动时运行的文件列表。

特征类型:: 列表

InteractiveShellApp.exec_lines¶

在 IPython 启动时运行的代码行。

特征类型:: 列表

InteractiveShellApp.extensions¶

要加载的 IPython 扩展的点模块名称列表。

特征类型:: 列表

InteractiveShellApp.extra_extensions¶

要加载的一个或多个 IPython 扩展的点模块名称。

用于在命令行上指定要加载的额外扩展。

在 7.10 版本中添加。

特征类型:: 列表
CLI 选项:: --ext

InteractiveShellApp.file_to_run¶

要运行的文件

特征类型:: Unicode

InteractiveShellApp.gui¶

启用 GUI 事件循环与以下任一内容的集成（‘asyncio’、‘glut’、‘gtk’、‘gtk2’、‘gtk3’、‘gtk4’、‘osx’、‘pyglet’、‘qt’、‘qt5’、‘qt6’、‘tk’、‘wx’、‘gtk2’、‘qt4’）。

选项:: 'asyncio', 'glut', 'gtk', 'gtk2', 'gtk3', 'gtk4', 'osx', 'pyglet', 'qt', 'qt5', 'qt6', 'tk', 'wx', 'gtk2', 'qt4'
CLI 选项:: --gui

InteractiveShellApp.hide_initial_ns¶

是否在启动时加载的变量（通过启动文件、exec_lines 等）对 %who？之类的工具隐藏？

特征类型:: 布尔值
默认值:: 真

InteractiveShellApp.ignore_cwd¶

如果为真，IPython 不会将当前工作目录添加到 sys.path。如果为假，则将当前工作目录添加到 sys.path，允许导入在当前目录中定义的模块。

特征类型:: 布尔值
默认值:: 假
CLI 选项:: --ignore-cwd

InteractiveShellApp.matplotlib¶

使用默认 matplotlib 后端配置 matplotlib 以进行交互式使用。可用的确切选项取决于 Matplotlib 在运行时的提供内容。

选项:: 'agg', 'auto', 'cairo', 'gtk3', 'gtk3agg', 'gtk3cairo', 'gtk4', 'gtk4agg', 'gtk4cairo', 'inline', 'macosx', 'nbagg', 'notebook', 'osx', 'pdf', 'pgf', 'ps', 'qt', 'qt5', 'qt5agg', 'qt5cairo', 'qt6', 'qtagg', 'qtcairo', 'svg', 'template', 'tk', 'tkagg', 'tkcairo', 'webagg', 'wx', <
CLI 选项:: --matplotlib

InteractiveShellApp.module_to_run¶

以脚本形式运行模块。

特征类型:: Unicode
CLI 选项:: -m

InteractiveShellApp.pylab¶

预加载 matplotlib 和 numpy 以供交互式使用，选择特定的 matplotlib 后端和循环集成。具体可用的选项取决于 Matplotlib 在运行时提供的选项。

选项:: 'agg', 'auto', 'cairo', 'gtk3', 'gtk3agg', 'gtk3cairo', 'gtk4', 'gtk4agg', 'gtk4cairo', 'inline', 'macosx', 'nbagg', 'notebook', 'osx', 'pdf', 'pgf', 'ps', 'qt', 'qt5', 'qt5agg', 'qt5cairo', 'qt6', 'qtagg', 'qtcairo', 'svg', 'template', 'tk', 'tkagg', 'tkcairo', 'webagg', 'wx', <
CLI 选项:: --pylab

InteractiveShellApp.pylab_import_all¶

如果为 true，IPython 将使用 numpy、pylab 等填充用户命名空间，并且在使用 pylab 模式时，将从 numpy 和 pylab 执行 import *。

如果为 False，pylab 模式不应将任何名称导入用户命名空间。

特征类型:: 布尔值
默认值:: 真

InteractiveShellApp.reraise_ipython_extension_failures¶

重新引发加载 IPython 扩展时遇到的异常？

特征类型:: 布尔值
默认值:: 假

Application.log_datefmt¶

用于 %(asctime)s 的日志记录格式化程序使用的日期格式

特征类型:: Unicode
默认值:: '%Y-%m-%d %H:%M:%S'

Application.log_format¶

日志记录格式模板

特征类型:: Unicode
默认值:: '[%(name)s]%(highlevel)s %(message)s'

Application.log_level¶

按值或名称设置日志级别。

选项:: 0, 10, 20, 30, 40, 50, 'DEBUG', 'INFO', 'WARN', 'ERROR', 'CRITICAL'
默认值:: 30
CLI 选项:: --log-level

Application.logging_config¶

配置其他日志处理程序。

默认的 stderr 日志处理程序由 log_level、log_datefmt 和 log_format 设置配置。

此配置可用于配置其他处理程序（例如，将日志输出到文件）或更精细地控制默认处理程序。

如果提供，这应为日志记录配置字典，有关更多信息，请参阅：https://docs.pythonlang.cn/3/library/logging.config.html#logging-config-dictschema

此字典与定义以下内容的基本日志记录配置合并

一个名为 console 的、用于交互式使用的日志记录格式化程序。
一个名为 console 的、写入 stderr 的日志记录处理程序，它使用格式化程序 console。
将此应用程序的名称设置为 DEBUG 级的记录器。

此示例添加了一个写入文件的新处理程序

c.Application.logging_config = {
    "handlers": {
        "file": {
            "class": "logging.FileHandler",
            "level": "DEBUG",
            "filename": "<path/to/file>",
        }
    },
    "loggers": {
        "<application-name>": {
            "level": "DEBUG",
            # NOTE: if you don't list the default "console"
            # handler here then it will be disabled
            "handlers": ["console", "file"],
        },
    },
}

特征类型:: 字典

Application.show_config¶

不启动应用程序，将配置转储到 stdout

特征类型:: 布尔值
默认值:: 假
CLI 选项:: --show-config

Application.show_config_json¶

不启动应用程序，将配置转储到 stdout（作为 JSON）

特征类型:: 布尔值
默认值:: 假
CLI 选项:: --show-config-json

BaseIPythonApplication.add_ipython_dir_to_sys_path¶

无描述

特征类型:: 布尔值
默认值:: 假

BaseIPythonApplication.auto_create¶

如果不存在，是否创建配置文件目录

特征类型:: 布尔值
默认值:: 假

BaseIPythonApplication.copy_config_files¶

是否将默认配置文件安装到配置文件目录中。如果正在创建新配置文件，并且 IPython 包含该配置文件的配置文件，则它们将被暂存到新目录中。否则，将自动生成默认配置文件。

特征类型:: 布尔值
默认值:: 假

BaseIPythonApplication.extra_config_file¶

要加载的额外配置文件的路径。

如果指定，则加载此配置文件以及任何其他 IPython 配置。

特征类型:: Unicode
CLI 选项:: --config

BaseIPythonApplication.ipython_dir¶

IPython 目录的名称。此目录用于记录配置（通过配置文件）、历史记录存储等。默认值通常为 $HOME/.ipython。此选项还可以通过环境变量 IPYTHONDIR 指定。

特征类型:: Unicode
CLI 选项:: --ipython-dir

BaseIPythonApplication.log_datefmt¶

用于 %(asctime)s 的日志记录格式化程序使用的日期格式

特征类型:: Unicode
默认值:: '%Y-%m-%d %H:%M:%S'

BaseIPythonApplication.log_format¶

日志记录格式模板

特征类型:: Unicode
默认值:: '[%(name)s]%(highlevel)s %(message)s'

BaseIPythonApplication.log_level¶

按值或名称设置日志级别。

选项:: 0, 10, 20, 30, 40, 50, 'DEBUG', 'INFO', 'WARN', 'ERROR', 'CRITICAL'
默认值:: 30

BaseIPythonApplication.logging_config¶

配置其他日志处理程序。

默认的 stderr 日志处理程序由 log_level、log_datefmt 和 log_format 设置配置。

此配置可用于配置其他处理程序（例如，将日志输出到文件）或更精细地控制默认处理程序。

如果提供，这应为日志记录配置字典，有关更多信息，请参阅：https://docs.pythonlang.cn/3/library/logging.config.html#logging-config-dictschema

此字典与定义以下内容的基本日志记录配置合并

一个名为 console 的、用于交互式使用的日志记录格式化程序。
一个名为 console 的、写入 stderr 的日志记录处理程序，它使用格式化程序 console。
将此应用程序的名称设置为 DEBUG 级的记录器。

此示例添加了一个写入文件的新处理程序

c.Application.logging_config = {
    "handlers": {
        "file": {
            "class": "logging.FileHandler",
            "level": "DEBUG",
            "filename": "<path/to/file>",
        }
    },
    "loggers": {
        "<application-name>": {
            "level": "DEBUG",
            # NOTE: if you don't list the default "console"
            # handler here then it will be disabled
            "handlers": ["console", "file"],
        },
    },
}

特征类型:: 字典

BaseIPythonApplication.overwrite¶

复制时是否覆盖现有配置文件

特征类型:: 布尔值
默认值:: 假

BaseIPythonApplication.profile¶

要使用的 IPython 配置文件。

特征类型:: Unicode
默认值:: 'default'
CLI 选项:: --profile

BaseIPythonApplication.show_config¶

不启动应用程序，将配置转储到 stdout

特征类型:: 布尔值
默认值:: 假

BaseIPythonApplication.show_config_json¶

不启动应用程序，将配置转储到 stdout（作为 JSON）

特征类型:: 布尔值
默认值:: 假

BaseIPythonApplication.verbose_crash¶

当 IPython 遇到可能为内部错误时，创建大量崩溃报告。默认情况下，将短消息追加到通常的回溯中

特征类型:: 布尔值
默认值:: 假

IPKernelApp.add_ipython_dir_to_sys_path¶

无描述

特征类型:: 布尔值
默认值:: 假

IPKernelApp.auto_create¶

如果不存在，是否创建配置文件目录

特征类型:: 布尔值
默认值:: 假

IPKernelApp.capture_fd_output¶

尝试捕获和转发低级输出，例如由扩展库生成的输出。

特征类型:: 布尔值
默认值:: 真

IPKernelApp.code_to_run¶

执行给定的命令字符串。

特征类型:: Unicode

IPKernelApp.connection_file¶

用于存储连接信息的 JSON 文件 [默认值：kernel-<pid>.json]

此文件将包含连接客户端到此内核所需的 IP、端口和身份验证密钥。默认情况下，此文件将在当前配置文件的安全目录中创建，但可以通过绝对路径指定。

特征类型:: Unicode
CLI 选项:: -f

IPKernelApp.control_port¶

设置控制 (ROUTER) 端口 [默认值：随机]

特征类型:: 整数
默认值:: 0
CLI 选项:: --control

IPKernelApp.copy_config_files¶

是否将默认配置文件安装到配置文件目录中。如果正在创建新配置文件，并且 IPython 包含该配置文件的配置文件，则它们将被暂存到新目录中。否则，将自动生成默认配置文件。

特征类型:: 布尔值
默认值:: 假

IPKernelApp.displayhook_class¶

DisplayHook 工厂的 importstring

特征类型:: DottedObjectName
默认值:: 'ipykernel.displayhook.ZMQDisplayHook'

IPKernelApp.exec_PYTHONSTARTUP¶

在 IPython 启动时运行 PYTHONSTARTUP 环境变量引用的文件。

特征类型:: 布尔值
默认值:: 真

IPKernelApp.exec_files¶

在 IPython 启动时运行的文件列表。

特征类型:: 列表

IPKernelApp.exec_lines¶

在 IPython 启动时运行的代码行。

特征类型:: 列表

IPKernelApp.extensions¶

要加载的 IPython 扩展的点模块名称列表。

特征类型:: 列表

IPKernelApp.extra_config_file¶

要加载的额外配置文件的路径。

如果指定，则加载此配置文件以及任何其他 IPython 配置。

特征类型:: Unicode

IPKernelApp.extra_extensions¶

要加载的一个或多个 IPython 扩展的点模块名称。

用于在命令行上指定要加载的额外扩展。

在 7.10 版本中添加。

特征类型:: 列表

IPKernelApp.file_to_run¶

要运行的文件

特征类型:: Unicode

IPKernelApp.gui¶

启用 GUI 事件循环与以下任一内容的集成（‘asyncio’、‘glut’、‘gtk’、‘gtk2’、‘gtk3’、‘gtk4’、‘osx’、‘pyglet’、‘qt’、‘qt5’、‘qt6’、‘tk’、‘wx’、‘gtk2’、‘qt4’）。

选项:: 'asyncio', 'glut', 'gtk', 'gtk2', 'gtk3', 'gtk4', 'osx', 'pyglet', 'qt', 'qt5', 'qt6', 'tk', 'wx', 'gtk2', 'qt4'

IPKernelApp.hb_port¶

设置心跳端口 [默认值：随机]

特征类型:: 整数
默认值:: 0
CLI 选项:: --hb

IPKernelApp.hide_initial_ns¶

是否在启动时加载的变量（通过启动文件、exec_lines 等）对 %who？之类的工具隐藏？

特征类型:: 布尔值
默认值:: 真

IPKernelApp.ignore_cwd¶

如果为真，IPython 不会将当前工作目录添加到 sys.path。如果为假，则将当前工作目录添加到 sys.path，允许导入在当前目录中定义的模块。

特征类型:: 布尔值
默认值:: 假

IPKernelApp.interrupt¶

仅在 Windows 上使用当父进程发出信号时中断此进程。

特征类型:: 整数
默认值:: 0

IPKernelApp.iopub_port¶

设置 iopub (PUB) 端口 [默认值：随机]

特征类型:: 整数
默认值:: 0
CLI 选项:: --iopub

IPKernelApp.ip¶

设置内核的 IP 地址 [默认值：localhost]。如果 IP 地址不是 localhost，则其他机器上的控制台将能够连接到内核，因此请小心！

特征类型:: Unicode
CLI 选项:: --ip

IPKernelApp.ipython_dir¶

IPython 目录的名称。此目录用于记录配置（通过配置文件）、历史记录存储等。默认值通常为 $HOME/.ipython。此选项还可以通过环境变量 IPYTHONDIR 指定。

特征类型:: Unicode

IPKernelApp.kernel_class¶

要使用的内核子类。

这应该允许轻松重复使用 IPKernelApp 入口点来配置和启动除 IPython 自身之外的内核。

特征类型:: 类型
默认值:: 'ipykernel.ipkernel.IPythonKernel'

IPKernelApp.log_datefmt¶

用于 %(asctime)s 的日志记录格式化程序使用的日期格式

特征类型:: Unicode
默认值:: '%Y-%m-%d %H:%M:%S'

IPKernelApp.log_format¶

日志记录格式模板

特征类型:: Unicode
默认值:: '[%(name)s]%(highlevel)s %(message)s'

IPKernelApp.log_level¶

按值或名称设置日志级别。

选项:: 0, 10, 20, 30, 40, 50, 'DEBUG', 'INFO', 'WARN', 'ERROR', 'CRITICAL'
默认值:: 30

IPKernelApp.logging_config¶

配置其他日志处理程序。

默认的 stderr 日志处理程序由 log_level、log_datefmt 和 log_format 设置配置。

此配置可用于配置其他处理程序（例如，将日志输出到文件）或更精细地控制默认处理程序。

如果提供，这应为日志记录配置字典，有关更多信息，请参阅：https://docs.pythonlang.cn/3/library/logging.config.html#logging-config-dictschema

此字典与定义以下内容的基本日志记录配置合并

一个名为 console 的、用于交互式使用的日志记录格式化程序。
一个名为 console 的、写入 stderr 的日志记录处理程序，它使用格式化程序 console。
将此应用程序的名称设置为 DEBUG 级的记录器。

此示例添加了一个写入文件的新处理程序

c.Application.logging_config = {
    "handlers": {
        "file": {
            "class": "logging.FileHandler",
            "level": "DEBUG",
            "filename": "<path/to/file>",
        }
    },
    "loggers": {
        "<application-name>": {
            "level": "DEBUG",
            # NOTE: if you don't list the default "console"
            # handler here then it will be disabled
            "handlers": ["console", "file"],
        },
    },
}

特征类型:: 字典

IPKernelApp.matplotlib¶

使用默认 matplotlib 后端配置 matplotlib 以进行交互式使用。可用的确切选项取决于 Matplotlib 在运行时的提供内容。

选项:: 'agg', 'auto', 'cairo', 'gtk3', 'gtk3agg', 'gtk3cairo', 'gtk4', 'gtk4agg', 'gtk4cairo', 'inline', 'macosx', 'nbagg', 'notebook', 'osx', 'pdf', 'pgf', 'ps', 'qt', 'qt5', 'qt5agg', 'qt5cairo', 'qt6', 'qtagg', 'qtcairo', 'svg', 'template', 'tk', 'tkagg', 'tkcairo', 'webagg', 'wx', <

IPKernelApp.module_to_run¶

以脚本形式运行模块。

特征类型:: Unicode

IPKernelApp.no_stderr¶

将 stderr 重定向到空设备

特征类型:: 布尔值
默认值:: 假
CLI 选项:: --no-stderr

IPKernelApp.no_stdout¶

将 stdout 重定向到空设备

特征类型:: 布尔值
默认值:: 假
CLI 选项:: --no-stdout

IPKernelApp.outstream_class¶

OutStream 工厂的 importstring

特征类型:: DottedObjectName
默认值:: 'ipykernel.iostream.OutStream'

IPKernelApp.overwrite¶

复制时是否覆盖现有配置文件

特征类型:: 布尔值
默认值:: 假

IPKernelApp.parent_handle¶

如果其父进程死亡，则终止此进程。在 Windows 中，该参数指定父进程的 HANDLE，否则它只是一个布尔值。

特征类型:: 整数
默认值:: 0

IPKernelApp.profile¶

要使用的 IPython 配置文件。

特征类型:: Unicode
默认值:: 'default'

IPKernelApp.pylab¶

预加载 matplotlib 和 numpy 以供交互式使用，选择特定的 matplotlib 后端和循环集成。具体可用的选项取决于 Matplotlib 在运行时提供的选项。

选项:: 'agg', 'auto', 'cairo', 'gtk3', 'gtk3agg', 'gtk3cairo', 'gtk4', 'gtk4agg', 'gtk4cairo', 'inline', 'macosx', 'nbagg', 'notebook', 'osx', 'pdf', 'pgf', 'ps', 'qt', 'qt5', 'qt5agg', 'qt5cairo', 'qt6', 'qtagg', 'qtcairo', 'svg', 'template', 'tk', 'tkagg', 'tkcairo', 'webagg', 'wx', <

IPKernelApp.pylab_import_all¶

如果为 true，IPython 将使用 numpy、pylab 等填充用户命名空间，并且在使用 pylab 模式时，将从 numpy 和 pylab 执行 import *。

如果为 False，pylab 模式不应将任何名称导入用户命名空间。

特征类型:: 布尔值
默认值:: 真

IPKernelApp.quiet¶

仅将 stdout/stderr 发送到输出流

特征类型:: 布尔值
默认值:: 真

IPKernelApp.reraise_ipython_extension_failures¶

重新引发加载 IPython 扩展时遇到的异常？

特征类型:: 布尔值
默认值:: 假

IPKernelApp.shell_port¶

设置 shell (ROUTER) 端口 [默认值：随机]

特征类型:: 整数
默认值:: 0
CLI 选项:: --shell

IPKernelApp.show_config¶

不启动应用程序，将配置转储到 stdout

特征类型:: 布尔值
默认值:: 假

IPKernelApp.show_config_json¶

不启动应用程序，将配置转储到 stdout（作为 JSON）

特征类型:: 布尔值
默认值:: 假

IPKernelApp.stdin_port¶

设置 stdin (ROUTER) 端口 [默认值：随机]

特征类型:: 整数
默认值:: 0
CLI 选项:: --stdin

IPKernelApp.transport¶

无描述

选项:: 'tcp', 'ipc'
默认值:: 'tcp'
CLI 选项:: --transport

IPKernelApp.trio_loop¶

设置主事件循环。

特征类型:: 布尔值
默认值:: 假

IPKernelApp.verbose_crash¶

当 IPython 遇到可能为内部错误时，创建大量崩溃报告。默认情况下，将短消息追加到通常的回溯中

特征类型:: 布尔值
默认值:: 假

Kernel._darwin_app_nap¶

是否使用 appnope 以兼容 OS X App Nap。

仅影响 OS X >= 10.9。

特征类型:: 布尔值
默认值:: 真

Kernel._execute_sleep¶

无描述

特征类型:: 浮点数
默认值:: 0.0005

Kernel._poll_interval¶

无描述

特征类型:: 浮点数
默认值:: 0.01

Kernel.debug_just_my_code¶

如果您想调试 Python 标准库和依赖库，请将其设置为 False。

特征类型:: 布尔值
默认值:: 真

Kernel.stop_on_error_timeout¶

在错误后中止排队请求时等待消息到达的时间（以秒为单位）。

在错误后在此窗口内到达的请求将被取消。

在异常缓慢的网络导致重大延迟的情况下增加，这可能表现为例如笔记本中的“全部运行”在错误后中止部分（但不是全部）消息。

特征类型:: 浮点数
默认值:: 0.0

IPythonKernel._darwin_app_nap¶

是否使用 appnope 以兼容 OS X App Nap。

仅影响 OS X >= 10.9。

特征类型:: 布尔值
默认值:: 真

IPythonKernel._execute_sleep¶

无描述

特征类型:: 浮点数
默认值:: 0.0005

IPythonKernel._poll_interval¶

无描述

特征类型:: 浮点数
默认值:: 0.01

IPythonKernel.debug_just_my_code¶

如果您想调试 Python 标准库和依赖库，请将其设置为 False。

特征类型:: 布尔值
默认值:: 真

IPythonKernel.help_links¶

无描述

特征类型:: 列表

IPythonKernel.stop_on_error_timeout¶

在错误后中止排队请求时等待消息到达的时间（以秒为单位）。

在错误后在此窗口内到达的请求将被取消。

在异常缓慢的网络导致重大延迟的情况下增加，这可能表现为例如笔记本中的“全部运行”在错误后中止部分（但不是全部）消息。

特征类型:: 浮点数
默认值:: 0.0

IPythonKernel.use_experimental_completions¶

将此标志设置为 False 以停用使用实验性 IPython 完成 API。

特征类型:: 布尔值
默认值:: 真

InteractiveShell.ast_node_interactivity¶

‘all’、‘last’、‘last_expr’或‘none’、‘last_expr_or_assign’，指定哪些节点应以交互方式运行（显示来自表达式的输出）。

选项:: 'all'、'last'、'last_expr'、'none'、'last_expr_or_assign'
默认值:: 'last_expr'

InteractiveShell.ast_transformers¶

ast.NodeTransformer 子类实例的列表，它将在运行代码之前应用于用户输入。

特征类型:: 列表

InteractiveShell.autoawait¶

在顶层 REPL 中自动运行 await 语句。

特征类型:: 布尔值
默认值:: 真

InteractiveShell.autocall¶

即使您没有键入显式括号，也让 IPython 自动调用任何可调用对象。例如，“str 43”将自动变为“str(43)”。该值可以为“0”以禁用该功能，“1”表示“智能”自动调用，如果行中没有更多参数则不应用该功能，以及“2”表示“完全”自动调用，其中所有可调用对象都会自动调用（即使没有参数）。

选项:: 0, 1, 2
默认值:: 0
CLI 选项:: --autocall

InteractiveShell.autoindent¶

自动缩进交互式输入的 IPython 代码。

特征类型:: 布尔值
默认值:: 真
CLI 选项:: --autoindent

InteractiveShell.automagic¶

启用在不使用前导 % 的情况下调用魔术命令。

特征类型:: 布尔值
默认值:: 真
CLI 选项:: --automagic

InteractiveShell.banner1¶

在配置文件之前打印的横幅部分

特征类型:: Unicode
默认值:: "Python 3.11.9 (main, Jun 18 2024, 09:40:25) [GCC 11.4.0]\\nTy...

InteractiveShell.banner2¶

在配置文件之后打印的横幅部分

特征类型:: Unicode

InteractiveShell.cache_size¶

设置输出缓存的大小。默认值为 1000，您可以在配置文件中永久更改它。将其设置为 0 将完全禁用缓存系统，接受的最小值为 3（如果您提供的值小于 3，则将其重置为 0 并发出警告）。定义此限制是因为否则您将花费更多时间重新刷新过小的缓存，而不是工作

特征类型:: 整数
默认值:: 1000
CLI 选项:: --cache-size

InteractiveShell.color_info¶

使用颜色显示有关对象的信息。由于此信息通过分页器（如“less”）传递，并且一些分页器会与颜色代码混淆，因此可以关闭此功能。

特征类型:: 布尔值
默认值:: 真
CLI 选项:: --color-info

InteractiveShell.colors¶

设置配色方案（NoColor、Neutral、Linux 或 LightBG）。

选项:: 'Neutral', 'NoColor', 'LightBG', 'Linux'
默认值:: 'Neutral'
CLI 选项:: --colors

InteractiveShell.debug¶

无描述

特征类型:: 布尔值
默认值:: 假

InteractiveShell.disable_failing_post_execute¶

不调用过去失败的后执行函数。

特征类型:: 布尔值
默认值:: 假

InteractiveShell.display_page¶

如果为 True，将传递给分页器的任何内容都将显示为常规输出。

特征类型:: 布尔值
默认值:: 假

InteractiveShell.enable_html_pager¶

(临时 API) 启用发送到分页器的 mime 捆绑包中的 html 表示。

特征类型:: 布尔值
默认值:: 假

InteractiveShell.history_length¶

命令历史记录的总长度

特征类型:: 整数
默认值:: 10000

InteractiveShell.history_load_length¶

在启动时加载到历史记录缓冲区中的已保存历史记录条目的数量。

特征类型:: 整数
默认值:: 1000

InteractiveShell.inspector_class¶

用于实例化 shell 检查器的类

特征类型:: 类型
默认值:: 'IPython.core.oinspect.Inspector'

InteractiveShell.ipython_dir¶

无描述

特征类型:: Unicode

InteractiveShell.logappend¶

在追加模式下开始记录到给定文件。使用 logfile 指定要覆盖日志的日志文件。

特征类型:: Unicode
CLI 选项:: --logappend

InteractiveShell.logfile¶

要使用的日志文件的名称。

特征类型:: Unicode
CLI 选项:: --logfile

InteractiveShell.logstart¶

在覆盖模式下开始记录到默认日志文件。使用 logappend 指定要追加日志的日志文件。

特征类型:: 布尔值
默认值:: 假

InteractiveShell.loop_runner¶

选择将用于执行顶级异步代码的循环运行器

特征类型:: 任意
默认值:: 'IPython.core.interactiveshell._asyncio_runner'

InteractiveShell.object_info_string_level¶

无描述

选项:: 0, 1, 2
默认值:: 0

InteractiveShell.pdb¶

在每次异常后自动调用 pdb 调试器。

特征类型:: 布尔值
默认值:: 假
CLI 选项:: --pdb

InteractiveShell.quiet¶

无描述

特征类型:: 布尔值
默认值:: 假

InteractiveShell.separate_in¶

无描述

特征类型:: SeparateUnicode
默认值:: '\\n'

InteractiveShell.separate_out¶

无描述

特征类型:: SeparateUnicode

InteractiveShell.separate_out2¶

无描述

特征类型:: SeparateUnicode

InteractiveShell.show_rewritten_input¶

显示重写的输入，例如自动调用。

特征类型:: 布尔值
默认值:: 真

InteractiveShell.sphinxify_docstring¶

启用文档字符串的丰富 html 表示。（这需要 docrepr 模块）。

特征类型:: 布尔值
默认值:: 假

InteractiveShell.warn_venv¶

如果在没有安装 IPython 的虚拟环境中运行，则发出警告（因此使用的是全局环境中的 IPython）。

特征类型:: 布尔值
默认值:: 真

InteractiveShell.wildcards_case_sensitive¶

无描述

特征类型:: 布尔值
默认值:: 真

InteractiveShell.xmode¶

切换 IPython 异常处理程序的模式。

选项:: 'Context', 'Plain', 'Verbose', 'Minimal'
默认值:: 'Context'

ZMQInteractiveShell.ast_node_interactivity¶

‘all’、‘last’、‘last_expr’或‘none’、‘last_expr_or_assign’，指定哪些节点应以交互方式运行（显示来自表达式的输出）。

选项:: 'all'、'last'、'last_expr'、'none'、'last_expr_or_assign'
默认值:: 'last_expr'

ZMQInteractiveShell.ast_transformers¶

ast.NodeTransformer 子类实例的列表，它将在运行代码之前应用于用户输入。

特征类型:: 列表

ZMQInteractiveShell.autoawait¶

在顶层 REPL 中自动运行 await 语句。

特征类型:: 布尔值
默认值:: 真

ZMQInteractiveShell.autocall¶

即使您没有键入显式括号，也让 IPython 自动调用任何可调用对象。例如，“str 43”将自动变为“str(43)”。该值可以为“0”以禁用该功能，“1”表示“智能”自动调用，如果行中没有更多参数则不应用该功能，以及“2”表示“完全”自动调用，其中所有可调用对象都会自动调用（即使没有参数）。

选项:: 0, 1, 2
默认值:: 0

ZMQInteractiveShell.automagic¶

启用在不使用前导 % 的情况下调用魔术命令。

特征类型:: 布尔值
默认值:: 真

ZMQInteractiveShell.banner1¶

在配置文件之前打印的横幅部分

特征类型:: Unicode
默认值:: "Python 3.11.9 (main, Jun 18 2024, 09:40:25) [GCC 11.4.0]\\nTy...

ZMQInteractiveShell.banner2¶

在配置文件之后打印的横幅部分

特征类型:: Unicode

ZMQInteractiveShell.cache_size¶

设置输出缓存的大小。默认值为 1000，您可以在配置文件中永久更改它。将其设置为 0 将完全禁用缓存系统，接受的最小值为 3（如果您提供的值小于 3，则将其重置为 0 并发出警告）。定义此限制是因为否则您将花费更多时间重新刷新过小的缓存，而不是工作

特征类型:: 整数
默认值:: 1000

ZMQInteractiveShell.color_info¶

使用颜色显示有关对象的信息。由于此信息通过分页器（如“less”）传递，并且一些分页器会与颜色代码混淆，因此可以关闭此功能。

特征类型:: 布尔值
默认值:: 真

ZMQInteractiveShell.colors¶

设置配色方案（NoColor、Neutral、Linux 或 LightBG）。

选项:: 'Neutral', 'NoColor', 'LightBG', 'Linux'
默认值:: 'Neutral'

ZMQInteractiveShell.debug¶

无描述

特征类型:: 布尔值
默认值:: 假

ZMQInteractiveShell.disable_failing_post_execute¶

不调用过去失败的后执行函数。

特征类型:: 布尔值
默认值:: 假

ZMQInteractiveShell.display_page¶

如果为 True，将传递给分页器的任何内容都将显示为常规输出。

特征类型:: 布尔值
默认值:: 假

ZMQInteractiveShell.enable_html_pager¶

(临时 API) 启用发送到分页器的 mime 捆绑包中的 html 表示。

特征类型:: 布尔值
默认值:: 假

ZMQInteractiveShell.history_length¶

命令历史记录的总长度

特征类型:: 整数
默认值:: 10000

ZMQInteractiveShell.history_load_length¶

在启动时加载到历史记录缓冲区中的已保存历史记录条目的数量。

特征类型:: 整数
默认值:: 1000

ZMQInteractiveShell.inspector_class¶

用于实例化 shell 检查器的类

特征类型:: 类型
默认值:: 'IPython.core.oinspect.Inspector'

ZMQInteractiveShell.ipython_dir¶

无描述

特征类型:: Unicode

ZMQInteractiveShell.logappend¶

在追加模式下开始记录到给定文件。使用 logfile 指定要覆盖日志的日志文件。

特征类型:: Unicode

ZMQInteractiveShell.logfile¶

要使用的日志文件的名称。

特征类型:: Unicode

ZMQInteractiveShell.logstart¶

在覆盖模式下开始记录到默认日志文件。使用 logappend 指定要追加日志的日志文件。

特征类型:: 布尔值
默认值:: 假

ZMQInteractiveShell.loop_runner¶

选择将用于执行顶级异步代码的循环运行器

特征类型:: 任意
默认值:: 'IPython.core.interactiveshell._asyncio_runner'

ZMQInteractiveShell.object_info_string_level¶

无描述

选项:: 0, 1, 2
默认值:: 0

ZMQInteractiveShell.pdb¶

在每次异常后自动调用 pdb 调试器。

特征类型:: 布尔值
默认值:: 假

ZMQInteractiveShell.quiet¶

无描述

特征类型:: 布尔值
默认值:: 假

ZMQInteractiveShell.separate_in¶

无描述

特征类型:: SeparateUnicode
默认值:: '\\n'

ZMQInteractiveShell.separate_out¶

无描述

特征类型:: SeparateUnicode

ZMQInteractiveShell.separate_out2¶

无描述

特征类型:: SeparateUnicode

ZMQInteractiveShell.show_rewritten_input¶

显示重写的输入，例如自动调用。

特征类型:: 布尔值
默认值:: 真

ZMQInteractiveShell.sphinxify_docstring¶

启用文档字符串的丰富 html 表示。（这需要 docrepr 模块）。

特征类型:: 布尔值
默认值:: 假

ZMQInteractiveShell.warn_venv¶

如果在没有安装 IPython 的虚拟环境中运行，则发出警告（因此使用的是全局环境中的 IPython）。

特征类型:: 布尔值
默认值:: 真

ZMQInteractiveShell.wildcards_case_sensitive¶

无描述

特征类型:: 布尔值
默认值:: 真

ZMQInteractiveShell.xmode¶

切换 IPython 异常处理程序的模式。

选项:: 'Context', 'Plain', 'Verbose', 'Minimal'
默认值:: 'Context'

ProfileDir.location¶

直接设置配置文件位置。这将覆盖 profile 选项所使用的逻辑。

特征类型:: Unicode
CLI 选项:: --profile-dir

Session.buffer_threshold¶

超出该阈值（以字节为单位）时，应提取对象的缓冲区以避免序列化。

特征类型:: 整数
默认值:: 1024

Session.check_pid¶

是否检查 PID 以防止在 fork 后调用。

如果在其他地方处理了 fork 安全性，则可以禁用此检查。

特征类型:: 布尔值
默认值:: 真

Session.copy_threshold¶

超出该阈值（以字节为单位）时，应在不进行复制的情况下发送缓冲区。

特征类型:: 整数
默认值:: 65536

Session.debug¶

会话中的调试输出

特征类型:: 布尔值
默认值:: 假

Session.digest_history_size¶

要记住的最大摘要数。

当摘要历史记录超过此值时，将对其进行筛选。

特征类型:: 整数
默认值:: 65536

Session.item_threshold¶

容器要被内省以进行自定义序列化的最大项目数。大于此值的容器将直接被序列化。

特征类型:: 整数
默认值:: 64

Session.key¶

执行密钥，用于对消息进行签名。

特征类型:: CBytes
默认值:: b''

Session.keyfile¶

包含执行密钥的文件的路径。

特征类型:: Unicode
CLI 选项:: --keyfile

Session.metadata¶

元数据字典，用作每条消息的默认顶级元数据字典。

特征类型:: 字典

Session.packer¶

用于序列化消息的打包器的名称。应该是“json”、“pickle”或自定义可调用序列化器的导入名称之一。

特征类型:: DottedObjectName
默认值:: 'json'

Session.session¶

标识此会话的 UUID。

特征类型:: CUnicode
CLI 选项:: --ident

Session.signature_scheme¶

用于构建消息签名的摘要方案。必须采用“hmac-HASH”的形式。

特征类型:: Unicode
默认值:: 'hmac-sha256'

Session.unpacker¶

用于反序列化消息的解包器的名称。仅与 packer 的自定义函数一起使用。

特征类型:: DottedObjectName
默认值:: 'json'

Session.username¶

会话的用户名。默认值是您的系统用户名。

特征类型:: Unicode
默认值:: 'username'
CLI 选项:: --user