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__
孙宇晨：波场DeFi 将成为对用户来说安全放心的首选:据官方消息，波场TRON创始人兼BitTorrent CEO孙宇晨就波场TRON世纪挖矿对话金色财经内容总监王瑜琨，孙宇晨在AMA中表示：“2021年，我们会更进一步打磨DeFi产品的深度，为整个区块链行业提供规模化、费用低且安全的区块链网络与DeFi产品。对DeFi用户而言，行业发展会给用户提供更多样化的选择。而我有信心，波场DeFi 将成为对用户来说最安全放心的首选。”[2021/3/10 18:32:15]
#已经根据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
狗狗币因TikTok挑战经历暴涨 孙宇晨宣布将进军短视频领域:波场创始人孙宇晨在推特表示，“从今天开始，我们将关注更多的TikTok内容。请继续关注TRON视频的病式传播”。分析认为，这可能与狗狗币的挑战视频病传播导致价格上涨有关。截至目前，孙宇晨在TikTok上有363个关注者， TRON基金会帐户有130个关注者。[2020/7/8]
下文将介绍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)
声音 | 孙宇晨回复特朗普推特：区块链是机会 邀请总统共进巴菲特晚餐:孙宇晨刚刚回复特朗普推特表示：“总统先生，你被假新闻误导了。比特币、区块链碰巧是美国最好的机会！我很乐意邀请??你和加密货币领军人物一起在7月25日与巴菲特共进午餐。我保证你在这个午餐后，没有人比你更了解加密！”[2019/7/12]
调用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)
模块是包含代码对象的顶层组件。例如，在path/to/my/file.py的编译过程中，file.py中包含的项目即为模块。一个可执行项可包含多个模块。上述案例中的“默认”或“入口”模块即为file.py。
调用Compiler.load_and_save(‘path/to/file.py’)时会专门为file.py创建一个模块。若file.py导入了其他任何功能，那些模块也会被添加至可执行项中，并置于Module.loaded_modules属性中。
行情 | 昨日Bitfinex 的 ETH 余额最高:据 Searchain.io 数据显示，截至今日 0 点，包含未公开的数据中，Bitfinex 的 ETH 余额最高。从余额变动来看，根据 Searchain.io 自有交易所标签统计，除 Bitfinex 和 Huobi 的 ETH 净流入为负，其中 Bitfinex 净流出达到 4 万 ETH；其他五家交易所昨日 ETH 净流入均为正数，其中 OKEX 的 ETH 净流入最高，为 3.1 万 ETH，币安的 ETH 净流入为 6 千，Gemini 的 ETH 净流入为 7 千。
从 ETH 换手率来看，以普通交易为主的四家交易所中，Huobi 在 35.63%左右，币安为 57.42%，Bitfinex 为 14.01%，Bittrex 最低， 为 2.05%；以合约交易为主的 OKEX 的换手率在 69.79%左右；以法币兑换为主的交易所中，Kraken 和 Gemini 的换手率为 5.74%和 1.94%。[2018/9/27]
在模块被当做方法处理，方法被当做基本块处理，基本块被处理为标记后，主模块或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增加十二个创新币种交易 : 据Finacemagenment周一（4月9日）报道，数字货币交易平台Bitfinex宣布现在有12个新的创新币在其平台上进行交易，可以与BTC，ETH和USDT进行交易。[2018/4/10]
对可执行项进行处理与标记化后，便会生成虚拟机标记集，虚拟机标记虽与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官方公众号
获取更多一手社区资讯
郑重声明： 本文版权归原作者所有， 转载文章仅为传播更多信息之目的， 如作者信息标记有误， 请第一时间联系我们修改或删除， 多谢。