重要
本文档涵盖 IPython 6.0 及更高版本。从 6.0 版本开始,IPython 不再支持与低于 Python 3.3 的 Python 版本(包括所有版本的 Python 2.7)的兼容性。
如果您正在寻找与 Python 2.7 兼容的 IPython 版本,请使用 IPython 5.x LTS 版本并参考其文档(LTS 是长期支持版本)。
终端 IPython 选项¶
- InteractiveShellApp.code_to_run¶
执行给定的命令字符串。
- 特征类型:
Unicode
- CLI 选项:
-c
- InteractiveShellApp.exec_PYTHONSTARTUP¶
在 IPython 启动时运行 PYTHONSTARTUP 环境变量引用的文件。
- 特征类型:
布尔
- 默认:
True
- 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 等工具中?
- 特征类型:
布尔
- 默认:
True
- InteractiveShellApp.ignore_cwd¶
如果为 True,IPython 将不会将当前工作目录添加到 sys.path。如果为 False,当前工作目录将被添加到 sys.path,允许导入在当前目录中定义的模块。
- 特征类型:
布尔
- 默认:
False
- 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'
,'wx'
,'wxagg'
,'wxcairo'
- 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'
,'wx'
,'wxagg'
,'wxcairo'
- CLI 选项:
--pylab
- InteractiveShellApp.pylab_import_all¶
如果为 true,IPython 将使用 numpy、pylab 等填充用户命名空间,并且在使用 pylab 模式时,将从 numpy 和 pylab 执行
import *
。如果为 False,pylab 模式不应将任何名称导入用户命名空间。
- 特征类型:
布尔
- 默认:
True
- InteractiveShellApp.reraise_ipython_extension_failures¶
重新引发加载 IPython 扩展时遇到的异常?
- 特征类型:
布尔
- 默认:
False
- 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
- 特征类型:
布尔
- 默认:
False
- CLI 选项:
--show-config
- Application.show_config_json¶
不启动应用程序,而是将配置转储到 stdout(作为 JSON)
- 特征类型:
布尔
- 默认:
False
- CLI 选项:
--show-config-json
- BaseIPythonApplication.add_ipython_dir_to_sys_path¶
无说明
- 特征类型:
布尔
- 默认:
False
- BaseIPythonApplication.auto_create¶
如果不存在,是否创建配置文件目录
- 特征类型:
布尔
- 默认:
False
- BaseIPythonApplication.copy_config_files¶
是否将默认配置文件安装到配置文件目录中。如果正在创建新的配置文件,并且 IPython 包含该配置文件的配置文件,则它们将被暂存到新目录中。否则,将自动生成默认配置文件。
- 特征类型:
布尔
- 默认:
False
- 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¶
复制时是否覆盖现有的配置文件
- 特征类型:
布尔
- 默认:
False
- BaseIPythonApplication.profile¶
要使用的 IPython 配置文件。
- 特征类型:
Unicode
- 默认:
'default'
- CLI 选项:
--profile
- BaseIPythonApplication.show_config¶
不启动应用程序,而是将配置转储到 stdout
- 特征类型:
布尔
- 默认:
False
- BaseIPythonApplication.show_config_json¶
不启动应用程序,而是将配置转储到 stdout(作为 JSON)
- 特征类型:
布尔
- 默认:
False
- BaseIPythonApplication.verbose_crash¶
当 IPython 遇到可能是内部错误时,创建一个大规模崩溃报告。默认情况下,将一条简短消息附加到通常的回溯中
- 特征类型:
布尔
- 默认:
False
- TerminalIPythonApp.add_ipython_dir_to_sys_path¶
无说明
- 特征类型:
布尔
- 默认:
False
- TerminalIPythonApp.auto_create¶
无说明
- 特征类型:
布尔
- 默认:
True
- TerminalIPythonApp.code_to_run¶
执行给定的命令字符串。
- 特征类型:
Unicode
- TerminalIPythonApp.copy_config_files¶
是否将默认配置文件安装到配置文件目录中。如果正在创建新的配置文件,并且 IPython 包含该配置文件的配置文件,则它们将被暂存到新目录中。否则,将自动生成默认配置文件。
- 特征类型:
布尔
- 默认:
False
- TerminalIPythonApp.display_banner¶
启动 IPython 时是否显示横幅。
- 特征类型:
布尔
- 默认:
True
- CLI 选项:
--banner
- TerminalIPythonApp.exec_PYTHONSTARTUP¶
在 IPython 启动时运行 PYTHONSTARTUP 环境变量引用的文件。
- 特征类型:
布尔
- 默认:
True
- TerminalIPythonApp.exec_files¶
在 IPython 启动时运行的文件列表。
- 特征类型:
列表
- TerminalIPythonApp.exec_lines¶
在 IPython 启动时运行的代码行。
- 特征类型:
列表
- TerminalIPythonApp.extensions¶
要加载的 IPython 扩展的点模块名称列表。
- 特征类型:
列表
- TerminalIPythonApp.extra_config_file¶
要加载的额外配置文件的路径。
如果指定,则加载此配置文件以及任何其他 IPython 配置。
- 特征类型:
Unicode
- TerminalIPythonApp.extra_extensions¶
要加载的一个或多个 IPython 扩展的点模块名称。
用于在命令行上指定要加载的额外扩展。
在 7.10 版本中添加。
- 特征类型:
列表
- TerminalIPythonApp.file_to_run¶
要运行的文件
- 特征类型:
Unicode
- TerminalIPythonApp.force_interact¶
如果通过命令行给出了命令或文件,例如“ipython foo.py”,在执行文件或命令后启动交互式 shell。
- 特征类型:
布尔
- 默认:
False
- CLI 选项:
-i
- TerminalIPythonApp.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'
- TerminalIPythonApp.hide_initial_ns¶
在启动时加载的变量(通过启动文件、exec_lines 等)是否应隐藏在 %who 等工具中?
- 特征类型:
布尔
- 默认:
True
- TerminalIPythonApp.ignore_cwd¶
如果为 True,IPython 将不会将当前工作目录添加到 sys.path。如果为 False,当前工作目录将被添加到 sys.path,允许导入在当前目录中定义的模块。
- 特征类型:
布尔
- 默认:
False
- TerminalIPythonApp.interactive_shell_class¶
用于实例化 TerminalInteractiveShell 对象的类。对自定义前端很有用
- 特征类型:
类型
- 默认:
'IPython.terminal.interactiveshell.TerminalInteractiveShell'
- TerminalIPythonApp.ipython_dir¶
IPython 目录的名称。此目录用于记录配置(通过配置文件)、历史记录存储等。默认值通常为 $HOME/.ipython。此选项还可以通过环境变量 IPYTHONDIR 指定。
- 特征类型:
Unicode
- TerminalIPythonApp.log_datefmt¶
日志记录格式化程序用于 %(asctime)s 的日期格式
- 特征类型:
Unicode
- 默认:
'%Y-%m-%d %H:%M:%S'
- TerminalIPythonApp.log_format¶
日志记录格式模板
- 特征类型:
Unicode
- 默认:
'[%(name)s]%(highlevel)s %(message)s'
- TerminalIPythonApp.log_level¶
按值或名称设置日志记录级别。
- 选项:
0
,10
,20
,30
,40
,50
,'DEBUG'
,'INFO'
,'WARN'
,'ERROR'
,'CRITICAL'
- 默认:
30
- TerminalIPythonApp.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"], }, }, }
- 特征类型:
字典
- TerminalIPythonApp.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'
,'wx'
,'wxagg'
,'wxcairo'
- TerminalIPythonApp.module_to_run¶
将模块作为脚本运行。
- 特征类型:
Unicode
- TerminalIPythonApp.overwrite¶
复制时是否覆盖现有的配置文件
- 特征类型:
布尔
- 默认:
False
- TerminalIPythonApp.profile¶
要使用的 IPython 配置文件。
- 特征类型:
Unicode
- 默认:
'default'
- TerminalIPythonApp.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'
,'wx'
,'wxagg'
,'wxcairo'
- TerminalIPythonApp.pylab_import_all¶
如果为 true,IPython 将使用 numpy、pylab 等填充用户命名空间,并且在使用 pylab 模式时,将从 numpy 和 pylab 执行
import *
。如果为 False,pylab 模式不应将任何名称导入用户命名空间。
- 特征类型:
布尔
- 默认:
True
- TerminalIPythonApp.quick¶
通过跳过加载配置文件来快速启动 IPython。
- 特征类型:
布尔
- 默认:
False
- CLI 选项:
--quick
- TerminalIPythonApp.reraise_ipython_extension_failures¶
重新引发加载 IPython 扩展时遇到的异常?
- 特征类型:
布尔
- 默认:
False
- TerminalIPythonApp.show_config¶
不启动应用程序,而是将配置转储到 stdout
- 特征类型:
布尔
- 默认:
False
- TerminalIPythonApp.show_config_json¶
不启动应用程序,而是将配置转储到 stdout(作为 JSON)
- 特征类型:
布尔
- 默认:
False
- TerminalIPythonApp.verbose_crash¶
当 IPython 遇到可能是内部错误时,创建一个大规模崩溃报告。默认情况下,将一条简短消息附加到通常的回溯中
- 特征类型:
布尔
- 默认:
False
- 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 语句。
- 特征类型:
布尔
- 默认:
True
- InteractiveShell.autocall¶
即使您没有键入显式括号,也让 IPython 自动调用任何可调用对象。例如,‘str 43’ 会自动变成 ‘str(43)’。该值可以是‘0’以禁用此功能,‘1’表示‘智能’自动调用,如果行中没有更多参数,则不应用;‘2’表示‘完全’自动调用,其中所有可调用对象都会自动调用(即使没有参数)。
- 选项:
0
,1
,2
- 默认:
0
- CLI 选项:
--autocall
- InteractiveShell.autoindent¶
自动缩进以交互方式输入的 IPython 代码。
- 特征类型:
布尔
- 默认:
True
- CLI 选项:
--autoindent
- InteractiveShell.automagic¶
启用魔术命令,无需前导 % 即可调用。
- 特征类型:
布尔
- 默认:
True
- 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”)传递的,并且一些分页器会与颜色代码混淆,因此可以关闭此功能。
- 特征类型:
布尔
- 默认:
True
- CLI 选项:
--color-info
- InteractiveShell.colors¶
设置配色方案(NoColor、Neutral、Linux 或 LightBG)。
- 选项:
'Neutral'
,'NoColor'
,'LightBG'
,'Linux'
- 默认:
'Neutral'
- CLI 选项:
--colors
- InteractiveShell.debug¶
无说明
- 特征类型:
布尔
- 默认:
False
- InteractiveShell.disable_failing_post_execute¶
不要调用过去失败的后执行函数。
- 特征类型:
布尔
- 默认:
False
- InteractiveShell.display_page¶
如果为 True,则将传递给分页器的任何内容都将显示为常规输出。
- 特征类型:
布尔
- 默认:
False
- InteractiveShell.enable_html_pager¶
(临时 API)启用发送到分页器的 MIME 捆绑包中的 HTML 表示形式。
- 特征类型:
布尔
- 默认:
False
- 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
指定要将日志追加到的日志文件。- 特征类型:
布尔
- 默认:
False
- InteractiveShell.loop_runner¶
选择将用于执行顶级异步代码的循环运行器
- 特征类型:
任何
- 默认:
'IPython.core.interactiveshell._asyncio_runner'
- InteractiveShell.object_info_string_level¶
无说明
- 选项:
0
,1
,2
- 默认:
0
- InteractiveShell.pdb¶
在每次异常后自动调用 pdb 调试器。
- 特征类型:
布尔
- 默认:
False
- CLI 选项:
--pdb
- InteractiveShell.quiet¶
无说明
- 特征类型:
布尔
- 默认:
False
- InteractiveShell.separate_in¶
无说明
- 特征类型:
SeparateUnicode
- 默认:
'\\n'
- InteractiveShell.separate_out¶
无说明
- 特征类型:
SeparateUnicode
- InteractiveShell.separate_out2¶
无说明
- 特征类型:
SeparateUnicode
- InteractiveShell.show_rewritten_input¶
显示重写的输入,例如自动调用。
- 特征类型:
布尔
- 默认:
True
- InteractiveShell.sphinxify_docstring¶
启用文档字符串的丰富 html 表示。(这需要 docrepr 模块)。
- 特征类型:
布尔
- 默认:
False
- InteractiveShell.warn_venv¶
如果在未安装 IPython 的虚拟环境中运行,则发出警告(因此使用全局环境中的 IPython)。
- 特征类型:
布尔
- 默认:
True
- InteractiveShell.wildcards_case_sensitive¶
无说明
- 特征类型:
布尔
- 默认:
True
- InteractiveShell.xmode¶
切换 IPython 异常处理程序的模式。
- 选项:
'Context'
,'Plain'
,'Verbose'
,'Minimal'
- 默认:
'Context'
- TerminalInteractiveShell.ast_node_interactivity¶
‘all’、‘last’、‘last_expr’或‘none’、‘last_expr_or_assign’,指定哪些节点应以交互方式运行(显示表达式的输出)。
- 选项:
'all'
、'last'
、'last_expr'
、'none'
、'last_expr_or_assign'
- 默认:
'last_expr'
- TerminalInteractiveShell.ast_transformers¶
ast.NodeTransformer 子类实例的列表,在运行代码之前,这些实例将应用于用户输入。
- 特征类型:
列表
- TerminalInteractiveShell.auto_match¶
在输入/删除左括号或引号时自动添加/删除右括号或引号。括号:()、[]、{} 引号:‘’、“”
- 特征类型:
布尔
- 默认:
False
- TerminalInteractiveShell.autoawait¶
在顶级 repl 中自动运行 await 语句。
- 特征类型:
布尔
- 默认:
True
- TerminalInteractiveShell.autocall¶
即使您没有键入显式括号,也让 IPython 自动调用任何可调用对象。例如,‘str 43’ 会自动变成 ‘str(43)’。该值可以是‘0’以禁用此功能,‘1’表示‘智能’自动调用,如果行中没有更多参数,则不应用;‘2’表示‘完全’自动调用,其中所有可调用对象都会自动调用(即使没有参数)。
- 选项:
0
,1
,2
- 默认:
0
- TerminalInteractiveShell.autoformatter¶
自动格式化程序,用于重新格式化终端代码。可以是
'black'
、'yapf'
或None
- 特征类型:
Unicode
- TerminalInteractiveShell.autoindent¶
自动缩进以交互方式输入的 IPython 代码。
- 特征类型:
布尔
- 默认:
True
- TerminalInteractiveShell.automagic¶
启用魔术命令,无需前导 % 即可调用。
- 特征类型:
布尔
- 默认:
True
- TerminalInteractiveShell.autosuggestions_provider¶
指定自动建议的来源。可以设置为
'NavigableAutoSuggestFromHistory'
(up 和 down 交换建议)、'AutoSuggestFromHistory'
或None
以禁用自动建议。默认值为'NavigableAutoSuggestFromHistory
’。- 特征类型:
Unicode
- 默认:
'NavigableAutoSuggestFromHistory'
- TerminalInteractiveShell.banner1¶
在配置文件之前要打印的标语部分
- 特征类型:
Unicode
- 默认:
"Python 3.11.9 (main, Jun 18 2024, 09:40:25) [GCC 11.4.0]\\nTy...
- TerminalInteractiveShell.banner2¶
在配置文件之后要打印的标语部分
- 特征类型:
Unicode
- TerminalInteractiveShell.cache_size¶
设置输出缓存的大小。默认值为 1000,您可以在配置文件中永久更改它。将其设置为 0 会完全禁用缓存系统,接受的最小值为 3(如果您提供的值小于 3,则会重置为 0 并发出警告)。定义此限制是因为否则您将花费更多时间重新刷新过小的缓存,而不是工作
- 特征类型:
整数
- 默认:
1000
- TerminalInteractiveShell.color_info¶
使用颜色显示有关对象的信息。由于此信息是通过分页器(如“less”)传递的,并且一些分页器会与颜色代码混淆,因此可以关闭此功能。
- 特征类型:
布尔
- 默认:
True
- TerminalInteractiveShell.colors¶
设置配色方案(NoColor、Neutral、Linux 或 LightBG)。
- 选项:
'Neutral'
,'NoColor'
,'LightBG'
,'Linux'
- 默认:
'Neutral'
- TerminalInteractiveShell.confirm_exit¶
当你尝试使用 EOF(Unix 中的 Control-D,Windows 中的 Control-Z/Enter)退出 IPython 时,设置为确认。通过键入“exit”或“quit”,你可以强制直接退出,无需任何确认。
- 特征类型:
布尔
- 默认:
True
- CLI 选项:
--confirm-exit
- TerminalInteractiveShell.debug¶
无说明
- 特征类型:
布尔
- 默认:
False
- TerminalInteractiveShell.debugger_history_file¶
存储和读取历史记录的文件
- 特征类型:
Unicode
- 默认:
'~/.pdbhistory'
- TerminalInteractiveShell.disable_failing_post_execute¶
不要调用过去失败的后执行函数。
- 特征类型:
布尔
- 默认:
False
- TerminalInteractiveShell.display_completions¶
用于显示制表符补全的选项,“column”、“multicolumn”和“readlinelike”。这些选项适用于
prompt_toolkit
,有关更多信息,请参阅prompt_toolkit
文档。- 选项:
'column'
,'multicolumn'
,'readlinelike'
- 默认:
'multicolumn'
- TerminalInteractiveShell.display_page¶
如果为 True,则将传递给分页器的任何内容都将显示为常规输出。
- 特征类型:
布尔
- 默认:
False
- TerminalInteractiveShell.editing_mode¶
提示符处使用的快捷方式样式。“vi”或“emacs”。
- 特征类型:
Unicode
- 默认:
'emacs'
- TerminalInteractiveShell.editor¶
设置 IPython 使用的编辑器(默认为 $EDITOR/vi/notepad)。
- 特征类型:
Unicode
- 默认:
'vi'
- TerminalInteractiveShell.emacs_bindings_in_vi_insert_mode¶
从“emacs”插入模式添加快捷方式到“vi”插入模式。
- 特征类型:
布尔
- 默认:
True
- TerminalInteractiveShell.enable_history_search¶
允许启用/禁用提示工具包历史记录搜索
- 特征类型:
布尔
- 默认:
True
- TerminalInteractiveShell.enable_html_pager¶
(临时 API)启用发送到分页器的 MIME 捆绑包中的 HTML 表示形式。
- 特征类型:
布尔
- 默认:
False
- TerminalInteractiveShell.extra_open_editor_shortcuts¶
启用 vi (v) 或 Emacs (C-X C-E) 快捷方式以打开外部编辑器。这是对 F2 绑定的补充,F2 绑定始终启用。
- 特征类型:
布尔
- 默认:
False
- TerminalInteractiveShell.handle_return¶
提供一个备用处理程序,以便在用户按下回车键时调用。这是一个高级选项,用于调试,可能在以后的版本中更改或移除。
- 特征类型:
任何
- TerminalInteractiveShell.highlight_matching_brackets¶
突出显示匹配的括号。
- 特征类型:
布尔
- 默认:
True
- TerminalInteractiveShell.highlighting_style¶
用于语法高亮的 Pygments 样式的名称或类。要查看可用的样式,请运行
pygmentize -L styles
。- 特征类型:
联合
- TerminalInteractiveShell.highlighting_style_overrides¶
覆盖特定令牌的突出显示格式
- 特征类型:
字典
- TerminalInteractiveShell.history_length¶
命令历史记录的总长度
- 特征类型:
整数
- 默认:
10000
- TerminalInteractiveShell.history_load_length¶
启动时加载到历史记录缓冲区中的已保存历史记录条目的数量。
- 特征类型:
整数
- 默认:
1000
- TerminalInteractiveShell.inspector_class¶
用于实例化 shell 检查器的类
- 特征类型:
类型
- 默认:
'IPython.core.oinspect.Inspector'
- TerminalInteractiveShell.ipython_dir¶
无说明
- 特征类型:
Unicode
- TerminalInteractiveShell.logappend¶
以追加模式开始记录到给定文件。使用
logfile
指定要将日志覆盖到的日志文件。- 特征类型:
Unicode
- TerminalInteractiveShell.logfile¶
要使用的日志文件的名称。
- 特征类型:
Unicode
- TerminalInteractiveShell.logstart¶
以覆盖模式开始记录到默认日志文件。使用
logappend
指定要将日志追加到的日志文件。- 特征类型:
布尔
- 默认:
False
- TerminalInteractiveShell.loop_runner¶
选择将用于执行顶级异步代码的循环运行器
- 特征类型:
任何
- 默认:
'IPython.core.interactiveshell._asyncio_runner'
- TerminalInteractiveShell.mime_renderers¶
无说明
- 特征类型:
字典
- TerminalInteractiveShell.modal_cursor¶
光标形状根据 vi 模式而改变:vi 插入模式下为光束,导航模式下为方块,替换模式下为下划线。
- 特征类型:
布尔
- 默认:
True
- TerminalInteractiveShell.mouse_support¶
在提示符中启用鼠标支持(注意:防止用鼠标选择文本)
- 特征类型:
布尔
- 默认:
False
- TerminalInteractiveShell.object_info_string_level¶
无说明
- 选项:
0
,1
,2
- 默认:
0
- TerminalInteractiveShell.pdb¶
在每次异常后自动调用 pdb 调试器。
- 特征类型:
布尔
- 默认:
False
- TerminalInteractiveShell.prompt_includes_vi_mode¶
显示当前 vi 模式(当使用 vi 编辑模式时)。
- 特征类型:
布尔
- 默认:
True
- TerminalInteractiveShell.prompt_line_number_format¶
行编号的格式,将传递
line
(int,从 1 开始) 当前行号和rel_line
相对行号。例如,要显示两者,可以使用以下模板字符串:c.TerminalInteractiveShell.prompt_line_number_format=’{line: 4d}/{rel_line:+03d} | ‘ 这将显示当前行号,带有前导空格且宽度至少为 4 个字符,以及相对行号 0 填充且始终带有 + 或 - 符号。请注意,在使用 Emacs 模式时,第一行的提示可能不会更新。- 特征类型:
Unicode
- TerminalInteractiveShell.prompts_class¶
用于为 prompt_toolkit 生成提示令牌的类
- 特征类型:
类型
- 默认:
'IPython.terminal.prompts.Prompts'
- TerminalInteractiveShell.quiet¶
无说明
- 特征类型:
布尔
- 默认:
False
- TerminalInteractiveShell.separate_in¶
无说明
- 特征类型:
SeparateUnicode
- 默认:
'\\n'
- TerminalInteractiveShell.separate_out¶
无说明
- 特征类型:
SeparateUnicode
- TerminalInteractiveShell.separate_out2¶
无说明
- 特征类型:
SeparateUnicode
- TerminalInteractiveShell.shortcuts¶
添加、禁用或修改快捷方式。
列表中的每个条目都应该是一个字典,其中
command
键标识由快捷方式执行的目标函数,并且至少有一个以下内容match_keys
:用于匹配现有快捷方式的键列表,match_filter
:用于匹配现有快捷方式的快捷方式过滤器,new_keys
:要设置的键列表,new_filter
:要设置的新快捷方式过滤器
过滤器必须由预定义的动词组成,并由以下连接符之一连接:
&
(and),|
(or),~
(not)。预定义的动词是always
never
has_line_below
has_line_above
is_cursor_at_the_end_of_line
has_selection
has_suggestion
vi_mode
vi_insert_mode
emacs_insert_mode
emacs_like_insert_mode
has_completions
insert_mode
default_buffer_focused
search_buffer_focused
ebivim
supports_suspend
is_windows_os
auto_match
focused_insert
not_inside_unclosed_string
readline_like_completions
preceded_by_paired_double_quotes
preceded_by_paired_single_quotes
preceded_by_raw_str_prefix
preceded_by_two_double_quotes
preceded_by_two_single_quotes
followed_by_closing_paren_or_end
preceded_by_opening_round_paren
preceded_by_opening_bracket
preceded_by_opening_brace
preceded_by_double_quote
preceded_by_single_quote
followed_by_closing_round_paren
followed_by_closing_bracket
followed_by_closing_brace
followed_by_double_quote
followed_by_single_quote
navigable_suggestions
cursor_in_leading_ws
pass_through
要禁用快捷方式,请将
new_keys
设置为空列表。要添加快捷方式,请添加键create
,其值为True
。修改/禁用快捷方式时,如果提供的规范唯一标识要修改/禁用的快捷方式,则可以省略
match_keys
/match_filter
。修改快捷方式时,可以省略new_filter
或new_keys
,这将导致重复使用现有的过滤器/键。只能修改或禁用 IPython 中定义的快捷方式(而不是默认的提示工具包快捷方式)。可以在 IPython 快捷方式 下找到快捷方式、命令标识符和过滤器的完整列表。
- 特征类型:
列表
- TerminalInteractiveShell.show_rewritten_input¶
显示重写的输入,例如自动调用。
- 特征类型:
布尔
- 默认:
True
- TerminalInteractiveShell.simple_prompt¶
对 REPL 使用
raw_input
,没有完成和提示颜色。在将 IPython 作为子进程控制并传输 STDIN/OUT/ERR 时很有用。已知用法有:IPython 自己的测试机制和 emacs 的 inferior-python 子进程(假设您已将
python-shell-interpreter
设置为“ipython”),可以通过内置的M-x run-python
和 elpy 等第三方包获得。如果设置了
IPY_TEST_SIMPLE_PROMPT
环境变量,或当前终端不是 tty,则此模式默认为True
。因此,在 –help-all 或 config 中报告的默认值通常会错误报告。- 特征类型:
布尔
- 默认:
True
- CLI 选项:
--simple-prompt
为选项卡完成菜单、搜索历史记录等保留屏幕底部的行数,这些菜单的高度最多为该值。如果您喜欢长而窄的菜单,请增加它,如果您喜欢短而宽的菜单,请减少它。
- 特征类型:
整数
- 默认:
6
- TerminalInteractiveShell.sphinxify_docstring¶
启用文档字符串的丰富 html 表示。(这需要 docrepr 模块)。
- 特征类型:
布尔
- 默认:
False
- TerminalInteractiveShell.term_title¶
自动设置终端标题
- 特征类型:
布尔
- 默认:
True
- CLI 选项:
--term-title
- TerminalInteractiveShell.term_title_format¶
自定义终端标题格式。这是一个 python 格式字符串。可用的替换项有:{cwd}。
- 特征类型:
Unicode
- 默认:
IPython: {cwd}'
- 终端交互式外壳.timeoutlen¶
等待映射的键序列完成的时间(以毫秒为单位)。
- 特征类型:
浮点数
- 默认:
0.5
- 终端交互式外壳.true_color¶
在提示突出显示中使用 24 位颜色,而不是 256 位颜色。如果您的终端支持真彩色,则以下命令应以橙色打印
TRUECOLOR
printf "\x1b[38;2;255;100;0mTRUECOLOR\x1b[0m\n"
- 特征类型:
布尔
- 默认:
False
- 终端交互式外壳.ttimeoutlen¶
等待键代码完成的时间(以毫秒为单位)。
- 特征类型:
浮点数
- 默认:
0.01
- 终端交互式外壳.warn_venv¶
如果在未安装 IPython 的虚拟环境中运行,则发出警告(因此使用全局环境中的 IPython)。
- 特征类型:
布尔
- 默认:
True
- 终端交互式外壳.wildcards_case_sensitive¶
无说明
- 特征类型:
布尔
- 默认:
True
- 终端交互式外壳.xmode¶
切换 IPython 异常处理程序的模式。
- 选项:
'Context'
,'Plain'
,'Verbose'
,'Minimal'
- 默认:
'Context'
- 历史记录访问器.connection_options¶
配置 SQLite 连接的选项
在建立数据库连接时,这些选项作为关键字参数传递给 sqlite3.connect。
- 特征类型:
字典
- 历史记录访问器.enabled¶
启用 SQLite 历史记录
将 enabled=False 设置为禁用 SQLite 历史记录,在这种情况下,将没有存储的历史记录、没有 SQLite 连接,也没有后台保存线程。这在 IPython 嵌入的某些线程环境中可能是必需的。
- 特征类型:
布尔
- 默认:
True
- 历史记录访问器.hist_file¶
用于 SQLite 历史记录数据库的文件路径。
默认情况下,IPython 会将历史记录数据库放在 IPython 配置文件目录中。如果您希望在配置文件之间共享一个历史记录,可以在每个配置文件中设置此值,以便它们保持一致。
由于 fcntl 的问题,已知 SQLite 在某些 NFS 挂载上会出现异常。如果您看到 IPython 挂起,请尝试将其设置为本地磁盘上的某个内容,例如
ipython --HistoryManager.hist_file=/tmp/ipython_hist.sqlite
您还可以使用特定值
:memory:
(包括两端的冒号,但不包括反引号),以避免创建历史记录文件。- 特征类型:
联合
- 历史记录管理器.connection_options¶
配置 SQLite 连接的选项
在建立数据库连接时,这些选项作为关键字参数传递给 sqlite3.connect。
- 特征类型:
字典
- 历史记录管理器.db_cache_size¶
每 x 个命令写入数据库(较高的值可节省磁盘访问和电量)。1 或更低的值实际上会禁用缓存。
- 特征类型:
整数
- 默认:
0
- 历史记录管理器.db_log_output¶
历史记录数据库是否应包括输出?(默认值:否)
- 特征类型:
布尔
- 默认:
False
- 历史记录管理器.enabled¶
启用 SQLite 历史记录
将 enabled=False 设置为禁用 SQLite 历史记录,在这种情况下,将没有存储的历史记录、没有 SQLite 连接,也没有后台保存线程。这在 IPython 嵌入的某些线程环境中可能是必需的。
- 特征类型:
布尔
- 默认:
True
- 历史记录管理器.hist_file¶
用于 SQLite 历史记录数据库的文件路径。
默认情况下,IPython 会将历史记录数据库放在 IPython 配置文件目录中。如果您希望在配置文件之间共享一个历史记录,可以在每个配置文件中设置此值,以便它们保持一致。
由于 fcntl 的问题,已知 SQLite 在某些 NFS 挂载上会出现异常。如果您看到 IPython 挂起,请尝试将其设置为本地磁盘上的某个内容,例如
ipython --HistoryManager.hist_file=/tmp/ipython_hist.sqlite
您还可以使用特定值
:memory:
(包括两端的冒号,但不包括反引号),以避免创建历史记录文件。- 特征类型:
联合
- 魔术管理器.auto_magic¶
自动调用行魔术,而无需显式 % 前缀
- 特征类型:
布尔
- 默认:
True
- 魔术管理器.lazy_magics¶
从魔术名称到要加载的模块的映射。
这可以在 IPython/IPykernel 配置中用于声明仅在首次使用时才会导入/注册的惰性魔术。
例如
c.MagicsManager.lazy_magics = { "my_magic": "slow.to.import", "my_other_magic": "also.slow", }
在首次调用
%my_magic
、%%my_magic
、%%my_other_magic
或%%my_other_magic
时,将加载相应的模块作为 ipython 扩展,就像您之前已经执行%load_ext ipython
一样。魔术名称应不带百分号,因为魔术既可以是单元格魔术,也可以是行魔术。
延迟加载在执行过程中发生得相对较晚,而操作 Python/IPython 内部状态或全局状态的复杂扩展可能不支持延迟加载。
- 特征类型:
字典
- ProfileDir.location¶
直接设置配置文件位置。这将覆盖
profile
选项使用的逻辑。- 特征类型:
Unicode
- CLI 选项:
--profile-dir
- BaseFormatter.deferred_printers¶
无说明
- 特征类型:
字典
- BaseFormatter.enabled¶
无说明
- 特征类型:
布尔
- 默认:
True
- BaseFormatter.singleton_printers¶
无说明
- 特征类型:
字典
- BaseFormatter.type_printers¶
无说明
- 特征类型:
字典
- PlainTextFormatter.deferred_printers¶
无说明
- 特征类型:
字典
- PlainTextFormatter.float_precision¶
无说明
- 特征类型:
CUnicode
- PlainTextFormatter.max_seq_length¶
将大型集合(列表、字典、元组、集合)截断到此大小。
设置为 0 以禁用截断。
- 特征类型:
整数
- 默认:
1000
- PlainTextFormatter.max_width¶
无说明
- 特征类型:
整数
- 默认:
79
- PlainTextFormatter.newline¶
无说明
- 特征类型:
Unicode
- 默认:
'\\n'
- PlainTextFormatter.pprint¶
无说明
- 特征类型:
布尔
- 默认:
True
- CLI 选项:
--pprint
- PlainTextFormatter.singleton_printers¶
无说明
- 特征类型:
字典
- PlainTextFormatter.type_printers¶
无说明
- 特征类型:
字典
- PlainTextFormatter.verbose¶
无说明
- 特征类型:
布尔
- 默认:
False
- Completer.auto_close_dict_keys¶
启用自动关闭字典键。
启用时,字符串键将以最终引号(与起始引号匹配)作为后缀,元组键在需要时也将收到分隔逗号,最终键将收到一个闭合方括号 (
]
)。- 特征类型:
布尔
- 默认:
False
- Completer.backslash_combining_completions¶
启用 unicode 补全,例如 alpha<tab>。包括补全 latex 命令、unicode 名称,以及将 unicode 字符扩展回 latex 命令。
- 特征类型:
布尔
- 默认:
True
- Completer.debug¶
为 Completer 启用调试。主要为实验性 jedi 集成打印额外信息。
- 特征类型:
布尔
- 默认:
False
- Completer.evaluation¶
补全下代码评估策略。
连续选项允许启用更激进的评估以获得更好的补全建议,包括嵌套字典、嵌套列表,甚至函数调用的结果。设置
unsafe
或更高可能导致在 Tab 上评估任意用户代码,并可能产生不需要或危险的副作用。允许的值为
forbidden
:不允许评估代码,minimal
:评估字面量和访问内置命名空间;无项目/属性评估,无本地/全局访问,无任何操作或比较的评估。limited
:访问所有命名空间,评估允许列表对象上的硬编码方法(例如:dict.keys
、object.__getattr__
、object.__getitem__
),例如:dict
、list
、tuple
、pandas.Series
),unsafe
:评估所有方法和函数调用,但不会评估具有副作用的语法,如del x
,dangerous
:完全任意评估。
- 选项:
'forbidden'
、'minimal'
、'limited'
、'unsafe'
、'dangerous'
- 默认:
'limited'
- Completer.greedy¶
激活贪婪补全。
自 8.8 版起已弃用:请改用
Completer.evaluation
和Completer.auto_close_dict_keys
。在 IPython 8.8 或更高版本中启用时,会按如下方式更改配置
Completer.evaluation = 'unsafe'
Completer.auto_close_dict_keys = True
- 特征类型:
布尔
- 默认:
False
- Completer.jedi_compute_type_timeout¶
实验性:限制 Jedi 计算类型的时间(以毫秒为单位)。设置为 0 以停止计算类型。低于 100 毫秒的非零值可能会通过阻止 jedi 构建其缓存而影响性能。
- 特征类型:
整数
- 默认:
400
- Completer.use_jedi¶
实验性:使用 Jedi 生成自动完成。如果已安装 jedi,则默认为 True。
- 特征类型:
布尔
- 默认:
True
- IPCompleter.auto_close_dict_keys¶
启用自动关闭字典键。
启用时,字符串键将以最终引号(与起始引号匹配)作为后缀,元组键在需要时也将收到分隔逗号,最终键将收到一个闭合方括号 (
]
)。- 特征类型:
布尔
- 默认:
False
- IPCompleter.backslash_combining_completions¶
启用 unicode 补全,例如 alpha<tab>。包括补全 latex 命令、unicode 名称,以及将 unicode 字符扩展回 latex 命令。
- 特征类型:
布尔
- 默认:
True
- IPCompleter.debug¶
为 Completer 启用调试。主要为实验性 jedi 集成打印额外信息。
- 特征类型:
布尔
- 默认:
False
- IPCompleter.disable_matchers¶
要禁用的匹配器列表。
该列表应包含匹配器标识符(参见
completion_matcher
)。- 特征类型:
列表
- IPCompleter.evaluation¶
补全下代码评估策略。
连续选项允许启用更激进的评估以获得更好的补全建议,包括嵌套字典、嵌套列表,甚至函数调用的结果。设置
unsafe
或更高可能导致在 Tab 上评估任意用户代码,并可能产生不需要或危险的副作用。允许的值为
forbidden
:不允许评估代码,minimal
:评估字面量和访问内置命名空间;无项目/属性评估,无本地/全局访问,无任何操作或比较的评估。limited
:访问所有命名空间,评估允许列表对象上的硬编码方法(例如:dict.keys
、object.__getattr__
、object.__getitem__
),例如:dict
、list
、tuple
、pandas.Series
),unsafe
:评估所有方法和函数调用,但不会评估具有副作用的语法,如del x
,dangerous
:完全任意评估。
- 选项:
'forbidden'
、'minimal'
、'limited'
、'unsafe'
、'dangerous'
- 默认:
'limited'
- IPCompleter.greedy¶
激活贪婪补全。
自 8.8 版起已弃用:请改用
Completer.evaluation
和Completer.auto_close_dict_keys
。在 IPython 8.8 或更高版本中启用时,会按如下方式更改配置
Completer.evaluation = 'unsafe'
Completer.auto_close_dict_keys = True
- 特征类型:
布尔
- 默认:
False
- IPCompleter.jedi_compute_type_timeout¶
实验性:限制 Jedi 计算类型的时间(以毫秒为单位)。设置为 0 以停止计算类型。低于 100 毫秒的非零值可能会通过阻止 jedi 构建其缓存而影响性能。
- 特征类型:
整数
- 默认:
400
- IPCompleter.limit_to__all__¶
从 5.0 版起已弃用。
指示自动完成程序对自动完成使用 __all__
具体来说,在
object.<tab>
上完成时。当为 True 时:仅包含 obj.__all__ 中的那些名称。
当为 False [默认值] 时:忽略 __all__ 属性
- 特征类型:
布尔
- 默认:
False
- IPCompleter.merge_completions¶
是否将完成结果合并到一个列表中
如果为 False,则仅返回第一个非空自动完成程序的完成结果。
从 8.6.0 版起,将该值设置为
False
是以下内容的别名:IPCompleter.suppress_competing_matchers = True.
。- 特征类型:
布尔
- 默认:
True
- IPCompleter.omit__names¶
指示自动完成程序忽略私有方法名称
具体来说,在
object.<tab>
上完成时。当为 2 [默认值] 时:将排除所有以“_”开头的名称。
当为 1 时:将排除所有“魔术”名称(
__foo__
)。当为 0 时:不排除任何内容。
- 选项:
0
,1
,2
- 默认:
2
- IPCompleter.profile_completions¶
如果为 True,则使用 cProfile 为完成子系统发出分析数据。
- 特征类型:
布尔
- 默认:
False
- IPCompleter.profiler_output_dir¶
用于输出完成分析数据的路径模板。
- 特征类型:
Unicode
- 默认:
'.completion_profiles'
- IPCompleter.suppress_competing_matchers¶
是否禁止来自其他匹配器的自动补全。
当设置为
None
(默认值)时,匹配器将尝试自动检测是否需要禁止其他匹配器。例如,在以%
开头的行的开头,我们希望魔法自动补全成为唯一适用的选项,而在my_dict['
之后,我们通常希望自动补全一个现有的字典键。如果您想禁用此启发式并查看来自所有匹配器的自动补全,请设置
IPCompleter.suppress_competing_matchers = False
。要禁用特定匹配器的启发式,请提供一个映射字典:IPCompleter.suppress_competing_matchers = 'IPCompleter.dict_key_matcher': False}
。设置
IPCompleter.suppress_competing_matchers = True
以将自动补全限制为具有最高优先级的匹配器集合;这等效于IPCompleter.merge_completions
,并且可能有利于性能,但有时会从优先级列表中较低位置的匹配器中省略相关候选者。- 特征类型:
联合
- IPCompleter.use_jedi¶
实验性:使用 Jedi 生成自动完成。如果已安装 jedi,则默认为 True。
- 特征类型:
布尔
- 默认:
True
- ScriptMagics.script_magics¶
要定义的额外脚本单元格魔术
这会生成
%%script foo
的简单包装器,如%%foo
。如果您想添加不在您的路径中的脚本魔术,请在 script_paths 中指定它们
- 特征类型:
列表
- ScriptMagics.script_paths¶
将短“ruby”名称映射到完整路径的字典,例如“/opt/secret/bin/ruby”
仅适用于 script_magics 中默认路径找不到正确解释器的项目。
- 特征类型:
字典
- LoggingMagics.quiet¶
在启用日志记录时禁止输出日志状态
- 特征类型:
布尔
- 默认:
False
- StoreMagics.autorestore¶
如果为 True,则在 IPython 启动时将自动恢复任何 %store-d 变量。
- 特征类型:
布尔
- 默认:
False