diff --git a/wiki/programming-language/Python/文化/社区文化.md b/wiki/programming-language/Python/文化/社区文化.md new file mode 100644 index 00000000..6e888bda --- /dev/null +++ b/wiki/programming-language/Python/文化/社区文化.md @@ -0,0 +1,56 @@ +--- +title: 社区文化 +description: Python 的社区文化 +keywords: +- Python +- 社区文化 +tags: +- Python +sidebar_position: 5 +author: 7Wate +date: 2022-10-25 +--- + +## Python 增强提案(PEP 文档) + +### PEP 是什么? + +PEP(Python Enhancement Proposal,Python 增强提案),它是 Python 记录 Python 变化的书面文档。PEP 文档对 Python 的作用非常重要,根据讨论的主题,PEP 主要有以下 3 种用途: + +- 通知:汇总 Python 核心开发者需要的信息,并通知 Python 发布日程。 +- 标准化:提供代码风格、文档或其他指导意见。 +- 设计:对提交的功能进行说明。 + +阅读 Python 源代码可以帮助你了解 Python 的当前的处理逻辑,读 PEP 文档可以帮助你了解 Python 设计的来龙去脉,帮助你解答如下问题: + +- A 功能为什么要以这样的方式运行? +- Python 为什么没有 B 功能? + +大多数情况下,关于该功能的某个 PEP 文档已经该出了上述问题的详细答案。很多提交关于 Python 语言功能的PEP文档并没有通过。这些文档可以作为历史资料来参考。 + +#### PEP 0 + +所有提交过的 PEP 都被汇总在一个文档中,就是 [PEP 0 — Index of Python Enhancement Proposals (PEPs)](https://www.python.org/dev/peps/)。同时 PEP 0 叙述了如何共享 PEP,如何提交 PEP 以及 PEP 目标。 + +#### PEP 贡献流程 + +![process_flow.svg](https://static.7wate.com/img/2022/10/25/bbff0519daa6e.svg) + +```markdown +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 + +- [PEP 8 — Style Guide for Python Code,Python编码规范](https://peps.python.org/pep-0008) +- [PEP 20 — The Zen of Python](https://peps.python.org/pep-0020) + +> 来源:[PEP 0 – Index of Python Enhancement Proposals (PEPs) | peps.python.org](https://peps.python.org/#);非商业引用,著作权归作者所有。 + +> 来源:[Python改进提案:PEP文档 – 标点符](https://www.biaodianfu.com/python-pep.html);非商业引用,著作权归作者所有。