brownie
id:eth-brownie/brownie ·
· 目录记录
项目概述
Brownie是面向EVM智能合约的Python开发与测试框架,支持Solidity/Vyper项目的pytest测试、基于Hypothesis的属性/状态测试、调试回溯和交互控制台。作者已声明不再活跃维护,并建议新的Python以太坊开发需求改用Ape Framework;本资料按文档描述其历史能力,不把它当作持续维护的首选工具。
原项目介绍
忠实中文 / 作者自述整理
作者定义Brownie为针对EVM的Python开发测试框架,并列明:Solidity>=0.4.22与Vyper>=0.1.0-beta.16、pytest及基于trace的覆盖率、Hypothesis属性/状态测试、Python风格回溯与自定义错误、内置控制台。依赖为Python 3.10+及hardhat或ganache;因ganache已sunset,一般建议hardhat。安装推荐pipx,也可用pip、setuptools或BROWNIE_LIB=1作为库(会放松依赖钉版本)。初始化为在空目录执行brownie init。文档托管于Read the Docs。许可为MIT。
短摘 / 原文
Brownie is no longer actively maintained
出处:https://github.com/eth-brownie/brownie/blob/HEAD/README.md
translation_kind:实际选读作者README定位段的忠实中文要点;非全文翻译
excerpt_kind:readme_literal
source_kind:official_repository_readme_via_sanctioned_github_tool
is_self_report:True
excerpt_truncated:False
当前具体详情
做什么
Brownie是面向EVM智能合约的Python开发与测试框架,支持Solidity/Vyper项目的pytest测试、基于Hypothesis的属性/状态测试、调试回溯和交互控制台。作者已声明不再活跃维护,并建议新的Python以太坊开发需求改用Ape Framework;本资料按文档描述其历史能力,不把它当作持续维护的首选工具。
谁会用
使用Python编写、测试或在控制台中与EVM合约交互的开发者;新项目需自行评估停更风险或转向作者推荐的Ape。
用户画像依据
按已读作者定位与功能归纳;非客户规模或效果调查
解决的问题(编辑归纳)
Python开发者需要在本地测试框架中编译、测试并与EVM合约交互。
文档化使用场景(编辑归纳)
pipx安装后brownie init,再配合hardhat或ganache做测试或控制台交互。须注意项目已停更,新需求作者指向Ape。
主要能力与用途
在Python中管理Solidity/Vyper合约项目,并用pytest做合约测试,包括基于执行trace的覆盖率评估。
可通过Hypothesis做基于属性和状态的测试;提供Python风格回溯和自定义错误字符串以便调试。
内置控制台用于快速与项目交互;也可在Docker或已运行的ganache等RPC上连接(文档示例,未在本研究执行)。
可作为独立CLI或用BROWNIE_LIB=1装进现有项目;后者会放松依赖版本,作者提醒需自备requirements以免上游升级导致意外。
如何使用 / 既有稿流程
文档场景:用pipx安装eth-brownie→新建目录并brownie init→以brownie --help查看命令,在测试或控制台中与本地hardhat/ganache交互。完整命令与工作流见官方Read the Docs,本次未通读。本研究不安装、不启动本地链、不部署合约。
用法证据状态
documented_workflow_only_not_executed
公开限制
作者明确不再活跃维护,未来版本可能很少或不再发布;不能把当前文档当作长期支持承诺。
依赖外部本地链(推荐hardhat,ganache已sunset);Python需3.10+。
官方文档网站未在本轮逐页阅读,因此编译器标志、网络配置和发布流程等细节仍待补。
作为库安装会放松依赖钉版本,存在升级风险。
未核实 / 来源缺口
仅所列README范围;未读实现、安装、运行、登录、测试、交易或连接钱包;不把作者宣传当安全/收益验证。
许可讨论
spdx_snapshot
MIT
discussion_zh
README写明MIT,快照为MIT。全文未读。
strict_open_source_verified
False
full_license_text_read
False
完成评估
status
specific_details_complete
count_as_completed
True
reason_zh
已逐项阅读所列README/官方文档,复核具体功能、用户、问题、场景/流程、依赖及边界;仅文档级具体描述,不是运行/源码核验。
completion_scope_zh
文档级具体描述;非源码/运行、安全、收益或许可全文核验
standard_id
pt780u-concrete-v1
problem_solved_zh
Python开发者需要在本地测试框架中编译、测试并与EVM合约交互。
documented_use_case_zh
pipx安装后brownie init,再配合hardhat或ganache做测试或控制台交互。须注意项目已停更,新需求作者指向Ape。
assistant_itemwise_content_reviewed
True
human_reviewed
False
assessed_cst
2026-11-17T08:56:36.072419+08:00
来源
https://github.com/eth-brownie/brownie/blob/HEAD/README.md
local_path 未打进数据包,不生成链接:research/sources/eth-brownie/brownie/README.md.phase036-tool.txt
{ "kind": "official_repository_readme_via_sanctioned_github_tool", "saved_cst": "2026-11-17T08:56:16.344705+08:00", "sha256": "fc17fbb994415ba3f768c55f3ca3cc914c10b3d5c9cbbea3ec4d8b9063e8aead", "read_scope": "选读README的定位、停更声明、功能/依赖、安装与brownie init用法;未读ReadTheDocs全文,不安装或运行框架", "capture_kind": "raw_text_tool_result_wrapper", "immutable_commit_verified": false, "readme_read": true, "source_code_read": false }https://github.com/eth-brownie/brownie
{ "kind": "repository_author_metadata_description_and_topics", "snapshot_cst": "2026-11-16T23:03:16+08:00", "description": "A Python-based development and testing framework for smart contracts targeting the Ethereum Virtual Machine.", "topics": [ "ethereum", "solidity", "vyper", "web3py" ], "record_sha256": "33e7f0ecd07ce8c7809a8510d9599762d8dde270a827920705f1e75573e947a3", "read_scope": "逐项重读作者description前900字符(更长者明确截断)、topics前12项及星数/时间/许可快照;旧文档限制沿用须标非新增核验", "readme_read": false }
研究层级与范围
{
"tier": "B1_readme_light_intro",
"status": "readme_based_brief_available_not_code_or_full_documentary_audit",
"new_source_read_this_phase": true,
"readme_read": true,
"read_scope": "选读README的定位、停更声明、功能/依赖、安装与brownie init用法;未读ReadTheDocs全文,不安装或运行框架",
"source_code_read": false,
"human_reviewed": false,
"human_tested": false,
"not_full_documentary_study": true,
"previous_metadata_profile_generation": "working_copy_after_phase010-b010-20261117T084141+0800",
"previous_metadata_profile_sha256": "a31e38a77c50b4ba340e6f23dbe403f47ca7a6cccaa86ebf24827f8deedeb03e"
}