test_right 0.2.0

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2011 Sauce Labs Inc
+
+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,73 @@
+Test::Right - Opinionated full-stack browser testing
+=================================================
+
+Test::Right is a testing framework designed to help users get maximum value out
+of browser testing. It provides a flexible Page Object model for building
+robust, reliable tests quickly and easily. No more slogging through XPaths in
+Selenium IDE: Test::Right is the right way to build browser tests.
+
+Setup
+-----
+
+    gem install test_right
+    cd MY_APP
+    test_right install
+
+The test_right executable will create a default directory structure in
+test/right for you to put your tests in.
+
+Begin by setting the base_url setting in test/right/config.yml to the base URL
+of your application staging environment. Then add the necessary code to reset
+your application state and launch your server to setup.rb.
+
+Tests are defined in terms of _actions_ and _properties_ on _widgets_. A
+widget is a piece of functionality present on one more more pages of your
+application. A single page can have many widgets, and multiple copies of a
+widget may appear on the same page.
+
+To get started, add widget definitions to the widgets/ directory. A widget
+defines its elements in terms of standard Selenium 2 selectors and actions in
+terms of those elements. For example, something like this in
+test/right/widgets/login.rb:
+
+    class LoginWidget < Test::Right::Widget
+      field :username, :id => 'username'
+      button :login, :css => "input[type=submit]"
+
+      action :login |username, password|
+        fill_in :username, username
+        click :login
+      end
+    end
+
+    class CartWidget  < Test::Right::Widget
+      element :count, :id => 'item_count'
+
+      property :number_of_items do
+        get_element(:count).text
+      end
+    end
+
+Once your widgets are setup, write tests for features of your application in
+test/right/features. For example, something like this would go in
+test/right/features/shopping_cart.rb:
+
+    class ShoppingCartFeature < Test::Right::Feature
+      def setup
+        with LoginWidget do |w|
+          w.login
+        end
+      end
+
+      def test_adding_item
+        with ItemWidget do |w|
+          w.add_an_item
+        end
+
+        with CartWidget do |w|
+          assert_equal, 1, w.number_of_items 
+        end
+      end
+    end
+
+Learn more on the Test::Right wiki at https://github.com/saucelabs/test_right/wiki

data/Rakefile

@@ -0,0 +1,53 @@
+require 'rubygems'
+require 'rake'
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+require 'rcov/rcovtask'
+Rcov::RcovTask.new do |t|
+  #t.test_files = FileList['test/test_*.rb']
+  t.ruby_opts << "-Ilib" # in order to use this rcov
+  t.ruby_opts << "-Itest"
+  t.rcov_opts << "--xrefs"  # comment to disable cross-references
+  t.rcov_opts << "--exclude-only" << "test/test*,^\/,^features\/,^widgets\/,test/helper.rb,test/mock_driver.rb"
+  t.verbose = true
+end
+
+task :build do
+  unless system "gem build test_right.gemspec"
+    raise "Failed to build"
+  end
+end
+
+desc 'Release gem to rubygems.org'
+task :release => :build do
+  system "gem push `ls *.gem | sort | tail -n 1`"
+end
+
+desc 'tag current version'
+task :tag do
+  version = nil
+  File.open("test_right.gemspec").each do |line|
+    if line =~ /s.version = "(.*)"/
+      version = $1
+    end
+  end
+
+  if version.nil?
+    raise "Couldn't find version"
+  end
+
+  system "git tag v#{version}"
+end
+
+desc 'push to github'
+task :push do
+  system "git push origin master --tags"
+end
+
+task :default => [:test, :tag, :push]

data/lib/test/right/assertions.rb

@@ -0,0 +1,36 @@
+module Test
+  module Right
+    module Assertions
+      DEFAULT_ASSERTION_TIMEOUT = 15 # seconds
+
+      def assert(timeout=DEFAULT_ASSERTION_TIMEOUT)
+        if !block_given?
+          raise ArgumentError, "assert requires a block"
+        end
+
+        start = Time.now
+        while Time.now-start < timeout
+          begin
+            if yield
+              return
+            end
+          rescue WidgetNotPresentError
+          end
+          sleep(0.5)
+        end
+
+        raise AssertionFailedError, "Assertion failed after #{timeout} seconds"
+      end
+
+      def assert_equal(expected, actual, timeout=DEFAULT_ASSERTION_TIMEOUT)
+        if actual.is_a? Value
+          assert do
+            expected == actual.value
+          end
+        else
+          raise AssertionFailedError, "Expected #{expected.inspect} but got #{actual.inspect}" unless expected == actual
+        end
+      end
+    end
+  end
+end

