Module: Minitest
- Defined in:
- lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb,
lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest/mock.rb,
lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest/test.rb,
lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest/unit.rb,
lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest/parallel.rb,
lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest/benchmark.rb,
lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest/benchmark.rb,
lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest/test_task.rb,
lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest/assertions.rb,
lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest/pride_plugin.rb
Overview
:nodoc:
Defined Under Namespace
Modules: Assertions, Expectations, Guard, Parallel, Reportable Classes: AbstractReporter, Assertion, BacktraceFilter, BenchSpec, Benchmark, CompositeReporter, Mock, PrideIO, PrideLOL, ProgressReporter, Reporter, Result, Runnable, Skip, Spec, StatisticsReporter, SummaryReporter, Test, TestTask, UnexpectedError, Unit
Constant Summary collapse
- VERSION =
:nodoc:
"5.17.0"
- @@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 Minitest to run at process exit.
-
.cattr_accessor(name) ⇒ Object
:nodoc:.
-
.clock_time ⇒ Object
:nodoc:.
-
.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
-
#backtrace_filter ⇒ Object
Filter object for backtraces.
-
#extensions ⇒ Object
Names of known extension plugins.
-
#info_signal ⇒ Object
The signal to use for dumping information to STDERR.
-
#parallel_executor ⇒ Object
Parallel test executor.
-
#reporter ⇒ Object
Reporter object to be used for all runs.
-
#seed ⇒ Object
The random seed used for this run.
Class Method Details
.__run(reporter, options) ⇒ Object
Internal run method. Responsible for telling all Runnable sub-classes to run.
173 174 175 176 177 178 179 180 181 182 183 184 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb', line 173 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:
Minitest.after_run { p $debugging_info }
94 95 96 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb', line 94 def self.after_run &block @@after_run << block end |
.autorun ⇒ Object
Registers Minitest to run at process exit
66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb', line 66 def self.autorun if Object.const_defined?(:Warning) && Warning.respond_to?(:[]=) Warning[:deprecated] = true end at_exit { next if $! and not ($!.kind_of? SystemExit and $!.success?) exit_code = nil pid = Process.pid at_exit { next if Process.pid != pid @@after_run.reverse_each(&:call) exit exit_code || false } exit_code = Minitest.run ARGV } unless @@installed_at_exit @@installed_at_exit = true end |
.cattr_accessor(name) ⇒ Object
:nodoc:
18 19 20 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb', line 18 def self.cattr_accessor name # :nodoc: (class << self; self; end).attr_accessor name end |
.clock_time ⇒ Object
:nodoc:
1059 1060 1061 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb', line 1059 def self.clock_time Process.clock_gettime Process::CLOCK_MONOTONIC end |
.filter_backtrace(bt) ⇒ Object
:nodoc:
264 265 266 267 268 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb', line 264 def self.filter_backtrace bt # :nodoc: result = backtrace_filter.filter bt result = bt.dup if result.empty? result end |
.init_plugins(options) ⇒ Object
:nodoc:
98 99 100 101 102 103 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb', line 98 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:
105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb', line 105 def self.load_plugins # :nodoc: return unless self.extensions.empty? seen = {} require "rubygems" unless defined? Gem Gem.find_files("minitest/*_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/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest/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(Minitest::Reporter).each do |rep| rep.io = io if rep.io.tty? end end end |
.plugin_pride_options(opts, _options) ⇒ Object
:nodoc:
4 5 6 7 8 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest/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:
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 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb', line 186 def self.process_args args = [] # :nodoc: = { :io => $stdout, } orig_args = args.dup OptionParser.new do |opts| opts. = "minitest options:" opts.version = Minitest::VERSION opts.on "-h", "--help", "Display this help." do puts opts exit end opts.on "--no-plugins", "Bypass minitest plugin auto-loading (or set $MT_NO_PLUGINS)." desc = "Sets random seed. Also via env. Eg: SEED=n rake" opts.on "-s", "--seed SEED", Integer, desc do |m| [:seed] = m.to_i end opts.on "-v", "--verbose", "Verbose. Show progress processing files." do [:verbose] = true end opts.on "--show-skips", "Show skipped at the end of run." do [:show_skips] = true end opts.on "-n", "--name PATTERN", "Filter run on /regexp/ or string." do |a| [:filter] = a end opts.on "-e", "--exclude PATTERN", "Exclude /regexp/ or string from run." do |a| [:exclude] = a end opts.on "-S", "--skip CODES", String, "Skip reporting of certain types of results (eg E)." do |s| [:skip] = s.chars.to_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] = (ENV["SEED"] || srand).to_i % 0xFFFF orig_args << "--seed" << [:seed].to_s end [: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:
Minitest.autorun
Minitest.run(args)
Minitest.__run(reporter, )
Runnable.runnables.each
runnable.run(reporter, )
self.runnable_methods.each
self.run_one_method(self, runnable_method, reporter)
Minitest.run_one_method(klass, runnable_method)
klass.new(runnable_method).run
140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb', line 140 def self.run args = [] self.load_plugins unless args.delete("--no-plugins") || ENV["MT_NO_PLUGINS"] = process_args args Minitest.seed = [:seed] srand Minitest.seed 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 self.parallel_executor.start if parallel_executor.respond_to?(:start) reporter.start begin __run reporter, rescue Interrupt warn "Interrupted. Exiting..." end self.parallel_executor.shutdown reporter.report reporter.passed? end |
.run_one_method(klass, method_name) ⇒ Object
:nodoc:
1050 1051 1052 1053 1054 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb', line 1050 def self.run_one_method klass, method_name # :nodoc: result = klass.new(method_name).run raise "#{klass}#run _must_ return a Result" unless Result === result result end |
Instance Method Details
#backtrace_filter ⇒ Object
Filter object for backtraces.
43 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb', line 43 cattr_accessor :backtrace_filter |
#extensions ⇒ Object
Names of known extension plugins.
55 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb', line 55 cattr_accessor :extensions |
#info_signal ⇒ Object
The signal to use for dumping information to STDERR. Defaults to “INFO”.
60 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb', line 60 cattr_accessor :info_signal |
#parallel_executor ⇒ Object
Parallel test executor
33 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb', line 33 cattr_accessor :parallel_executor |
#reporter ⇒ Object
Reporter object to be used for all runs.
NOTE: This accessor is only available during setup, not during runs.
50 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb', line 50 cattr_accessor :reporter |
#seed ⇒ Object
The random seed used for this run. This is used to srand at the start of the run and between each Runnable.run
.
Set via Minitest.run after processing args.
28 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/minitest-5.17.0/lib/minitest.rb', line 28 cattr_accessor :seed |