前言
每个人写脚本时的格式都会有所不同,有的会注明脚本本身的一些信息,有的则开门见山,这在小团队里其实没什么,基本别人做什么你也都知道,但如果放到大的团队就比较麻烦了,因为随着人数的增多,脚本成指数增长,如果每个人风格不统一,到最后就会造成非常大的弊端,所以当团队人数增长后,就必须有一套标准,形成大家统一的编码规则,这样即使不看脚本具体实现,也知道这个脚本的功能是什么。
我们今天分享的一段脚本是自动添加注释信息的脚本,添加的信息包括脚本名称、作者、时间、描述、脚本用法、语言版本、备注等,下面来看示例代码
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
|
#!/usr/bin/env python from os.path import exists from time import strftime import os title = raw_input ( "Enter a title for your script: " ) title = title + '.py' title = title.lower() title = title.replace( ' ' , '_' ) if exists(title): print "\nA script with this name already exists." exit( 1 ) descrpt = raw_input ( "Enter a description: " ) name = raw_input ( "Enter your name: " ) ver = raw_input ( "Enter the version number: " ) div = '=======================================' filename = open (title, 'w' ) date = strftime( "%Y%m%d" ) filename.write( '#!/usr/bin/python' ) filename.write( '\n#title\t\t\t:' + title) filename.write( '\n#description\t\t:' + descrpt) filename.write( '\n#author\t\t\t:' + name) filename.write( '\n#date\t\t\t:' + date) filename.write( '\n#version\t\t:' + ver) filename.write( '\n#usage\t\t\t:' + 'python ' + title) filename.write( '\n#notes\t\t\t:' ) filename.write( '\n#python_version\t\t:2.6.6' ) filename.write( '\n#' + div * 2 + '\n' ) filename.write( '\n' ) filename.write( '\n' ) filename.close() os.system( "clear" ) os.system( "vim +12 " + title) exit() |
脚本不做过多解释了,基本就是获取信息,然后写入一个文件中,其它不废话了,这个脚本足够简单了,我们最后来看看生成的结果:
1
2
3
4
5
6
7
8
9
10
|
#!/usr/bin/python #title :test4.py #description :I am test script #author :python技术 #date :20160902 #version :0.1 #usage :python test4.py #notes : #python_version :2.6.6 #============================================================================== |
总结
大家想一下,如果每个脚本前面都有这些基本信息,是不是看起来会清晰很多,最后希望这个脚本给给大家带来些帮助,当然如果有任何问题可以留言交流。谢谢大家对服务器之家的支持。