Brownie
Brownie is a Python-based development and testing framework for smart contracts targeting the Ethereum Virtual Machine.
Features
- Full support for Solidity (
>=0.4.22) and Vyper (>=0.1.0-beta.16) - Contract testing via
pytest, including trace-based coverage evaluation - Property-based and stateful testing via
hypothesis - Powerful debugging tools, including python-style tracebacks and custom error strings
- Built-in console for quick project interaction
Dependencies
Installation
via pipx
The recommended way to install Brownie is via pipx. pipx installs Brownie into a virtual environment and makes it available directly from the commandline. Once installed, you will never have to activate a virtual environment prior to using Brownie.
To install pipx:
python3 -m pip install --user pipx
python3 -m pipx ensurepath
To install Brownie using pipx:
pipx install eth-brownie
To upgrade to the latest version:
pipx upgrade eth-brownie
To use lastest master or another branch as version:
pipx install git+https://github.com/eth-brownie/brownie.git@master
via pip
You can install the latest release via pip:
pip install eth-brownie
via setuptools
You can clone the repository and use setuptools for the most up-to-date version:
git clone https://github.com/eth-brownie/brownie.git
cd brownie
python3 setup.py install
as a library
If you want to install brownie inside your own project (rather than as a standalone cli tool):
export BROWNIE_LIB=1
pip install eth-brownie
This loosens the pins on all dependencies. You'll want to make sure you have your own requirements.txt to make sure upgrades upstream don't surprise anyone.
for development
There are extra tools that are helpful when developing:
git clone https://github.com/eth-brownie/brownie.git
cd brownie
python3 -m venv venv
./venv/bin/pip install wheel
./venv/bin/pip install -e . -r requirements-dev.txt
Upgrading the pinned versions of dependencies is easy:
./venv/bin/pip-compile --upgrade
./venv/bin/pip-compile --upgrade requirements-dev.in
./venv/bin/pip-compile --upgrade requirements-windows.in
Even small upgrades of patch versions have broken things in the past, so be sure to run all tests after upgrading things!
Quick Usage
To initialize a new Brownie project, start by creating a new folder. From within that folder, type:
brownie init
Next, type brownie --help for basic usage information.
Documentation and Support
Brownie documentation is hosted at Read the Docs.
If you have any questions about how to use Brownie, feel free to ask on Ethereum StackExchange or join us on Gitter.
Testing
To run the tests, first install the developer dependencies:
pip install -e . -r requirements-dev.txt
Then use tox to run the complete suite against the full set of build targets, or pytest to run tests against a specific version of Python. If you are using pytest you must include the -p no:pytest-brownie flag to prevent it from loading the Brownie plugin.
Using Docker
You can use a sandbox container provided in the docker-compose.yml file for testing inside a Docker environment.
This container provides everything you need to test using a Python 3.6 interpreter.
Start the test environment:
docker-compose up -d
To open a session to the container:
docker-compose exec sandbox bash
To run arbitrary commands, use the bash -c prefix.
docker-compose exec sandbox bash -c ''
For example, to run the tests in brownie/tests/test_format_input.py:
docker-compose exec sandbox bash -c 'python -m pytest tests/convert/test_format_input.py'
Attaching to dockerized RPC clients
You can also attach to a RPC client already running inside a docker container.
For example for running ganache-cli you could just startup the official ganache-cli docker image:
docker run -p 8545:8545 trufflesuite/ganache-cli
Then in another terminal on your host you could connect to it:
brownie console
If you have your RPC client bound to a specific hostname e.g. ganache you could create a separate brownie network for it:
brownie networks add Development dev cmd=ganache-cli host=http://ganache:8545
Then connect to it with:
brownie console --network dev
Contributing
Help is always appreciated! Feel free to open an issue if you find a problem, or a pull request if you've solved an issue.
Please check out our Contribution Guide prior to opening a pull request, and join the Brownie Gitter channel if you have any questions.
License
This project is licensed under the MIT license.
1 maintainer
Metadata
1 maintainer
Release files for eth-brownie 1.19.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| eth-brownie-1.19.3.tar.gz | 216.1 kB | Details |
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| eth_brownie-1.19.3-py3.10.egg | Legacy Egg format | - | - | Details |
| eth_brownie-1.19.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.0 MB
Release files / eth-brownie-1.19.3.tar.gz
| Download URL | eth-brownie-1.19.3.tar.gz |
|---|---|
| Size | 216.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a3659dc23ecf1ab96586d32ffa382736e711b38ccd2fe0fab9cc1617e36e00b0
|
|
BLAKE2b-256 checksum How to use checksums |
020750050bcae93b950eae3842d54c17593c0d5e18d56b717d772ec31be069bd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.2 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.28.1 requests-toolbelt/0.9.1 tqdm/4.64.1 CPython/3.10.9
|
Release files / eth_brownie-1.19.3-py3.10.egg
| Download URL | eth_brownie-1.19.3-py3.10.egg |
|---|---|
| Size | 561.3 kB |
| Tags | Egg |
|
SHA-256 checksum How to use checksums |
7c1a87131563c7ecaa46fcfea43b9528733e652ba7bc1f29f649f668d630a2a8
|
|
BLAKE2b-256 checksum How to use checksums |
d2878c05996e8d4c3987da373d88cb634147461e546771310cb40613b9dab2ca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.2 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.28.1 requests-toolbelt/0.9.1 tqdm/4.64.1 CPython/3.10.9
|
Release files / eth_brownie-1.19.3-py3-none-any.whl
| Download URL | eth_brownie-1.19.3-py3-none-any.whl |
|---|---|
| Size | 232.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d8d3e497d8e056a093006fb27fab6c3a3f97ac5b166f7946db5a46bdcc4eaa8a
|
|
BLAKE2b-256 checksum How to use checksums |
0f9e29445417f0b9ea8e8f964ef3515a7fff8ea225dd2736e2c100c5677a3842
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.2 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.28.1 requests-toolbelt/0.9.1 tqdm/4.64.1 CPython/3.10.9
|
