前言
每个人写脚本时的格式都会有所不同,有的会注明脚本本身的一些信息,有的则开门见山,这在小团队里其实没什么,基本别人做什么你也都知道,但如果放到大的团队就比较麻烦了,因为随着人数的增多,脚本成指数增长,如果每个人风格不统一,到最后就会造成非常大的弊端,所以当团队人数增长后,就必须有一套标准,形成大家统一的编码规则,这样即使不看脚本具体实现,也知道这个脚本的功能是什么。
我们今天分享的一段脚本是自动添加注释信息的脚本,添加的信息包括脚本名称、作者、时间、描述、脚本用法、语言版本、备注等,下面来看示例代码
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
#==============================================================================
|
总结
大家想一下,如果每个脚本前面都有这些基本信息,是不是看起来会清晰很多,最后希望这个脚本给给大家带来些帮助,当然如果有任何问题可以留言交流。谢谢大家对服务器之家的支持。