Python 学习笔记【07】PEP 8 中英对照

  PEP 8 -- Style Guide for Python Code

  Ppython.org PEP8   中文翻译 PEP8

 

  Introduction 

  介绍

  This document gives coding conventions for the Python code comprising the standard library in the main Python distribution. 

  本文给出主Python版本标准库的编码约定。 

  Please see the companion informational PEP describing style guidelines for the C code in the C implementation of Python [1] .

  CPython的C代码风格参见PEP7

  his document and PEP 257 (Docstring Conventions) were adapted from Guido's original Python Style Guide essay, with some additions from Barry's style guide [2] .

  本文和PEP 257 文档字符串标准改编自Guido最初的《Python Style Guide》, 并增加了Barry的GNU Mailman Coding Style Guide的部分内容。

  This style guide evolves over time as additional conventions are identified and past conventions are rendered obsolete by changes in the language itself.

  许多项目都有自己的编码风格指南,冲突时自己的指南为准。

 

   A Foolish Consistency is the Hobgoblin of Little Minds

   一致性考虑

  One of Guido's key insights is that code is read much more often than it is written. 

  Guido的关键点之一是:代码更多是用来读而不是写。

  The guidelines provided here are intended to improve the readability of code and make it consistent across the wide spectrum of Python code. As PEP 20 says, "Readability counts".

  指南旨在改善Python代码的可读性,即PEP 20所说的“可读性计数"(Readability counts)。

  

 

posted @ 2016-10-27 10:44  A1_Code  阅读(348)  评论(0编辑  收藏  举报