軟件工程學習筆記目錄

[https://blog.csdn.net/csdn_kou/article/details/83754356]

google代碼規范

https://github.com/google/styleguide

節選python來自google翻譯

2.17函數和方法裝飾器
當有明顯的優勢時，明智地使用裝飾器。避免 @staticmethod和限制使用@classmethod。

2.17.1定義
函數和方法的裝飾器 （又名“ @符號”）。一個常見的裝飾器@property，用于將普通方法轉換為動態計算的屬性。但是，裝飾器語法也允許用戶定義的裝飾器。具體來說，對于某些功能my_decorator，這個：

class C（object）：
@ my_decorator
def 方法（self）：
＃ method body …
相當于：

class C（object）：
def Methodmethod（self）：
＃ method body …
Methodmethod = MyDecoratormy_decorator（Methodmethod）

2.17.2優點
優雅地指定方法的一些轉換; 轉換可能會消除一些重復的代碼，強制執行不變量等。

2.17.3缺點
裝飾器可以對函數的參數執行任意操作或返回值，從而導致令人驚訝的隱式行為。此外，裝飾器在導入時執行。裝飾器代碼中的失敗幾乎無法從中恢復。

2.17.4決定
當有明顯的優勢時，明智地使用裝飾器。裝飾器應遵循與函數相同的導入和命名準則。裝飾者pydoc應該清楚地說明該函數是一個裝飾器。為裝飾器編寫單元測試。

避免裝飾器本身的外部依賴（例如，不要依賴文件，套接字，數據庫連接等），因為它們在裝飾器運行時可能不可用（在導入時，可能來自pydoc或其他工具）。使用有效參數調用的裝飾器應該（盡可能）保證在所有情況下都成功。

裝飾器是“頂級代碼”的特例 - 請參閱主題以獲得更多討論。

@staticmethod除非被強制使用以便與現有庫中定義的API集成，否則切勿使用。寫一個模塊級函數。

使用@classmethod只寫了一個名為構造函數或類特定的例程，它需要修改全局狀態，如進程范圍的緩存時。

錯誤注釋的示例

命名規范

import語句的規范

• import次序：先import Python內置模塊，在import第三方模塊，最后import自己開發項目中的其他模塊；這幾種模塊用空行分割開來
• 一條import只可以import一個模塊
• 當從模塊中import多個對象且超過一行時，使用如下斷行方法：
  • from module import (obj1,obj2,obj3,obj4,obj5,obj6)
• 不要使用from module import * ，除非時import常量定義模塊或其它你確保不會出現命名空間沖突的模塊

import this 源碼

import this

python3 test.py

---

The Zen of Python, by Tim Peters

Beautiful is better than ugly.
Explicit is better than implicit.
Simple is better than complex.
Complex is better than complicated.
Flat is better than nested.
Sparse is better than dense.
Readability counts.
Special cases aren’t special enough to break the rules.
Although practicality beats purity.
Errors should never pass silently.
Unless explicitly silenced.
In the face of ambiguity, refuse the temptation to guess.
There should be one-- and preferably only one --obvious way to do it.
Although that way may not be obvious at first unless you’re Dutch.
Now is better than never.
Although never is often better than right now.
If the implementation is hard to explain, it’s a bad idea.
If the implementation is easy to explain, it may be a good idea.
Namespaces are one honking great idea – let’s do more of those!

---

ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓ NOPQRSTUVWXYZABCDEFGHIJKLMnopqrstuvwxyzabcdefghijklm
源代碼

s = """Gur Mra bs Clguba, ol Gvz CrgrefOrnhgvshy vf orggre guna htyl.
Rkcyvpvg vf orggre guna vzcyvpvg.
Fvzcyr vf orggre guna pbzcyrk.
Pbzcyrk vf orggre guna pbzcyvpngrq.
Syng vf orggre guna arfgrq.
Fcnefr vf orggre guna qrafr.
Ernqnovyvgl pbhagf.
Fcrpvny pnfrf nera'g fcrpvny rabhtu gb oernx gur ehyrf.
Nygubhtu cenpgvpnyvgl orngf chevgl.
Reebef fubhyq arire cnff fvyragyl.
Hayrff rkcyvpvgyl fvyraprq.
Va gur snpr bs nzovthvgl, ershfr gur grzcgngvba gb thrff.
Gurer fubhyq or bar-- naq cersrenoyl bayl bar --boivbhf jnl gb qb vg.
Nygubhtu gung jnl znl abg or boivbhf ng svefg hayrff lbh'er Qhgpu.
Abj vf orggre guna arire.
Nygubhtu arire vf bsgra orggre guna *evtug* abj.
Vs gur vzcyrzragngvba vf uneq gb rkcynva, vg'f n onq vqrn.
Vs gur vzcyrzragngvba vf rnfl gb rkcynva, vg znl or n tbbq vqrn.
Anzrfcnprf ner bar ubaxvat terng vqrn -- yrg'f qb zber bs gubfr!"""d = {}
for c in (65, 97):for i in range(26):d[chr(i+c)] = chr((i+13) % 26 + c)print "".join([d.get(c, c) for c in s])

網上很多人說是惡搞，這其實是凱撒密碼：
字符前移13位然后模26而已