編寫整潔的Python代碼（第2版）

第 1章　簡介、代碼格式設(shè)置和工具 1
1．1　簡介 1
1．1．1　整潔代碼的含義 2
1．1．2　整潔代碼的重要性 2
1．1．3　一些例外情況 4
1．2　設(shè)置代碼的格式 4
1．3　文檔 7
1．3．1　代碼注釋 7
1．3．2　文檔字符串 8
1．3．3　注解 10
1．3．4　注解是否會取代文檔字符串 13
1．4　配置和使用工具 15
1．4．1　類型一致性檢查 15
1．4．2　一般性代碼驗證 17
1．4．3　自動設(shè)置格式 18
1．4．4　自動檢查設(shè)置 20
1．5　小結(jié) 21
1．6　參考資料 22
第 2章　符合Python語言習(xí)慣的代碼 23
2．1　索引和切片 24
2．2　上下文管理器 26
2．3　推導(dǎo)式和賦值表達式 31
2．4　對象的特性、屬性及各種方法 34
2．4．1　Python中的下劃線 34
2．4．2　特性 36
2．4．3　使用更緊湊的語法創(chuàng)建類 38
2．4．4　可迭代對象 41
2．4．5　容器對象 46
2．4．6　對象的動態(tài)屬性 47
2．4．7　可調(diào)用對象 49
2．4．8　魔法方法小結(jié) 50
2．5　Python注意事項 51
2．5．1　可變的默認(rèn)參數(shù) 51
2．5．2　擴展內(nèi)置類型 52
2．6　異步代碼簡介 54
2．7　小結(jié) 56
2．8　參考資料 56
第3章　優(yōu)質(zhì)代碼的通用特征 57
3．1　契約式設(shè)計 58
3．1．1　前置條件 59
3．1．2　后置條件 60
3．1．3　Python契約 60
3．1．4　契約式設(shè)計小結(jié) 60
3．2　防御式編程 61
3．2．1　錯誤處理 61
3．2．2　在Python中使用斷言 69
3．3　關(guān)注點分離 70
3．4　常見縮略語 71
3．4．1　DRY/OAOO 72
3．4．2　YAGNI 73
3．4．3　KIS 74
3．4．4　EAFP/LBYL 76
3．5　Python中的繼承 77
3．5．1　什么情況下使用繼承是個好主意 77
3．5．2　反模式的繼承 78
3．5．3　Python中的多繼承 81
3．6　函數(shù)和方法中的參數(shù) 83
3．6．1　Python中函數(shù)參數(shù)的工作原理 84
3．6．2　函數(shù)的參數(shù)數(shù)量 91
3．7　有關(guān)軟件設(shè)計最佳實踐的最后說明 94
3．7．1　軟件中的正交性 94
3．7．2　結(jié)構(gòu)化代碼 95
3．8　小結(jié) 96
3．9　參考資料 97
第4章　SOLID原則 98
4．1　單一職責(zé)原則 98
4．1．1　一個職責(zé)過多的類 99
4．1．2　分配職責(zé) 100
4．2　開/閉原則 101
4．2．1　因未遵循OCP而帶來可維護性問題的示例 102
4．2．2　重構(gòu)事件系統(tǒng)以提高可擴展性 104
4．2．3　擴展事件系統(tǒng) 106
4．2．4　OCP小結(jié) 107
4．3　里氏替換原則 108
4．3．1　使用工具找出LSP問題 109
4．3．2　更微妙的LSP違反情形 111
4．3．3　LSP小結(jié) 113
4．4　接口分離 114
4．4．1　一個提供了太多功能的接口 115
4．4．2　接口越小越好 115
4．4．3　接口應(yīng)多小 117
4．5　依賴倒置 117
4．5．1　一個剛性依賴案例 118
4．5．2　倒置依賴 118
4．5．3　依賴注入 119
4．6　小結(jié) 121
4．7　參考資料 122
第5章　使用裝飾器改善代碼 123
5．1　Python裝飾器是什么 123
5．1．1　函數(shù)裝飾器 124
5．1．2　類裝飾器 125
5．1．3　其他類型的裝飾器 129
5．2　高級裝飾器 129
5．2．1　向裝飾器傳遞參數(shù) 129
5．2．2　指定了參數(shù)默認(rèn)值的裝飾器 133
5．2．3　協(xié)程裝飾器 135
5．2．4　擴展的裝飾器語法 137
5．3　充分利用裝飾器 138
5．3．1　調(diào)整函數(shù)的簽名 139
5．3．2　驗證參數(shù) 140
5．3．3　跟蹤代碼 140
5．4　有效的裝飾器：避免常見錯誤 140
5．4．1　保留被包裝的原始對象的數(shù)據(jù) 140
5．4．2　在裝飾器中處理副作用 143
5．4．3　創(chuàng)建在任何情況下都管用的裝飾器 146
5．5　裝飾器與整潔的代碼 149
5．5．1　組合勝過繼承 149
5．5．2　DRY原則與裝飾器 152
5．5．3　裝飾器與關(guān)注點分離 153
5．5．4　分析優(yōu)良的裝飾器 154
5．6　小結(jié) 155
5．7　參考資料 156
第6章　使用描述符更充分地利用對象 157
6．1　初識描述符 157
6．1．1　描述符背后的機制 157
6．1．2　探討描述符協(xié)議中的各個方法 160
6．2　描述符類型 167
6．2．1　非數(shù)據(jù)描述符 167
6．2．2　數(shù)據(jù)描述符 169
6．3　使用描述符 171
6．3．1　描述符的一種用途 171
6．3．2　各種描述符實現(xiàn)方式 175
6．3．3　使用描述符時需要考慮的其他方面 178
6．4　分析描述符 182
6．4．1　Python如何在內(nèi)部使用描述符 182
6．4．2　在裝飾器中實現(xiàn)描述符 187
6．5　描述符結(jié)語 188
6．5．1　描述符的接口 188
6．5．2　描述符的面向?qū)ο笤O(shè)計 188
6．5．3　描述符中的類型注解 188
6．6　小結(jié) 189
6．7　參考資料 189
第7章　生成器、迭代器和異步編程 190
7．1　技術(shù)要求 190
7．2　創(chuàng)建生成器 190
7．2．1　初識生成器 191
7．2．2　生成器表達式 193
7．3　以慣用法迭代 195
7．4　協(xié)程 205
7．4．1　生成器接口中的方法 205
7．4．2　高級協(xié)程 210
7．5　異步編程 216
7．5．1　異步魔法方法 217
7．5．2　異步迭代 219
7．5．3　異步生成器 221
7．6　小結(jié) 222
7．7　參考資料 223
第8章　單元測試和重構(gòu) 224
8．1　設(shè)計原則與單元測試 224
8．1．1　其他形式的自動測試 225
8．1．2　單元測試與敏捷軟件開發(fā) 226
8．1．3　單元測試與軟件設(shè)計 227
8．1．4　確定測試范圍 230
8．2　測試工具 230
8．3　重構(gòu) 248
8．3．1　代碼演進 249
8．3．2　需要演進的并非只有生產(chǎn)代碼 251
8．4　再談測試 252
8．4．1　基于屬性的測試 252
8．4．2　變異測試 253
8．4．3　常見的測試概念 255
8．4．4　測試驅(qū)動開發(fā)簡介 256
8．5　小結(jié) 257
8．6　參考資料 257
第9章　常見設(shè)計模式 259
9．1　在Python中使用設(shè)計模式時需要注意的事項 260
9．2　設(shè)計模式實戰(zhàn) 261
9．2．1　創(chuàng)建型模式 261
9．2．2　結(jié)構(gòu)型模式 267
9．2．3　行為型模式 273
9．3　空對象模式 283
9．4　設(shè)計模式結(jié)語 284
9．4．1　模式對設(shè)計的影響 285
9．4．2　作為理論的設(shè)計模式 286
9．4．3　模型中的名稱 286
9．5 小結(jié) 286
9．6　參考資料 287
第 10章　整潔的架構(gòu) 288
10．1　從整潔代碼到整潔架構(gòu) 288
10．1．1　關(guān)注點分離 289
10．1．2　大一統(tǒng)的應(yīng)用程序和微服務(wù) 290
10．1．3　抽象 291
10．2　軟件組件 292
10．2．1　包 292
10．2．2　Docker容器 298
10．2．3　用例 299
10．2．4　服務(wù) 303
10．3　小結(jié) 308
10．4　參考資料 309
結(jié)語 310