Module: Betatest
- Defined in:
- lib/betatest/mock.rb,
lib/betatest.rb,
lib/betatest/test.rb,
lib/betatest/unit.rb,
lib/betatest/version.rb,
lib/betatest/parallel.rb,
lib/betatest/benchmark.rb,
lib/betatest/benchmark.rb,
lib/betatest/assertions.rb,
lib/betatest/pride_plugin.rb
Overview
:nodoc:
Defined Under Namespace
Modules: Assertions, Expectations, Guard, Parallel Classes: AbstractReporter, Assertion, BacktraceFilter, BenchSpec, Benchmark, CompositeReporter, Mock, PrideIO, PrideLOL, ProgressReporter, Reporter, Runnable, Skip, Spec, StatisticsReporter, SummaryReporter, Test, UnexpectedError, Unit
Constant Summary collapse
- VERSION =
"0.0.2"
- @@after_run =
[]
Class Method Summary collapse
-
.__run(reporter, options) ⇒ Object
Internal run method.
-
.after_run(&block) ⇒ Object
A simple hook allowing you to run a block of code after everything is done running.
-
.autorun ⇒ Object
Registers Betatest to run at process exit.
-
.filter_backtrace(bt) ⇒ Object
:nodoc:.
-
.init_plugins(options) ⇒ Object
:nodoc:.
-
.load_plugins ⇒ Object
:nodoc:.
-
.plugin_pride_init(options) ⇒ Object
:nodoc:.
-
.plugin_pride_options(opts, options) ⇒ Object
:nodoc:.
-
.process_args(args = []) ⇒ Object
:nodoc:.
-
.run(args = []) ⇒ Object
This is the top-level run method.
-
.run_one_method(klass, method_name) ⇒ Object
:nodoc:.
Instance Method Summary collapse
-
#attr_accessor ⇒ Object
Names of known extension plugins.
Class Method Details
.__run(reporter, options) ⇒ Object
Internal run method. Responsible for telling all Runnable sub-classes to run.
NOTE: this method is redefined in parallel_each.rb, which is loaded if a Runnable calls parallelize_me!.
144 145 146 147 148 149 150 151 152 153 154 155 |
# File 'lib/betatest.rb', line 144 def self.__run reporter, suites = Runnable.runnables.shuffle parallel, serial = suites.partition { |s| s.test_order == :parallel } # If we run the parallel tests before the serial tests, the parallel tests # could run in parallel with the serial tests. This would be bad because # the serial tests won't lock around Reporter#record. Run the serial tests # first, so that after they complete, the parallel tests will lock when # recording results. serial.map { |suite| suite.run reporter, } + parallel.map { |suite| suite.run reporter, } end |
.after_run(&block) ⇒ Object
A simple hook allowing you to run a block of code after everything is done running. Eg:
Betatest.after_run { p $debugging_info }
70 71 72 |
# File 'lib/betatest.rb', line 70 def self.after_run &block @@after_run << block end |
.autorun ⇒ Object
Registers Betatest to run at process exit
42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 |
# File 'lib/betatest.rb', line 42 def self.autorun at_exit { next if $! and not ($!.kind_of? SystemExit and $!.success?) # Keep track of the testing process pid, so that we don't accidentally run the @@after_run handlers in children processes (e.g. Process.fork). @@testing_process_pid = Process.pid exit_code = nil at_exit { # Don't do anything if we aren't the testing process. next if Process.pid != @@testing_process_pid @@after_run.reverse_each(&:call) exit exit_code || false } exit_code = Betatest.run ARGV } unless @@installed_at_exit @@installed_at_exit = true end |
.filter_backtrace(bt) ⇒ Object
:nodoc:
222 223 224 |
# File 'lib/betatest.rb', line 222 def self.filter_backtrace bt # :nodoc: backtrace_filter.filter bt end |
.init_plugins(options) ⇒ Object
:nodoc:
74 75 76 77 78 79 |
# File 'lib/betatest.rb', line 74 def self.init_plugins # :nodoc: self.extensions.each do |name| msg = "plugin_#{name}_init" send msg, if self.respond_to? msg end end |
.load_plugins ⇒ Object
:nodoc:
81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 |
# File 'lib/betatest.rb', line 81 def self.load_plugins # :nodoc: return unless self.extensions.empty? seen = {} require "rubygems" unless defined? Gem Gem.find_files("betatest/*_plugin.rb").each do |plugin_path| name = File.basename plugin_path, "_plugin.rb" next if seen[name] seen[name] = true require plugin_path self.extensions << name end end |
.plugin_pride_init(options) ⇒ Object
:nodoc:
10 11 12 13 14 15 16 17 18 19 |
# File 'lib/betatest/pride_plugin.rb', line 10 def self.plugin_pride_init # :nodoc: if PrideIO.pride? then klass = ENV["TERM"] =~ /^xterm|-256color$/ ? PrideLOL : PrideIO io = klass.new [:io] self.reporter.reporters.grep(Betatest::Reporter).each do |rep| rep.io = io end end end |
.plugin_pride_options(opts, options) ⇒ Object
:nodoc:
4 5 6 7 8 |
# File 'lib/betatest/pride_plugin.rb', line 4 def self. opts, # :nodoc: opts.on "-p", "--pride", "Pride. Show your testing pride!" do PrideIO.pride! end end |
.process_args(args = []) ⇒ Object
:nodoc:
157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 |
# File 'lib/betatest.rb', line 157 def self.process_args args = [] # :nodoc: = { :io => $stdout, } orig_args = args.dup OptionParser.new do |opts| opts. = "betatest options:" opts.version = Betatest::VERSION opts.on "-h", "--help", "Display this help." do puts opts exit end opts.on "-s", "--seed SEED", Integer, "Sets random seed" do |m| [:seed] = m.to_i end opts.on "-v", "--verbose", "Verbose. Show progress processing files." do [:verbose] = true end opts.on "-n", "--name PATTERN","Filter run on /pattern/ or string." do |a| [:filter] = a end unless extensions.empty? opts.separator "" opts.separator "Known extensions: #{extensions.join(', ')}" extensions.each do |meth| msg = "plugin_#{meth}_options" send msg, opts, if self.respond_to?(msg) end end begin opts.parse! args rescue OptionParser::InvalidOption => e puts puts e puts puts opts exit 1 end orig_args -= args end unless [:seed] then srand [:seed] = srand % 0xFFFF orig_args << "--seed" << [:seed].to_s end srand [:seed] [:args] = orig_args.map { |s| s =~ /[\s|&<>$()]/ ? s.inspect : s }.join " " end |
.run(args = []) ⇒ Object
This is the top-level run method. Everything starts from here. It tells each Runnable sub-class to run, and each of those are responsible for doing whatever they do.
The overall structure of a run looks like this:
Betatest.autorun
Betatest.run(args)
Betatest.__run(reporter, )
Runnable.runnables.each
runnable.run(reporter, )
self.runnable_methods.each
self.run_one_method(self, runnable_method, reporter)
Betatest.run_one_method(klass, runnable_method, reporter)
klass.new(runnable_method).run
116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 |
# File 'lib/betatest.rb', line 116 def self.run args = [] self.load_plugins = process_args args reporter = CompositeReporter.new reporter << SummaryReporter.new([:io], ) reporter << ProgressReporter.new([:io], ) self.reporter = reporter # this makes it available to plugins self.init_plugins self.reporter = nil # runnables shouldn't depend on the reporter, ever reporter.start __run reporter, self.parallel_executor.shutdown reporter.report reporter.passed? end |
.run_one_method(klass, method_name) ⇒ Object
:nodoc:
762 763 764 765 766 |
# File 'lib/betatest.rb', line 762 def self.run_one_method klass, method_name # :nodoc: result = klass.new(method_name).run raise "#{klass}#run _must_ return self" unless klass === result result end |
Instance Method Details
#attr_accessor ⇒ Object
Names of known extension plugins.
19 |
# File 'lib/betatest.rb', line 19 mc.send :attr_accessor, :parallel_executor |