COM:NEXT社區小課堂 | 第十三課：NEO Python編譯器介紹（一）_COMP

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__

Eqonex任命前Binance UK負責人Jonathan Farnell為新CEO:金色財經消息，加密貨幣托管商Digivault母公司Eqonex宣布任命曾擔任Binance UK負責人兼Bifinity首席執行官的Jonathan Farnell為新CEO，現任臨時首席執行官Andrew Eldon將恢復其首席運營官和臨時首席營銷官的主要角色。Jonathan Farnell將加快Eqonex和Bifinity的戰略合作伙伴關系。

Bifinity是一家隸屬于幣安的支付技術公司。未來Bifinity將利用EQONEX交易所作為替代交易平臺的方法，部署資源以加強技術，并探索擴大資產管理業務。（eqonex.com）[2022/3/17 14:03:25]

#已經根據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')

Bitfinex即將上線Solana（SOL） FTX已開啟SOL質押服務:2月18日消息，Bitfinex宣布即將上線Solana（SOL）并開放相關交易對，具體時間將后續公布。FTX聯合創始人SBF轉發此消息并表示，FTX現已開啟SOL質押服務。[2021/2/19 17:28:08]

4、許可證

·開源MIT?

·主作者為localhuman

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’)

Nexo聯合創始人：預測年底比特幣的價值可能會達到5萬美元:加密借貸平臺Nexo聯合創始人兼董事總經理Antoni Trenchev表示，到今年年底，比特幣的價值可能會達到5萬美元，較目前的水平飆升470%。Trenchev稱，雖然比特幣可能已經消化了減半的影響，但隨著時間的推移，這仍將導致其大幅升值。“批評人士可以盡情貶低比特幣，但它確實是過去十年中表現最好的資產。我們看好比特幣的未來。”（彭博社）[2020/5/6]

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。

動態 | Tether核心錢包向Bitfinex地址轉入5000萬枚USDT:今日23:12:41 ，Tether核心錢包地址之一Tether Treasury向Bitfinex地址一次性單向轉入了5000萬USDT。上次Tether轉出一億枚USDT至Bitfinex錢包的時間為9月3日。[2018/9/22]

調用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屬性中。

您可調用module.to_s()來查看該程序，因為該程序已根據NEO虛擬機的特點進行了標記化。

DragonEx上線MKR/USDT交易對:DragonEx將于新加坡時間 2018年6月16日15:30（UTC+8)上線 MKR/USDT 交易對。具體時間如下：6月15日16:00 開放充幣，6月16日15:30 開放交易 。[2018/6/15]

>>>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官方公眾號

獲取更多一手社區資訊

Tags：COMLOALOADCOMPCompound Basic Attention TokenFloat ProtocolUPLOAD價格Internet Computer(Dfinity)

火幣交易所