data/lib/test/right/browser_driver.rb

@@ -0,0 +1,34 @@
+require 'selenium-webdriver'
+
+module Test
+  module Right
+    class BrowserDriver
+      def initialize(config)
+        @base_url = config[:base_url]
+        if @base_url =~ /\/$/
+          @base_url = @base_url[0..-2]
+        end
+        @driver = Selenium::WebDriver.for :firefox
+      end
+
+      def get(url, options = {})
+        if options[:relative]
+          @driver.get(relative_url(url))
+        else
+          @driver.get(url)
+        end
+      end
+
+      private
+
+      def relative_url(url)
+        raise ConfigurationError, "No base_url in config.yml" if @base_url.nil?
+        @base_url + url
+      end
+
+      def method_missing(name, *args)
+        @driver.send(name, *args)
+      end
+    end
+  end
+end

data/lib/test/right/cli.rb

@@ -0,0 +1,117 @@
+require 'yaml'
+
+module Test
+  module Right
+    class CLI
+      RUBY_FILE = /^[^.].+.rb$/
+
+
+      def start(argument_list)
+        if argument_list.first == "install"
+          Generator.new(argument_list[1..-1]).generate
+          return
+        else
+          load_and_run_tests
+        end
+      end
+
+      def load_and_run_tests
+        run_setup
+
+        subdir = false
+        if File.directory? "test/right"
+          Dir.chdir("test/right")
+          subdir = true
+        end
+
+        load_config
+        load_widgets
+        load_features
+        
+        Dir.chdir("../..") if subdir
+
+        puts "Running #{features.size} features"
+        runner = Runner.new(config, widgets, features)
+        if runner.run
+          puts "Passed!"
+        else
+          at_exit {
+            exit(1)
+          }
+          puts "Failed:"
+          runner.results.each do |feature, feature_result|
+            puts "  #{feature}"
+            feature_result.each do |method, result|
+              if result.is_a? Exception
+                if result.is_a? WidgetActionNotImplemented
+                  puts "    #{method} => #{result}"
+                else
+                  puts "    #{method} => #{result.class} - #{result}"
+                  result.backtrace.each do |trace|
+                    puts "      #{trace}"
+                  end
+                end
+              else
+                puts "    #{method} => #{result}"
+              end
+            end
+          end
+        end
+      end
+
+      def run_setup
+        if File.exists? "setup.rb"
+          unless system("./setup.rb")
+            raise ConfigurationError, "Setup failed"
+          end
+        elsif File.exists? "test/right/setup.rb"
+          unless system("test/right/setup.rb")
+            raise ConfigurationError, "Setup failed"
+          end
+        end
+      end
+
+      def load_config
+        options = {}
+        if File.exists? "config.yml"
+          options = YAML.load(open("config.yml"))
+        end
+        @config = Config.new(options)
+      end
+
+      def config
+        @config
+      end
+
+      def load_widgets
+        raise ConfigurationError, "no widgets/ directory" unless File.directory? "widgets"
+        load_ruby_in_dir("widgets")
+      end
+
+      def widgets
+        Widget.subclasses || []
+      end
+
+      def load_features
+        raise ConfigurationError, "no features/ directory" unless File.directory? "features"
+        load_ruby_in_dir("features")
+      end
+
+      def features
+        Feature.subclasses || []
+      end
+
+      private
+      
+      def load_ruby_in_dir(dirname)
+        Dir.foreach dirname do |filename|
+          unless [".", ".."].include? filename
+            if filename =~ RUBY_FILE
+              load "#{dirname}/#{filename}"
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/test/right/config.rb

@@ -0,0 +1,13 @@
+module Test
+  module Right
+    class Config
+      def initialize(options={})
+        @options = options
+      end
+
+      def [](name)
+        @options[name] || @options[name.to_s]
+      end
+    end
+  end
+end

data/lib/test/right/data_factory.rb

@@ -0,0 +1,22 @@
+require 'set'
+
+module Test
+  module Right
+    class DataFactory
+      def initialize(template)
+        @template = template
+        @used_ids = Set.new([nil])
+      end
+
+      def [](name)
+        base = @template[name] || @template[name.to_s] || name.to_s
+        id = nil
+        while @used_ids.include? id
+          id = rand(100000)
+        end
+        base += id.to_s
+        return base
+      end
+    end
+  end
+end

