SuperAPI AI 工具集

jupytext

通用与其它

查看项目

更新于 10-15 21:37

技能介绍

用途:把 Jupyter notebook 转成文本格式(.py、.R、.md)或反向转换,方便用 Git 做版本控制,并支持 Python/R/Stata/SAS 等多内核项目。

主要能力:推荐使用 percent 格式(py:percent),用 # %% 标记代码单元、# %% [markdown] 标记 Markdown。可在项目根目录建 jupytext.toml 配置 formats = "ipynb,py:percent" 及元数据过滤。常用命令:jupytext --to py:percent notebook.ipynb、jupytext --to notebook script.py、jupytext --set-formats ipynb,py:percent notebook.ipynb、jupytext --sync notebook.ipynb。

执行方式:技能要求先转换再执行,推荐管道:jupytext --to notebook --output - script.py | papermill - output.ipynb,可加 -p 注入参数、--log-output 记录日志。执行后须检查 papermill 退出码与 stderr,确认 output.ipynb 存在且非空,并检查单元中无 traceback、execution_count 非 null。

多内核数据共享:Python 到 R 用 Parquet,Python 到 Stata 用 DTA,通用可用 CSV,也可用 DuckDB 查询 Parquet。

集成与结构:可配置 pre-commit 钩子(jupytext --sync),VS Code 装 Jupytext 扩展、JupyterLab 右键 Pair Notebook 实现同步。标准项目含 jupytext.toml、environment.yml、notebooks/、data/、results/。内核可在文件头 kernelspec 指定。

限制:资料未提供收费、价格、平台支持范围等信息;技能强调不得仅凭转换成功或退出码就声称执行成功,必须核验输出。