Skip to main content

Run Go-Ethereum as a subprocess

Project description

# PyGeth [![Build Status](https://travis-ci.org/ethereum/py-geth.png)](https://travis-ci.org/ethereum/py-geth) [![PyPi version](https://img.shields.io/pypi/v/py-geth.svg)](https://pypi-hypernode.com/pypi/py-geth)

Python wrapper around running geth as a subprocess

## System Dependency

This library requires the geth executable to be present.

## Installation

Installation

`bash pip install py-geth `

## Quickstart

To run geth connected to the mainnet

`python >>> from geth import LiveGethProcess >>> geth = LiveGethProcess() >>> geth.start() `

Or a private local chain for testing. These require you to give them a name.

`python >>> from geth import DevGethProcess >>> geth = DevGethProcess('testing') >>> geth.start() `

By default the DevGethProcess sets up test chains in the default datadir used by geth. If you would like to change the location for these test chains, you can specify an alternative base_dir.

`python >>> geth = DevGethProcess('testing', '/tmp/some-other-base-dir/') >>> geth.start() `

Each instance has a few convenient properties.

`python >>> geth.data_dir "~/.ethereum" >>> geth.rpc_port 8545 >>> geth.ipc_path "~/.ethereum/geth.ipc" >>> geth.accounts ['0xd3cda913deb6f67967b99d67acdfa1712c293601'] >>> geth.is_alive False >>> geth.is_running False >>> geth.is_stopped False >>> geth.start() >>> geth.is_alive True # indicates that the subprocess hasn't exited >>> geth.is_running True # indicates that `start()` has been called (but `stop()` hasn't) >>> geth.is_stopped False >>> geth.stop() >>> geth.is_alive False >>> geth.is_running False >>> geth.is_stopped True `

When testing it can be nice to see the logging output produced by the geth process. py-geth provides a mixin class that can be used to log the stdout and stderr output to a logfile.

`python >>> from geth import LoggingMixin, DevGethProcess >>> class MyGeth(LoggingMixin, DevGethProcess): ... pass >>> geth = MyGeth() >>> geth.start() `

All logs will be written to logfiles in ./logs/ in the current directory.

The underlying geth process can take additional time to open the RPC or IPC connections, as well as to start mining if it needs to generate the DAG. You can use the following interfaces to query whether these are ready.

`python >>> geth.is_rpc_ready True >>> geth.wait_for_rpc(timeout=30) # wait up to 30 seconds for the RPC connection to open >>> geth.is_ipc_ready True >>> geth.wait_for_ipc(timeout=30) # wait up to 30 seconds for the IPC socket to open >>> geth.is_dag_generated True >>> geth.is_mining True >>> geth.wait_for_dag(timeout=600) # wait up to 10 minutes for the DAG to generate. `

> The DAG functionality currently only applies to the DAG for epoch 0.

# Installing specific versions of geth

> This feature is experimental and subject to breaking changes.

Versions of geth dating back to v1.5.6 can be installed using py-geth. See [install.py](https://github.com/ethereum/py-geth/blob/master/geth/install.py) for the current list of supported versions.

Installation can be done via the command line:

`bash $ python -m geth.install v1.10.8 `

Or from python using the install_geth function.

`python >>> from geth import install_geth >>> install_geth('v1.10.8') `

The installed binary can be found in the $HOME/.py-geth directory, under your home directory. The v1.10.8 binary would be located at $HOME/.py-geth/geth-v1.10.8/bin/geth.

# About DevGethProcess

The DevGethProcess is designed to facilitate testing. In that regard, it is preconfigured as follows.

  • A single account is created and allocated 1 billion ether.

  • All APIs are enabled on both rpc and ipc interfaces.

  • Account 0 is unlocked

  • Networking is configured to not look for or connect to any peers.

  • The networkid of 1234 is used.

  • Verbosity is set to 5 (DEBUG)

  • Mining is enabled with a single thread.

  • The RPC interface tries to bind to 8545 but will find an open port if this port is not available.

  • The DevP2P interface tries to bind to 30303 but will find an open port if this port is not available.

# Gotchas

If you are running with mining enabled (which is default for DevGethProcess then you will likely need to generate the DAG manually. If you do not, then it will auto-generate the first time you run the process and this takes a while.

To generate it manually:

`sh $ geth makedag 0 ~/.ethash `

This is especially important in CI environments like Travis-CI where your process will likely timeout during generation.

## Development

Clone the repository and then run:

`sh pip install -e ".[dev]" `

### Running the tests

You can run the tests with:

`sh pytest 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”

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

py-geth-3.5.0.tar.gz (21.7 kB view details)

Uploaded Source

Built Distribution

py_geth-3.5.0-py3-none-any.whl (22.9 kB view details)

Uploaded Python 3

File details

Details for the file py-geth-3.5.0.tar.gz.

File metadata

  • Download URL: py-geth-3.5.0.tar.gz
  • Upload date:
  • Size: 21.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.9.6

File hashes

Hashes for py-geth-3.5.0.tar.gz
Algorithm Hash digest
SHA256 09600d409a2553b7d5c5fa4a3222cd66bbad74707b90906fbcf73a6991418272
MD5 eb68e31e7f82eb5c23d1f91b614f74a3
BLAKE2b-256 09cb012b74aca6d7bb06bac6dd8bdcbd3713feb113416de2960c608602217eec

See more details on using hashes here.

File details

Details for the file py_geth-3.5.0-py3-none-any.whl.

File metadata

  • Download URL: py_geth-3.5.0-py3-none-any.whl
  • Upload date:
  • Size: 22.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.4 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.9.6

File hashes

Hashes for py_geth-3.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 85fed64e3edba311f39cce942e8b0ecc152e72c204158b679e16830dfe880615
MD5 24ca9aae77802b0075abfee07f93a621
BLAKE2b-256 2222e88043bf3bc9ffe10f8e5def2d405442f2a188fdb706d8a1f13ac6d2c7b5

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page