多思考,多实践,现状才会改变!

ruby+watir之自动化测试脚本编写规范

上一篇 / 下一篇  2011-07-07 12:40:49 / 个人分类:ruby watir 自动化脚本规范

一、命名规范

1.1 全体

1.      原则上不使用单词的省略词。

2.      对于作用域小的循环变量,以i, j, k这样的名字顺序使用。

3.      对于作用域小的变量名,可以使用类名的省略语。 (eo = ExampleObject.new)

1.2 类名和模块名

类以及模块名、各单词的每头一个字母大写,不要使用“_”下划线等分隔符。但是,像HTTP这样的通用缩略语,全都照样大写。名称最好使用“名词”或者“形容词+名词”

正例:

OtherClass

HTTPClient

例:

Other_Class

OTHERCLASS

HttpClient

HTTPclient

HTTP_Client

1.3 方法名

方法名全都小写、各个单词之间用“_”分隔。方法名中使用“动词”或者“动词+名词”

正例:

add_something

误例:

addsSomething

Add_Something

返回真假值的方法的命名,在动词或形容词后追加“?”,对形容词,不用添加“is_”。

正例:

visible?

误例:

is_visible

is_visible?

另外,在使用具有破坏性和非破坏性的方法时候,要在破坏性的方法名后追加“!”。

:

split

split! # 具有破坏性的split

1.4 常数名

类和模块名以外的常数名,全都用大写,单词之间用“_”来分隔。

:

EXAMPLE_CONSTANT

1.5 变量名

对于变量名,全都用小写,单词之间用“_”来分隔。全局变量以$开头,实例变量以@开头,类变量以2@开头。

:

tmp

local_variable

@instance_variable

$global_variable

@@class_variable

变量名称要能清晰表达该变量的含义,如order_state,记录订单的状态

1.6 文件名

文件名全都使用小写字母,单词之间用“_”来分隔。另外,可以把文件中的已经变换的主要类名作为文件名来使用。

:

foo.rb # 定义了Foo

foo_bar.rb # 定义了FooBar


二、代码排版规范

2.1 注释风格

注释的位置应与被描述的代码相邻,可以放在代码的上方或右方,不要放在代码的下方;注释内容应明确表达被注释代码的含义。

例:

    # Return a Watir::IE object for an existing IE window. Window can be

    # referenced by url, title, or window handle.

    # Second argument can be either a string or a regular expression in the

    # case of of :url or :title.

    # IE.attach(:url, 'http://www.google.com')

    # IE.attach(:title, 'Google')

    # IE.attach(:hwnd, 528140)

    # This method will not work when

    # Watir/Ruby is run under a service (instead of a user).

defself.attach(how, what)

ie = new true # don't create window

ie._attach_init(how, what)

ie

end

2.2 代码格式

   2.2.1空格

  1. 逗号“,”、分号“;”之后要留空格
  2. 赋值操作符、比较操作符、算术操作符、逻辑操作符,如“=”、“+=”“>=”、“<=”、“+”、“*”、“%”、“&&”、“||”等二元操作符的前后都加空格或者前后都不加空格。

正例:

a+b

a + b

误例:

a+ b

a +b

  1. 一元操作符如“!”、“~”以及“[]”、“.”、“::”这类操作符前后不加空格。
  2. 函数名之后不要留空格

    2.2.2代码缩进

为了增加程序的可读性而进行的适当的缩进,缩进的幅度以2个字符为宜。另外,缩进的时候,只可使用空格,不可使用TAB(编程工具不同的时候,看起来会不一样)

:

if x > 0

 if y > 0

    puts "x > 0 && y > 0"

 end

end

    2.2.3空行

同一函数内,不同含义的代码段之间空一行;不同函数和不同类之间空两行

2.3.输出检查点的格式

输出检查点采用“---输出语句---”格式,输出语句应简洁清晰的表达意思。



此文出处 :http://www.blogjava.net/lijun_li/archive/2010/07/22/326820.html


TAG: Ruby ruby Watir watir 规范 自动化测试

引用 删除 ferrylu2011   /   2011-07-14 10:02:19
如果你正在求职
如果你从事自动化测试工作
如果你能够搭建自动化测试框架

外企职位等你来
加qq:1483620344  咨询
 

评分:0

我来说两句

Open Toolbar