hyperledger/fabric-sdk-py

Fabric-SDK-Py

镜像概述和主要用途

Fabric-SDK-Py是Hyperledger Fabric SDK的Python 3.x实现，主要支持Fabric 1.4.x版本。该SDK提供与Hyperledger Fabric网络交互的Python API，便于开发者使用Python语言开发、测试和部署基于Fabric的应用。

核心功能和特性

• 支持Python 3.x环境
• 与Hyperledger Fabric 1.4.x版本兼容
• 提供完整的API用于与Fabric网络交互（包括链码调用、交易处理、身份管理等）
• 支持虚拟环境隔离，确保开发环境清洁
• 提供集成测试框架，便于功能验证
• 可生成Docker镜像，简化部署流程

使用场景和适用范围

适用于需要使用Python语言开发基于Hyperledger Fabric***平台应用的开发者，包括但不限于：

• ***应用开发
• 链码测试与调试
• Fabric网络交互脚本编写
• ***系统集成

使用方法和配置说明

前置要求

SDK需要安装Python3和Libssl软件包。根据操作系统，使用以下命令安装前置依赖：

有关构建加密库的更多详细信息，请参见安装Python加密库。

教程

阅读https://fabric-sdk-py.readthedocs.io/en/latest/tutorial.html（源文件）以熟悉API。Jupyter笔记本形式的示例代码说明可在此处找到。

快速测试

使用虚拟环境

https://virtualenv.pypa.io有助于提供清洁的环境，建议使用它进行测试：

sh
$ pip3 install virtualenv  # 安装virtualenv工具（如未安装）
$ make venv  # 创建虚拟环境
$ source venv/bin/activate  # 激活虚拟环境
$ # 在此处进行测试
$ deactivate  # 退出虚拟环境
$ make clean  # 清理临时文件

运行集成测试

使用以下命令运行测试：

sh
$ make check  # 检查环境并运行测试
$ make test  # 仅运行测试用例
$ tox -e py3 -- test/integration/ca_test.py  # 运行指定测试用例

生成Docker镜像

以下命令将构建Docker镜像hyperledger/fabric-sdk-py：

sh
$ make image

重新生成protos

确保已安装grpcio-tools（pip install grpcio-tools）：

sh
$ make proto

其他信息

变更日志

请参见变更日志获取提交记录。在新发布前运行make changelog更新变更日志。

Bug、问题和代码贡献

欢迎任何形式的贡献，例如https://jira.hyperledger.org/projects/FABP、https://chat.hyperledger.org/channel/fabric-sdk-py和https://github.com/hyperledger/fabric-sdk-py/tree/master/docs！建议在采取行动前阅读贡献指南。

其他重要链接

• https://wiki.hyperledger.org/display/fabric/Hyperledger+Fabric+SDK+Py
• https://www.hyperledger.org
• http://lists.hyperledger.org/
• https://chat.hyperledger.org

孵化通知

该项目目前处于孵化阶段，于2016年9月8日由Hyperledger TSChttps://docs.google.com/document/d/1N-KbwlFb7Oo_pTG2NjjLTqwlhqp_kjyv5fco7VH8WrE/并http://lists.hyperledger.org/pipermail/hyperledger-tsc/2016-September/000292.html。

许可证

Hyperledger Fabric-SDK-Py软件使用Apache License Version 2.0软件许可证。

http://creativecommons.org/licenses/by/4.0/
本文档采用http://creativecommons.org/licenses/by/4.0/进行许可。