#!/usr/bin/env python #在文件头部 ( 第一行 ) 加上 设置 Python 解释器
# -*- coding: utf-8 -*- #在文件头部 ( 第二行 ) 加上 在编辑器中设置以 UTF-8 默认编码保存文件
# Copyright (c) 2011 - chinakr <chinakr@gmail.com> #版权信息放在文件头部,文件编码之后
# docstring 是 Python 特有的注释风格,它是模 块、类或函数的第一个语句,可以通过 __doc__ 方法访问
# 用英语撰写注释,短注释可以忽略末尾的句号 (.)
# docstring 为每个模块、类或函数撰写 docstring 推荐使用三个双引号 (”””) 来定义 docsting , 不推荐使用三个单引号 (''')
# 模块的 docsting 放在文件头部,版权信息之后
”””This is a one line docstring.”””
”””The title of a multiline docstring:
After title is the content.You can write it as long as needed.
”””
# 把 import 语句放在文件头部,在模块 docstring 之后,在模块全局变量或全局常量之前
# 按照从一般到特殊的原则分组 import 语句,先 import 标准库,然后 import 第三方库,最后 import 程序中的自定义库
# 在不同分组的 import 语句之间加空行
# 每个 import 语句只导入一个模块
import sys
import time
from PyQt.QtCore import SIGNAL, QTimer
# 在终端中使用中文字符 在文件头部加上
# import sys
# reload(sys)
# sys.setdefaultencoding('utf-8')
# 一行代码的长度不能超过 79 个字符
# 在括号 ( 圆括号、方括号、花括号 ) 内部折行是 推荐使用的方式
fooBar(self, width, height, color='balck', design=None, x='foo',
emphasis=None, highlight=0)
# 需要时可以在表达式两侧加上额外的括号
if (width == 0 and height == 0 and
color == 'red' and empasis == 'strong'):
# 括号内的长字符串可以直接写成两个短字符串
x = ('This will build a very long long '
'long long long long long long string')
# 使用续行符号,折行的位置可以在逗号 (,) 后或 运算符前,折行后要多一个缩进
from PyQt4.QtCore import QTextCodec, SIGNAL, SLOT, \
QLibraryInfo, QTimer
veryLongVariableA = veryLongVariableB \
+ verLongVariableC
# 使用 4 个空格进行缩进 不要使用 Tab 或者混合使用空格和 Tab
# 适当的空行可以提高代码的可读性 加空行的原则:
## 在不同分组的 import 语句之间加空行
## 在顶层的类或函数定义之间加两个空行
## 在类或函数定义之间加空行
## 相关的函数定义可以放在一起,并使用两个空行来分 隔 ( 应谨慎地使用额外的空行 )
## 在函数或方法内部可以加空行,也就是把相关的代码 紧凑地写在一起,形成逻辑段落,段落之间用空行分 隔 ( 应谨慎地使用额外的空行 )
# 加空格的情况:
## 逗号 (,) 、冒号 (:) 后要加空格
## 二元运算符前后要加空格,如赋值运算符 (=) 、比较 运算符 (==, <, >, !=, <=, >=, in, not in, is, is not) 和逻 辑运算符 (and, or, not)
## 算数运算符前后要加空格
# 不加空格的情况:
## 逗号 (,) 、冒号 (:) 前不加空格 参数列表、索引 (index) 或切片 (slice) 的前括号 ( 圆
## 括号, 方括号)前不加空格 前括号 ( 圆括号、 方括号、花括号 ) 后不加空格,后
## 括号前不加空格 一元运算符前后不加空格
## 函数或方法定义或调用时参数列表中的等号 (=) 前后 不加空格
## 冒号 (:) 在行尾时不加空格,如类定义、函数定义、 分支语句、循环语句
# 谨慎地使用括号
# 不要在返回语句和条件语句中使用括号,除非是 为了换行
if foo:
bar()
return foo
# 可以在元组 (tuple) 两侧使用括号
for (x, y) in dict.items():
# 恰当的命名可以提高代码的可读性 命名时只使用 ASCII 字符,并尽量使用英文单词 命名规则
# 类型 公共 内部
# 包 lower_with_under
# 模块 lower_with_under _lower_with_under
# 类 CapWords _CapWords
# 函数 capWords() _capWords()
# 全局常量 / 类常量 CAPS_WITH_UNDER _CAPS_WITH_UNDER
# 全局变量 / 类变量 capWords _capWords
# 方法 capWrods() _capWords() ( 保护 ) __capWords() ( 私有 )
# 函数参数 / 方法参数 capWords
# 局部变量 capWrods
# 不要使用l(小写的L)、o(小写的O)和I(大写的 i) 作为单字符变量名,因为在某些字体下很难把 它们和数字1、0区分开
## 当需要使用 l( 小写的 L) 时可以使用 L 代替
## 当需要使用保留关键字作为函数名时,可以在名 字后加一个下划线 (_) ,而不要破坏正常的拼写
# 模块的主要功能要放在 main() 函数中
def main():
//do something
if __name__ == '__main__':
main()
分享到:
相关推荐
1.2 Python 编码风格方面的准则 2. Python 语言方面的准则 2.1 pychecker 2.2 导入模块和包 2.3 完整路径导入 2.4 异常处理 2.5 全局变量 2.6 内嵌/本地/内部类和函数 2.7 List Comprehensions 2.8 默认迭代器和...
PEP8Python 编码规范 将Python 的英文编码变成中文的数据规范
Google 开源项目Python风格指南 中文版 1、Python语言规范 2、Python风格规范
Google 推荐的python编码规则,适合大/小型项目维护与代码管理规范。
Google Python code style 中文的编码规范,非常详细,吐血推荐。
Python_编码风格指南中译版
一个高品质编码风格习惯和标准清单列表
网上收集的Goolge Python编码规范。包含两个版本,Google Python Style Guide中文版_li3p.pdf,Google-python-style-guide中文版_guoqiao.pdf。两份文档内容基本一致,guoqiao翻译的格式比较好,而且带详细书签。
对于提高Python编码风格有很好的帮助
这篇文档所给出的编码约定适用于在主要的Python发布版本中组成标准库的Python 代码,请查阅相关的关于在Python的C实现中C代码风格指南的描述。 这篇文档改编自Guido最初的《Python风格指南》一文,并从《Barry's ...
Python开发编码规范 官方 权威 这篇文档所给出的编码约定适用于在主要的Python发布版本中组成标准库的Python 代码.请查阅相关的关于在Python的C实现中C代码风格指南的描述. 这篇文档改编自Guido最初的《Python风格...
google的python编码规范,以及python的google代码编写风格
Google开源项目Python编码风格指南@作者:( ) Google开源项目Python编码风格指南[1]的翻译,翻译过程中主要参考了项目[2]与项目[3],但在细节方面捋顺了一些象征,并根据最新指南添加了部分内容。其中本项目文件...
文档整理自下面网址: http://code.google.com/p/zh-google-styleguide/ Google的Python编程风格指南,排版之后便于打印。
请参阅PEP关于Python的C实现的C编码风格指南的描述。 本文档和PEP257(文档字符串规范)改编自Guido的《Python Style Guide》一文,并从《Barry's style guide》添加了部分内容作为补充。 这篇风格指南随着时间的...
即 Style Guide for Python Code(Python编码风格指南)。如果面试时不知道什么是 PEP 8 ,那聊起来想必不会很愉快。速战速决的面试,如果不是你把面试官“秒杀”了,那就是面试官把你“秒杀”了,大部分是后者。 ...
所以遵循良好的编码风格,可以有效的提高代码的可读性,降低出错几率和维护难度。除了 Flask 之外,Pocoo 团队还有开发出很多广受欢迎的项目,例如 Jinj
这篇文档所给出的编码约定适用于在主要的Python发布版本中组成标准库的Python 代码,请查阅相关的关于在Python的C实现中C代码风格指南的描述。 这篇文档改编自Guido最初的《Python风格指南》一文,并从《Barry's ...
用Python切片官方的Holberton Python编码风格是什么,以及如何使用PEP 8检查您的代码 要求 Python脚本 允许的编辑器:vi,vim,emacs所有文件都将在Ubuntu 14.04 LTS上使用python3(版本3.4.3)进行解释/编译。所有...
python 代码讲究优雅、简洁,这离不开良好的代码风格,通过文档 Python 代码编程规范(取自google) 可以修正自己的代码风格,提升自己代码整体感官。