IPython 5.x 系列深度解析终端交互重构、LTS 特性回溯与系统级配置【免费下载链接】ipythonOfficial repository for IPython itself. Other repos in the IPython organization contain things like the website, documentation builds, etc.项目地址: https://gitcode.com/gh_mirrors/ip/ipython导读IPython 5.x 是 IPython 发展史上一座重要的里程碑5.0 用基于prompt_toolkit的全新终端界面彻底取代了readline带来输入时实时语法高亮、多行编辑与多行粘贴等能力5.4-LTS 则把 6.x 新增的核心 API 回溯到 Python 2 兼容分支使新旧版本代码无需条件分支即可迁移随后的 5.55.8 继续补齐了系统级配置、内置进度条、字典保持插入序显示等实用特性。阅读本文你将系统掌握 IPython 5.x 的终端架构变化、配置项TerminalIPythonApp.interactive_shell_class、Completer.backslash_combining_completions、InteractiveShell.sphinxify_docstring等、Display ID 更新机制与ProgressBar迭代用法并对照当前仓库源码IPython/core/display.py、IPython/terminal/ipapp.py 等理解其底层实现。5.0全新终端界面prompt_toolkit 时代开启IPython 5.0 发布于 2016 年 7 月 7 日其核心变革是终端界面的彻底重构输入时实时语法高亮、真正的多行编辑与多行粘贴、以及不再污染历史记录的 Tab 补全。这些能力全部由纯 Python 跨平台库prompt_toolkit提供取代了原先贯穿整个终端界面的readline。这一替换也简化了安装流程依赖的pyreadlineWindows与gnureadlineMac被一并移除prompt_toolkit的纯 Python 实现使得 IPython 在各平台的安装与使用更加统一。在仓库中终端相关代码集中在 IPython/terminal/如 interactiveshell.py、ptutils.py调试器同样迁移到该体系IPython/terminal/debugger.py。5.0 的不兼容变更%install_ext魔法自 4.0 起已弃用5.0 中正式删除。扩展应作为 PyPI 包分发安装。事件处理期间注册的回调只会对后续事件生效处理期间被移除的回调则仍会收到当前事件参见 :ghissue:9447、:ghpull:9453对应修复。移除了与 pydb 的集成——pydb 自 2012 年起停止开发且无法从 PyPI 安装。移除长期失效的autoedit_syntax选项。旧用户迁移注意点不再读取~/.inputrcIPython 不再使用 readline 配置需要的功能如 vi 输入模式应直接配置 IPython 本身。PromptManager类被移除提示符机制被大幅简化自定义提示符需使用新的机制参考 docs/source/config/ 下的相关文档。调试器接口更扁平IPython/core/debugger.py 提供更简洁的接口而基于 prompt_toolkit 的终端调试器位于 IPython/terminal/debugger.py。语法高亮配色有新增配置项官方尝试与经典--colors选项及%colors魔法集成但两者能力范围不完全一致某些配置可能产生与预期不同的效果。与 Emacs inferior-shell 不兼容如需继续在 Emacs 中使用请为 Emacs 运行的命令附加--simple-prompt标志该标志会关闭大部分 IPython 特性由 Emacs 提供 Tab 补全等能力。5.0 的实验性Provisional功能实验性功能可能不会进入未来版本API 也可能在无警告的情况下变化尤其在 Jupyter notebook 场景下可能带来安全影响启用需自担风险。通过 notebook 或兼容客户端可启用富文档实验功能当安装了docrepr包并将布尔配置项InteractiveShell.sphinxify_docstring设为True时对象在显示前会先经过 sphinx 处理同时还需用InteractiveShell.enable_html_pager开启分页器的富 HTML 展示。除了写入配置文件也可动态开启ip get_ipython() ip.sphinxify_docstring True ip.enable_html_pager True随后在 notebook 中即可体验效果例如import numpy as np np.histogram?这是“让 Python 文档更丰富”的长期探索的一部分未来可能支持包含数学公式、图片、widgets 的动态示例。5.0 弃用项Deprecated若在 CI 或常规测试中使用 IPython建议把DeprecationWarning当作错误处理import warnings warnings.filterwarnings(error, .*, DeprecationWarning, moduleyourmodule.*)5.0 标记的弃用项包括hooks.fix_error_editor疑似未被使用待弃用。IPython/core/excolors.py 中的ExceptionColors已弃用。IPython.core.InteractiveShell.write()弃用改用sys.stdout。IPython.core.InteractiveShell.write_err()弃用改用sys.stderr。IPython.core.oinspect中Inspector.info的formatter关键字参数已无效果。IPython Embed 的global_ns关键字参数弃用且无效改用module关键字参数。5.0 已知问题Esc键无法关闭补全器或清空当前缓冲区这是有意为之受技术限制Esc控制字符被其他快捷键使用且无法可靠区分请改用Ctrl-G或Ctrl-C。终端中无法用Shift-Enter、Ctrl-Enter提交代码终端无法区分这些按键序列与普通换行。PageUp/PageDown不能在补全菜单中移动。颜色样式可能不随终端模拟器主题自适应这需要新版本 Pygments 支持可先用自定义主题缓解。5.1稳定性修复与 True Color 支持5.1 的主要修复包括修复 Python 2 上__qualname__导致%timeit损坏的问题恢复%gui qt在必要时创建并返回QApplication默认不再设置终端标题用Ctrl-O插入换行时保留缩进恢复调试器内的补全弃用IPython.core.debugger.Tracer()推荐更简洁的新 API恢复被误删的NoOpContext上下文管理器并添加DeprecationWarning恢复Ctrl-\作为退出 IPython 的快捷键当启动文件导入模块时也能访问get_ipython()支持用ipython命令运行含__main__.py的目录等。True Color 特性prompt_toolkit使用 pygments 样式做语法高亮默认将颜色近似到标准 256 色调色板但也支持 24bit即 true、1600 万色转义序列。true_color选项把这一能力暴露给 IPython shell让兼容终端显示精确颜色而非近似值。5.2调试器行为回调与配置增强5.2 发布于 2017 年 1 月 29 日主要变更包括恢复 IPython 调试器退出时抛异常的行为c.TerminalInteractiveShell.highlighting_style现在可以直接接受类参数以使用自定义配色正确解析 matplotlib 图形的 dpi弃用%notebook魔法中无效果的-e标志终端提示符下可按F2用$EDITOR指定的编辑器编辑当前输入sdist 按 PyPI 要求统一为.tar.gzIPython/core/debugger.py 新增便捷的set_trace()方法移除了 5.0 引入的调试器 smart command mode多数人更偏好旧行为因此c等调试器命令即使同名变量已定义仍按命令处理修复 OS X 启动时事件循环问题弃用%autoindent魔法设置弃用的limit_to_all补全选项时会发出DeprecationWarning%%capture单元魔法现在除了捕获打印与显示输出外还能捕获单元最后一行的表达式结果。InteractiveShellEmbed行为也有调整默认%kill_embedded会阻止当前调用位置的再次进入而非实例创建位置更符合直觉新增%kill_embedded --instance简写-i停用实例、--yes/-y跳过确认、-x/--exit直接退出当前嵌入调用。5.3终端可用性修复5.3 发布于 2017 年 2 月 24 日修复了set_next_input导致终端 IPython 崩溃的 bug终端 IPython 总是等待编辑器 inputhook终端中禁用_ipython_display_调整默认终端配色使其在 Windows 上更清晰终端调试器新增Ctrl-Z挂起快捷键换行缩进依据光标前文本计算更新 Qt 事件循环集成以解决部分 matplotlib 集成问题终端调试器遵循补全显示样式新增配置项TerminalInteractiveShell.extra_open_editor_shortcuts可启用额外快捷键将输入在编辑器中打开vi 模式为vemacs 模式为C-X C-EF2始终可用。5.4-LTS面向 Python 2 分支的能力回溯IPython 5.4-LTS 是 6.x仅支持 Python 3发布后的首个 LTS 版本回溯了 6.0 与 6.1 的大多数新公开 API让旧版本代码无需按 IPython 版本编写条件逻辑。升级提示升级 IPython 前请先将 pip 升级到 9 或更高版本否则在 Python 2 上可能得到损坏的 IPython 安装。可配置的 TerminalInteractiveShellIPython 新增c.TerminalIPythonApp.interactive_shell_class选项允许自定义用于启动终端前端的类。在源码中该选项定义于 IPython/terminal/ipapp.py默认值为TerminalInteractiveShellinteractive_shell_class Type( klassobject, # use default_value otherwise which only allow subclasses. default_valueTerminalInteractiveShell, helpClass to use to instantiate the TerminalInteractiveShell object. Useful for custom Frontends ).tag(configTrue)并在 ipapp.py 处通过self.shell self.interactive_shell_class.instance(parentself, ...)实际实例化。这允许用户使用自定义交互界面例如复活旧的 readline 界面它已独立成包不再由核心团队维护。典型配置写法c.TerminalIPythonApp.interactive_shell_class mypackage.MyShell定义_repr_mimebundle_对象现在可以定义_repr_mimebundle_来代替多个_repr_*_方法一次返回完整的 mimebundle极大简化实现并允许发布自定义 mimetype如 geojson、plotly、dataframes 等。详见 IPython/core/formatters.py 中MimeBundleFormatter的实现class MimeBundleFormatter(BaseFormatter): A Formatter for arbitrary mime-types. Unlike other _repr_mimetype_ methods, _repr_mimebundle_ should return mime-bundle data, either the mime-keyed data dictionary or the tuple (data, metadata). Any mime-type is valid. ... print_method ObjectName(_repr_mimebundle_) _return_type dict其_check_return统一把返回值规范化为(data, metadata)二元组__call__还会把include/exclude等额外参数透传给方法。formatter 的优先级逻辑位于 IPython/core/formatters.py自 6.1 起_repr_mimebundle_成为展示自定义 mime-type 的推荐方式_ipython_display_仅建议用于需要多次 display 调用等特殊场景。执行启发式Execution Heuristics命令行界面的执行判断现在更偏向单语句立即执行在 IPython 4.x 及以前按下 Enter 会执行单行5.x 曾改为插入新行5.4 起如果单行是合法 Python 代码IPython 会无论光标位置如何直接执行它。如需插入新行使用Ctrl-O在 5.1 中已修复该操作保留缩进的问题。Display ID 实现实现了 display id 机制支持更新指定的展示对象。这大幅简化了代码——不再需要 widgets 也能实现进度条等动态效果其他前端同样可以借此实现类似能力。display 函数默认可用display()函数现在默认就在 IPython 会话中可用用户可对任意对象调用它以查看其富表示增强了 REPL 与 notebook 环境的交互性。脚本和库如果依赖 display 且可能在 IPython 之外运行仍需显式导入from IPython.display import display5.4 其他修复_mp_main_不再被重载修复了 multiprocessing 相关问题。Pdb 也使用用户的配色方案。更快的退出速度。修复反向搜索reverse search崩溃。新增Completer.backslash_combining_completions布尔选项可关闭可能与 Windows 路径冲突的反斜杠 Tab 补全。该选项在 IPython/core/completer.py 中定义backslash_combining_completions Bool(True, helpEnable unicode completions, e.g. \\alphatab . Includes completion of latex commands, unicode names, and expanding unicode characters back to latex commands.).tag(configTrue)配置为False即可关闭\alphatab这类 unicode 补全避免与 Windows 路径补全冲突。5.5系统级配置与内置 ProgressBar系统级配置System Wide configIPython 现在会在{sys.prefix}/etc/ipython下查找环境专属的配置文件启动文件则可在/etc/ipython/startup或{sys.prefix}/etc/ipython/startup中找到除 profile 目录外适用于系统级或环境级启动脚本。相关配置机制可参考 IPython/core/profileapp.py 与 IPython/core/profiledir.py。ProgressBar 内置进度条IPython 内置了进度条支持交互示例如下In[1]: from IPython.display import ProgressBar ... : pb ProgressBar(100) ... : pb In[2]: pb.progress 50 # progress bar in cell 1 updates.其源码位于 IPython/core/display.py底层正是基于 5.4 引入的 Display ID 更新机制class ProgressBar(DisplayObject): Progressbar supports displaying a progressbar like element def __init__(self, total): Creates a new progressbar Parameters ---------- total : int maximum size of the progressbar self.total total self._progress 0 self.html_width 60ex self.text_width 60 self._display_id hexlify(os.urandom(8)).decode(ascii)关键实现要点构造时生成随机_display_iddisplay()用该 id 首次展示update()用updateTrue原地刷新对应 IPython/core/display_functions.py 的display()/update_display()逻辑display_id以True传入时会自动_new_id()。progress是属性setter 会自动调用update()因此pb.progress 50就能刷新展示。__repr__生成纯文本条text_width60字符宽_repr_html_生成progress元素html_width60ex同时覆盖终端与 notebook 场景。5.5 Misc修复IPython.core.display:Pretty._repr_pretty_签名错误。%timeit在遇到裸return时给出正确的SyntaxError。让:ipython:指令兼容 Sphinx 1.7。支持 OpenSSL FIPS 模式输入哈希算法从 md5 改为 sha1。运行任何带调试器的脚本前先清除断点。文档说明%profile已弃用勿与%prun混淆。默认补全返回数量上限为 500。5.6字典保持插入序与输入处理过渡5.6 的变更包括Python 3.6 字典保持插入顺序在这些版本上IPython 显示字典时按原生顺序展示而不再按键排序此前是按键排序。ProgressBar可作为迭代器使用自 5.6 起见上文 IPython/core/display.py 的__iter__/__next__实现——迭代开始时先display()每次next递增进度并自动更新def __iter__(self): self.display() self._progress -1 # First iteration is 0 return self def __next__(self): Returns current value and increments display by one. self.progress 1 if self.progress self.total: return self.progress else: raise StopIteration()因此可以直接写from IPython.display import ProgressBar for i in ProgressBar(100): # do work passshell 对象新增check_complete方法为 IPython 7 规划的新输入处理机制平滑过渡。该方法在 IPython/core/interactiveshell.py 定义def check_complete(self, code: str) - tuple[str, str]: Return whether a block of code is ready to execute, or should be continued Parameters ---------- code : string Python input code, which can be multiline. Returns ------- status : str One of complete, incomplete, or invalid if source is not a prefix of valid code. indent : str When status is incomplete, this is some whitespace to insert on the next line of the prompt. status, nspaces self.input_transformer_manager.check_complete(code) return status, * (nspaces or 0)其核心委托给输入转换管理器底层实现在 IPython/core/inputtransformer2.py返回complete/incomplete/invalid三种状态并对incomplete给出下一行应缩进的空格数同时处理结尾无换行时补\n以保证 tokenization 一致等细节。启动加速启动时不再扫描所有可用的 pygments 样式。5.7 与 5.8最后的稳定修补5.7修复 IPython 尝试导入不存在的 matplotlib 后端修复 display hook 未发布对象 metadata 的问题。5.8.0更新函数/方法的检查逻辑以面向未来future-proofing避免与未来 Python 版本冲突。小结5.x 系列的价值从本仓库源码看5.x 引入的许多机制至今仍是 IPython 的基石prompt_toolkit终端界面、_repr_mimebundle_富展示协议、Display ID 驱动的动态更新、check_complete输入状态判定、ProgressBar迭代器以及系统级配置目录。对于维护兼容旧版 Python 环境的开发者5.4-LTS 的 API 回溯设计思路在 6.x 新 API 与 Python 2 分支之间架桥也值得借鉴而对于所有 IPython 用户5.x 的配置项与调试器行为约定如%kill_embedded的语义调整、F2编辑快捷键依旧在后续版本中延续。相关配置总览可继续阅读 docs/source/config/ 目录下的文档终端配置项细节见 docs/source/config/options/。【免费下载链接】ipythonOfficial repository for IPython itself. Other repos in the IPython organization contain things like the website, documentation builds, etc.项目地址: https://gitcode.com/gh_mirrors/ip/ipython创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
IPython 5.x 系列深度解析终端交互重构、LTS 特性回溯与系统级配置【免费下载链接】ipythonOfficial repository for IPython itself. Other repos in the IPython organization contain things like the website, documentation builds, etc.项目地址: https://gitcode.com/gh_mirrors/ip/ipython导读IPython 5.x 是 IPython 发展史上一座重要的里程碑5.0 用基于prompt_toolkit的全新终端界面彻底取代了readline带来输入时实时语法高亮、多行编辑与多行粘贴等能力5.4-LTS 则把 6.x 新增的核心 API 回溯到 Python 2 兼容分支使新旧版本代码无需条件分支即可迁移随后的 5.55.8 继续补齐了系统级配置、内置进度条、字典保持插入序显示等实用特性。阅读本文你将系统掌握 IPython 5.x 的终端架构变化、配置项TerminalIPythonApp.interactive_shell_class、Completer.backslash_combining_completions、InteractiveShell.sphinxify_docstring等、Display ID 更新机制与ProgressBar迭代用法并对照当前仓库源码IPython/core/display.py、IPython/terminal/ipapp.py 等理解其底层实现。5.0全新终端界面prompt_toolkit 时代开启IPython 5.0 发布于 2016 年 7 月 7 日其核心变革是终端界面的彻底重构输入时实时语法高亮、真正的多行编辑与多行粘贴、以及不再污染历史记录的 Tab 补全。这些能力全部由纯 Python 跨平台库prompt_toolkit提供取代了原先贯穿整个终端界面的readline。这一替换也简化了安装流程依赖的pyreadlineWindows与gnureadlineMac被一并移除prompt_toolkit的纯 Python 实现使得 IPython 在各平台的安装与使用更加统一。在仓库中终端相关代码集中在 IPython/terminal/如 interactiveshell.py、ptutils.py调试器同样迁移到该体系IPython/terminal/debugger.py。5.0 的不兼容变更%install_ext魔法自 4.0 起已弃用5.0 中正式删除。扩展应作为 PyPI 包分发安装。事件处理期间注册的回调只会对后续事件生效处理期间被移除的回调则仍会收到当前事件参见 :ghissue:9447、:ghpull:9453对应修复。移除了与 pydb 的集成——pydb 自 2012 年起停止开发且无法从 PyPI 安装。移除长期失效的autoedit_syntax选项。旧用户迁移注意点不再读取~/.inputrcIPython 不再使用 readline 配置需要的功能如 vi 输入模式应直接配置 IPython 本身。PromptManager类被移除提示符机制被大幅简化自定义提示符需使用新的机制参考 docs/source/config/ 下的相关文档。调试器接口更扁平IPython/core/debugger.py 提供更简洁的接口而基于 prompt_toolkit 的终端调试器位于 IPython/terminal/debugger.py。语法高亮配色有新增配置项官方尝试与经典--colors选项及%colors魔法集成但两者能力范围不完全一致某些配置可能产生与预期不同的效果。与 Emacs inferior-shell 不兼容如需继续在 Emacs 中使用请为 Emacs 运行的命令附加--simple-prompt标志该标志会关闭大部分 IPython 特性由 Emacs 提供 Tab 补全等能力。5.0 的实验性Provisional功能实验性功能可能不会进入未来版本API 也可能在无警告的情况下变化尤其在 Jupyter notebook 场景下可能带来安全影响启用需自担风险。通过 notebook 或兼容客户端可启用富文档实验功能当安装了docrepr包并将布尔配置项InteractiveShell.sphinxify_docstring设为True时对象在显示前会先经过 sphinx 处理同时还需用InteractiveShell.enable_html_pager开启分页器的富 HTML 展示。除了写入配置文件也可动态开启ip get_ipython() ip.sphinxify_docstring True ip.enable_html_pager True随后在 notebook 中即可体验效果例如import numpy as np np.histogram?这是“让 Python 文档更丰富”的长期探索的一部分未来可能支持包含数学公式、图片、widgets 的动态示例。5.0 弃用项Deprecated若在 CI 或常规测试中使用 IPython建议把DeprecationWarning当作错误处理import warnings warnings.filterwarnings(error, .*, DeprecationWarning, moduleyourmodule.*)5.0 标记的弃用项包括hooks.fix_error_editor疑似未被使用待弃用。IPython/core/excolors.py 中的ExceptionColors已弃用。IPython.core.InteractiveShell.write()弃用改用sys.stdout。IPython.core.InteractiveShell.write_err()弃用改用sys.stderr。IPython.core.oinspect中Inspector.info的formatter关键字参数已无效果。IPython Embed 的global_ns关键字参数弃用且无效改用module关键字参数。5.0 已知问题Esc键无法关闭补全器或清空当前缓冲区这是有意为之受技术限制Esc控制字符被其他快捷键使用且无法可靠区分请改用Ctrl-G或Ctrl-C。终端中无法用Shift-Enter、Ctrl-Enter提交代码终端无法区分这些按键序列与普通换行。PageUp/PageDown不能在补全菜单中移动。颜色样式可能不随终端模拟器主题自适应这需要新版本 Pygments 支持可先用自定义主题缓解。5.1稳定性修复与 True Color 支持5.1 的主要修复包括修复 Python 2 上__qualname__导致%timeit损坏的问题恢复%gui qt在必要时创建并返回QApplication默认不再设置终端标题用Ctrl-O插入换行时保留缩进恢复调试器内的补全弃用IPython.core.debugger.Tracer()推荐更简洁的新 API恢复被误删的NoOpContext上下文管理器并添加DeprecationWarning恢复Ctrl-\作为退出 IPython 的快捷键当启动文件导入模块时也能访问get_ipython()支持用ipython命令运行含__main__.py的目录等。True Color 特性prompt_toolkit使用 pygments 样式做语法高亮默认将颜色近似到标准 256 色调色板但也支持 24bit即 true、1600 万色转义序列。true_color选项把这一能力暴露给 IPython shell让兼容终端显示精确颜色而非近似值。5.2调试器行为回调与配置增强5.2 发布于 2017 年 1 月 29 日主要变更包括恢复 IPython 调试器退出时抛异常的行为c.TerminalInteractiveShell.highlighting_style现在可以直接接受类参数以使用自定义配色正确解析 matplotlib 图形的 dpi弃用%notebook魔法中无效果的-e标志终端提示符下可按F2用$EDITOR指定的编辑器编辑当前输入sdist 按 PyPI 要求统一为.tar.gzIPython/core/debugger.py 新增便捷的set_trace()方法移除了 5.0 引入的调试器 smart command mode多数人更偏好旧行为因此c等调试器命令即使同名变量已定义仍按命令处理修复 OS X 启动时事件循环问题弃用%autoindent魔法设置弃用的limit_to_all补全选项时会发出DeprecationWarning%%capture单元魔法现在除了捕获打印与显示输出外还能捕获单元最后一行的表达式结果。InteractiveShellEmbed行为也有调整默认%kill_embedded会阻止当前调用位置的再次进入而非实例创建位置更符合直觉新增%kill_embedded --instance简写-i停用实例、--yes/-y跳过确认、-x/--exit直接退出当前嵌入调用。5.3终端可用性修复5.3 发布于 2017 年 2 月 24 日修复了set_next_input导致终端 IPython 崩溃的 bug终端 IPython 总是等待编辑器 inputhook终端中禁用_ipython_display_调整默认终端配色使其在 Windows 上更清晰终端调试器新增Ctrl-Z挂起快捷键换行缩进依据光标前文本计算更新 Qt 事件循环集成以解决部分 matplotlib 集成问题终端调试器遵循补全显示样式新增配置项TerminalInteractiveShell.extra_open_editor_shortcuts可启用额外快捷键将输入在编辑器中打开vi 模式为vemacs 模式为C-X C-EF2始终可用。5.4-LTS面向 Python 2 分支的能力回溯IPython 5.4-LTS 是 6.x仅支持 Python 3发布后的首个 LTS 版本回溯了 6.0 与 6.1 的大多数新公开 API让旧版本代码无需按 IPython 版本编写条件逻辑。升级提示升级 IPython 前请先将 pip 升级到 9 或更高版本否则在 Python 2 上可能得到损坏的 IPython 安装。可配置的 TerminalInteractiveShellIPython 新增c.TerminalIPythonApp.interactive_shell_class选项允许自定义用于启动终端前端的类。在源码中该选项定义于 IPython/terminal/ipapp.py默认值为TerminalInteractiveShellinteractive_shell_class Type( klassobject, # use default_value otherwise which only allow subclasses. default_valueTerminalInteractiveShell, helpClass to use to instantiate the TerminalInteractiveShell object. Useful for custom Frontends ).tag(configTrue)并在 ipapp.py 处通过self.shell self.interactive_shell_class.instance(parentself, ...)实际实例化。这允许用户使用自定义交互界面例如复活旧的 readline 界面它已独立成包不再由核心团队维护。典型配置写法c.TerminalIPythonApp.interactive_shell_class mypackage.MyShell定义_repr_mimebundle_对象现在可以定义_repr_mimebundle_来代替多个_repr_*_方法一次返回完整的 mimebundle极大简化实现并允许发布自定义 mimetype如 geojson、plotly、dataframes 等。详见 IPython/core/formatters.py 中MimeBundleFormatter的实现class MimeBundleFormatter(BaseFormatter): A Formatter for arbitrary mime-types. Unlike other _repr_mimetype_ methods, _repr_mimebundle_ should return mime-bundle data, either the mime-keyed data dictionary or the tuple (data, metadata). Any mime-type is valid. ... print_method ObjectName(_repr_mimebundle_) _return_type dict其_check_return统一把返回值规范化为(data, metadata)二元组__call__还会把include/exclude等额外参数透传给方法。formatter 的优先级逻辑位于 IPython/core/formatters.py自 6.1 起_repr_mimebundle_成为展示自定义 mime-type 的推荐方式_ipython_display_仅建议用于需要多次 display 调用等特殊场景。执行启发式Execution Heuristics命令行界面的执行判断现在更偏向单语句立即执行在 IPython 4.x 及以前按下 Enter 会执行单行5.x 曾改为插入新行5.4 起如果单行是合法 Python 代码IPython 会无论光标位置如何直接执行它。如需插入新行使用Ctrl-O在 5.1 中已修复该操作保留缩进的问题。Display ID 实现实现了 display id 机制支持更新指定的展示对象。这大幅简化了代码——不再需要 widgets 也能实现进度条等动态效果其他前端同样可以借此实现类似能力。display 函数默认可用display()函数现在默认就在 IPython 会话中可用用户可对任意对象调用它以查看其富表示增强了 REPL 与 notebook 环境的交互性。脚本和库如果依赖 display 且可能在 IPython 之外运行仍需显式导入from IPython.display import display5.4 其他修复_mp_main_不再被重载修复了 multiprocessing 相关问题。Pdb 也使用用户的配色方案。更快的退出速度。修复反向搜索reverse search崩溃。新增Completer.backslash_combining_completions布尔选项可关闭可能与 Windows 路径冲突的反斜杠 Tab 补全。该选项在 IPython/core/completer.py 中定义backslash_combining_completions Bool(True, helpEnable unicode completions, e.g. \\alphatab . Includes completion of latex commands, unicode names, and expanding unicode characters back to latex commands.).tag(configTrue)配置为False即可关闭\alphatab这类 unicode 补全避免与 Windows 路径补全冲突。5.5系统级配置与内置 ProgressBar系统级配置System Wide configIPython 现在会在{sys.prefix}/etc/ipython下查找环境专属的配置文件启动文件则可在/etc/ipython/startup或{sys.prefix}/etc/ipython/startup中找到除 profile 目录外适用于系统级或环境级启动脚本。相关配置机制可参考 IPython/core/profileapp.py 与 IPython/core/profiledir.py。ProgressBar 内置进度条IPython 内置了进度条支持交互示例如下In[1]: from IPython.display import ProgressBar ... : pb ProgressBar(100) ... : pb In[2]: pb.progress 50 # progress bar in cell 1 updates.其源码位于 IPython/core/display.py底层正是基于 5.4 引入的 Display ID 更新机制class ProgressBar(DisplayObject): Progressbar supports displaying a progressbar like element def __init__(self, total): Creates a new progressbar Parameters ---------- total : int maximum size of the progressbar self.total total self._progress 0 self.html_width 60ex self.text_width 60 self._display_id hexlify(os.urandom(8)).decode(ascii)关键实现要点构造时生成随机_display_iddisplay()用该 id 首次展示update()用updateTrue原地刷新对应 IPython/core/display_functions.py 的display()/update_display()逻辑display_id以True传入时会自动_new_id()。progress是属性setter 会自动调用update()因此pb.progress 50就能刷新展示。__repr__生成纯文本条text_width60字符宽_repr_html_生成progress元素html_width60ex同时覆盖终端与 notebook 场景。5.5 Misc修复IPython.core.display:Pretty._repr_pretty_签名错误。%timeit在遇到裸return时给出正确的SyntaxError。让:ipython:指令兼容 Sphinx 1.7。支持 OpenSSL FIPS 模式输入哈希算法从 md5 改为 sha1。运行任何带调试器的脚本前先清除断点。文档说明%profile已弃用勿与%prun混淆。默认补全返回数量上限为 500。5.6字典保持插入序与输入处理过渡5.6 的变更包括Python 3.6 字典保持插入顺序在这些版本上IPython 显示字典时按原生顺序展示而不再按键排序此前是按键排序。ProgressBar可作为迭代器使用自 5.6 起见上文 IPython/core/display.py 的__iter__/__next__实现——迭代开始时先display()每次next递增进度并自动更新def __iter__(self): self.display() self._progress -1 # First iteration is 0 return self def __next__(self): Returns current value and increments display by one. self.progress 1 if self.progress self.total: return self.progress else: raise StopIteration()因此可以直接写from IPython.display import ProgressBar for i in ProgressBar(100): # do work passshell 对象新增check_complete方法为 IPython 7 规划的新输入处理机制平滑过渡。该方法在 IPython/core/interactiveshell.py 定义def check_complete(self, code: str) - tuple[str, str]: Return whether a block of code is ready to execute, or should be continued Parameters ---------- code : string Python input code, which can be multiline. Returns ------- status : str One of complete, incomplete, or invalid if source is not a prefix of valid code. indent : str When status is incomplete, this is some whitespace to insert on the next line of the prompt. status, nspaces self.input_transformer_manager.check_complete(code) return status, * (nspaces or 0)其核心委托给输入转换管理器底层实现在 IPython/core/inputtransformer2.py返回complete/incomplete/invalid三种状态并对incomplete给出下一行应缩进的空格数同时处理结尾无换行时补\n以保证 tokenization 一致等细节。启动加速启动时不再扫描所有可用的 pygments 样式。5.7 与 5.8最后的稳定修补5.7修复 IPython 尝试导入不存在的 matplotlib 后端修复 display hook 未发布对象 metadata 的问题。5.8.0更新函数/方法的检查逻辑以面向未来future-proofing避免与未来 Python 版本冲突。小结5.x 系列的价值从本仓库源码看5.x 引入的许多机制至今仍是 IPython 的基石prompt_toolkit终端界面、_repr_mimebundle_富展示协议、Display ID 驱动的动态更新、check_complete输入状态判定、ProgressBar迭代器以及系统级配置目录。对于维护兼容旧版 Python 环境的开发者5.4-LTS 的 API 回溯设计思路在 6.x 新 API 与 Python 2 分支之间架桥也值得借鉴而对于所有 IPython 用户5.x 的配置项与调试器行为约定如%kill_embedded的语义调整、F2编辑快捷键依旧在后续版本中延续。相关配置总览可继续阅读 docs/source/config/ 目录下的文档终端配置项细节见 docs/source/config/options/。【免费下载链接】ipythonOfficial repository for IPython itself. Other repos in the IPython organization contain things like the website, documentation builds, etc.项目地址: https://gitcode.com/gh_mirrors/ip/ipython创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
