如何將你的應用遷移到Python3的三個步驟

2022-10-04 15:24:22 字數 4277 閱讀 2009

python 2.x 很快就要 失去官方支援 了,儘管如此,從 python 2 遷移到 python 3 卻並沒有想象中那麼難。我在上週用了乙個晚上的時間將乙個 3d 渲染器的前端**及其對應的 pyside 遷移到 python 3,回想起來,儘管在遷移過程中無可避免地會遇到一些牽一髮而動全身的修改,但整個過程相比起痛苦的重構來說簡直是出奇地簡單。

每個人都別無選擇地有各種必須遷移的原因:或許是覺得已經拖延太久了,或許是依賴了某個在 python 2 下不再維護的模組。但如果你僅僅是想通過做一些事情來對開源做貢獻,那麼把乙個 python 2 應用遷移到 python 3 就是乙個簡單而又有意義的做法。

無論你從 python 2 遷移到 python 3 的原因是什麼,這都是一項重要的任務。按照以下三個步驟,可以讓你把任務完成得更加清晰。

1、使用 2to3

從幾年前開始,python 在你或許還不知道的情況下就已經自帶了乙個名叫 2to3 的指令碼,它可以幫助你實現大部分**從 python 2 到 python 3 的自動轉換。

下面是一段使用 python 2.6 編寫的**:

#!/usr/bin/env python

# -*- coding: utf-8 -*-

mystring = u'abcd'

print ord(mystring[-1])

對其執行 2to3 指令碼:

$ 2to3 example.py

refactoringtool: refactored example.py

--- example.py (original)

+++ example.py (refactored)

@@ -1,5 +1,5 @@

#!/usr/bin/env python

# -*- coding: utf-8 -*-

-mystring = u'abcd'

-print ord(mystring[-1])

+mystring = 'abcd'

+print(ord(mystring[-1]))

refactoringtool: files that need to be modified:

refactoringtool: example.py

在預設情況下,2to3 只會對遷移到 python 3 時必須作出修改的**進行標示,在輸出結果中顯示的 python 3 **是直接可用的,但你可以在 2to3 加上 -w 或者 --write 引數,這樣它就可以直接按照給出的方案修改你的 python 2 **檔案了。

$ 2to3 -w example.py

[...]

refactoringtool: files that were modified:

refactoringtool: example.py

2to3 指令碼不僅僅對單個檔案有效,你還可以把它用於乙個目錄下的所有 python 檔案,同時它也會遞迴地對所有子目錄下的 python 檔案都生效。

2、使用 pylint 或 pyflakes

有一些不良的**在 python 2 下執行是沒有異常的,在 python 3 下執行則會或多或少報出錯誤,這種情況並不鮮見。因為這些不良**無法通過語法轉換來修復,所以 2to3 對它們沒有效果,但一旦使用 python 3 來執行就會產生報錯。

要找出這種問題,你需要使用 pylint 、 pyflakes (或 flake8 封裝器)這類工具。其中我更喜歡 pyflakes,它會忽略**風格上的差異,在這一點上它和 pylint 不同。儘管**優美是 python 的一大特點,但在**遷移的層面上,「讓**功能保持一致」無疑比「讓**風格保持一致」重要得多。

以下是 pyflak程式設計客棧es 的輸出樣例:

$ pyflakes example/maths

example/maths/enum.py:19: undefined name 'cmp'

example/maths/enum.py:105: local variable 'e' is assigned to but never used

example/maths/enum.py:109: undefwww.cppcns.comined name 'basestring'

example/maths/enum.py:208: undefined name 'enumvaluecompareerror'

example/maths/enum.py:208: local variable 'e' is assigned to but never used

上面這些由 pyflakes 輸出的內容清晰地給出了**中需要修改的問題。相比之下,pylint 會輸出多達 143 行的內容,而且多數是諸如**縮排這樣無關緊要的問題。

值得注意的是第 19 行這個容易產生誤導的錯誤。從輸出來看你可能會以為 cmp 是乙個在使用前未定義的變數,實際上 cmp 是 python 2 的乙個內建函式,而它在 python 3 中被移除了。而且這段**被放在了 try 語句塊中,除非認真檢查這段**的輸出值,否則這個問題很容易被忽略掉。程式設計客棧