data/lib/test/right/errors.rb

@@ -0,0 +1,15 @@
+module Test
+  module Right
+    class Error < StandardError; end
+    class ConfigurationError < Error; end
+    class WidgetActionNotImplemented < Error; end
+    class WidgetNotFoundError < Error; end
+    class SelectorNotFoundError < Error; end
+    class SelectorsNotFoundError < Error; end
+    class ElementNotFoundError < Error; end
+    class AssertionFailedError < Error; end
+    class WidgetConfigurationError < Error; end
+    class WidgetNotPresentError < Error; end
+    class IAmConfusedError < Error; end
+  end
+end

data/lib/test/right/feature.rb

@@ -0,0 +1,38 @@
+module Test
+  module Right
+    class Feature
+      extend Utils::SubclassTracking
+      include Assertions
+
+      attr_reader :data
+
+      WIDGET_TIMEOUT = 10 # seconds
+
+      def initialize(driver, data)
+        @driver = driver
+        @data = data
+      end
+
+      private
+
+      
+      def with(widget_class)
+        wait_for(widget_class)
+        yield widget_class.new(@driver)
+      end
+
+      def wait_for(widget_class)
+        widget = widget_class.new(@driver)
+
+        timeout = Time.now + WIDGET_TIMEOUT
+        while Time.now < timeout
+          break if widget.exists?
+          sleep(0.25)
+        end
+        if !widget.exists?
+          raise WidgetNotPresentError
+        end
+      end
+    end
+  end
+end

data/lib/test/right/generator.rb

@@ -0,0 +1,28 @@
+require 'fileutils'
+
+module Test
+  module Right
+    class Generator
+      include FileUtils
+
+      def initialize(args)
+        @args = args
+      end
+
+      def generate
+        mkdir_p("test/right/features")
+        mkdir_p("test/right/widgets")
+
+        open("test/right/config.yml", 'wb') do |file|
+          file.write <<-EOF
+# The base URL of your staging server
+base_url: http://example.com/
+
+# Which browser you want to run your tests in
+browser: firefox
+          EOF
+        end
+      end
+    end
+  end
+end

data/lib/test/right/runner.rb

@@ -0,0 +1,83 @@
+# trigger autoload before the threads get ahold of it
+Selenium::WebDriver::Firefox
+
+module Test
+  module Right
+    class Runner
+      attr_reader :results, :widget_classes
+
+      def initialize(config, widgets, features)
+        @config = config
+        @widget_classes = widgets
+        @features = features
+        @results = {}
+        @pool = Threadz::ThreadPool.new(:initial_size => 2, :maximum_size => 2)
+        @result_queue = Queue.new
+        @data_template = config[:data] || {}
+      end
+
+      def run
+        @batch = @pool.new_batch
+
+        @features.sort_by{|x| rand(10000)}.all? do |feature|
+          run_feature(feature)
+        end
+
+        @batch.wait_until_done
+
+        process_results
+      end
+
+      def process_results
+        failed = false
+        until @result_queue.empty?
+          feature, method, result = @result_queue.pop
+          if result.is_a? Exception
+            failed = true
+          end
+          @results[feature] ||= {}
+          @results[feature][method] = result
+        end
+        return !failed
+      end
+
+      def run_feature(feature)
+        methods = feature.instance_methods
+        methods.sort_by{|x| rand(10000)}.each do |method_name|
+          if method_name =~ /^test_/
+            @batch << Proc.new do
+              begin
+                method = method_name.to_sym
+                run_test(feature, method_name.to_sym)
+
+                @result_queue << [feature, method, true]
+              rescue => e
+                @result_queue << [feature, method, e]
+              end
+            end
+          end
+        end
+      end
+
+      def run_test(feature, method)
+        if $MOCK_DRIVER
+          driver = MockDriver.new(@config)
+        else
+          driver = BrowserDriver.new(@config)
+        end
+
+        data = DataFactory.new(@data_template)
+
+        begin
+          target = feature.new(driver, data)
+          if target.respond_to? :setup
+            target.setup
+          end
+          target.send(method)
+        ensure
+          driver.quit
+        end
+      end
+    end
+  end
+end

data/lib/test/right/utils.rb

