PEP Python 规范

PEP简介

Python Code Standard

Posted by pfan8 on July 1, 2019

PEP是什么？

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

我个人倾向于前一个翻译，因为它更贴切。Python核心开发者主要通过邮件列表讨论问题、提议、计划等，PEP通常是汇总了多方信息，经过了部分核心开发者review和认可，最终形成的正式文档，起到了对外公示的作用，所以我认为翻译成“提案”更恰当。

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），随后会经历一个过程，因此也就出现了不同的状态。以下是一个流程图：

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评审的机制等等。

Meta-PEP列表

PEP PEP名称
1 PEP Purpose and Guidelines
4 Deprecation of Standard Modules
5 Guidelines for Language Evolution
6 Bug Fix Releases
7 Style Guide for C Code
8 Style Guide for Python Code
10 Voting Guidelines
11 Removing support for little used platforms
12 Sample reStructuredText PEP Template

以上仅列出主要PEP文件，更多PEP请参考PEP0

为什么要读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，布尔值（建议阅读《Python对象的身份迷思：从全体公民到万物皆数》）
  • 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值得阅读（https://dwz.cn/7CHMBlLu），如何看待PEP 572（https://dwz.cn/L46jpzMB）。

对PEP的贡献

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

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

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

我用心搜集了几篇中文翻译成果，分享给大家：

最后，表达一下我的私心：

（1）希望本文能给大家带来知识和见识的增长，激发一些小伙伴的学习热情

（2）希望有小伙伴去翻译更多的PEP，造福Python的中文学习社区

转载说明

作者：豌豆花下猫

链接：https://zhuanlan.zhihu.com/p/48993189

来源：知乎

著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

CATALOG
    FEATURED TAGS
    面试 Machine Learning 工作 PEP Python 规范 Jupyter Notebook 小象学院 NLP 模型 SOTA IT 算法 LSTM 深度学习 梯度 排序 总结 贪心 动态规划 数据结构 堆 栈 背包问题 C++ STL 位运算 double pointer 快慢指针 链表 cpython 字符串匹配 github ssh 安全 git css layout responsive life film javascript functional programming nodejs 工具 图论 最小生成树 并查集 oauth node express cookie cache HTTP
    FRIENDS