为了方便维护、他人阅读,整理出该编码规范文档。请大家开发时遵循本规范进行更开发
本文档参考Guido的《Python风格指南》一文,并从《Barry's》
整个项目的开发中,请尽量保持一致性,尤其是一个模块或者一个函数中的一致性更为重要
因此存在这样的一个问题,由于不同模块的lib库开发人不同,编码规范也可能不同,整合起来会显得不够“和谐”。还是希望各模块lib库负责人做想对应的修改,尽量“和谐”
众所周知,Python是通过缩进来进行代码布局的。使用vi 可以在~/.vimrc中配置几个空格来代表一个tab,从而来布局Python函数的缩进。
Python里面有叫“以空格为荣,以用tab键为耻”。但全用空格时确实很麻烦。因此,这里不限定tab键还是空格。但记 住:'不可混用!'
类似于函数中的行注释、函数体等,如果某一行很长,则导致换行折叠看,很影响美观,而且还不利于阅读。因此,对顺序排放的大块文本(文档字符串或者注释),推荐长度限制在72个字节内。推荐使用反斜杠
用两行分隔顶层函数和类的定义。
用一行分割类成员方法的定义。
在一个函数内使用空行时请注意谨慎使用于一个逻辑段。
在python2.4之后内核已经开始支持Unicode了,无论在什么情况下,使用UTF-8才是王道!
通常应该在单独行中使用导入。
import 也是有顺序的:
1.)Python标准库的import;
2.)第三方库的import;
3.)自定义的库的import;
并且在每组的import之间使用一行空格分割
以下地方不推荐出现空格:
1.紧挨着圆括号,方括号和花括号的
如:‘spanm( ham[1],{aa:2})’,写成'spanm(ham[1],{aa:2})'
2.紧贴在逗号,分号或冒号前的
如:‘if x == 4 :print x , y ; x , y = y ,x’.写成‘if x == 4:print x, y; x, y = y’
3.紧贴着函数调用的参数列表前
如:‘dict['key'] = list [index]’.写成'dict['key'] = list[index]'
4.紧贴在索引或切片下边开始的开式括号前
如:‘dict ['key'] = list [index]’.写成‘dict['key'] = list[index]’
5.在赋值(或其他)运算符周围的用于和其他并排的一个以上的空格,如:
始终在这些二元运算符两边放置一个空格:赋值(=),比较(==,<,>),按你的看法在算数运算符周围插入空格,始终保持二元运算符两边空格的一致
一些例子;
不要在用于指定关键字参数或默认参数值的'='号周围使用空格,例如:
def one(a,b=1.1):
return b(r=re,i=im)
不要讲多条语句写在同一行上:
No:if a == 'aa':nice()
注释必须跟代码保持一致,当你想修改代码时,建议优点修改注释。
注释必须是完整的句子。
如果注释是一个句子或者短语,请首字母大写。
如果注释很短,建议省略句末的句号。
注释块通常由一个或者多个由完整句子构成的段落组成,每个句子应该以句号结尾。
注释请使用英文。
约定使用统一的文档化注释格式有助于良好的习惯和团队的进步。
注释块通常应用于跟随着一些(或者全部)代码并和这些代码有着相同的缩进层次。
注释块中每行以'#'和一个空格开始(除非他是注释内的缩进文本)
注释块内的段落以仅含单个'#'的行分割。
注释块上下方最好有一空行包围(或上下两行下方一行,对一个新函数定义段的注释)。
行内注释应该至少用两个空格和语句分开,它们应该以'#'和单个空格开始
区别 | microbit | Arduino |
---|---|---|
适合人群 | 学生爱好者 ( 小学以上 ) | 学生与爱好者(高中以上 ) |
处理器 | 32位ARM Cortex MO | ATmega328p |
尺寸 | 43 mm X 52 mm | 53 mm X 69 mm |
编程环境 | 在线编程工具 + 本地编程工具 | 本地编程工具 (Arduino IDE ) |
编程语言 | 图形化编程工具 ; MicroPython ;Scrtach | C ; C++ |
板载元件 | I/O 信号口 ; 蓝牙 ; 加速度计 ; 电子罗盘 ; 按钮 ; LED点阵 | I/O信号口 |
如何连接外部设备 | 鳄鱼夹 ; 扩展板 ; | 条线 ; 扩展板 |
兼容电压 | 3 V | 3 V - 5 V |
1.micro:bit 是一款由英国广播电视公司(BBC)推出的专为青少年编程教育设计的微型电脑开发板。
2. microbit 板有信用卡的一半大小 , 搭载了5 X 5可编程LED点阵, 两颗可编程按键 , 加速度计 , 电子罗盘 , 温度计 , 蓝牙等电子模块.
from micro:bit import *
While True:
t=temperature()
display.shOw( str (t)+'#' , delay = 1000)
1. 在线图形化编程工具MakeCode
优点:功能齐全,采用积木式图形化编程,更简单方便
缺点: 因服务器在国外 , 所以卡顿 , 必须有网络 , 不支持离线编程
2. mu离线python编译器
优点:1.代码提示、
2.可以不用网络
3.可以连接数据线 , 直接上传
缺点:1.不支持中文注释
2.下载程序时会把之前上传的自定义的库文件删除掉
3.REPL和FITLE两种模式之间切换有点麻烦
1.安装Node.js
官网:https://nodejs.org/en/
2.安装cli工具pxt
1.Node.js安装成功后,以管理员身份运行Node.js command prompt
2.在cmd输入:npm install -g pxt
3.安装pxt-microbit
1.先创建一个microbit文件夹
2.在microbit文件夹路径使用命令窗口打开
3.在命令行窗口输入:pxt target microbit
过程有点长,因为需要下载大量的文件,请耐心等待!
4.启动
在microbit文件夹目录中打开命令行窗口,输入命令:pxt serve
如果浏览器给你弹出一个MakeCode界面显示链接就成功了
v