actir 1.4.2 → 1.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b43d744c66c2dd1e24f9e64b7d2646636c15a793
-  data.tar.gz: 23f165b5dd8b7ccf7e198d6d8f10c4b56395c2f1
+  metadata.gz: 5fd03ea345d89f235da0da7018897b291bac51e4
+  data.tar.gz: 36008a746454c6ac769fa39686b8040133e8c913
 SHA512:
-  metadata.gz: 6b47142432f0de33ffb80f45f402c6b0ea78714b7edd4c108fb243e8d45b795c154be3b236b70ea7c7e3fd8770254a2bef290a82968e0dc3aec98d708b39f47b
-  data.tar.gz: 4b7c59ff5a59442be44fa29abce1b2005fe59ca03bc3d0b8419b3645602e7cbc96e97b052b335f0afaced329e96802faa49aef9917285ca2b4af510b96004910
+  metadata.gz: cafec979c937f0ae7ce4fe1e89bf507ae930935888745f18c1a6901cbe9ec24dc9451b75ee5284958600dc0901b2a4c0831edec0ccf044002fd69083bf2ff399
+  data.tar.gz: 9af0c87b695b771a93568e3368d23b802af1f71c681676287fddc2432d88f3b8eda500d9b690b3705194f260ec77df61e05f6a6fe13d675be080688047884d4e

data/README.md

@@ -2,49 +2,76 @@
 
 Application Concurrence Test in Ruby.
 
-## Installation
+## 安装
 
-git clone code and then execute:
+通过Rake本地安装gem包：
 
     $ rake install
 
