电压测试

没有任何

先决条件

• 蟒蛇 3.8
• 诗歌

Python

volttron-testing 需要 Python 3.8 或更高版本。

要安装 Python 3.8，我们建议使用pyenv。

# install pyenv
git clone https://github.com/pyenv/pyenv ~/.pyenv

# setup pyenv (you should also put these three lines in .bashrc or similar)
export PATH="${HOME}/.pyenv/bin:${PATH}"
export PYENV_ROOT="${HOME}/.pyenv"
eval "$(pyenv init -)"

# install Python 3.8
pyenv install 3.8.10

# make it available globally
pyenv global system 3.8.10

诗歌

该项目用于poetry安装和管理依赖项。要安装诗歌，请按照这些说明进行操作。

安装和虚拟环境设置

如果要安装所有依赖项，包括帮助开发代理的依赖项，请运行以下命令：

poetry install

如果您只想安装运行代理所需的依赖项，请运行以下命令：

poetry install --no-dev

将环境设置在您的项目目录中：

poetry config virtualenvs.in-project true

激活虚拟环境：

poetry shell

Git 设置

1. 要使用 git 管理版本控制，请在本地代理项目中创建一个新的 git 存储库。

git init

2. 然后在你的 Github 或 Gitlab 帐户中创建一个新的 repo。在您的 Github 或 Gitlab 帐户中复制指向该新存储库的 URL。这将被称为我们的“远程”。

3. 将远程（即来自您的 Github 或 Gitlab 帐户的新 repo URL）添加到您的本地存储库。运行以下命令：

git remote add origin <my github/gitlab URL>

当您推送到您的存储库时，请注意默认分支称为“主”。

可选配置

预提交

安装预提交钩子：

pre-commit install

要对所有文件运行预提交，请运行以下命令：

pre-commit run --all-files

如果您安装了 precommit 并且您希望在每次运行提交时忽略运行提交挂钩，请在提交中包含该--no-verify标志。下面是一个例子：

git commit -m "Some message" --no-verify

文档

要构建文档，请导航到“文档”目录并构建文档：

cd docs
make html

文档构建完成后，在浏览器中查看 html 格式的文档。html 文件将位于~<path to agent project directory>/docs/build/html.

提示：要直接从命令行打开文档的登录页面，请运行以下命令：

open <path to agent project directory>/docs/build/html/index.html

这将在您的默认浏览器（例如 Chrome、Firefox）中打开文档登录页面。