PyGeth 是一个 Python 封装库,用来作为子进程运行 geth。

系统依赖

该库需要 geth 可执行文件。

安装

pip install py-geth

快速启动

运行连接到 mainnet 的 geth

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

或者是用于测试的私人本地区块链。这就要求你给他们一个名字。

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

默认情况下,DevGethProcess 在 geth 使用的默认 datadir 设置测试链。如果要更改这些测试链的位置,可以指定替代 base_dir

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

每个实例都有一些方便的属性。

>>> 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 # 表示子进程尚未退出
>>> geth.is_running
True # 表示调用了start(),但是没有stop()
>>> geth.is_stopped
False
>>> geth.stop()
>>> geth.is_alive
False
>>> geth.is_running
False
>>> geth.is_stopped
True

在测试时,可以很好地查看 geth 进程生成的日志记录输出。py-geth 提供了一个 mixin 类,可用于将 stdout 和 stderr 输出记录到日志文件中。

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

所有日志都将写入当前目录./logs/ 中的日志文件。

底层 geth 进程可能需要额外的时间来打开 RPC 或 IPC 连接,以及在需要生成 DAG 时开始挖掘。你可以使用以下接口来查询这些接口是否已准备就绪。

>>> geth.is_rpc_ready
True
>>> geth.wait_for_rpc(timeout=30) # 等待最多30秒,以便打开RPC连接。
>>> geth.is_ipc_ready
True
>>> geth.wait_for_ipc(timeout=30) # 等待最多30秒,以便IPC套接字打开。
>>> geth.is_dag_generated
True
>>> geth.is_mining
True
>>> geth.wait_for_dag(timeout=600) # 等待最多10分钟,以便生成DAG。

DAG 功能目前仅适用于 epoch 0。

安装特定版本的 geth

此功能是实验性的,可能会发生重大变化。

可以使用 py-geth 在列出的平台上安装以下任何版本的 geth 。

  • v1.5.6 (linux/osx)
  • v1.5.7 (linux/osx)
  • v1.5.8 (linux/osx)
  • v1.5.9 (linux/osx)
  • v1.6.0 (linux/osx)
  • v1.6.1 (linux/osx)
  • v1.6.2 (linux/osx)
  • v1.6.3 (linux/osx)
  • v1.6.4 (linux/osx)
  • v1.6.5 (linux/osx)
  • v1.6.6 (linux/osx)
  • v1.6.7 (linux/osx)
  • v1.7.0 (linux/osx)
  • v1.7.2 (linux/osx)
  • v1.8.1 (linux/osx)

可以通过命令行完成安装:

$ python -m geth.install v0.4.12

或者使用 install_geth 函数从 python 安装。

>>> from geth import install_geth
>>> install_geth('v1.7.0')

已安装的二进制文件可以在 $HOME/.py-geth 目录下找到。v1.7.0 二进制文件位于 $HOME/.py-geth/geth-v1.7.0/bin/geth


关于 DevGethProcess

DevGethProcess 旨在促进测试。在这方面,它预先配置如下。

  • 创建一个帐户并分配 10 亿以太。
  • 在 rpc 和 ipc 接口上都启用了所有 API。
  • 帐户 0 已解锁。
  • 网络配置为不查找或连接到任何对等方。
  • 使用 1234 的 networkid
  • 测试程度设为 5(DEBUG)
  • 使用单个线程启用挖掘。
  • RPC 接口尝试绑定到 8545,但如果此端口不可用,则会找到一个开放端口。
  • DevP2P 接口尝试绑定到 30303,但如果此端口不可用,将找到一个开放端口。

Gotchas