-Or install it yourself as:
-
-    $ gem install actir
-
-## Usage
-
-使用须知:  
-1. 对应测试工程结构如下  
-   config -- 配置文件  
-    |-config.yaml -- 总体配置文件,test_mode相关的配置项必须要填  
-   elements  
-    |-components -- 公用页面元素方法  
-    |-pages -- 页面元素封装的方法,可以继承自Actir::BasicPage,已经封装了部分公用方法  
-   testcode -- 测试用例,执行之前需要初始化 Actir::Initializer.new(project_path)
-              
-2.project_path:测试工程根目录
-
-3.Browser.new(type, *args):  
-   Browser重新封装了watir以及selenium的初始化浏览器的方法  
-   1).type指定初始化浏览器的类型,可以指定www/wap两类  
-   2).*args:  
-   :browser - 浏览器类型,可以支持 :chrome/:phantomjs/:firefox, 默认为chrome  
-   :agent   - user agent类型,可以支持 :iphone/:andriod_phone, 默认为iphone  
-   :mode    - 启动模式,支持 :local/:remote, 默认为local  
-   :url     - 配合mode为remote的模式,指定远程机器的url,需要 IP+端口号  
-
-4.初始化会自动require所有的elements内的文件并自动定义每个页面类对应的方法  
-   如: 某页面类名为LoginPage,则会自动定义出login_page方法  
-   3中初始化出的browser对象,可以直接调用login_page方法  
-   也可以直接调用Watir::Browser对应的所有方法  
-   如:browser = Browser.new(type, *args)  
-     browser.login_page.xxx (xxx为LoginPage中定义的方法)
-
-## Contributing
-
-1. Fork it ( https://github.com/hub128/actir.git )
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create a new Pull Request
+或者通过rubygems远程安装
+
+    $ sudo gem install actir
+    
+如果是Mac OS X 10.11版本以上的系统，要么关闭rootless机制，或者：
+
+    $ sudo gem install actir -n /usr/local/bin
+    
+
+## 使用须知
+
+####测试工程结构
+  - **config**：配置文件  
+    |--- config.yaml：总体配置文件,test_mode相关的配置项必须要填  
+  - **elements**：页面元素  
+    |--- components：公用页面元素方法, 包装成`Module`  
+    |--- pages：页面元素封装的方法,可以继承自`Actir::BasicPage`,已经封装了部分公用方法  
+    |--- items：根据业务抽象出的类
+    |--- user：根据系统业务抽象出的角色及其Action  
+  - **testcode**： 测试用例, 文件和用例方法都要以`test`开头, 执行之前需要初始化 Actir::Initializer.new(project_path)，`project_path`为测试工程根目录
+
+####浏览器对象
+``` ruby
+Browser.new(type, *args)
+```
+Browser重新封装了Watir以及Selenium的初始化浏览器的方法  
+- **type**：指定初始化浏览器的类型,可以指定www/wap两类  
+- ***args**：
+  - `:browser`：浏览器类型,可以支持 :chrome/:phantomjs/:firefox, 默认为chrome  
+    - `:agent`：user agent类型,可以支持 :iphone/:andriod_phone, 默认为iphone  
+    - `:mode`：启动模式,支持 :local/:remote, 默认为local  
+    - `:url`： 配合mode为remote的模式,指定远程机器的url,需要 IP+端口号  
+
+####Initializer自动加载工程文件
+``` ruby
+Actir::Initializer.new(project_path)
+```
+-  自动require所有的elements内的文件并自动定义每个页面类对应的方法。如: 某页面类名为`LoginPage`,则会自动定义出`login_page`方法供`Browser`对象调用
+- 可以直接调用Watir::Browser的所有方法    
+``` ruby
+browser = Browser.new(:wap)
+browser.login_page.login("xxx")
+# 调用Watir::Browser对象的方法
+browser.refresh
+```
+
+####执行测试用例
+
+    $ actir [switches] [--] [files & folders]
+    $ actir testcode/test_refund/test_full_refund.rb
+    $ actir testcode
+    
+指定执行某个用例文件中的某个方法：
+
+    $ actir testcode/test_pay/test_pay.rb -n test_ecard
+
+指定用例失败重试次数：
+
+    $ actir testcode/test_pay/test_pay.rb -r 2
+
+输出html格式的测试报告：
+
+    $ actir testcode/test_pay/test_pay.rb -r 2 --report
+
+
+> 可使用`actir -h` 了解更多的运行参数
+> 

data/lib/actir/config.rb

@@ -59,11 +59,17 @@ module Actir
         #先取出数组中的第一个元素当做配置文件名称，并从数组中移除此元素
         file_name = key_array.shift
         #再取出第二个元素，指定配置项,并移除
-        cfg_name = key_array.shift 
+        # cfg_name = key_array.shift 
         hash = {}
         #加载yaml配置文件，加锁
         lock(file_name, config_path) do
-          hash = cfg_name ? load_file(file(file_name, config_path))[cfg_name] : load_file(file(file_name, config_path))
+          # hash = cfg_name ? load_file(file(file_name, config_path))[cfg_name] : load_file(file(file_name, config_path))
+          hash = load_file(file(file_name, config_path))
+        end
+        #判断是否存在 online 和 qatest 关键词，存在的话就读取当前env配置
+        if (hash.has_key?("online") || hash.has_key?("qatest"))
+          #在key_array头上加入env配置
+          key_array.unshift(determine_env)
         end
         #遍历key数组
         until key_array.empty? do
@@ -78,9 +84,9 @@ module Actir
       #
       # 改文件加锁，解决多进程同时写文件的问题
       #
-      # @example : set("config.test_mode.env", ":remote")
+      # @example : set("config.test_mode.mode", ":remote")
       #
-      # @param key   : [String] 指定配置项的字符串,形如config.test_mode.env，以点衔接
+      # @param key   : [String] 指定配置项的字符串,形如config.test_mode.mode，以点衔接
       #              
       #        value : [String] 要修改的值的字符串     
       #
@@ -89,6 +95,19 @@ module Actir
         key_array = key.split(".")  
         #先取出数组中的第一个元素当做配置文件名称，并从数组中移除此元素
         file_name = key_array.shift
+
+        hash = {}
+        #加载yaml配置文件，加锁
+        lock(file_name, config_path) do
+          # hash = cfg_name ? load_file(file(file_name, config_path))[cfg_name] : load_file(file(file_name, config_path))
+          hash = load_file(file(file_name, config_path))
+        end
+        #判断是否存在 online 和 qatest 关键词，存在的话就读取当前env配置
+        if (hash.has_key?("online") || hash.has_key?("qatest"))
+          #在key_array头上加入env配置
+          key_array.unshift(determine_env)
+        end
+
         cfg_str = key_array.shift
         old_value = ""
         lock(file_name, config_path) do
@@ -115,9 +134,10 @@ module Actir
           end
           config_file.close
         end
-        puts "Already set [" + key + "]'s value form " + old_value + " into " + value
+        puts "set [" + key + "]'s value form " + old_value + " into " + value
       end
 
+
       #
       # 判断配置文件的上一次修改时间和当前时间是否一样
       #
@@ -189,6 +209,15 @@ module Actir
         true
       end
 
+      # 判断执行环境，如果$env为nil则从环境变量里面读取
+      def determine_env
+        if $env
+          $env
+        else
+          ENV["env"]
+        end
+      end
+
     end
   end
 end

data/lib/actir/data.rb

@@ -5,37 +5,29 @@ module Actir
     class << self
 
       def get(key)
-        #按照点分割字符串
-        key_array = key.split(".")  
-        #先取出数组中的第一个元素当做配置文件名称，并从数组中移除此元素
-        file_name = key_array.shift
-        #再取出第二个元素，指定配置项,并移除
-        cfg_name = key_array.shift 
-        hash = cfg_name ? load_file(file(file_name))[cfg_name] : load_file(file(file_name))
-        #遍历key数组
-        until key_array.empty? do
-          key = key_array.shift
-          hash = hash[key]
-        end
-        hash
+        # #按照点分割字符串
+        # key_array = key.split(".")  
+        # #先取出数组中的第一个元素当做配置文件名称，并从数组中移除此元素
+        # file_name = key_array.shift
+        # #再取出第二个元素，指定配置项,并移除
+        # cfg_name = key_array.shift 
+        # hash = cfg_name ? load_file(file(file_name))[cfg_name] : load_file(file(file_name))
+        # #遍历key数组
+        # until key_array.empty? do
+        #   key = key_array.shift
+        #   hash = hash[key]
+        # end
+        # hash
+        Actir::Config.get(key, data_dir)
       end
 
       private 
 
-      def file(file_name)
-        File.expand_path(File.join(data_dir, "/#{file_name}.yaml"), __FILE__)
-      end
-
       #默认配置文件夹路径
       def data_dir
         @data_dir ||= File.join($project_path, "data")
       end
 
-      #读取yaml配置文件
-      def load_file(file)
-        YAML.load_file file
-      end
-
     end
 
   end

data/lib/actir/parallel_tests/cli.rb

@@ -11,7 +11,7 @@ module Actir
         $env = "online"
         options = parse_options!(argv)
         num_processes = Actir::ParallelTests.determine_number_of_processes(options[:count])
-        $mode = Actir::ParallelTests.determine_run_env(options[:mode])
+        $mode = Actir::ParallelTests.determine_run_mode(options[:mode])
         if options[:execute]
           execute_shell_command_in_parallel(options[:execute], num_processes, options)
         else
@@ -184,7 +184,7 @@ module Actir
           #             default - filesize
           #   TEXT
           #   ) { |type| options[:group_by] = type.to_sym }
-          opts.on("-e [online][qatest]", String, "set environment to run testcase, default: online") { |env| env = "online" if ((env != "qatest" && env != "online")|| (env == nil)); $env = env;}
+          opts.on("-e [online][qatest]", String, "set environment to run testcase, default: online") { |env| env = "online" if ((env != "qatest" && env != "online")||(env == nil)); $env = env}
           opts.on("-r [TIMES]", "--rerun [TIMES]", Integer, "rerun times for failure&error testcase, default: 0") { |n| options[:rerun] = n }
           opts.on("-u", "--update", "Update Baifubao's cookies") { options[:update] = true }
           opts.on("--verbose", "Print more output") { options[:verbose] = true }

data/lib/actir/parallel_tests/parallel_tests.rb

@@ -27,25 +27,24 @@ module Actir
         [
           times,
           0
-          #Actir::Config.get("config.test_mode.re_run")
         ].detect{|c| not c.to_s.strip.empty? }.to_i
       end
 
       #判断用例执行的环境是local还是remote
-      def determine_run_env(mode)
+      def determine_run_mode(mode)
         env_mode = :local
         #判断是否存在config.yaml配置文件，如果不存在，则test_mode给默认值
         if File.exist?(File.join($project_path, "config", "config.yaml")) 
           #刷新配置文件中的env配置项为remote模式，以防止本地调试代码改写上传后导致CI失败
           if mode
-            unless mode == /#{Actir::Config.get("config.test_mode.env")}/
+            unless mode == /#{Actir::Config.get("config.test_mode.mode")}/
               #同步修改配置文件，需要先将Symbol转换成String
               mode_str = ":" + mode.to_s
-              Actir::Config.set("config.test_mode.env", mode_str)
+              Actir::Config.set("config.test_mode.mode", mode_str)
             end
             env_mode = mode
           else
-            env_mode = Actir::Config.get("config.test_mode.env")
+            env_mode = Actir::Config.get("config.test_mode.mode")
           end
         else
           if mode

data/lib/actir/parallel_tests/test/result.rb

@@ -41,26 +41,39 @@ module Actir
 
           def record_detail(test_result)
             failure_detail_hash = get_testfailed_info(test_result)
-              $testsuites.each do |testsuite|
-                testcases = testsuite[:testcases] 
-                testcases.each do |testcase|
-                  #标识用例是否执行失败
-                  fail_flag = 0
-                  failure_detail_hash.each do |testcase_failure, detail|
-                    if testcase_failure == testcase[:testcase_name]
-                      testcase[:success] = false
-                      testcase[:detail] = detail 
-                      fail_flag = 1
-                      #从hash表中移除 
-                      failure_detail_hash.delete(testcase_failure)
-                    end
-                  end
-                  if fail_flag == 0
-                    testcase[:success] = true
-                    testcase[:detail] = nil
+            
+            $testsuites.each do |testsuite|
+              testcases = testsuite[:testcases] 
+              testcases.each do |testcase|
+                #标识用例是否执行失败
+                fail_flag = 0
+                failure_detail_hash.each do |testcase_failure, detail|
+                  if testcase_failure == testcase[:testcase_name]
+                    testcase[:success] = false
+                    testcase[:detail] = detail 
+                    fail_flag = 1
+                    #从hash表中移除 
+                    failure_detail_hash.delete(testcase_failure)
                   end
                 end
+                if fail_flag == 0
+                  testcase[:success] = true
+                  testcase[:detail] = nil
+                end
+              end
+            end
+            # 反向再检查一遍是否有$testsuites种未记录的失败用例
+            miss_failed_case = []
+            if failure_detail_hash.size > 0
+              failure_detail_hash.each do |testcase_failure, detail|
+                testcase = {:testcase_name => testcase_failure, :success => false, :detail => detail}
+                #从hash表中移除 
+                failure_detail_hash.delete(testcase_failure)
+                miss_failed_case << testcase
               end
+              testsuite = {:testsuite_name => "miss_failed_case", :testcases => miss_failed_case}
+              $testsuites << testsuite
+            end
           end
 
           def get_run_test_info(test_result)

data/lib/actir/parallel_tests/test/runner.rb

@@ -83,6 +83,7 @@ module Actir
           def execute_command(cmd, process_number, num_processes, options)
             env = (options[:env] || {}).merge(
               #"TEST_ENV_NUMBER" => test_env_number(process_number),
+              "env" => $env,
               "TEST_ENV_NUMBER" => process_number,
               "PARALLEL_TEST_GROUPS" => num_processes
             )

data/lib/actir/version.rb

@@ -1,3 +1,3 @@
 module Actir
-  VERSION = "1.4.2"
+  VERSION = "1.4.3"
 end

data/lib/actir/webdriver/browser.rb

@@ -18,7 +18,7 @@ class Browser
   # 初始化函数
   #
   # 可以配置测试的mode：
-  #  1.:env
+  #  1.:mode
   #     :local  本地环境上测试
   #     :remote 远程测试环境上测试
   #  2.:browser
@@ -27,20 +27,20 @@ class Browser
   #  3.:agent wap页面的useragent类型 
   #     :iphone
   #     :android_phone
-  #  4.:address  当env为:remote时，url指定远程执行脚本的地址
+  #  4.:address  当mode为:remote时，url指定远程执行脚本的地址
   #
   def initialize(type = :www, *args)
     args = init_args(*args)
     @browser_type = args[:browser]
     @agent = args[:agent]
-    @env = args[:mode]
+    @mode = args[:mode]
     @window_size = args[:window_size]
-    if @env == :remote
+    if @mode == :remote
       @url = if args[:url]
         "http://#{args[:url]}/wd/hub"
       else
         #TO-DO ,远程模式没有传入IP,改成local模式
-        @env = :local
+        @mode = :local
         puts "selenium-node's IPAddress is null. switch to local mode"
       end
     end
@@ -90,8 +90,8 @@ class Browser
       else
         #若ENV为空，则读取配置文件，判断有无配置文件
         if config_exist
-          env = $config["config"]["test_mode"]["env"]
-          args[:mode] = (env == nil) ? :local : env
+          mode = $config["config"]["test_mode"]["mode"]
+          args[:mode] = (mode == nil) ? :local : mode
         else
           args[:mode] = :local
         end
@@ -127,7 +127,7 @@ class Browser
   # 打开普通www浏览器
   #
   def browser_www
-    case @env
+    case @mode
     when :local
       #本地chrome浏览器
       browser = Watir::Browser.new @browser_type
@@ -142,7 +142,7 @@ class Browser
     #重新设置窗口大小,不然phantomjs的ghost driver各种问题
     if @browser_type == :phantomjs
       browser.window.resize_to(PHANTOMJS_SIZE["width"], PHANTOMJS_SIZE["height"])
-    elsif @env == :remote
+    elsif @mode == :remote
       browser.window.resize_to(REMOTE_SIZE["width"], REMOTE_SIZE["height"])
     elsif @window_size != nil
       browser.window.resize_to(@window_size["width"], @window_size["height"])
@@ -160,7 +160,7 @@ class Browser
   # TO-DO: remote模式的phantomjs
   #
   def browser_wap
-    case @env
+    case @mode
     when :local
       driver = Actir::Webdriver.driver(:browser => @browser_type, :agent => @agent)
     when :remote

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: actir
 version: !ruby/object:Gem::Version
-  version: 1.4.2
+  version: 1.4.3
 platform: ruby
 authors:
 - hub
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-05-09 00:00:00.000000000 Z
+date: 2016-05-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: test-unit