Common utility functions for ethereum codebases.
Project description
# Ethereum Utils
[](https://gitter.im/ethereum/eth-utils)
[](https://circleci.com/gh/ethereum/eth-utils)
[Documentation hosted by ReadTheDocs](https://eth-utils.readthedocs.io/en/latest/)
Common utility functions for codebases which interact with ethereum.
> This library and repository was previously located at https://github.com/pipermerriam/ethereum-utils. It was transferred to the Ethereum foundation github in November 2017 and renamed to `eth-utils`. The PyPi package was also renamed from `ethereum-utils` to `eth-utils.
## Installation
```sh
pip install eth-utils
```
## Development
Clone the repository and then run:
```sh
pip install -e .[dev] eth-hash[pycryptodome]
```
## Documentation
Building Sphinx docs locally:
```sh
pip install -e .[doc]
cd docs
make html
```
Docs are written in [reStructuredText](http://docutils.sourceforge.net/rst.html) and built using the [Sphinx](http://www.sphinx-doc.org/) documentation generator.
### Running the tests
You can run the tests with:
```sh
py.test tests
```
Or you can install `tox` to run the full test suite.
### Releasing
Pandoc is required for transforming the markdown README to the proper format to
render correctly on pypi.
For Debian-like systems:
```
apt install pandoc
```
Or on OSX:
```sh
brew install pandoc
```
To release a new version:
```sh
make release bump=$$VERSION_PART_TO_BUMP$$
```
#### How to bumpversion
The version format for this repo is `{major}.{minor}.{patch}` for stable, and
`{major}.{minor}.{patch}-{stage}.{devnum}` for unstable (`stage` can be alpha or beta).
To issue the next version in line, specify which part to bump,
like `make release bump=minor` or `make release bump=devnum`.
If you are in a beta version, `make release bump=stage` will switch to a stable.
To issue an unstable version when the current version is stable, specify the
new version explicitly, like `make release bump="--new-version 4.0.0-alpha.1 devnum"`
[](https://gitter.im/ethereum/eth-utils)
[](https://circleci.com/gh/ethereum/eth-utils)
[Documentation hosted by ReadTheDocs](https://eth-utils.readthedocs.io/en/latest/)
Common utility functions for codebases which interact with ethereum.
> This library and repository was previously located at https://github.com/pipermerriam/ethereum-utils. It was transferred to the Ethereum foundation github in November 2017 and renamed to `eth-utils`. The PyPi package was also renamed from `ethereum-utils` to `eth-utils.
## Installation
```sh
pip install eth-utils
```
## Development
Clone the repository and then run:
```sh
pip install -e .[dev] eth-hash[pycryptodome]
```
## Documentation
Building Sphinx docs locally:
```sh
pip install -e .[doc]
cd docs
make html
```
Docs are written in [reStructuredText](http://docutils.sourceforge.net/rst.html) and built using the [Sphinx](http://www.sphinx-doc.org/) documentation generator.
### Running the tests
You can run the tests with:
```sh
py.test tests
```
Or you can install `tox` to run the full test suite.
### Releasing
Pandoc is required for transforming the markdown README to the proper format to
render correctly on pypi.
For Debian-like systems:
```
apt install pandoc
```
Or on OSX:
```sh
brew install pandoc
```
To release a new version:
```sh
make release bump=$$VERSION_PART_TO_BUMP$$
```
#### How to bumpversion
The version format for this repo is `{major}.{minor}.{patch}` for stable, and
`{major}.{minor}.{patch}-{stage}.{devnum}` for unstable (`stage` can be alpha or beta).
To issue the next version in line, specify which part to bump,
like `make release bump=minor` or `make release bump=devnum`.
If you are in a beta version, `make release bump=stage` will switch to a stable.
To issue an unstable version when the current version is stable, specify the
new version explicitly, like `make release bump="--new-version 4.0.0-alpha.1 devnum"`
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
eth-utils-1.3.0b0.tar.gz
(12.7 kB
view details)
Built Distribution
File details
Details for the file eth-utils-1.3.0b0.tar.gz.
File metadata
- Download URL: eth-utils-1.3.0b0.tar.gz
- Upload date:
- Size: 12.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.3.0 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.6.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2aaf7ca762b5b771243effd7abcb462148d320714205b1360cc98317433c9b73 |
|
| MD5 | 9ed8571043d243f2c88c9493c9508bb6 |
|
| BLAKE2b-256 | a955a9063ef366706a1bd6ea05eae89ddfc5949b2ce5e3172fa07f7140a0ceac |
File details
Details for the file eth_utils-1.3.0b0-py2-none-any.whl.
File metadata
- Download URL: eth_utils-1.3.0b0-py2-none-any.whl
- Upload date:
- Size: 18.9 kB
- Tags: Python 2
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.3.0 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.6.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | fe5195004f6c579df50b39a50b822882a3d2b6a71eb3b3946a54a2ff6f72f03b |
|
| MD5 | 87f187423a50472ab10883764947147f |
|
| BLAKE2b-256 | bdd871352de5d268b3107da3f6a2b5d80f637001853ac857dceec62b77e608ef |
