商标设计logo网站,我要表白网在线生成,企业如何做网络推广,营销型网站有哪些代表一、pep8起源 龟叔创立Python的初衷里就有创立一个容易阅读的编程语言#xff0c;所以亲自操刀写了pep8 代码规范#xff0c;每个项目开始前都要有一个共识#xff0c;就是自己的代码规范#xff0c;pep8 就是一个很好的范本。 二、官网链接 https://www.python.org/dev/pe…一、pep8起源 龟叔创立Python的初衷里就有创立一个容易阅读的编程语言所以亲自操刀写了pep8 代码规范每个项目开始前都要有一个共识就是自己的代码规范pep8 就是一个很好的范本。 二、官网链接 https://www.python.org/dev/peps/pep-0008/ 中文翻译链接 https://my.oschina.net/u/1433482/blog/464444 三、重要总结 一致性问题 风格指南强调一致性。项目、模块或函数保持一致都很重要。 当遵循指南降低代码一致性可读性的时候就不必强行修改。 代码布局 缩进四个空格代替tab 行宽79个字符文本长块72个字符 字符编码总是用UTF-8 导入模块 导入时单行导入开头导入 顺序为标准库本地库第三方库 尽量使用绝对路径不用通配符导入 空格 括号内没有空格 关键字参数和默认值参数的前后不要加空格 逗号分号冒号前无空格 运算符后有空格 不推荐复合语句一句一行 用英文写注释及时更新注释少用行内注释文档字符串为所有公共模块、函数、类和方法书写 命名 最重要的原则 用户可见的API命名应遵循使用约定而不是实现。不太明白 命名风格 b(单个小写字母) B(单个大写字母) lowercase(小写串) lower_case_with_underscores(带下划线的小写) UPPERCASE(大写串) UPPER_CASE_WITH_UNDERSCORES(带下划线的大写串) CapitalizedWords(首字母大写的单词串或驼峰缩写注意: 使用大写缩写时缩写使用大写字母更好。故 HTTPServerError 比 HttpServerError 更好。 mixedCase(混合大小写第一个单词是小写) Capitalized_Words_With_Underscores带下划线首字母大写丑陋 首尾有下划线的情况: _single_leading_underscore:(单前置下划线): 弱内部使用标志。 例如from M import 不会导入以下划线开头的对象。 single_trailing_underscore_(单后置下划线): 用于避免与 Python关键词的冲突。 例如Tkinter.Toplevel(master, class_ClassName) __double_leading_underscore(双前置下划线): 当用于命名类属性会触发名字重整。 (在类FooBar中__boo变成 _FooBar__boo)。 __double_leading_and_trailing_underscore__(双前后下划线)用户名字空间的魔法对象或属性。例如:__init__ , __import__ or __file__不要自己发明这样的名字。 命名约定规范 避免采用的名字 决不要用字符l(小写字母el)O(大写字母oh)或 I(大写字母eye) 作为单个字符的变量名。一些字体中这些字符不能与数字1和0区别。用L 代替l时。 包和模块名 模块名要简短全部用小写字母可使用下划线以提高可读性。包名和模块名类似但不推荐使用下划线。 模块名对应到文件名有些文件系统不区分大小写且截短长名字在 Unix上不是问题但当把代码迁移到 Mac、Windows 或 DOS 上时就可能是个问题。当然随着系统的演进这个问题已经不是经常出现。 另外有些模块底层用C或C 书写并有对应的高层Python模块C/C模块名有一个前置下划线 (如_socket)。 类名 遵循CapWord。 接口需要文档化并且可以调用时可能使用函数的命名规则。 注意大部分内置的名字是单个单词或两个CapWord只适用于异常名称和内置的常量。 异常名 如果确实是错误需要在类名添加后缀 Error。 全局变量名 变量尽量只用于模块内部约定类似函数。 对设计为通过 from M import 来使用的模块应采用 __all__ 机制来防止导入全局变量或者为全局变量加一个前置下划线。 函数名 函数名应该为小写必要时可用下划线分隔单词以增加可读性。 mixedCase(混合大小写)仅被允许用于兼容性考虑(如: threading.py)。 函数和方法的参数 实例方法第一个参数是 self。 类方法第一个参数是 cls。 如果函数的参数名与保留关键字冲突通常在参数名后加一个下划线。 方法名和实例变量 同函数命名规则。 非公开方法和实例变量增加一个前置下划线。 为避免与子类命名冲突采用两个前置下划线来触发重整。类Foo属性名为__a 不能以 Foo.__a访问。(执著的用户还是可以通过Foo._Foo__a。) 通常双前置下划线仅被用来避免与基类的属性发生命名冲突。 常量 常量通常在模块级定义,由大写字母用下划线分隔组成。比如括MAX_OVERFLOW和TOTAL。 继承设计 考虑类的方法和实例变量(统称为属性)是否公开。如果有疑问选择不公开把其改为公开比把公开属性改为非公开要容易。 公开属性可供所有人使用并通常向后兼容。非公开属性不给第三方使用、可变甚至被移除。 这里不使用术语private Python中没有属性是真正私有的。 另一类属性是子类API(在其他语言中通常称为 protected)。 一些类被设计为基类可以扩展和修改。 谨记这些Python指南 公开属性应该没有前导下划线。 如果公开属性名和保留关键字冲突可以添加后置下划线 简单的公开数据属性最好只公开属性名没有复杂的访问/修改方法python的Property提供了很好的封装方法。 d.如果不希望子类使用的属性考虑用两个前置下划线(没有后置下划线)命名。 公共和内部接口 任何向后兼容的保证只适用于公共接口。 文档化的接口通常是公共的除非明说明是临时的或为内部接口、其他所有接口默认是内部的。 为了更好地支持内省模块要在__all__属性列出公共API。 内部接口要有前置下划线。 如果命名空间(包、模块或类)是内部的里面的接口也是内部的。 导入名称应视为实现细节。其他模块不能间接访名字除非在模块的API文档中明确记载如os.path中或包的__init__暴露了子模块。 转载于:https://www.cnblogs.com/xinghuaikang/p/8486493.html
