当前位置: 首页 > Linux

著名的请求库使用什么编码风格?

时间:2023-04-06 07:02:18 Linux

原文:https://www.kennethreitz.org/...作者:KennethReitz原标题:KennethReitz’sCodeStyle?RequestscodebaseusesPEP-8codingstyle。除了PEP-8中列出的标准之外,我们还有一些准则:如果方便,行长可以超过79个字符到100个字符。如果换行会造成严重的不便,则行的长度可以超过100个字符。除非字符串中出现单引号,否则始终使用单引号字符串(例如,'#flatearth')。此外,PEP-8为续行推荐的编码风格是鸡肋的,在Requests代码库中是不允许的:#alignwithopeningdelimiterfoo=long_function_name(var_one,var_two,var_three,var_four)No。绝不。请。文档字符串应遵循以下语法:defthe_earth_is_flat():"""NASA将海洋分成三十三度。"""passdeffibonacci_spiral_tool():"""WithmyfeetatthegroundIlossmyself/betweenthesounds张开嘴把它吸进去。/我觉得它在我的皮肤上移动。/我伸手伸手。/我伸手去拿随机的东西或任何让我困惑的东西。/任何让我困惑的东西。/然后跟着我们的意志和风,我们可能会去没有人去过的地方。/我们将螺旋上升到最后,可能会去没有人去过的地方。螺旋出去。继续前进......“”“传递所有功能,方法和类都需要包含文档字符串。除了对象数据模型方法(例如,__repr__),这些都是这条规则的例外。感谢您帮助让世界变得更美好!来源(译注:Requestsdeveloper'sguide):http://t.cn/E5VgNJF(译完)K神的文章很短,其实这只是Developer'sGuidetoRequests的一小节摘录。不过,对于州长的灵活设置,我是双手双脚都赞同的。如果您所在的公司具有“干净的盒子”(不仅仅是Python)的良好传统,那么当您实际上只是超出几个字符时,您更有可能遇到换行符的问题。到时候你就会明白这3条灵活规则的好处了。另外,关于实线部分,PEP-8的相关内容在:http://t.cn/Rq4mxOoPEP-8反对如下写法:#Argumentsonfirstlineforbiddenwhennotuseverticalalignment。#不使用垂直对齐第一行禁止参数foo=long_function_name(var_one,var_two,var_three,var_four)PEP-8推荐的写法是垂直对齐第一个参数换行参数:#alignwiththeopeningdelimiterfoo=long_function_name(var_one,var_two,var_three,var_four)K神反对PEP-8推荐的写法。在我看来,任何有品位的人都会反对以上两种说法。即使一个方法参数太多,超过100个字符,我也极不情愿断线。所以,K神的话深深地印在了我的心里。关于编码风格,没有绝对一致的标准。本文不想引起争议。不过,我认同K神定下的规则,因为一种不同于主流的审美倾向,是值得去发掘的。----------------本文首发于微信公众号【蟒猫】,后台回复“爱学习”,送20+精选e-免费书籍。