try:

result = cmp(self.index, other.index)

except:

result = 42

return result

在**遷移過程中,你會發現很多原本在 python 2 中能正常執行的函式都發生了變化,甚至直接在 python 3 中被移除了。例如 pyside 的繫結方式發生了變化、importlib 取代了 imp 等等。這樣的問題只能見到乙個解決乙個,而涉及到的功能需要重構還是直接放棄,則需要你自己權衡。但目前來說,大多數問題都是已知的,並且有 完善的文件記錄 。所以難的不是修復問題,而是找到問題,從這個角度來說,使用 pyflake 是很有必要的。

3、修復被破壞的 python 2 **

儘管 2to3 指令碼能夠幫助你把**修改成相容 python 3 的形式,但對於乙個完整的**庫,它就顯得有點無能為力了,因為一些老舊的**在 python 3 中可能需要不同的結構來表示。在這樣的情況下,只能人工進行修改。

例如以下**在 python 2.6 中可以正常執行:

class clock_speed:

ticks_per_second = 16

tick_rates = [int(i * ticks_per_second)

for i in (0.5, 1, 2, 3, 4, 6, 8, 11, 20)]

class fps:

stats_update_frequency = clock_speed.ticks_per_second

類似 2to3 和 pyflakes 這些自動化工具並不能發現其中的問題,但如果上述**使用 python 3 來執行,直譯器會認為 clock_speed.ticks_per_second 是未被明確定義的。因此就需要把**改成物件導向的結構:

class clock_speed:

def ticks_per_second():

ticks_per_second = 16

tick_rates = [int(i * ticks_per_second)

for i in (0.5, 1, 2, 3, 4, 6, 8, 11, 20)]

return ticks_per_second

class fps:

s程式設計客棧tats_update_frequency = clock_speed.ticks_per_second()

你也許會認為如果把 ticks_per_second() 改寫為乙個建構函式(用 __init__ 函式設定預設值)能讓**看起來更加簡潔,但這樣就需要把這個方法的呼叫形式從 clock_speed.ticks_per_second() 改為 clock_speed() 了,這樣的改動或多或少會對整個庫造成一些未知的影響。如果你對整個**庫的結構爛熟於心,那麼你確實可以隨心所欲地作出這樣的修改。但我通常認為,只要我做出了修改程式設計客棧,都可能會影響到其它**中的至少三處地方,因此我更傾向於不使**的結構發生改變。

堅持信念

如果你正在嘗試將乙個大專案從 python 2 遷移到 python 3,也許你會覺得這是乙個漫長的過程。你可能會費盡心思也找不到一條有用的報錯資訊,這種情況下甚至會有將**推倒重建的衝動。但從另乙個角度想,**原本在 python 2 中就可以執行,要讓它能在 python 3 中繼續執行,你需要做的只是對它稍加轉換而已。

但只要你完成了遷移,你就得到了這個模組或者整個應用程式的 python 3 版本,外加 python 官方的長期支援。

本文標題: 如何將你的應用遷移到python3的三個步驟

本文位址:

如何將系統的data目錄遷移到web以外目錄

data目錄是系統快取和配置檔案的目錄,一般都有可以讀寫的許可權,只要是能夠寫入的目錄都可能存在安全隱患,很多站長甚至給予這個目錄可執行的許可權,更是非常危險,所以我們建議將這個data目錄搬移出web可訪問目錄之外。本篇將介紹如何將data目錄搬移出web訪問目錄。本操作需要使用者對dedecms...

如何將資料庫從SQL Server遷移到MySQL

一 遷移database schema。首先使用sybase powerdesigner的逆向工程功能,逆向出sql server資料庫的物理模型。具體操作是在powerdesigner中選擇 file reverse engine 再選擇database,將dbms選擇為sql server,如圖...

如何將資料庫從SQL Server遷移到MySQL

一 遷移database schema。首先使用sybase powerdesigner的逆向工程功能,逆向出sql server資料庫的物理模型。具體操作是在powerdesigner中選擇 file reverse engine 再選擇database,將dbms選擇為sql server,如圖...