如果你在启用 mining 情况下运行(这是 DevGethProcess 默认设置,那么你可能需要手动生成 DAG。如果不这样做,那么它将在你第一次运行该过程时自动生成,这需要一段时间。

要手动生成它:

$ geth makedag 0 ~/.ethash

这在像 Travis-CI 这样的 CI 环境中尤其重要,在这种情况下,你的流程可能会在生成期间超时。

开发


克隆存储库然后运行:

pip install -e . -r requirements-dev.txt

运行测试


可以使用以下命令运行测试:

py.test tests

或者你可以安装 tox 来运行完整的测试套件。


发布

需要 Pandoc 才能将 markdown README 转换为正确的格式,以便在 pypi 上正确呈现。

对于类似 Debian 的系统:

apt install pandoc

或者在 OSX 上:

brew install pandoc

要发布新版本:

make release bump=$$VERSION_PART_TO_BUMP$$

如何 bump 版本

此 repo 的版本格式为 {major}.{minor}.{patch} 表示 stable,{major}.{minor}.{patch} {major}.{minor}.{patch}-{stage}.{devnum} 表示 unstable(stage 可以是 alpha 或 beta)。

要在行中发布下一个版本,请指定要 bump 的部分,例如 make release bump=minor 或 make release bump=devnum

如果你处于测试版,则 make release bump=stage 将切换为稳定版。

要在当前版本稳定时发出不稳定版本,请明确指定新版本,例如 make release bump="--new-version 4.0.0-alpha.1 devnum"

Python 的 Geth 封装库 PyGeth的更多相关文章

  1. VBA/VB6/VBS/VB.NET/C#/Python/PowerShell都能调用的API封装库

    API函数很强大,但是声明的时候比较繁琐. 我开发的封装库,包括窗口.键盘.鼠标.消息等常用功能.用户不需要添加API函数的声明,就可以用到API的功能. 在VBA.VB6的引用对话框中引用API.t ...

  2. 【归纳】正则表达式及Python中的正则库

    正则表达式 正则表达式30分钟入门教程 runoob正则式教程 正则表达式练习题集(附答案) 元字符\b代表单词的分界处,在英文中指空格,标点符号或换行 例子:\bhi\b可以用来匹配hi这个单词,且 ...

  3. Python测试 ——开发工具库

    Web UI测试自动化 splinter - web UI测试工具,基于selnium封装. selenium - web UI自动化测试. mechanize- Python中有状态的程序化Web浏 ...

  4. Python常用的标准库以及第三方库有哪些?

    20个必不可少的Python库也是基本的第三方库 读者您好.今天我将介绍20个属于我常用工具的Python库,我相信你看完之后也会觉得离不开它们.他们是: Requests.Kenneth Reitz ...

  5. Python常用的标准库以及第三方库

    Python常用的标准库以及第三方库有哪些?   20个必不可少的Python库也是基本的第三方库 读者您好.今天我将介绍20个属于我常用工具的Python库,我相信你看完之后也会觉得离不开它们.他们 ...

  6. Mac os 下 python爬虫相关的库和软件的安装

      由于最近正在放暑假,所以就自己开始学习python中有关爬虫的技术,因为发现其中需要安装许多库与软件所以就在这里记录一下以避免大家在安装时遇到一些不必要的坑. 一. 相关软件的安装:   1. h ...

  7. Python系列——常用第三方库

    幕布视图(更加方便.明了):https://mubu.com/doc/AqoVZ8x6m0 参考文献:嵩天老师的Python讲义 模块 定义 计算机在开发过程中,代码越写越多,也就越难以维护,所以为了 ...

  8. Python 常用的标准库以及第三方库有哪些?

    作者:史豹链接:https://www.zhihu.com/question/20501628/answer/223340838来源:知乎著作权归作者所有.商业转载请联系作者获得授权,非商业转载请注明 ...

  9. python爬虫03 Urllib库

    Urllib   这可是 python 内置的库 在 Python 这个内置的 Urllib 库中 有这么 4 个模块 request request模块是我们用的比较多的 就是用它来发起请求 所以我 ...

随机推荐

  1. windows下PyCharm安装及使用 【转自 https://blog.csdn.net/yctjin/article/details/70307933?locationNum=11&fps=1】

    一.首先安装pycharm,可以参考这篇文章:http://www.jianshu.com/p/042324342bf4 搭建环境 1.win10_X64,其他Win版本也可以.2.PyCharm版本 ...

  2. php 图片指定留白叠加缩放

    遇到这样一个需求:原图大小不一,而且留白也大小不一,需要将原图切出来一个核心图,然后将图片左右留白,组成一个其他尺寸的图片.换句话说,原图在新图片中的位置是可以控制的. 这里思路是:先创建一个规定大小 ...

  3. 【原创】003 | 搭上基于SpringBoot事务思想实战专车

    前言 如果这是你第二次看到师长,说明你在觊觎我的美色! 点赞+关注再看,养成习惯 没别的意思,就是需要你的窥屏^_^ 专车介绍 该趟专车是开往基于Spring Boot事务思想实战的专车,在上一篇 搭 ...

  4. luogu P2417 课程

    题目描述 n个学生去p个课堂,每一个学生都有自己的课堂,并且每个学生只能去一个课堂,题目要求能够安排每一个课堂都有人吗? 输入格式 第一行是测试数据的个数, 每组测试数据的开始分别是p和n, 接着p行 ...

  5. HDU1517 Multiply Game

    Stan and Ollie play the game of multiplication by multiplying an integer p by one of the numbers 2 t ...

  6. ubuntu文件权限

    以root身份登录linux. 在某一目录下执行 ls -al,显示类似如下内容: dr-xr-x---. 14 root root 4096 Aug 27 09:38 . dr-xr-xr-x. 2 ...

  7. kerberos&ssh 原理、免密登录搭建

    原理 详细介绍 参考oracle文档:Kerberos 服务 安装过程 1.安装krb5 yum install -y krb5-server yum install krb5-workstation ...

  8. 基于FPGA+USB2.0的图像采集系统测试小结-mt9m001

    基于FPGA+USB2.0的图像采集系统测试小结-mt9m001 该系统采用层层惊涛出品的FPGA_VIP_USB_V102板卡测试 板卡分为:核心板.底板.摄像头板 核心板采用:ep4ce10e22 ...

  9. redis(4)--redis集群之主从复制

    集群 先来简单了解下redis中提供的集群策略, 虽然redis有持久化功能能够保障redis服务器宕机也能恢复并且只有少量的数据损失,但是由于所有数据在一台服务器上,如果这台服务器出现硬盘故障,那就 ...

  10. 面试BAT前先搞定这18道MySQL经典面试题(含答案解析)

    一.MySQL的复制原理以及流程 (1)复制基本原理流程 1. 主:binlog线程——记录下所有改变了数据库数据的语句,放进master上的binlog中: 2. 从:io线程——在使用start ...