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__
Bitfinex与OpenPayd合作提供英镑和欧元支付服务:据官方公告，Bitfinex与OpenPayd达成合作，以提供快速、安全和低成本的英镑和欧元支付服务。
OpenPayd是面向数字经济的全球支付和银行即服务（BaaS）平台。Bitfinex与OpenPayd合作，为中级及以上认证级别的Bitfinex账户提供电汇存取款服务。
所有利用OpenPayd进行的交易都是通过SEPA进行的，如果用户银行账户符合SEPA Instant的条件，它将自动被选择。[2023/2/9 11:56:21]
#已经根据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
Bitfinex将上线FCL:官方消息，Bitfinex将上线FCL，FCL (erc20) 的存款将于北京时间 7 月 12 日上午 19:00 开放。FCL 交易将于北京时间7 月 14 日20:00 开始。FCL 可以用美元 (FCL/USD) 和 Tether 代币 (FCL/USDt) 进行交易。[2021/7/12 0:45:51]
5、boa.compiler.Compiler
下文将介绍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’)
Nexus Mutual社区提案提议移除其背后的法律实体:4月23日，投资基金1kx联合创始人Christopher Heymann发推文称，链上互助保险项目Nexus Mutual （NXM）社区目前正在考虑一项提议，即移除Nexus Mutual背后的法律实体，这将消除NXM代币持有者对KYC的要求。Heymann称，Nexus最初是与一家“英国有限公司”合作推出的，目的是保护团队免受法律责任和税务相关问题的影响。然而，Heymann认为该项目的DAO管理模式现在已经足够去中心化，不再需要有限公司形式的“合法包装”。[2021/4/24 20:53:10]
10、staticload_and_save(path,output_path=None)
调用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。
声音 | Bitfinex通信主管：Tether没有故意缩减供应量:据Coindesk报道，Bitfinex的通信主管Kasper Rasmussen上周写信给CoinDesk表示，Tether没有故意缩减供应量，并称破坏USDT和保持其与美元平价没有任何关系。但在周三发给CoinDesk的电子邮件中，Rasmussen却拒绝评论“Tether在二级市场的价格波动”。他仅补充说，Tether和美元是按照1：1发行和兑换的。[2018/11/1]
调用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
对可执行项进行处理与标记化后，便会生成虚拟机标记集，虚拟机标记虽与byteplay3标记相类似，但仍存在显著区别。这些标记均包含在该模块的all_vm_tokens属性中。
行情 | 比特币在Bitfinex上的溢价约为300美元:据bitcoinist消息，普遍猜测，人们正在卖出Tether以换取比特币。这导致比特币在Bitfinex交易所的溢价约为300美元。那些使用Bitfinex的人发现，与其他交易所相比，Bitfinex上比特币的溢价约为300美元。[2018/10/18]
您可调用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官方公众号
获取更多一手社区资讯
郑重声明： 本文版权归原作者所有， 转载文章仅为传播更多信息之目的， 如作者信息标记有误， 请第一时间联系我们修改或删除， 多谢。