py-lll

Python的LLL编译器。

在ReadTheDocs上的[文档](https://py-lll.readthedocs.io/)中了解更多信息。查看[变更日志](https://py-lll.readthedocs.io/en/latest/releases.html)。

快速入门

pip install py-lll

开发者设置

如果您想对py-lll进行黑客攻击，请查看[Snake Charmers战术手册](https://github.com/ethereum/snake-charmers-tactical-manual)以获取有关我们如何做的信息。

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

开发环境设置

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

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

测试设置

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

在文件更改时显示flake8错误

# Test flake8
when-changed -v -s -r -1 lll/ tests/ -c "clear; flake8 lll 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 py-lll failed'" ../tests ../lll

发布设置

对于类似Debian的系统

apt install pandoc

要发布新版本

make release bump=$$VERSION_PART_TO_BUMP$$

如何增加版本号

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

要发布下一个版本，指定要升级的部分，例如 make release bump=minor 或 make release bump=devnum。这通常在主分支上完成，除非发布测试版（在这种情况下，测试版从主分支发布，上一个稳定分支从该分支发布）。为了包含每个版本所做的更改，更新 "docs/releases.rst" 中的更改，并在发布前直接将提交应用到主分支。

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

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