easy-automation 0.0.2 → 0.0.3

data/README.markdown

@@ -3,16 +3,8 @@ Easy Automation
 
 Friendly Automation Testing Framework, tired of update every single test when developers change an XPath, id, class, etc? This is for you.
 
-Design
-------
-
-This framework uses common patterns to make maintainability easy and scalable tests. It's divided in:
-
-* Pages
-* Page Elements
-* Test
-* Data for Tests
-* Runner
+Why another automation testing framework?
+======
 
 Challenges when developing automated tests
 ------
@@ -22,6 +14,18 @@ Challenges when developing automated tests
 * Some tests depend in other
 * If you need to update data used by test, you touch test code
 
+Maintainability
+------
+
+This framework uses common patterns to make maintainability easy and scalable tests. It's divided in:
+
+* Pages, mapped to actual pages on your systems
+* Page Elements, defining every single element in your pages needed by tests, each element has actions
+* Test, tests checking your site
+* Data for Tests, do you want to modify login credentials or run it using different ones? change it in a single place, and you're done
+* Runner, you can group multiples tests to perform full tests, run stable ones, smock check, etc.
+* Hooks, do you want to call a service that resets the db before every single test? it's already implemented.
+
 Design
 ------
 
@@ -91,6 +95,23 @@ You can change any behaviour using EasyAutomation::Runner.config helper, options
       end
     end
 
+You can modify the behaviour via command line arguments, it's very useful when you want to run the same tests against different url, browser, etc, for example:
+    bundle exec ruby example.rb --url=http://google.com
+This will run the example provided against http://google.com instead of http://www.google.com defined on the configure block, another example:
+
+    bundle exec ruby example.rb --url=http://images.google.com --browser=*safari
+This will run example tests against images.google.com using safari browser
+
+
+Installation
+-------
+Bundler:
+    echo "gem 'easy-automation' " >> Gemfile
+    bundle install
+
+Gems:
+    gem install easy-automation
+
 Example
 -------
 Structure:
@@ -166,6 +187,7 @@ Roadmap
 * More hooks [before|after] [:all|:each] [:test|:suite]
 * Update Selenium gem to use latest selenium-RC and fix weird firefox crashes.
 * Multi browser
+* Arguments via command line, done
 * Wait for element to be loaded event
 * Rake integration
 * Retry on failed tests
@@ -187,11 +209,18 @@ From 0.0.1 to 0.0.2
 * [before|after] [:all|:each] [:test|:suite] hooks
 * Remote Selenium RC
 
+From 0.0.2 to 0.0.3
+-------
+* Arguments support
+
+
 From 0.0.2 to 0.1.0
 -------
 * Retry failed tests
+* Better test reporting
 * Selenium Grid integration
 
+
 Contributing
 ------------
 
@@ -201,3 +230,12 @@ Contributing
 4. Push to the branch (`git push origin my_branch`)
 5. Create an [Issue][1] with a link to your branch
 6. Enjoy a refreshing Beer and wait
+
+
+About the Author
+------------
+[Crowd Interactive](http://www.crowdint.com) is a Ruby and Rails consultancy firm
+powered by a team of enthusiast engineers who love programming.
+We turn your ideas into web applications, and we like challenging projects. We also have
+a lot of experience in retail, so it doesn't matter if your idea is about
+something you'd like to sell, we can surely help you.

data/lib/easy-automation.rb

@@ -1,5 +1,6 @@
 require 'selenium'
 require 'test/unit/ui/console/testrunner'
+require 'easy_automation/args'
 require 'easy_automation/config'
 require 'easy_automation/data_elements'
 require 'easy_automation/load_data'

data/lib/easy_automation/args.rb

@@ -0,0 +1,25 @@
+module EasyAutomation
+  class Args
+    class << self
+      def parse args
+        Args.usage if args.include?('--help')
+        args.each do |arg|
+          var_name = arg.split('=')
+          begin
+          eval(%{
+             EasyAutomation::Runner.configuration.#{var_name[0].gsub('--', '')} = "#{var_name[1]}"
+          })
+          rescue Exception => e
+            Args.usage
+            break
+          end
+
+        end
+      end
+
+      def usage
+        puts "Easy Automation"
+      end
+    end
+  end
+end

data/lib/easy_automation/version.rb

@@ -1,3 +1,3 @@
 module EasyAutomation
-    VERSION = "0.0.2"
+    VERSION = "0.0.3"
 end

data/spec/lib/easy-automation/runner_spec.rb

@@ -8,7 +8,7 @@ describe EasyAutomation::Runner do
     context "selenium params" do
       it "should default params" do
         EasyAutomation::Runner.configuration.selenium_port.should be(4444)
-        EasyAutomation::Runner.configuration.selenium_timeout.should be(1000)
+        EasyAutomation::Runner.configuration.selenium_timeout.should be(4000)
         EasyAutomation::Runner.configuration.browsers.should == ["* firefox"]
         EasyAutomation::Runner.configuration.url.should == "http://www.google.com"
       end

data/spec/lib/easy-automation/zz_args_spec.rb

@@ -0,0 +1,32 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+
+describe EasyAutomation::Args do
+  subject {Args}
+
+  describe "When specifying no args" do
+    it "should not alter configuration" do
+      EasyAutomation::Runner.configure do |config|
+        config.url = "not_modified"
+      end
+      argv = []
+      EasyAutomation::Args.parse(argv)
+      EasyAutomation::Runner.configuration.url.should == "not_modified"
+    end
+  end
+  describe "When specifying args" do
+    it "should not alter configuration" do
+      argv = ["--url=testing_args"]
+      EasyAutomation::Args.parse(argv)
+      EasyAutomation::Runner.configuration.url.should == "testing_args"
+    end
+  end
+
+  describe "when specifying wrong params" do
+    it "should not raise any exception" do
+      EasyAutomation::Args.should_receive(:usage).and_return(true)
+      argv = ["--wrong_param=testing_args"]
+      EasyAutomation::Args.parse(argv)
+    end
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: easy-automation
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 25
   prerelease: 
   segments: 
   - 0
   - 0
-  - 2
-  version: 0.0.2
+  - 3
+  version: 0.0.3
 platform: ruby
 authors: 
 - Edwin Cruz
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-03-24 00:00:00 -07:00
+date: 2011-03-29 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -65,6 +65,7 @@ files:
 - Rakefile
 - easy-automation.gemspec
 - lib/easy-automation.rb
+- lib/easy_automation/args.rb
 - lib/easy_automation/config.rb
 - lib/easy_automation/data_elements.rb
 - lib/easy_automation/load_data.rb
@@ -84,6 +85,7 @@ files:
 - spec/lib/easy-automation/runner_spec.rb
 - spec/lib/easy-automation/suite_spec.rb
 - spec/lib/easy-automation/test_spec.rb
+- spec/lib/easy-automation/zz_args_spec.rb
 - spec/spec_helper.rb
 - spec/support/browser.rb
 - spec/support/data/hometest.yml
@@ -131,6 +133,7 @@ test_files:
 - spec/lib/easy-automation/runner_spec.rb
 - spec/lib/easy-automation/suite_spec.rb
 - spec/lib/easy-automation/test_spec.rb
+- spec/lib/easy-automation/zz_args_spec.rb
 - spec/spec_helper.rb
 - spec/support/browser.rb
 - spec/support/data/hometest.yml