actir 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c7b0a489730d193f8c5bffcd60dfe8b3d7da3bdc
+  data.tar.gz: 1de0ba72345bc6b04ef8b7b51b011934b9765e7e
+SHA512:
+  metadata.gz: d8fd820b3ead55edbe520a4f2dbca6d8208402d38643def11e85ffb5057dcb01522e2b3ce7aa7688206f47cf21684a97bc5e0f12518e8eed8acbecb50a0de4e2
+  data.tar.gz: e9014a2c7c424a93c6f4864e46e9deb607eb22ace0bee67216da77d5ccf77e33e078bc75b06d724010c94f5efc1836b9efcba6e1e031cf1cb09ebac65c41d5c2

data/.gitignore

@@ -0,0 +1,17 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+*.gem
+.DS_Store
+mkmf.log
+/.travis/

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.0.0
+before_install: gem install bundler -v 1.10.3

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -0,0 +1,11 @@
+source 'https://ruby.taobao.org'
+
+# Specify your gem's dependencies in actir.gemspec
+gemspec
+gem 'bundler'
+gem 'rake'
+gem 'test-unit'
+gem 'watir-webdriver'
+gem 'selenium-webdriver'
+gem 'parallel'
+gem 'facets'

data/README.md

@@ -0,0 +1,56 @@
+# Actir
+
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/actir`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+TODO: Delete this and the text above, and describe your gem
+
+## Installation
+
+git clone code and then execute:
+
+    $ rake install
+
+Or install it yourself as:
+
+    $ gem install actir
+
+## Usage
+
+使用须知:  
+1. 对应测试工程结构如下  
+   config -- 配置文件  
+    |-config.yaml -- 总体配置文件,test_mode相关的配置项必须要填  
+   elements  
+    |-components -- 公用页面元素方法  
+    |-pages -- 页面元素封装的方法.如果是Web页面,可以直接继承自Actir::WebPage,已经封装了部分公用方法  
+   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中定义的方法)
+
+## Development
+
+.
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/actir/fork )
+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

data/Rakefile

@@ -0,0 +1,70 @@
+# encoding: utf-8
+require 'rake'
+
+def is_taobao_gemsource?
+  source = `gem sources -l`
+  source.include? "taobao"
+end
+
+unless is_taobao_gemsource?
+  # 修改RubyGems源
+  sh "gem sources --remove https://rubygems.org/"
+  sh "gem sources -a https://ruby.taobao.org/"
+  sh "gem sources -l"
+end
+
+def check_gem_available(gemName, versionLimit=nil)
+  isAvailable = false
+  begin
+    if versionLimit == nil
+      gem gemName
+    else
+      gem gemName, versionLimit
+    end
+    isAvailable = true
+  rescue LoadError
+  end
+  isAvailable
+end
+
+def is_root?
+  name = `whoami`
+  name.include? "root"
+end
+
+def sudo_str
+ "sudo" unless is_root?
+end
+
+# 判断是否安装bundler包，若没有，则安装，并require
+sh "#{sudo_str} gem install bundler" if check_gem_available("bundler") == false
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'actir/version'
+
+# Defines gem name.
+def repo_name
+  'actir'
+end
+
+def version
+  Actir::VERSION
+end
+
+task :package do
+  sh "#{sudo_str} bundle update"
+end
+
+task :gem do
+  sh "#{sudo_str} rm -rf #{repo_name}-#{version}.gem"
+  sh "#{sudo_str} gem build #{repo_name}.gemspec"
+end
+
+task :uninstall do
+  sh "#{sudo_str} gem uninstall #{repo_name} -a -x"
+end
+
+task :install => [:package, :gem, :uninstall] do
+  sh "#{sudo_str} gem install #{repo_name}"
+end

data/actir.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'actir/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "actir"
+  spec.version       = Actir::VERSION
+  spec.platform      = Gem::Platform::RUBY
+  spec.authors       = ["hub"]
+  spec.email         = ["hub@qima-inc.com"]
+
+  spec.summary       = %q{Application Concurrence Test in Ruby.}
+  spec.description   = %q{Distribut automated testing framework for Web or App.}
+  spec.homepage      = "http://git.qima-inc.com/qa/ants.git"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.files        += Dir.glob("{bin,lib}/**/*")
+  spec.executables   = %w(actir ants)
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "test-unit", "~> 3.0"
+  spec.add_development_dependency "watir-webdriver", "~> 0.6.11"
+  spec.add_development_dependency "selenium-webdriver", "~> 2.45"
+  spec.add_development_dependency "parallel", "~> 1.4"
+  spec.add_development_dependency "facets", "~>2.9"
+end

data/bin/actir

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+
+root = File.expand_path("../..", __FILE__)
+$LOAD_PATH << "#{root}/lib" if File.exist?("#{root}/Gemfile")
+
+require "actir"
+
+#开始执行
+Actir::ParallelTests::CLI.new.run(ARGV)

data/bin/ants

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+
+root = File.expand_path("../..", __FILE__)
+$LOAD_PATH << "#{root}/lib" if File.exist?("#{root}/Gemfile")
+
+require "actir"
+
+#开始执行
+Actir::ParallelTests::CLI.new.run(ARGV)

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "actir"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/actir.rb

@@ -0,0 +1,41 @@
+require 'test/unit'
+require 'watir-webdriver'
+require 'selenium-webdriver'
+lib = File.dirname(__FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'actir/config'
+require 'actir/initializer'
+require 'actir/remote'
+require 'actir/basic_page'
+require 'actir/parallel_tests/parallel_tests'
+require 'actir/webdriver/browser'
+require 'actir/script/cookies_baidu'
+require 'actir/version'
+
+module Actir
+  
+  #测试用例基础类，读取配置文件定义常量
+  class Test < Test::Unit::TestCase
+    
+    #IP地址的正则表达式
+    num = /\d|[01]?\d\d|2[0-4]\d|25[0-5]/  
+    ip = /^(#{num}\.){3}#{num}/ 
+    #遍历所有的入参，取出IP作为传给测试脚本的IPAddress
+    ARGV.each do |arg| 
+      if arg =~ ip
+        $address = arg
+      end
+    end
+
+    #若用例执行失败则进行截图，在每个用例的teardown方法中直接调用，传入浏览器对象实例
+    def screenshot_if_failed(browser)
+      unless self.passed?
+        Dir::mkdir('screenshots') if not File.directory?('screenshots')
+        time = Time.now.strftime('%Y%m%d-%H%M%S')
+        screenshot = "./screenshots/FAILED_#{self.name}_#{time}.png"
+        browser.screenshot.save screenshot
+      end
+    end
+  end
+  
+end

data/lib/actir/basic_page.rb

@@ -0,0 +1,49 @@
+module Actir
+
+  class BasicPage
+
+    #include PageObject	
+    
+    def initialize(driver)
+      case driver
+      #若是浏览器对象
+      when Watir::Browser, Browser
+        @browser = driver
+        #Appium TO-DO
+      when Appium::Driver
+        @appium = driver
+      else
+        raise "wrong driver"
+      end
+    end
+
+    def method_missing(m, *args, &blk)
+      if @browser.respond_to? m
+        @browser.send(m, *args, &blk)
+      elsif @appium.respond_to? m
+        @appium.send(m, *args, &blk)
+      else
+        super
+      end
+    end 
+
+    def turn_to kls
+      raise "Invalid Page Error" unless kls <= Actir::BasicPage
+      kls.new(@browser)
+    end
+
+    def data_driven hash, &blk
+      raise "Argument Error" unless hash.is_a?(Hash)
+      hash.each do |mtd, data|
+        m_with_eql = (mtd.to_s + '=').to_sym
+        if respond_to?(m_with_eql)
+          eval "self.#{m_with_eql.to_s}(data)"
+        elsif respond_to?(mtd.to_sym)
+          self.send(mtd.to_sym).send(data.to_sym) 
+        end #if
+      end #each
+      class_eval &blk if block_given?
+    end
+
+  end #BasicPage
+end #Actir

data/lib/actir/config.rb

@@ -0,0 +1,192 @@
+require 'yaml'
+require 'ostruct'
+
+module Actir
+
+  #
+  # 读取yaml文件中配置的内容
+  #
+  # @author: Hub
+  #
+  # @Date: 2015-1-20
+  #
+  module Config
+    
+    class << self
+
+      attr_accessor :config_dir
+      
+      #
+      # 从yaml文件中读取youzan的cookies
+      #
+      # @example : youzan_cookies
+      #
+      # @return [Hash] youzan的cookies的hash
+      #
+      def youzan_cookies(youzan_user)
+        cfg_str = "cookies." + youzan_user
+        get(cfg_str)
+      end
+      
+      #
+      # 从yaml文件中读取出所有内容
+      #
+      # @example : get_content(path)
+      #
+      # @return [OpenStruct] 所有配置文件内容 
+      #
+      def get_content(filepath)
+        f ||= filepath if valid?(filepath)
+        File.open(f) {|handle| @hash_content = YAML.load(handle)}
+        content = OpenStruct.new(@hash_content)
+        content
+      end
+
+      #
+      # 从config文件夹下的配置文件中读取对应的配置项，以hash形式返回
+      #
+      # @example : get "safeguard.mode"
+      #
+      # @param [String] : 指定配置项的字符串,形如safeguard.safeguard_type，以点衔接
+      #              
+      #                   第一个字符串表示配置文件的名字，之后表示在该文件中的配置项名称     
+      #
+      # @return [Hash] 对应配置项的hash
+      #
+      def get(key)
+        #按照点分割字符串
+        key_array = key.split(".")  
+        #先取出数组中的第一个元素当做配置文件名称，并从数组中移除此元素
+        file_name = key_array.shift
+        #再取出第二个元素，指定配置项,并移除
+        cfg_name = key_array.shift 
+        hash = {}
+        #加载yaml配置文件，加锁
+        lock(file_name) do 
+          hash = cfg_name ? load_file(file(file_name))[cfg_name] : load_file(file(file_name))
+        end
+        #遍历key数组
+        until key_array.empty? do
+          key = key_array.shift
+          hash = hash[key]
+        end
+        hash
+      end
+
+      #
+      # 更新配置文件中的key对应的value值
+      #
+      # 改文件加锁，解决多进程同时写文件的问题
+      #
+      # @example : set("config.test_mode.env", ":remote")
+      #
+      # @param key   : [String] 指定配置项的字符串,形如config.test_mode.env，以点衔接
+      #              
+      #        value : [String] 要修改的值的字符串     
+      #
+      def set(key, value)
+        #按照点分割字符串
+        key_array = key.split(".")  
+        #先取出数组中的第一个元素当做配置文件名称，并从数组中移除此元素
+        file_name = key_array.shift
+        cfg_str = key_array.shift
+        old_value = ""
+        lock(file_name) do 
+          #先读出所有的内容
+          str_array = IO.readlines(file(file_name))
+          str_array.each_with_index do |line, index|
+            if ( cfg_str != "" && line =~ /(\s*#{cfg_str}\:\s*)(.*)/ )
+              cfg_key = $1
+              old_value = $2
+              #找对了父节点，继续取下一个
+              if key_array.size > 0
+                cfg_str = key_array.shift
+              else
+                #只剩最后一个配置项了，说明找到了唯一的配置项，修改之
+                replace_str = cfg_key.chomp + value
+                str_array[index] = replace_str
+                cfg_str = ""
+              end
+            end
+          end
+          config_file = File.open(file(file_name), "w")
+          str_array.each do |line|
+            config_file.puts line
+          end
+          config_file.close
+        end
+        puts "Already set [" + key + "]'s value form " + old_value + " into " + value
+      end
+
+      #
+      # 判断配置文件的上一次修改时间和当前时间是否一样
+      #
+      # @example : is_same_day?("config")
+      #
+      # @param file_name : [String] 配置文件的名字,后缀省略
+      #               
+      # @return : [Boolean] 同一天则返回true
+      #
+      #                     不同则返回false
+      #
+      def is_same_day?(file_name)
+        now_date = Time.new.strftime("%m-%d")
+        modify_date = get_modify_time(file_name)
+        now_date == modify_date
+      end
+
+      #获取配置文件的修改时间(只精确到日期，不考虑具体时间)
+      #返回String,格式为：04-27... 12-29
+      def get_modify_time(file_name)
+        sh_str = "ls -l " + file(file_name) + " | awk '{print $6 \"-\" $7}'"
+        stat_str = `#{sh_str}`  
+        #从中取出月份和日期
+        stat_str =~ /(\d+).*\-(\d+)/
+        month = $1
+        day = $2
+        #若果是1-9,则在前面加个0
+        month = "0" + month if month.to_i <= 9 && month.to_i >= 1
+        day = "0" + day if day.to_i <= 9 && day.to_i >= 1
+        month + "-" + day
+      end
+      
+      # 多进程操作文件时加锁
+      def lock(file_name)
+        File.open(file(file_name), 'r') do |f|
+          begin
+            f.flock File::LOCK_EX
+            yield
+          ensure
+            f.flock File::LOCK_UN
+          end
+        end
+      end
+
+      #配置文件路径
+      def file(file_name)
+        File.expand_path(File.join(config_dir, "/#{file_name}.yaml"), __FILE__)
+      end
+      
+      #默认配置文件夹路径
+      def config_dir
+        @config_dir ||= File.join($project_path, "config")
+      end
+      
+      private
+
+      #读取yaml配置文件
+      def load_file(file)
+        YAML.load_file file
+      end
+
+      def valid?(filepath)
+        raise "file didn't exist!" unless File.exists?(filepath)
+        true
+      end
+
+    end
+  end
+end
+
+#Actir::Config.set("cookies.baidu.card2.available", "false")
+#puts Actir::Config.is_same_day?("cookies")