💻 工作🐍PythonPEP
TODO, 待学清单
Source
Edit
History

PEP 中文翻译计划

文章目录
  1. 1. 什么是 PEP
  2. 2. 为什么要读 PEP
  3. 3. 哪些 PEP 是必读的
  4. 4. 对 PEP 的贡献
  5. 5. 相关链接
  6. 6. 翻译成果

出处：PEP 中文翻译计划

什么是 PEP

全称是 Python Enhancement Proposals，其中 Enhancement 是增强改进的意思，Proposals 则可译为提案或建议书，所以合起来，比较常见的翻译是 Python增强提案或Python改进建议书。

PEP 的官网是：https://www.python.org/dev/peps/ ，这也就是 PEP 0 的地址。其它 PEP 的地址是将编号拼接在后面，例如：https://www.python.org/dev/peps/pep-0020/ 就是 PEP 20 的链接，以此类推。

第一个 PEP 诞生于 2000 年，现在正好是 18 岁成年。到目前为止，它拥有 478 个“兄弟姐妹”。

官方将 PEP 分成三类:

I - Informational PEP

P - Process PEP

S - Standards Track PEP

其含义如下:

信息类：这类 PEP 就是提供信息，有告知类信息，也有指导类信息等等。例如 PEP 20（The Zen of Python，即著名的 Python 之禅）、PEP 404 (Python 2.8 Un-release Schedule，即宣告不会有 Python2.8 版本)。

流程类：这类 PEP 主要是 Python 本身之外的周边信息。例如 PEP 1（PEP Purpose and Guidelines，即关于 PEP 的指南）、PEP 347（Migrating the Python CVS to Subversion，即关于迁移 Python 代码仓）。

标准类：这类 PEP 主要描述了 Python 的新功能和新实践（implementation），是数量最多的提案。例如我之前推文《详解 Python 拼接字符串的七种方式》提到过的 f-string 方式，它出自 PEP 498（Literal String Interpolation，字面字符串插值）。

每个 PEP 最初都是一个草案（Draft），随后会经历一个过程，因此也就出现了不同的状态。以下是一个流程图：

PEP process flow diagram

A – Accepted (Standards Track only) or Active proposal 已接受（仅限标准跟踪）或有效提案

D – Deferred proposal 延期提案

F – Final proposal 最终提案

P – Provisional proposal 暂定提案

R – Rejected proposal 被否决的提案

S – Superseded proposal 被取代的提案

W – Withdrawn proposal 撤回提案

在 PEP 0（Index of Python Enhancement Proposals (PEPs)）里，官方列举了所有的 PEP，你可以按序号、按类型以及按状态进行检索。而在 PEP 1（PEP Purpose and Guidelines）里，官方详细说明了 PEP 的意图、如何提交 PEP、如何修复和更新 PEP、以及 PEP 评审的机制等等。

为什么要读 PEP

无论你是刚入门 Python 的小白、有一定经验的从业人员，还是资深的黑客，都应该阅读 Python 增强提案。

依我之见，阅读 PEP 至少有如下好处:

（1）了解 Python 有哪些特性，它们与其它语言特性的差异，为什么要设计这些特性，是怎么设计的，怎样更好地运用它们；

（2）跟进社区动态，获知业内的最佳实践方案，调整学习方向，改进工作业务的内容；

（3）参与热点议题讨论，或者提交新的 PEP，为 Python 社区贡献力量。

说到底，学会用 Python 编程，只是掌握了皮毛。PEP 提案是深入了解 Python 的途径，是真正掌握 Python 语言的一把钥匙，也是得心应手使用 Python 的一本指南。

哪些 PEP 是必读的

如前所述，PEP 提案已经累积产生了 478 个，我们并不需要对每个 PEP 都熟知，没有必要。下面，我列举了一些 PEP，推荐大家一读：

PEP 0 – Index of Python Enhancement Proposals

PEP 7 – Style Guide for C Code，C 扩展

PEP 8 – Style Guide for Python Code，Python 编码规范（必读）

PEP 20 – The Zen of Python，Python 之禅

PEP 202 – List Comprehensions，列表生成式

PEP 274 – Dict Comprehensions，字典生成式

PEP 234 – Iterators，迭代器

PEP 257 – Docstring Conventions，文档注释规范

PEP 279 – The enumerate() built-in function，enumerate 枚举

PEP 282 – A Logging System，日志模块

PEP 285 – Adding a bool type，布尔值

PEP 289 – Generator Expressions，生成器表达式

PEP 318 – Decorators for Functions and Methods，装饰器

PEP 342 – Coroutines via Enhanced Generators，协程

PEP 343 – The “with” Statement，with 语句

PEP 380 – Syntax for Delegating to a Subgenerator，yield from 语法

PEP 405 – Python Virtual Environments，虚拟环境

PEP 471 – os.scandir() function，遍历目录

PEP 484 – Type Hints，类型约束

PEP 492 – Coroutines with async and await syntax，async/await 语法

PEP 498 – Literal String Interpolation Python，字面字符串插值

PEP 525 – Asynchronous Generators，异步生成器

PEP 572 – Assignment Expressions，表达式内赋值（最具争议）

PEP 3105 – Make print a function，print 改为函数

PEP 3115 – Metaclasses in Python 3000，元类

PEP 3120 – Using UTF-8 as the default source encoding，默认 UTF-8

PEP 3333 – Python Web Server Gateway Interface v1.0.1，Web 开发

PEP 8000 – Python Language Governance Proposal Overview，GvR 老爹退出决策层后，事关新决策方案

关于 PEP，知乎上有两个问题，推荐大家关注：哪些 PEP 值得阅读，如何看待 PEP 572？。

对 PEP 的贡献

虽无确切数据作证，我国 Python 开发者的数量应该比任何国家都多。然而，纵观 PEP 0 里面列举的 200 多个 PEP 作者，我只看到了一个像是汉语拼音的国人名字（不排除看漏，或者使用了英文名的）。反差真是太大了。

我特别希望，国内的 Python 黑客们的名字，能越来越多地出现在那个列表里，出现在 Python 核心开发者的列表里。

此外，关于对 PEP 的贡献，还有一种很有效的方式，就是将 PEP 翻译成中文，造福国内的 Python 学习社区。经过一番搜索，我还没有看到系统性翻译 PEP 的项目，只找到了零星的对于某个 PEP 的翻译。

原文链接：https://mp.weixin.qq.com/s/oRoBxZ2-IyuPOf_MWyKZyw

相关链接

官方索引地址：https://www.python.org/dev/peps/

官方文档地址：https://github.com/python/peps

翻译成果

（由于版权缘故，未获得译者授权的 PEP，未放入仓库）