sinfo

注意新名称

“sinfo”包已更名，现在称为“session_info”，以提高可发现性和自解释性。为避免破坏旧安装，“sinfo” PyPI包将保留，如果您想使用它而不显示此消息，则可以降级到0.3.2。请安装“session_info”以获取最新功能和错误修复。使用和默认值也略有变化，请查阅最新的README，网址为https://gitlab.com/joelostblom/session_info。

“sinfo”输出当前会话、Python、操作系统和CPU的模块版本信息。它设计为最小措施，以提高可重复性，并提供与R中的“sessionInfo”类似的信息。名称缩短是为了通过减少输入来鼓励经常使用=)

动机

在Jupyter笔记本中进行探索性数据分析时，“sinfo”特别有用。在导入模块后列出所有加载模块的版本号是一种确保最低程度可重复性的简单方法，同时需要很少额外的努力。这种方法在回顾笔记本以及与同事共享笔记本时都很有用。“sinfo”旨在补充更健壮的实践，如冻结虚拟环境、容器和binder。

安装

可以通过“pip install sinfo”安装“sinfo”。它不依赖于包管理器来查找版本号，因为它从模块的版本字符串中获取它们。它的唯一依赖项是“stdlib_list”，用于区分标准库和第三方模块。

使用

import math

import natsort
import numpy
import pandas
from sinfo import sinfo


sinfo()

输出

-----
natsort     5.3.3
numpy       1.17.3
pandas      0.25.1
sinfo       0.3.0
-----
Python 3.7.3 | packaged by conda-forge | (default, Dec  6 2019, 08:54:18) [GCC 7.3.0]
Linux-5.4.2-arch1-1-x86_64-with-arch
4 logical CPU cores
-----
Session information updated at 2019-12-14 16:14

默认行为是仅输出不在标准库中的模块，这就是为什么上面省略了 math 模块（可以通过指定 std_lib=True 来包含）。为了包含不仅显式导入的模块，还包括它们内部导入的任何依赖项，请指定 dependencies=True。默认情况下，笔记本输出被隐藏在 <details> 标签中，以避免占用过多的视觉空间。当从笔记本调用时，sinfo 将模块依赖项写入名为 <notebook_name>-requirements.txt 的文件中，该文件与 pip install -r /path/to/requirements.txt 兼容。请参阅文档字符串以获取完整的参数信息。

背景

sinfo 最初是对 py_session 的少量修改，随着其发展，创建一个新包变得方便。在 stackoverflow 答案和现有类似包的帮助下构建了 sinfo，包括

• https://github.com/fbrundu/py_session
• https://github.com/jrjohansson/version_information
• https://stackoverflow.com/a/4858123/2166823
• https://stackoverflow.com/a/40690954/2166823
• https://stackoverflow.com/a/52187331/2166823