编写整洁的Python代码电子书

版权

版权声明

内容提要

译者简介

前言

资源与支持

第1章 简介、代码格式和工具

1.1 代码整洁的意义

1.2 代码整洁的重要性

1.2.1 代码格式化在代码整洁中的作用

1.2.2 在项目中遵循编码风格准则

1.3 文档字符串和注解

1.3.1 文档字符串

1.3.2 注解

1.3.3 注解是否会替代文档字符串

1.3.4 配置用于实施基本质量控制的工具

1.4 小结

第2章 Python风格代码

2.1 索引和切片

创建自己的序列

2.2 上下文管理器

实现上下文管理器

2.3 对象的属性、特性和不同类型的方法

2.3.1 Python中的下划线

2.3.2 属性

2.4 可迭代对象

2.4.1 创建可迭代对象

2.4.2 创建序列

2.5 容器对象

2.6 对象的动态属性

2.7 可调用对象

2.8 魔法方法概述

2.9 Python中的警告

2.9.1 可变的默认参数

2.9.2 扩展内置类型

2.10 小结

第3章 好代码的一般特征

3.1 契约式设计

3.1.1 前置条件

3.1.2 后置条件

3.1.3 Python的契约

3.1.4 设计契约：结论

3.2 防错性程序设计

3.2.1 错误处理

3.2.2 在Python中使用断言

3.3 关注点分离

内聚和耦合

3.4 常用缩略词

3.4.1 DRY和OAOO

3.4.2 YAGNI

3.4.3 KIS

3.4.4 EAFP和LBYL

3.5 组合和继承

3.5.1 什么时候继承是一个好的决定

3.5.2 反模式的继承

3.5.3 Python中的多重继承

3.6函数和方法中的参数

3.6.1 Python函数的参数是如何工作的

3.6.2 函数中参数的数量

3.7 关于软件设计良好实践的结束语

3.7.1 软件的正交性

3.7.2 构建代码

3.8 小结

第4章 SOLID原则

4.1 单一职责原则

4.1.1 一个有太多职责的类

4.1.2 分配责任

4.2 打开/关闭原则

4.2.1 不遵循打开/关闭原则的可维护性风险的示例

4.2.2 重构事件系统以获得可扩展性

4.2.3 扩展事件系统

4.2.4 关于OCP的结束语

4.3 里氏替换原则

4.3.1 使用工具检测LSP问题

4.3.2 更微妙的LSP违规案例

4.3.3 关于LSP需要注意的一些点

4.4 接口隔离原则

4.4.1 提供太多信息的接口

4.4.2 接口越小越好

4.4.3 接口应该多小

4.5 依赖倒置原则

4.5.1 一个严格依赖的案例

4.5.2 倒置依赖

4.6 小结

第5章 用装饰器改进代码

5.1 Python中的装饰器是什么

5.1.1 装饰器函数

5.1.2 装饰类

5.1.3 其他类型的装饰器

5.1.4 将参数传递给装饰器

5.1.5 充分利用装饰器

5.2 有效的装饰：避免常见的错误

5.2.1保存关于原始包装对象的数据

5.2.2 处理装饰器中的副作用

5.2.3 创建始终有效的装饰器

5.3 装饰器的DRY原则

5.4 装饰器和关注点分离

5.5 好的装饰器的相关分析

5.6 小结

第6章 用描述符从对象中获取更多信息

6.1 初探描述符

6.1.1 描述符背后的机制

6.1.2 研究描述符协议中的每个方法

6.2 描述符的类型

6.2.1 非数据描述符

6.2.2 数据描述符

6.3 描述符的实际应用

6.3.1 描述符的一种应用

6.3.2 实现描述符的不同形式

6.3.3 关于描述符的更多考虑

6.4 分析描述符

6.4.1 Python内部如何使用描述符

6.4.2 在装饰器中实现描述符

6.5 小结

第7章 使用生成器

7.1 技术要求

7.2 创建生成器

7.2.1 初探生成器

7.2.2 生成器表达式

7.3 惯用迭代

7.3.1 迭代的习惯用法

7.3.2 Python中的迭代器模式

7.4 协同程序

7.4.1 使用生成器接口的方法

7.4.2 更先进的协同程序

7.5 异步编程

7.6 小结

第8章 单元测试和重构

8.1 设计原则和单元测试

8.1.1 关于其他形式的自动化测试的说明

8.1.2 单元测试和敏捷软件开发

8.1.3 单元测试和软件设计

8.1.4 定义测试内容的边界

8.2 测试的框架和工具

8.2.1 用于单元测试的框架和库

8.2.2 代码覆盖率

8.2.3 模拟对象（Mock对象）

8.3 代码重构

8.3.1 代码演进

8.3.2 需要演进的不仅仅是生产代码

8.4 更多关于单元测试的信息

8.4.1 基于属性的测试

8.4.2 突变测试

8.5 测试驱动开发的简要介绍

8.6 小结

第9章 常见的设计模式

9.1 Python中设计模式的注意事项

9.2 有效的设计模式

9.2.1 创建型模式

9.2.2 结构型模式

9.2.3 行为模式

9.3 空对象模式

9.4 关于设计模式的最后想法

9.4.1 模式对设计的影响

9.4.2 模型中的名称

9.5 小结

第10章 整洁架构

10.1 从整洁代码到整洁架构

10.1.1 关注点分离

10.1.2 抽象

10.2 软件组件

10.2.1 包

10.2.2 容器

10.3 用例

10.3.1 编码

10.3.2 服务

10.3.3 分析

10.4 小结

写在最后