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.2.x)
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
Support for ethPM packages

Dependencies

python3 version 3.6 or greater, python3-dev
ganache-cli - tested with version 6.8.2

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

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

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 -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'

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.

Metadata

Release files for eth-brownie 1.10.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for eth-brownie 1.10.2
File	Size	Uploaded
eth-brownie-1.10.2.tar.gz	141.7 kB	Jul 18, 2020	Details

Built distribution (wheel)

Table of built distributions (wheels) for eth-brownie 1.10.2
File	Interpreter	ABI	Platform	Reset
eth_brownie-1.10.2-py3-none-any.whl 168.8 kB Jul 18, 2020	Python 3	none	any	Details

Total release size: 310.5 kB

Release files / eth-brownie-1.10.2.tar.gz

Download URL	eth-brownie-1.10.2.tar.gz
Size	141.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`f4357615e6099f44eda5ca53e5e19250aeecee286e5ff46a3da6a8076becf08d`
BLAKE2b-256 checksum How to use checksums	`50963d34f871dc3d0dbc86925ba0f06691d7ac2c36ecb73d768689e28d6f92b9`
Upload date	Jul 18, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.0 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.2`

Release files / eth_brownie-1.10.2-py3-none-any.whl

Download URL	eth_brownie-1.10.2-py3-none-any.whl
Size	168.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`bed8246d6dd41ef4a8fa8cf8b66dbf4a05313df4e5fb63a72b3aab3b095ca15b`
BLAKE2b-256 checksum How to use checksums	`e13eaed1c79b58a934771438145886432a2cf0698c5b447ad30b2ad40ada4d11`
Upload date	Jul 18, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.0 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.2`