发现V5 DHT

P2P Discoveryv5协议的实现

在ReadTheDocs的文档中了解更多信息。 查看变更日志。

快速入门

pip install ddht

要运行它

ddht

--help 将告诉您ddht接受的参数。可以使用LOGLEVEL环境变量来控制哪些日志消息被发出。例如，要抑制Packer的无关紧要的消息，您可以运行

LOGLEVEL=WARNING:ddht.v5.packer.Packer ddht

开发者设置

如果您想对ddht进行黑客攻击，请查看Snake Charmers战术手册，了解我们如何操作

• 测试
• 拉取请求
• 代码风格
• 文档

开发环境设置

您可以使用以下方法设置您的开发环境

git clone git@github.com:ethereum/ddht.git
cd ddht
virtualenv -p python3 venv
. venv/bin/activate
pip install -e .[dev]

测试设置

在开发过程中，您可能希望在每次文件保存时运行测试。

在文件更改时显示flake8错误

# Test flake8
when-changed -v -s -r -1 ddht/ tests/ -c "clear; flake8 ddht tests && echo 'flake8 success' || echo 'error'"

使用单个命令运行多进程测试，但不要使用颜色

# in the project root:
pytest --numprocesses=4 --looponfail --maxfail=1
# the same thing, succinctly:
pytest -n 4 -f --maxfail=1

使用单个线程运行，使用颜色和桌面通知

cd venv
ptw --onfail "notify-send -t 5000 'Test failure ⚠⚠⚠⚠⚠' 'python 3 test on ddht failed'" ../tests ../ddht

发布设置

对于类似Debian的系统

apt install pandoc

要发布新版本

make release bump=$$VERSION_PART_TO_BUMP$$

如何使用bumpversion

此存储库的版本格式为稳定版 {major}.{minor}.{patch}，和不稳定版 {major}.{minor}.{patch}-{stage}.{devnum}（阶段可以是alpha或beta）。

要发布下一个版本，请指定要升级的部分，例如make release bump=minor或make release bump=devnum。这通常在主分支上完成，除非发布beta版本（在这种情况下，beta版本从主分支发布，上一个稳定分支从该分支发布）。

如果您处于beta版本，make release bump=stage将切换到稳定版本。

当当前版本是稳定版本时，发布不稳定版本，请明确指定新版本，例如make release bump="--new-version 4.0.0-alpha.1 devnum"