@@ -0,0 +1,20 @@
+module Test
+  module Right
+    module Utils
+      module SubclassTracking
+        def inherited(subclass)
+          @subclasses ||= [] 
+          @subclasses << subclass 
+        end
+
+        def subclasses
+          @subclasses
+        end
+
+        def wipe!
+          @subclasses = []
+        end
+      end
+    end
+  end
+end

data/lib/test/right/value.rb

@@ -0,0 +1,13 @@
+module Test
+  module Right
+    class Value
+      def initialize(&body)
+        @body = body
+      end
+
+      def value
+        @body.call
+      end
+    end
+  end
+end

data/lib/test/right/widget.rb

@@ -0,0 +1,240 @@
+module Test
+  module Right
+    class Widget
+      extend Utils::SubclassTracking
+
+      module ClassMethods
+        attr_reader :root, :name_elements, :validator, :location
+
+        def selector(name)
+          @selectors[name]
+        end
+
+        def element(name, locator)
+          @selectors[name] = locator
+        end
+
+        def lives_at(url)
+          @location = url
+        end
+
+        def rooted_at(root)
+          @root = [root.keys.first, root.values.first]
+          @selectors[:root] = root
+        end
+
+        def named_by(*args)
+          @name_elements ||= []
+          if args.length == 2
+            property, name_element = args
+            @name_elements << [property, name_element.keys.first, name_element.values.first]
+          else
+            name_element = args.first
+            @name_elements << [:text, name_element.keys.first, name_element.values.first]
+          end
+        end
+
+        def validated_by_presence_of(selector)
+          @validator = selector
+        end
+
+        def action(name, &body)
+          define_method name do |*args|
+            self.validate!
+            self.instance_exec *args, &body
+          end
+        end
+
+        def property(name, &body)
+          define_method name do
+            self.validate!
+            Value.new do
+              self.instance_eval &body
+            end
+          end
+        end
+
+        def [](name)
+          WidgetProxy.new(self, name)
+        end
+
+        alias_method :button, :element
+        alias_method :field, :element
+      end
+
+      def self.inherited(subclass)
+        @subclasses ||= [] 
+        @subclasses << subclass 
+        subclass.instance_eval do
+          @selectors = {}
+          @location = nil
+        end
+
+        subclass.extend(ClassMethods)
+      end
+
+      attr_reader :name
+
+      def initialize(driver, name=nil)
+        @driver = driver
+        @name = name
+      end
+
+      def visit
+        @driver.get(self.class.location, :relative => true)
+      end
+
+      def exists?
+        begin
+          root
+          return true
+        rescue WidgetNotPresentError
+          return false
+        end
+      end
+
+      def validate!(timeout=15)
+        timeout = Time.now + timeout
+        while Time.now < timeout
+          if self.exists?
+            return
+          end
+        end
+        raise WidgetNotPresentError
+      end
+
+      def method_missing(name, *args)
+        raise WidgetActionNotImplemented, "#{self.class.to_s}##{name.to_s} not implemented"
+      end
+
+      private
+
+      def fill_in(selector_name, value)
+        get_element(selector_name).send_keys(value)
+      end
+
+      def clear(selector_name)
+        get_element(selector_name).clear
+      end
+      
+      def click(selector_name)
+        get_element(selector_name).click
+      end
+
+      def select(selector_name)
+        get_element(selector_name).select
+      end
+
+      def navigate_to(url)
+        @driver.get(url)
+      end
+
+      def wait_for_element_present(selector_name, timeout=10)
+        endtime = Time.now + timeout
+        while Time.now < endtime
+          begin
+            get_element(selector_name)
+            return
+          rescue ElementNotFoundError
+          rescue WidgetNotPresentError
+          end
+        end
+        raise ElementNotFoundError
+      end
+
+      def wait_for_element_not_present(selector_name, timeout=10)
+        endtime = Time.now + timeout
+        while Time.now < endtime
+          begin
+            get_element(selector_name)
+          rescue ElementNotFoundError
+            return true
+          rescue WidgetNotPresentError
+            return true
+          end
+        end
+        raise Error, "Element didn't disappear"
+      end
+
+      def get_element(selector_name)
+        selector = find_selector(selector_name)
+        if selector_name == :root
+          begin
+            return @driver.find_element(*self.class.root)
+          rescue Selenium::WebDriver::Error::NoSuchElementError => e
+            raise ElementNotFoundError, e.message
+          end
+        end
+
+        target = nil
+        while target.nil?
+          begin
+            target = root.find_element(*selector)
+          rescue Selenium::WebDriver::Error::NoSuchElementError => e
+            raise ElementNotFoundError, "Element #{selector_name} not found on #{self.class.name} using #{selector.inspect}"
+          rescue Selenium::WebDriver::Error::ObsoleteElementError
+            # ignore
+          end
+        end
+        return target
+      end
+
+      def get_elements(selector_name)
+        selector = find_selector(selector_name)
+        begin
+          element = root.find_elements(*selector)
+        rescue Selenium::WebDriver::Error::NoSuchElementError => e
+          raise ElementNotFoundError, e.message
+        end
+      end
+
+      def find_selector(selector_name)
+        if !self.class.selector(selector_name)
+          raise SelectorNotFoundError, "Selector \"#{selector_name}\" for Widget \"#{self.class}\" not found"
+        end
+
+        selector = self.class.selector(selector_name)
+        return [selector.keys.first, selector.values.first]
+      end
+
+      def root
+        if self.class.root.nil? && self.class.name_elements.nil?
+          return @driver
+        elsif self.class.root && self.class.name_elements.nil?
+          begin
+            return @driver.find_element(*self.class.root)
+          rescue Selenium::WebDriver::Error::NoSuchElementError => e
+            raise WidgetNotPresentError, "#{self.class.name} not found on page"
+          end
+        elsif self.class.root && self.class.name_elements
+          all_instances = @driver.find_elements(*self.class.root)
+          target = all_instances.find do |root_element|
+            self.class.name_elements.any? do |property, how, what|
+              begin
+                element = root_element.find_element(how, what)
+                element_name = nil
+                if :value == property
+                  element_name = element.attribute('value')
+                else
+                  element_name = element.send(property)
+                end
+                @name == element_name
+              rescue Selenium::WebDriver::Error::ObsoleteElementError
+                false
+              rescue Selenium::WebDriver::Error::NoSuchElementError
+                false
+              end
+            end
+          end
+          if target.nil?
+            raise WidgetNotPresentError, "#{self.class.name} with name \"#{name}\" not found"
+          end
+          
+          return target
+        else
+          raise IAmConfusedError
+        end
+      end
+    end
+  end
+end

