NEXT社区|小课堂
由于近期NEXT社区加入很多新的小伙伴，有在校大学生，有对区块链感兴趣的传统企业从业者。为了更方便、更系统的让NEXT社区的伙伴们了解NEO的技术知识，因此我们开设了小课堂，每周3节，向大家普及NEO相关的知识要点！
NEXT社区小课堂|第十三课
NEOPython编译器介绍
neo-boa编译器介绍
neo-boa编译器可将Python文件编译为.avm格式，在NEO虚拟机中运行。NEO虚拟机可在NEO区块链上执行合约。
编译器支持Python语言子集。
1、目前功能
·?将Python语言子集编译成.avm格式，在NEO虚拟机上运行
·??适用于Python3.4与3.5
2、未来功能
·?编译更广泛的Python语言子集
·??适用于Python3.6
3、已支持的Python功能
下文为目前支持的Python功能一览。详细介绍请参见boa.tests.src目录中的案例
4、流控制
If、Else、Elif、While、Break、Methodcalls、Lamdbas、forxin
5、用于整数运算的算数运算符与相等运算符
ADD、SUB、MUL、DIV、ABS、LSHIFT、RSHIFT、AND、OR、XOR、MODULO、INVERT、GT、GTE、LT、LTE、EQ、NOTEQ
6、使用自定义内置功能进行列表创建。注意列表一经创建，其长度便不可更改。
fromboa.code.builtinsimportlist
#thisworks
x=list(length=10)
x=84
#thisalsoworks
x=
#thisdoesNOTwork
x=
x.append(1)
#支持列表操作
x=
y=x
#在可能的情况下，Python的某些__builtins__
CoinEx上线OKU，支持自由交易随充随提:据官方消息，为了帮助OKEx用户资产更好的流通，CoinEx于10月20日上线了一种特殊的资产：OKU，每1个OKU代表在OKEx平台持有的1 USDT，并支持OKU与USDT的交易。用户可以在OKEx通过内部转账的方式，将USDT资产转账到CoinEx指定的OKEX账户上，在CoinEx上将自动按照 1 : 1 比例获得OKU。用户通过在CoinEx上交易OKU即可兑换为USDT变现。[2020/10/20]
#已经根据NEO虚拟机的特点以自定义的方式实现
fromboa.code.builtinsimportrange
xrange=range(1,30)
#thisalsoworks
foriinrange(2,21):
i=i1
安装
1、使用pip
pipinstallneo-boa
2、手动安装
克隆存储库，进入项目目录后创建Python3虚拟环境，并通过以下指令激活。
python3?-mvenvvenvsourcevenv/bin/activate
或单独安装Python3.5
virtualenv?-p?/usr/local/bin/python3.5venvsourcevenv/bin/activate
或单独安装Python3.5
virtualenv?-p?/usr/local/bin/python3.5venvsourcevenv/bin/activate
接着，通过以下指令安装需求
pipinstall?-rrequirements.txt
3、基本用途
编译器使用指南如下
fromboa.compiler?import?CompilerCompiler.load_and_save('path/to/your/file.py')
4、许可证
·开源MIT?
·主作者为localhuman
5、boa.compiler.Compiler
分析 | 根据LEO销毁数据 Bitfinex过去三个月收入约为3400万美元:The Block发布分析文章称，根据LEO的销毁数据，Bitfinex在过去三个月的收入约为3400万美元（平均每天331500美元）。Bitfinex的收入一直在下降，因为整个市场的交易量持续下降。（The Block）[2019/9/26]
下文将介绍Compiler的具体实现细则。
6、classboa.compiler.Compiler
主编译器接口类
通过下列程序加载python文件，编译为.avm格式，并与python文件存储在一个地方。
fromboa.compilerimportCompilerCompiler.load_and_save(‘path/to/your/file.py’)#returnthecompilerobjectforinspectioncompiler=Compiler.load(‘path/to/your/file.py’)#retrievethedefaultmoduleforinpectiondefault_module=compiler.default#retreivethedefault/entrymethodforthesmartcontractentry_method=default_module.main
7、defaule
取回默认或“入口”模块。
返回值：默认反回值为boa.code.Module对象，异常时无返回值
8、staticinstance()
取回当前编译器对象的实例，否则创建一个实例
返回值：编译器对象的单个实例
9、staticload(path)
调用load来加载需编译但无需写为.avm格式的Python文件
参数：path–Python文件的编译路径
返回值：编译器实例
用途：通过下述程序返回编译器对象进行检查
fromboa.compiler?import?Compilercompiler?=?Compiler.load(‘path/to/your/file.py’)
10、staticload_and_save(path,output_path=None)
动态 | 报告：比特币多头在Bitfinex的表现强于空头 但看涨信号尚未确定:据AMBcrypto 9月14日消息，根据datamish.com最近的一份报告，在过去几个月里，Bitfinex交易所比特币空头交易的资本流动大幅下降，但该交易所的全部空头头寸尚未收复年初的部分利润率。据估计，价值2亿美元的比特币被押注于Bitfinex的空头保证金，5月份Bitfinex的保证金大幅下跌。随后也出现了几次类似的下跌，7月份的最后一次暴跌导致总保证金低于5000枚BTC。做空比特币的交易显示出一种看涨的趋势，但有趣的是，资本外出并没有进入比特币的多头头寸。自7月以来，多头头寸的投资呈现逐步增长，但增量已低于10000枚BTC，并且没有平衡耗尽BTC空头的约20000枚BTC。截至发稿时，Bitfinex上的多头保证金总额为27.4万枚比特币，空头保证金总额为12.64万枚比特币。按照目前的价格，交易员在比特币多头上押注的资金超过3亿美元，而在比特币空头上押注的资金不足1.3亿美元。[2019/9/15]
调用load_and_save来加载需编译为.avm格式的Python文件，并保存结果。
默认情况下，最终生成的.avm文件将与源文件存储在一个地方。
参数：
·path——Python文件的编译路径
·output_path——已编译的.avm文件的可选保存路径
返回值：返回编译器实例
用途：通过下述代码返回编译器对象进行检查
fromboa.compilerimportCompiler
Compiler.load_and_save(‘path/to/your/file.py’)
11、write()
返回值：已编译的Python程序的字节串
12、staticwrite_file(data,path)
通过指定路径将输出数据存储至文件系统
参数：
·data——待写入磁盘的数据字节串
·path——文件写入路径
13、boa.code.module.Module
下文将介绍Module的具体实现细则。
14、classboa.code.module.Module(path,module_name=”,is_sys_module=False,items_to_import=None)
动态 | Nexo加密货币钱包推出OTC交易及借贷平台服务:据Bitcoin Exchange Guide报道，Nexo加密货币钱包宣布推出场外交易以及借贷平台服务。该公司计划向无法在正常交易所获得流动性的机构、大型零售和企业客户提供私有化和个性化的场外交易服务。据悉，Nexo是一家加密货币交易所，允许用户交易数字资产，使用加密货币贷款并以高回报借出数字资产。[2019/7/4]
模块是包含代码对象的顶层组件。例如，在path/to/my/file.py的编译过程中，file.py中包含的项目即为模块。一个可执行项可包含多个模块。上述案例中的“默认”或“入口”模块即为file.py。
调用Compiler.load_and_save(‘path/to/file.py’)时会专门为file.py创建一个模块。若file.py导入了其他任何功能，那些模块也会被添加至可执行项中，并置于Module.loaded_modules属性中。
在模块被当做方法处理，方法被当做基本块处理，基本块被处理为标记后，主模块或default模块的write()方法即被调用，将可执行项写为字节串，返回磁盘并存储。
如果您想检查模块内容，可使用Compiler.load(‘path/to/file.py’)，该功能将返回一个编译器实例。获取该实例后，您便可以访问编译器的default模块，从而访问该默认模块中装入的其他模块。
各模块均包含byteplay3对象bp的引用，该对象包含可在Python解释器中显示的指令集。
您可对具备bp属性的任意对象调用print(module.bp.code)，结果将输出一段Python解释器代码。
fromboa.compilerimportCompiler
module=Compiler.load
(‘./boa/tests/src/AddTest1.py’).default
print(module.bp.code)
LOAD_CONST
LOAD_CONST‘Main’
MAKE_FUNCTION0
STORE_NAMEMain
LOAD_CONSTNone
RETURN_VALUE
数字货币交易所 Bitfinex上线6种数字资产:领先的数字货币交易所 Bitfinex今日宣布上线6种数字资产，其中包括BAT, ZRX, FUN, MANA, SPANK以及 TNB, 此外，这些新上的数字资产均开通了BTC, ETH以及 USD交易对，而当交易对流动性足够时，Bitfinex将会开启杠杠交易。[2018/1/9]
对可执行项进行处理与标记化后，便会生成虚拟机标记集，虚拟机标记虽与byteplay3标记相类似，但仍存在显著区别。这些标记均包含在该模块的all_vm_tokens属性中。
您可调用module.to_s()来查看该程序，因为该程序已根据NEO虚拟机的特点进行了标记化。
>>>module.to_s()
LOAD_FAST?
LOAD_CONST
BINARY_MULTIPL??
STORE_FAST?
LOAD_FAST?
LOAD_CONST?
BINARY_ADD????
LOAD_FAST
LOAD_CONST
BINARY_TRUE_DIVIDE
STORE_FAST?
LOAD_FAST?
LOAD_CONST?
BINARY_SUBTRACT
STORE_FAST
b''
LOAD_FAST
LOAD_FAST
BINARY_ADD????
LOAD_FAST?
BINARY_ADD
LOAD_FAST?
BINARY_ADD
NOP
15、add_method(method)
在模块中添加方法如下：
Parameters:?method(boa.code.method.Method)——模块中待添加的方法对象
返回值：显示是否已添加该方法
返回值类型：布尔值
16、build()
将bp.code对象拆分成行，并合并多行，生成不同的项目。
17、link_methods()
关联各方法地址
18、main
返回该模块的默认方法
返回值：该模块的默认方法
返回值类型：boa.code.method.Method
19、method_by_name(method_name)
在模块的methods列表中查找方法名称:parammethod_name:
待查找的方法名称：typemethod_name:str
返回值：方法
返回值类型：boa.code.method.Method
20、module_path
返回该模块的文件路径
返回值：模块路径
返回值类型：str
21、orderered_methods
方法序列表
返回值：该模块中的方法序列表
返回值类型：列表
22、process_action(lineset)
处理模块中的动作，样本如下，其目的类似于创建下列事件：
fromboa.blockchain.vm.Neo.ActionimportRegisterAction
#Registertheaction.
onRefund=RegisterAction(‘refund’,’to_address’,’amount’)
#Dispatchanaction.
onRefund(my_address,100)
参数：lineset(list)–包含应用程序调用注册功能的行集
23、process_import(import_item)
处理该模块中的导入语句
Parameters:?import_item(boa.code.items.Importsubclass)–
24、process_method(lineset)
处理包含byteplay3代码对象的行集
参数：lineset(list)–需处理与添加的行集
25、process_smart_contract_app_registration(lineset)?
在智能合约中调用另一个智能合约时处理智能合约应用程序注册事宜：
fromboa.blockchain.vm.Neo.AppimportRegisterAppCall
#registerthecontract
otherContract=RegisterAppCall(‘contract_hash’,’param1′,’param2′)
#callthecontract
result=otherContract(a,b)
参数：lineset(list)–包含应用程序调用注册功能的行集
26、split_lines()
将模块中的行集拆分成可编译的对象集
27、to_s()
该方法的目的在于以可读/标记化的格式打印可执行项的输出值，样本如下：
>>>fromboa.compilerimportCompiler
>>>module=Compiler.
load('./boa/tests/src/LambdaTest.py').default
>>>module.write()
>>>module.to_s()
LOAD_CONST
STORE_FAST
LOAD_FAST
CALL_FUNCTION?Main..
q_1
STORE_FAST
b''
m??
NOP?
RETURN_VALUE??
b''?
LOAD_FAST?x?
LOAD_CONST?
BINARY_ADD??
NOP????
RETURN_VALUE?
28、tokenize()
将boa.code.pytoken.PyToken对象集转化为boa.code.vmtoken.VMToken对象。
29、total_lines
获取该方法的总行数
返回值：总行数
返回值类型：int
30、total_module_variables
获取局部变量总数
返回值：该模块中的变量总数
返回值类型：int
31、vm_tokens
返回该方法中的虚拟机标记列表
返回值：该方法中的虚拟机标记列表
返回值类型：列表
32、write()
将标记器当前的状态写为字节串
返回值：当前标记器的字节串
返回值类型：字节
原文链接：https://github.com/localhuman/neo-python
往期精彩内容
NEXT社区小课堂|第五课：NEO-共识算法dBFT源码解析
NEXT社区小课堂|第八课：如果往错误的NEO地址转账会发生什么
NEXT社区小课堂|第十课：如何正确理解NEO平台上的GAS
NEXT社区小课堂|第十一课：NEO中数字的表达和运算
??
联系我们?
微博：https://weibo.com/u/6724929880
官网：https://neonext.club/
QQ群：612334080
电报：https://t.me/neonextop
twitter：https://twitter.com/NE0NEXT
关注NEONEXT官方公众号
获取更多一手社区资讯
郑重声明： 本文版权归原作者所有， 转载文章仅为传播更多信息之目的， 如作者信息标记有误， 请第一时间联系我们修改或删除， 多谢。