小螞蟻  
          風雨過后才見彩虹
          公告

          • —————————————
            李麗君
            軟件測試工作者
            廣東籍貫的海南人
            北京生活12年
            目前在深圳

            郵箱:
            llj2003hbdd@163.com
            —————————————
            說明:本Blog中的內容均為本人原創或轉載,本人依法保留Blog內原創文章的所有權利,如需轉載,請注明作者及出處。未經許可,不得將本Blog內文章用于任何盈利性用途。
            —————————————
          日歷
          <2010年7月>
          27282930123
          45678910
          11121314151617
          18192021222324
          25262728293031
          1234567

          導航

          常用鏈接

          留言簿(174)

          隨筆分類(189)

          0--感興趣的網站

          1--國內測試網站

          2--測試同行的blog

          3--開發好友的blog

          最新評論

           
           

          編寫背景:

          測試組團隊經過1年多的實戰,測試工作流程及規范大家都已經明白并能很好的完成每個月的測試任務;下半年要向工作質量和工作效率邁上一個臺階,需要發揮大家的力量;自動化測試腳本編寫這幾個月在測試任務中讓大家感受了一把;大家都認識到,要想讓這些自動化測試腳本能高效的維護、使用,讓新人和老人更容易的明白這些代碼,我們需要一個自動化測試腳本編寫的規范。

          經過大家的努力,得出了這么個初稿,放在這里和大家交流交流,希望有經驗的同行能給些建議。


          一、命名規范

          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.輸出檢查點的格式

          輸出檢查點采用“---輸出語句---”格式,輸出語句應簡潔清晰的表達意思。


          三、代碼示例

          代碼示例如下圖

          posted on 2010-07-22 11:33 lijun 閱讀(2463) 評論(3)  編輯  收藏 所屬分類: 軟件自動化測試
          評論:
           
          Copyright © lijun Powered by: 博客園 模板提供:滬江博客
          主站蜘蛛池模板: 宜春市| 徐水县| 泰安市| 宜州市| 高密市| 台江县| 喜德县| 二手房| 略阳县| 德州市| 丰都县| 黑龙江省| 沙洋县| 宜阳县| 海淀区| 米脂县| 赣榆县| 曲水县| 阿尔山市| 鄯善县| 辽宁省| 榕江县| 台东市| 新宁县| 兴义市| 夏河县| 新宾| 专栏| 滦平县| 灵丘县| 宁城县| 宁夏| 方正县| 杭州市| 长海县| 南开区| 江孜县| 赣州市| 清徐县| 改则县| 五河县|