data/lib/test/right/widget_proxy.rb

@@ -0,0 +1,14 @@
+module Test
+  module Right
+    class WidgetProxy
+      def initialize(klass, name)
+        @klass = klass
+        @name = name
+      end
+
+      def new(driver)
+        @klass.new(driver, @name)
+      end
+    end
+  end
+end

data/lib/test/right.rb

@@ -0,0 +1,21 @@
+require 'test/unit/assertions'
+require 'threadz'
+
+module Test
+  module Right
+  end
+end
+
+require 'test/right/errors'
+require 'test/right/utils'
+require 'test/right/config'
+require 'test/right/value'
+require 'test/right/widget_proxy'
+require 'test/right/widget'
+require 'test/right/assertions'
+require 'test/right/feature'
+require 'test/right/browser_driver'
+require 'test/right/data_factory'
+require 'test/right/runner'
+require 'test/right/generator'
+require 'test/right/cli'

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification 
+name: test_right
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: 
+  segments: 
+  - 0
+  - 2
+  - 0
+  version: 0.2.0
+platform: ruby
+authors: 
+- Eric Allen
+- Sean Grove
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-03 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: selenium-webdriver
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 0
+        - 2
+        - 0
+        version: 0.2.0
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: threadz
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 29
+        segments: 
+        - 0
+        - 1
+        - 3
+        version: 0.1.3
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: mocha
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 35
+        segments: 
+        - 0
+        - 9
+        - 12
+        version: 0.9.12
+  type: :development
+  version_requirements: *id003
+description: An opinionated browser testing framework
+email: help@saucelabs.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- LICENSE
+- README.md
+- Rakefile
+- lib/test/right/assertions.rb
+- lib/test/right/browser_driver.rb
+- lib/test/right/cli.rb
+- lib/test/right/config.rb
+- lib/test/right/data_factory.rb
+- lib/test/right/errors.rb
+- lib/test/right/feature.rb
+- lib/test/right/generator.rb
+- lib/test/right/runner.rb
+- lib/test/right/utils.rb
+- lib/test/right/value.rb
+- lib/test/right/widget.rb
+- lib/test/right/widget_proxy.rb
+- lib/test/right.rb
+has_rdoc: true
+homepage: 
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.4.2
+signing_key: 
+specification_version: 3
+summary: An opinionated browser testing framework
+test_files: []
+