jetstream

自动实验分析。

Jetstream自动计算指标并对不同分析窗口收集的实验数据进行统计分析。

更多信息请参阅文档。

本地安装

# Create and activate a python virtual environment.
python3 -m venv venv/
source venv/bin/activate
# --no-deps to workaround https://github.com/pypa/pip/issues/9644
pip install --no-deps -r requirements.txt
pip install -e .

运行测试

• 安装tox（包含在requirements.txt中）

• 从您克隆此仓库的任何位置运行tox。 （您不需要先安装jetstream。）

  • 要运行集成测试，请运行tox -e py310-integration。

代码检查

ruff check jetstream

ruff也可以修复代码检查问题

• ruff format jetstream

依赖关系

Jetstream使用pip-tools管理依赖关系，并附带一个运行pip-tools命令的脚本。有两个要求文件由script/update_deps自动生成

• requirements.in：从pyproject.toml中依赖关系列表生成的依赖关系和版本列表。
• requirements.txt：由pip-tools（pip-compile）自动从requirements.in文件生成。还包含每个软件包的哈希值，以便pip在安装时进行验证，以及显示每个依赖项的来源注释。

添加新的依赖项

1. 将依赖项添加到pyproject.toml的依赖项列表中。
2. 使用./script/update_deps生成新的依赖项文件
3. 使用python -m pip install -r requirements.txt进行安装

更新所有依赖项

./script/update_deps

请确保运行pip install --no-deps -r requirements.txt，然后重新安装jetstream（pip install -e .），并测试功能！

更新单个依赖项

0. 建议更新所有依赖项（见上文）！

1. 编辑requirements.in

• mypy==1.8.0 --> mypy==1.9.0

2. 重新生成requirements.txt

• pip-compile --generate-hashes -o requirements.txt requirements.in
  • （注意：这是script/update_deps的最后一条命令）

3. 安装依赖项

• pip install --no-deps -r requirements.txt
• pip install -e .

4. 测试！