1.介紹實現Python代碼整潔應遵循的基本原則；2.涵蓋避免由不良代碼導致的效率低下以及存在諸多隱患的代碼的方法；3.作者專業背景深厚，項目經驗豐富；4.本書的代碼示例基於Python3.7版本；5.提供源代碼。

●第1章 簡介、代碼格式和工具 1
1.1 代碼整潔的意義 2
1.2 代碼整潔的重要性 2
1.2.1 代碼格式化在代碼整潔中的作用 3
1.2.2 在項目中遵循編碼風格準則 4
1.3 文檔字符串和注解 6
1.3.1 文檔字符串 6
1.3.2 注解 9
1.3.3 注解是否會替代文檔字符串 11
1.3.4 配置用於實施基本質量控制的工具 12
1.4 小結 16

第2章 Python風格代碼 17
2.1 索引和切片 18
2.2 上下文管理器 21
2.3 對像的屬性、特性和不同類型的方法 26
2.3.1 Python中的下劃線 27
2.3.2 屬性 29
2.4 可迭代對像 31
2.4.1 創建可迭代對像 32
2.4.2 創建序列 34
2.5 容器對像 36
2.6 對像的動態屬性 37
2.7 可調用對像 39
2.8 魔法方法概述 40
2.9 Python中的警告 41
2.9.1 可變的默認參數 41
2.9.2 擴展內置類型 42
2.10 小結 44

第3章 好代碼的一般特征 45
3.1 契約式設計 46
3.1.1 前置條件 47
3.1.2 後置條件 48
3.1.3 Python的契約 48
3.1.4 設計契約：結論 49
3.2 防錯性程序設計 50
3.2.1 錯誤處理 50
3.2.2 在Python中使用斷言 57
3.3 關注點分離 58
3.4 常用縮略詞 60
3.4.1 DRY和OAOO 60
3.4.2 YAGNI 62
3.4.3 KIS 63
3.4.4 EAFP和LBYL 64
3.5 組合和繼承 65
3.5.1 什麼時候繼承是一個好的決定 66
3.5.2 反模式的繼承 67
3.5.3 Python中的多重繼承 69
3.6 函數和方法中的參數 72
3.6.1 Python函數的參數是如何工作的 73
3.6.2 函數中參數的數量 77
3.7 關於軟件設計良好實踐的結束語 80
3.7.1 軟件的正交性 80
3.7.2 構建代碼 82
3.8 小結 83

第4章 SOLID原則 84
4.1 單一職責原則 84
4.1.1 一個有太多職責的類 85
4.1.2 分配責任 86
4.2 打開/關閉原則 87
4.2.1 不遵循打開/關閉原則的可維護性風險的示例 88
4.2.2 重構事件繫統以獲得可擴展性 90
4.2.3 擴展事件繫統 92
4.2.4 關於OCP的結束語 94
4.3 裡氏替換原則 94
4.3.1 使用工具檢測LSP問題 95
4.3.2 更微妙的LSP違規案例 97
4.3.3 關於LSP需要注意的一些點 100
4.4 接口隔離原則 100
4.4.1 提供太多信息的接口 102
4.4.2 接口越小越好 102
4.4.3 接口應該多小 103
4.5 依賴倒置原則 103
4.5.1 一個嚴格依賴的案例 104
4.5.2 倒置依賴 104
4.6 小結 106

第5章 用裝飾器改進代碼 107
5.1 Python中的裝飾器是什麼 107
5.1.1 裝飾器函數 108
5.1.2 裝飾類 109
5.1.3 其他類型的裝飾器 113
5.1.4 將參數傳遞給裝飾器 114
5.1.5 充分利用裝飾器 117
5.2 有效的裝飾：避免常見的錯誤 118
5.2.1 保存關於原始包裝對像的數據 118
5.2.2 處理裝飾器中的副作用 121
5.2.3 創建始終有效的裝飾器 125
5.3 裝飾器的DRY原則 128
5.4 裝飾器和關注點分離 129
5.5 好的裝飾器的相關分析 130
5.6 小結 132

第6章 用描述符從對像中獲取更多信息 133
6.1 初探描述符 133
6.1.1 描述符背後的機制 133
6.1.2 研究描述符協議中的每個方法 136
6.2 描述符的類型 142
6.2.1 非數據描述符 143
6.2.2 數據描述符 145
6.3 描述符的實際應用 147
6.3.1 描述符的一種應用 147
6.3.2 實現描述符的不同形式 151
6.3.3 關於描述符的更多考慮 154
6.4 分析描述符 158
6.4.1 Python內部如何使用描述符 158
6.4.2 在裝飾器中實現描述符 163
6.5 小結 164
第7章 使用生成器 165
7.1 技術要求 165
7.2 創建生成器 165
7.2.1 初探生成器 166
7.2.2 生成器表達式 168
7.3 慣用迭代 169
7.3.1 迭代的習慣用法 169
7.3.2 Python中的迭代器模式 175
7.4 協同程序 179
7.4.1 使用生成器接口的方法 179
7.4.2 更優選的協同程序 184
7.5 異步編程 191
7.6 小結 192

第8測試和重構 193
8.1 設計原測試 193
8.1.1 關於其他形式的自動化測試的說明 194
8.1.測試和敏捷軟件開發 195
8.1.測試和軟件設計 196
8.1.4 定義測試內容的邊界 199
8.2 測試的框架和工具 200
8.2.1 測試的框架和庫 200
8.2.2 代碼覆蓋率 209
8.2.3 模擬對像（Mock對像） 211
8.3 代碼重構 216
8.3.1 代碼演進 216
8.3.2 需要演進的不僅僅是生產代碼 218
8.4 更多測試的信息 220
8.4.1 基於屬性的測試 220
8.4.2 突變測試 221
8.5 測試驅動開發的簡要介紹 223
8.6 小結 224

第9章 常見的設計模式 225
9.1 Python中設計模式的注意事項 225
9.2 有效的設計模式 227
9.2.1 創建型模式 227
9.2.2 結構型模式 233
9.2.3 行為模式 240
9.3 空對像模式 250
9.4 關於設計模式的最後想法 252
9.4.1 模式對設計的影響 252
9.4.2 模型中的名稱 253
9.5 小結 254

第10章 整潔架構 255
10.1 從整潔代碼到整潔架構 255
10.1.1 關注點分離 256
10.1.2 抽像 257
10.2 軟件組件 258
10.2.1 包 258
10.2.2 容器 261
10.3 用例 262
10.3.1 編碼 263
10.3.2 服務 268
10.3.3 分析 271
10.4 小結 273

寫在最後 274

本書介紹Python軟件工程的主要實踐和原則，旨在幫助讀者編寫更易於維護和更整潔的代碼。全書共10章：第1章介紹Python語言的基礎知識和搭建Python開發環境所需的主要工具；第2章描述Python風格代碼，介紹Python中的第一個習慣用法；第3章總結好代碼的一般特征，回顧軟件工程中的一般原則；第4章介紹一套面向對像軟件設計的原則，即SOLID原則；第5章介紹裝飾器，它是Python的優選特性之一；第6章探討描述符，介紹如何通過描述符從對像中獲取更多的信息；第7章和第8章介紹生成器測試和重構的相關內容；第9章回顧Python中最常見的設計模式；第10章再次強調代碼整潔是實現良好架構的基礎。本書適合所有Python編程愛好者、對程序設計感興趣的人，以及其他想學習更多Python知識的軟件工程的從業人員。