Python代码规范及micro:bit小试

Python代码规范

小引:

import this
导入此
The Zen of Python, by Tim Peters
《蟒蛇禅》,提姆·彼得斯著

Beautiful is better than ugly.
美胜于丑。
Explicit is better than implicit.
显式优于隐式。
Simple is better than complex.
简单胜于复杂。
Complex is better than complicated.
复杂总比复杂好。
Flat is better than nested.
平的比嵌套的好。
Sparse is better than dense.
稀疏胜于稠密。
Readability counts.
可读性计数。
Special cases aren’t special enough to break the rules.
特殊情况不足以打破规则。
Although practicality beats purity.
尽管实用性胜过纯洁性。
Errors should never pass silently.
错误永远不会悄悄地过去。
Unless explicitly silenced.
除非明确沉默。
In the face of ambiguity, refuse the temptation to guess.
面对歧义,拒绝猜测的诱惑。
There should be one-- and preferably only one --obvious way to do it.
应该有一种——最好只有一种——显而易见的方法来做到这一点。
Although that way may not be obvious at first unless you’re Dutch.
不过,如果不是荷兰语的话,这种方式一开始可能并不明显。
Now is better than never.
现在总比没有好。
Although never is often better than right now.
虽然从来没有比现在更好。
If the implementation is hard to explain, it’s a bad idea.
如果实现很难解释,那是个坏主意。
If the implementation is easy to explain, it may be a good idea.
如果实现很容易解释,这可能是一个好主意。
Namespaces are one honking great idea – let’s do more of those!
名称空间是一个非常好的主意——让我们做更多的事情吧!

1、规范文档

为了方便维护、他人阅读使用,整理出该编码规范文档。请大家开发是遵循本规范进行更(二次)开发。

本文档参考Guido的《Python风格指南》,并从《Barr’s style guide》中添加了内容部分,及个人建议。

2、一致性的建议

整个下面的开发请尽量保持一致性,尤其是一个模块或者一个函数中的一致性更为重要、

因此存在这样的一个问题:由于不同模块的lib库开发人不同,编码规范也可能不同。

3、代码的布局

3.1、缩进

Python是通过缩进来布局的,使用vi可以在“~/vimrc”中配置几个空格来代表一个tab,

3.2、Tab键还是空格键

“空格为荣,Tab为耻”,但全用空格键确实很麻烦。因此,不限定空格键还是Tab键。但:**不可混用!**可以用Tab键且不会出错。

3.3 、行的最大长度

类似函数中的行注释,函数体等,如果某一行很长,则导致换行折叠观看,很影响美观,而且还不利于阅读。因此,对顺序排序放的大块文本(文档字符串或注释),推荐在72字节内

3.5、编码

在Python2.4之后内核已经开始支持Unicode了。

无论什么情况,使用UTF-8才是王道!

Import 也是有顺序的:

  1. Python标准库的import;
  2. 第三方库的import
  3. 自定义库的import;

并且在每组的import直接使用一行空行分割。

4 、其他建议

始终在这些二元运算符两边放置一个空格:赋值(=),比较(==,<,>,!=,<>,<=,>=,in,not in,is,is not),布尔运算(and,or,not).

按你的看法在算术运算

不要在用于指定关键字参数或默认参数值的’='号周围使用空格,例如:

1 def complex(real,imag=0.0):
    return magic(r=real,i=imag)

5、注释

注释必须跟代码一致,当你想修改代码时,建议优先修改注释。

注释必须是完整的句子。

如果注释是一个句子或者短语,请首字母大写。

如果注释很短,建议省略句末的句号。

注释通常由一个或多个由完整句子构成的段落组成,每个句子应该以

约定使用系统统一的文档化注释格式有助于良好的习惯

6、注释块

注释块通常应用于跟随着一-些(或者全部)代码并和这些代码有着相同的缩进层次。注释块中每行以#和一个空格开始(除非他是注释内的缩进文本)。注释块内的段落以仅含单个#"的行分割。
注释块上下方最好有一空行包围(或上方两行下方一行,对一个新函数定义段的注释)。

micro:bit小试部分:

第一题:

1.micro:bit 和 Arduino有什么区别?

microbit:在线编程工具+本地编程工具,尺寸 43mm * 52mm,兼容电压:3V
Arduino: 本地编程工具(Arduino IDE),尺寸 53mm * 69mm,兼容电压:3V-5V

第二题:

2.简单介绍一下microbit,并介绍开发板上的功能
1.microbit是一款由英国广播电视公司(BBC)推出的专为青少年编程教育设计,并由微软,三星ARM,英国兰卡斯特大学等合作伙伴共同完成开发的微型电脑。
2.microbit仅有信用卡的一半大小。5*5可编程LED点阵灯、两颗可编程按键、加速计、电子罗盘、温度计、蓝牙等电子模块。

第三题:

3.画出在用力摇晃micro:bit 后在LED点阵上随机显示1-6中的一个数字,按下micro:bit 上的按钮B后就清空LED点阵的流程框图

Python代码规范及micro:bit小试_第1张图片

第四题:

4.写出用micro:bit 测温度的Python代码

from microbit import *
while True:
t=temperature()
display.show(str(t)+'#',delay=1000)

第五题:

5.micro:bit支持哪些编程工具?分别写出优缺点。
mu:
优点:在没网的时候也能编程,
缺点:不能用中文注释,寻找错误的时候要重新上传一次代码,上传代码时不可以进行任何操作
makecode在线编程:
优点:当没有microbit板的时候也能看效果
缺点:在没网的时候用不了,因为服务器在国外,会有点卡顿
makecode离线编程:
优点:在没网的时候也能编程
缺点:功能没有在线的齐全,不能及时得到更新
手机编程:
优点:在没有电脑的时候可以
缺点:比起电脑来说操作比较复杂

第六题:

6.MakeCode国内服务器安装步骤简述及涉及的命令代码。
1、安装Node.js
2、在安装node.js的地址,同一及地址创建一个microbit文件夹
3、运行Node.js command prompt打开命令行窗口(最好以管理员方式运行),输入npm install -g pxt
4、继续在命令行窗口中输入:pxt target microbit。过程有点久
5、安装完成之后打开cmd,输入microbit的路径,切换到microbit文件夹的地址后输入pxt serve
国内服务器就安装完毕!

第七题:

7.填空题

Python代码规范及micro:bit小试_第2张图片

如上图所示,序号1-5分别对应的名称

1:电机接口 2:外接电源
3:超声波传感器接口 4:颜色传感器接口
5:2路总舵机接口

你可能感兴趣的:(Python,Scratch,micro:bit)