simplexframe 0.0.01

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,21 @@
+source 'https://rubygems.org'
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+gem "rspec", ">= 2.13.0"
+gem "page-object", ">= 0.8.6.1"
+gem "thor", ">= 0.14.6"
+gem "active_support", "~> 3.0.0"
+
+group :development do
+  gem "rdoc", "~> 3.12"
+  gem "bundler", "~> 1.3.5"
+  gem "jeweler", "~> 1.8.4"
+	gem "rspec", ">= 2.13.0"
+	gem "page-object", ">= 0.8.6.1"
+	gem "thor", ">= 0.14.6"
+	gem "active_support", "~> 3.0.0"
+end

data/Gemfile.lock

@@ -0,0 +1,64 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    active_support (3.0.0)
+      activesupport (= 3.0.0)
+    activesupport (3.0.0)
+    childprocess (0.3.9)
+      ffi (~> 1.0, >= 1.0.11)
+    data_magic (0.14)
+      faker (>= 1.1.2)
+      yml_reader (>= 0.2)
+    diff-lcs (1.2.4)
+    faker (1.1.2)
+      i18n (~> 0.5)
+    ffi (1.6.0-x86-mingw32)
+    git (1.2.5)
+    i18n (0.6.4)
+    jeweler (1.8.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.7.7)
+    multi_json (1.7.2)
+    page-object (0.8.6.1)
+      page_navigation (>= 0.7)
+      selenium-webdriver (>= 2.31.0)
+      watir-webdriver (>= 0.6.2)
+    page_navigation (0.7)
+      data_magic (>= 0.14)
+    rake (10.0.4)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.5)
+    rspec-expectations (2.14.0)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.1)
+    rubyzip (0.9.9)
+    selenium-webdriver (2.31.0)
+      childprocess (>= 0.2.5)
+      multi_json (~> 1.0)
+      rubyzip
+      websocket (~> 1.0.4)
+    thor (0.14.6)
+    watir-webdriver (0.6.2)
+      selenium-webdriver (>= 2.18.0)
+    websocket (1.0.7)
+    yml_reader (0.2)
+
+PLATFORMS
+  x86-mingw32
+
+DEPENDENCIES
+  active_support (~> 3.0.0)
+  bundler (~> 1.3.5)
+  jeweler (~> 1.8.4)
+  page-object (>= 0.8.6.1)
+  rdoc (~> 3.12)
+  rspec (>= 2.13.0)
+  thor (>= 0.14.6)

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 theSimplex
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,94 @@
+simplexframe
+=====================
+
+A simple web automation test framework using [selenium-webdriver](http://docs.seleniumhq.org/projects/webdriver/),[watir-webdriver](https://github.com/watir/watir-webdriver),[page-object](https://github.com/cheezy/page-object) and [rspec](https://github.com/rspec/rspec). 
+
+
+Install simplexframe
+---------------
+Install simplexframe from rubygems
+
+	gem install simplexframe
+
+Or clone from github, build the gem and install 
+
+If you have any issue when install simplexframe, install the gems below:
+	
+	gem install thor
+
+
+Create a simplexframe project 
+------------------------
+In windows, open command console and type just like below:
+
+	simplexframe new your_project_name	
+		
+Run Examples
+------------
+
+Simplexframe contains some examples that explain how to use simplexframe writing your own test cases.
+
+By default, simplexframe runs examples using chrome browser, so make sure you installed google chrome and according [chrome driver](http://code.google.com/p/chromedriver/downloads/list)
+
+Using following command to make everything running.
+
+	cd your_project_name
+	simplexframe go  
+
+Simplexframe go command supports all the rspec options and it is the recommend way.
+
+You can find test report in app/reports folder. It is a html file with current time stamp.
+
+Using Console
+-------------
+You can use eat console to debug your test in irb.
+
+	cd your_project_name
+	simplexframe c
+
+Simplexframe will load all your pages, start irb and open browser which was defined in your config.yml.
+
+Then you can use $navi variable the same way in your test file.
+
+	p = $navi.goto_baidu_page
+	p.keyword="watir-webdriver"
+	p.search_element.click
+
+You can type everything just like you are write a text case.
+
+Understand project structure
+------------------------------------
+
+Simplexframe project has a clean and simple structure. 
+
+* app: holds your test codes;
+* config: where your config file placed;
+
+* app->pages: puts all your pages files here;
+* app->pages->components: sometimes,there are some html element that could be reused more than once, define a component, place the file here and you can include your components in your pages.
+
+* app->cases: holds your testcase files;
+* app->cases->shared: Image that, you are testing a system which need to login before any actions, so you want to define a login function which can be called from your cases. Define reused cases here.
+
+* app->reports: the fold holds your test reports.
+
+* app->matchers: defind your owner rspec matchers here.
+
+
+Contributing to simplexframe
+-----------------------
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+Copyright
+---------
+
+Copyright (c) 2013 easonhan. See LICENSE.txt for
+further details.
+

data/README.rdoc

@@ -0,0 +1,38 @@
+simplexframe
+=====================
+
+A simple web automation test framework using [selenium-webdriver](http://docs.seleniumhq.org/projects/webdriver/),[watir-webdriver](https://github.com/watir/watir-webdriver),[page-object](https://github.com/cheezy/page-object) and rspec(https://github.com/rspec/rspec). 
+
+Now simplexframe only tested in windows, other platformes are going to be tested soon.
+
+Install simplexframe
+---------------
+Install simplexframe from rubygems
+
+	gem install simplexframe
+
+Or clone from github
+
+Create a simplexframe project 
+------------------------
+In windows, open command console and type just like below:
+
+	simplexframe new your_project_name	
+		
+
+
+== Contributing to simplexframe
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2013 easonhan. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/VERSION

@@ -0,0 +1 @@
+0.1.14

data/bin/simplexframe

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+simplexframe_path = File.expand_path('../../lib', __FILE__)
+#puts simplexframe_path 
+$:.unshift(simplexframe_path)
+
+require 'simplexframe/cli'

data/lib/simplexframe.rb

@@ -0,0 +1,9 @@
+require 'active_support/all' # need be replaced, only required string of active support 
+require 'watir-webdriver'
+require 'page-object'
+require 'simplexframe/ext/string'
+require 'simplexframe/errors'
+require 'simplexframe/simple_config'
+require 'simplexframe/simple_page'
+require 'simplexframe/simple_navigator'
+require 'simplexframe/simple_initializer'

data/lib/simplexframe/cli.rb

@@ -0,0 +1,38 @@
+require 'thor'
+
+module Simplexframe
+	class CLI < Thor	
+		include Thor::Actions
+
+		argument :app_name, required: false
+
+		def self.source_root
+			File.join File.dirname(__FILE__), 'generators'
+		end
+
+		desc 'new', 'create a simplexframe project'
+		def new
+			if app_name
+				directory 'simplexframe', app_name
+			else
+				say 'no app name'
+			end 
+		end
+
+		desc 'go ', 'run test case with rspec'
+		def go
+			ARGV.shift
+			puts "rspec #{ARGV.join('')}" if $debug
+			run "rspec #{ARGV.join('')}"
+		end
+
+		desc 'c ', 'open simplexframe console'
+		def c
+			run 'bin/console'
+		end
+		
+	end
+CLI.start
+
+end #Simplexframe
+

data/lib/simplexframe/errors.rb

@@ -0,0 +1,6 @@
+module Simplexframe
+	class SimpleError < StandardError; end
+	class ConfigFileMissingError < SimpleError; end
+	class IncorrectConfigFileError < SimpleError; end
+	class InvalidSimplexframePageError < SimpleError; end
+end #Simplex

data/lib/simplexframe/ext/string.rb

@@ -0,0 +1,12 @@
+class String
+	def simple_to_hash
+		hash = { }
+		return hash if self.empty?
+		arr = self.split(',').map { |i| i.strip }
+		arr.each do |key|
+			hash[key.to_sym] = true 
+		end #each
+		hash
+	end
+
+end

data/lib/simplexframe/generators/simplexframe/.rspec

@@ -0,0 +1,3 @@
+--default-path=./app/cases
+--format Simplexframe::SimplexframeFormatter
+-r ./config/simplexframe_formatter.rb

data/lib/simplexframe/generators/simplexframe/app/cases/baidu_and_google/baidu_example_spec.rb

@@ -0,0 +1,24 @@
+#encoding: utf-8
+require File.expand_path 'app/cases/spec_helper'
+
+describe 'Baidu example show you how to use simplexframe', :baidu do
+
+	before :all do
+		@keyword = 'watir-webdriver'
+	end
+
+	it 'should search baidu using key word' do
+		baidu_page = $navi.goto_baidu_page
+		baidu_page.keyword = @keyword
+		baidu_page.search_element.click
+		result_page = SearchResultPage.new baidu_page.browser
+		result_page.first_result.should eq 'watir-webdriver_百度百科'
+	end
+
+	it 'should have correct search result' do
+		baidu_page = $navi.goto_baidu_page
+		result_page = baidu_page.search_for @keyword
+		result_page.first_result.should eq 'watir-webdriver_百度百科'
+	end
+
+end

data/lib/simplexframe/generators/simplexframe/app/cases/baidu_and_google/google_example_spec.rb

@@ -0,0 +1,16 @@
+#encoding: utf-8
+require File.expand_path 'app/cases/spec_helper'
+
+describe 'Google example show you how to use simplexframe', :google do
+
+	before :all do
+		@keyword = 'watir-webdriver'
+	end
+
+	it 'should have correct search result' do
+		google_page = $navi.goto_google_page
+		result_page = google_page.search_for @keyword
+		result_page.first_result.should eq 'Watir WebDriver | the most elegant way to use webdriver with ruby'
+	end
+
+end

data/lib/simplexframe/generators/simplexframe/app/cases/mantis/report_issue_spec.rb

@@ -0,0 +1,27 @@
+#encoding: utf-8
+require File.expand_path 'app/cases/spec_helper'
+require File.expand_path 'app/cases/shared/login'
+
+describe 'report issue', :mantis do
+	context 'login' do
+		include_shared 'login'
+	end
+
+	context 'report issue' do
+
+		it 'should create report' do
+			report_issue_page = $navi.goto_report_issue_page	
+			summary = "simplexframe test #{Time.now.to_s}"
+			desc = "description #{Time.now.to_s}"
+			category = 'GUI'
+
+			report_issue_page.create_issue category, summary, desc do |page|
+				page.check_report_stay
+			end
+
+			view_page = $navi.goto_view_all_bug_page
+			view_page.first_row[view_page.summary_column].text.should eq(summary)
+		end
+
+	end #context
+end

data/lib/simplexframe/generators/simplexframe/app/cases/shared/login.rb

@@ -0,0 +1,11 @@
+shared_examples 'login' do
+	it 'should login' do
+		data = test_data('login_user')
+		user = data['demo']['name']
+		password = data['demo']['password']
+		
+		login_page = $navi.goto_login_page
+		my_view_page = login_page.login user, password
+		my_view_page.report_issue?.should be_true
+	end 
+end 

data/lib/simplexframe/generators/simplexframe/app/cases/spec_helper.rb.tt

@@ -0,0 +1,49 @@
+ENV.delete 'HTTP_PROXY' if ENV['HTTP_PROXY']
+require 'rubygems' #for ruby187
+require 'erb'
+require 'psych'
+
+begin
+	require 'simplexframe'
+rescue LoadError
+	puts 'you need using "gem install simplexframe" to install simplexframe first'
+end
+
+<% require 'active_support/all' %>
+Simplexframe::Initializer.new(File.expand_path(File.join('.')), '<%= app_name %>')
+$:.unshift(File.expand_path File.join('.'))
+
+RSpec.configure do |c|
+	c.treat_symbols_as_metadata_keys_with_true_values = true
+	c.run_all_when_everything_filtered = true
+	c.alias_example_to :test_case
+	c.alias_it_should_behave_like_to :include_shared
+
+	unless($config.tags.empty?)
+		tags = case 
+			when String
+				$config.tags.simple_to_hash
+			when Hash
+				$config.tags
+			end #case
+		c.filter_run tags
+	end 
+
+	def test_data file
+		content = ''
+		file_path = File.expand_path(File.join('.', 'app', 'test_data', "#{file}.yml"))
+		raise "Can not find #{file}.yml" unless File.exists?(file_path)
+		File.open(file_path, 'r') do |handle|
+			content = handle.read
+		end
+		Psych.load ERB.new(content).result(binding)
+	end
+	
+	c.before(:suite) do
+		$navi = <%= app_name.camelize %>Navigator.new $config
+	end
+
+	c.after(:suite) do
+		$navi.close
+	end
+end